@novastera-oss/nitro-metamask 0.1.3

package/android/fix-prefab.gradle

@@ -0,0 +1,51 @@
+tasks.configureEach { task ->
+  // Make sure that we generate our prefab publication file only after having built the native library
+  // so that not a header publication file, but a full configuration publication will be generated, which
+  // will include the .so file
+
+  def prefabConfigurePattern = ~/^prefab(.+)ConfigurePackage$/
+  def matcher = task.name =~ prefabConfigurePattern
+  if (matcher.matches()) {
+    def variantName = matcher[0][1]
+    task.outputs.upToDateWhen { false }
+    task.dependsOn("externalNativeBuild${variantName}")
+  }
+}
+
+afterEvaluate {
+  def abis = reactNativeArchitectures()
+  rootProject.allprojects.each { proj ->
+    if (proj === rootProject) return
+
+    def dependsOnThisLib = proj.configurations.findAll { it.canBeResolved }.any { config ->
+      config.dependencies.any { dep ->
+        dep.group == project.group && dep.name == project.name
+      }
+    }
+    if (!dependsOnThisLib && proj != project) return
+
+    if (!proj.plugins.hasPlugin('com.android.application') && !proj.plugins.hasPlugin('com.android.library')) {
+      return
+    }
+
+    def variants = proj.android.hasProperty('applicationVariants') ? proj.android.applicationVariants : proj.android.libraryVariants
+    // Touch the prefab_config.json files to ensure that in ExternalNativeJsonGenerator.kt we will re-trigger the prefab CLI to
+    // generate a libnameConfig.cmake file that will contain our native library (.so).
+    // See this condition: https://cs.android.com/android-studio/platform/tools/base/+/mirror-goog-studio-main:build-system/gradle-core/src/main/java/com/android/build/gradle/tasks/ExternalNativeJsonGenerator.kt;l=207-219?q=createPrefabBuildSystemGlue
+    variants.all { variant ->
+      def variantName = variant.name
+      abis.each { abi ->
+        def searchDir = new File(proj.projectDir, ".cxx/${variantName}")
+        if (!searchDir.exists()) return
+        def matches = []
+        searchDir.eachDir { randomDir ->
+          def prefabFile = new File(randomDir, "${abi}/prefab_config.json")
+          if (prefabFile.exists()) matches << prefabFile
+        }
+        matches.each { prefabConfig ->
+          prefabConfig.setLastModified(System.currentTimeMillis())
+        }
+      }
+    }
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NitroMetamask_kotlinVersion=2.1.20
+NitroMetamask_minSdkVersion=23
+NitroMetamask_targetSdkVersion=36
+NitroMetamask_compileSdkVersion=36
+NitroMetamask_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "NitroMetamaskOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::nitrometamask::initialize(vm);
+}

package/android/src/main/java/com/margelo/nitro/nitrometamask/HybridMetamaskConnector.kt

@@ -0,0 +1,48 @@
+package com.margelo.nitro.nitrometamask
+
+import io.metamask.androidsdk.ConnectOptions
+import io.metamask.androidsdk.EthereumClient
+import io.metamask.androidsdk.Request
+import io.metamask.androidsdk.RequestResult
+
+class HybridMetamaskConnector : HybridMetamaskConnectorSpec() {
+    private val client by lazy { EthereumClient.getInstance() }
+
+    override suspend fun connect(): ConnectResult {
+        val response = client.connect(ConnectOptions())
+        val address = response.accounts.firstOrNull()
+            ?: throw IllegalStateException("MetaMask SDK returned no accounts")
+
+        return ConnectResult(
+            address = address,
+            chainId = response.chainId.toString()
+        )
+    }
+
+    override suspend fun signMessage(message: String): String {
+        val address = client.getSelectedAddress() 
+            ?: throw IllegalStateException("No connected account. Call connect() first.")
+        
+        // Convert message to hex-encoded format for personal_sign
+        // personal_sign expects: personal_sign(messageHex, address)
+        // where messageHex is "0x" + hex-encoded UTF-8 bytes
+        val messageBytes = message.toByteArray(Charsets.UTF_8)
+        val messageHex = "0x" + messageBytes.joinToString("") { "%02x".format(it) }
+        
+        val request = Request(
+            method = "personal_sign",
+            params = listOf(messageHex, address)
+        )
+        
+        val result = client.sendRequest(request)
+        return when (result) {
+            is RequestResult.Success -> {
+                result.data as? String ?: throw IllegalStateException("Invalid signature response")
+            }
+            is RequestResult.Error -> {
+                throw Exception(result.error.message ?: "Failed to sign message")
+            }
+        }
+    }
+}
+

package/android/src/main/java/com/margelo/nitro/nitrometamask/NitroMetamaskPackage.kt

@@ -0,0 +1,18 @@
+package com.margelo.nitro.nitrometamask
+
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.BaseReactPackage
+
+class NitroMetamaskPackage : BaseReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? = null
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider { HashMap() }
+
+    companion object {
+        init {
+            NitroMetamaskOnLoad.initializeNative()
+        }
+    }
+}

package/ios/Bridge.h

@@ -0,0 +1,8 @@
+//
+//  Bridge.h
+//  NitroMetamask
+//
+//  Created by Marc Rousavy on 22.07.24.
+//
+
+#pragma once

package/ios/HybridMetamaskConnector.swift

@@ -0,0 +1,58 @@
+import Foundation
+import MetaMaskSDK
+
+class HybridMetamaskConnector: HybridMetamaskConnectorSpec {
+  private let sdk = MetaMaskSDK.shared
+
+  func connect() async throws -> ConnectResult {
+    try await withCheckedThrowingContinuation { continuation in
+      sdk.connect { response in
+        switch response {
+        case .success(let account):
+          let result = ConnectResult(address: account.address, chainId: "\(account.chainId)")
+          continuation.resume(returning: result)
+        case .failure(let error):
+          continuation.resume(throwing: error)
+        }
+      }
+    }
+  }
+
+  func signMessage(message: String) async throws -> String {
+    // Get the connected account address
+    guard let account = sdk.account else {
+      throw NSError(domain: "MetamaskConnector", code: -1, userInfo: [NSLocalizedDescriptionKey: "No connected account. Call connect() first."])
+    }
+    
+    // Convert message to hex-encoded format for personal_sign
+    // personal_sign expects: personal_sign(messageHex, address)
+    // where messageHex is "0x" + hex-encoded UTF-8 bytes
+    // Reference: https://github.com/MetaMask/metamask-ios-sdk#5-connect-with-request
+    guard let messageData = message.data(using: .utf8) else {
+      throw NSError(domain: "MetamaskConnector", code: -1, userInfo: [NSLocalizedDescriptionKey: "Failed to encode message"])
+    }
+    
+    let messageHex = "0x" + messageData.map { String(format: "%02x", $0) }.joined()
+    let params: [String] = [messageHex, account.address]
+    
+    // Create EthereumRequest for personal_sign JSON-RPC method
+    let request = EthereumRequest(
+      method: .personalSign,
+      params: params
+    )
+    
+    // Make the request using the SDK's async request method
+    let result = try await sdk.request(request)
+    
+    // Extract signature from response
+    // The signature should be a hex-encoded string (0x-prefixed)
+    if let signature = result as? String {
+      return signature
+    } else if let dict = result as? [String: Any], let sig = dict["signature"] as? String ?? dict["result"] as? String {
+      return sig
+    } else {
+      throw NSError(domain: "MetamaskConnector", code: -1, userInfo: [NSLocalizedDescriptionKey: "Invalid signature response format"])
+    }
+  }
+}
+

package/lib/MetamaskConnector.nitro.d.ts

@@ -0,0 +1,12 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+export interface ConnectResult {
+    address: string;
+    chainId: string;
+}
+export interface MetamaskConnector extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    connect(): Promise<ConnectResult>;
+    signMessage(message: string): Promise<string>;
+}

package/lib/MetamaskConnector.nitro.js

@@ -0,0 +1 @@
+export {};

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectResult, MetamaskConnector } from './MetamaskConnector.nitro';
+export declare const metamaskConnector: MetamaskConnector;
+export type { ConnectResult, MetamaskConnector };

package/lib/index.js

@@ -0,0 +1,2 @@
+import { NitroModules } from 'react-native-nitro-modules';
+export const metamaskConnector = NitroModules.createHybridObject('MetamaskConnector');

package/lib/specs/Example.nitro.js

@@ -0,0 +1,2 @@
+"use strict";
+// TODO: Export specs that extend HybridObject<...> here

package/nitro.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://nitro.margelo.com/nitro.schema.json",
+  "cxxNamespace": [
+    "nitrometamask"
+  ],
+  "ios": {
+    "iosModuleName": "NitroMetamask"
+  },
+  "android": {
+    "androidNamespace": [
+      "nitrometamask"
+    ],
+    "androidCxxLibName": "NitroMetamask"
+  },
+  "autolinking": {
+    "MetamaskConnector": {
+      "swift": "HybridMetamaskConnector",
+      "kotlin": "HybridMetamaskConnector"
+    }
+  },
+  "ignorePaths": [
+    "**/node_modules"
+  ]
+}

package/nitrogen/generated/android/NitroMetamask+autolinking.cmake

@@ -0,0 +1,81 @@
+#
+# NitroMetamask+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2026 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroMetamask+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROMETAMASK_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  NitroMetamask PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/NitroMetamaskOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridMetamaskConnectorSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridMetamaskConnectorSpec.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  NitroMetamask PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        NitroMetamask
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        NitroMetamask
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        NitroMetamask
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/NitroMetamask+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// NitroMetamask+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/NitroMetamask+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 NitroMetamask is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/NitroMetamaskOnLoad.cpp

@@ -0,0 +1,44 @@
+///
+/// NitroMetamaskOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_NITROMETAMASK_WITH_GENERATED_CMAKE_PROJECT
+#error NitroMetamaskOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "NitroMetamaskOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "JHybridMetamaskConnectorSpec.hpp"
+#include <NitroModules/DefaultConstructableObject.hpp>
+
+namespace margelo::nitro::nitrometamask {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::nitrometamask;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    margelo::nitro::nitrometamask::JHybridMetamaskConnectorSpec::registerNatives();
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "MetamaskConnector",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridMetamaskConnectorSpec::javaobject> object("com/margelo/nitro/nitrometamask/HybridMetamaskConnector");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::nitrometamask

package/nitrogen/generated/android/NitroMetamaskOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// NitroMetamaskOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::nitrometamask {
+
+  /**
+   * Initializes the native (C++) part of NitroMetamask, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::nitrometamask::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::nitrometamask

package/nitrogen/generated/android/c++/JConnectResult.hpp

@@ -0,0 +1,61 @@
+///
+/// JConnectResult.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "ConnectResult.hpp"
+
+#include <string>
+
+namespace margelo::nitro::nitrometamask {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "ConnectResult" and the the Kotlin data class "ConnectResult".
+   */
+  struct JConnectResult final: public jni::JavaClass<JConnectResult> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrometamask/ConnectResult;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct ConnectResult by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    ConnectResult toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldAddress = clazz->getField<jni::JString>("address");
+      jni::local_ref<jni::JString> address = this->getFieldValue(fieldAddress);
+      static const auto fieldChainId = clazz->getField<jni::JString>("chainId");
+      jni::local_ref<jni::JString> chainId = this->getFieldValue(fieldChainId);
+      return ConnectResult(
+        address->toStdString(),
+        chainId->toStdString()
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JConnectResult::javaobject> fromCpp(const ConnectResult& value) {
+      using JSignature = JConnectResult(jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>);
+      static const auto clazz = javaClassStatic();
+      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
+      return create(
+        clazz,
+        jni::make_jstring(value.address),
+        jni::make_jstring(value.chainId)
+      );
+    }
+  };
+
+} // namespace margelo::nitro::nitrometamask

package/nitrogen/generated/android/c++/JHybridMetamaskConnectorSpec.cpp

@@ -0,0 +1,84 @@
+///
+/// JHybridMetamaskConnectorSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include "JHybridMetamaskConnectorSpec.hpp"
+
+// Forward declaration of `ConnectResult` to properly resolve imports.
+namespace margelo::nitro::nitrometamask { struct ConnectResult; }
+
+#include "ConnectResult.hpp"
+#include <NitroModules/Promise.hpp>
+#include <NitroModules/JPromise.hpp>
+#include "JConnectResult.hpp"
+#include <string>
+
+namespace margelo::nitro::nitrometamask {
+
+  jni::local_ref<JHybridMetamaskConnectorSpec::jhybriddata> JHybridMetamaskConnectorSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
+    return makeCxxInstance(jThis);
+  }
+
+  void JHybridMetamaskConnectorSpec::registerNatives() {
+    registerHybrid({
+      makeNativeMethod("initHybrid", JHybridMetamaskConnectorSpec::initHybrid),
+    });
+  }
+
+  size_t JHybridMetamaskConnectorSpec::getExternalMemorySize() noexcept {
+    static const auto method = javaClassStatic()->getMethod<jlong()>("getMemorySize");
+    return method(_javaPart);
+  }
+
+  void JHybridMetamaskConnectorSpec::dispose() noexcept {
+    static const auto method = javaClassStatic()->getMethod<void()>("dispose");
+    method(_javaPart);
+  }
+
+  std::string JHybridMetamaskConnectorSpec::toString() {
+    static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
+    auto javaString = method(_javaPart);
+    return javaString->toStdString();
+  }
+
+  // Properties
+  
+
+  // Methods
+  std::shared_ptr<Promise<ConnectResult>> JHybridMetamaskConnectorSpec::connect() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("connect");
+    auto __result = method(_javaPart);
+    return [&]() {
+      auto __promise = Promise<ConnectResult>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<JConnectResult>(__boxedResult);
+        __promise->resolve(__result->toCpp());
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+  std::shared_ptr<Promise<std::string>> JHybridMetamaskConnectorSpec::signMessage(const std::string& message) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* message */)>("signMessage");
+    auto __result = method(_javaPart, jni::make_jstring(message));
+    return [&]() {
+      auto __promise = Promise<std::string>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<jni::JString>(__boxedResult);
+        __promise->resolve(__result->toStdString());
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+
+} // namespace margelo::nitro::nitrometamask

package/nitrogen/generated/android/c++/JHybridMetamaskConnectorSpec.hpp

@@ -0,0 +1,66 @@
+///
+/// HybridMetamaskConnectorSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <NitroModules/JHybridObject.hpp>
+#include <fbjni/fbjni.h>
+#include "HybridMetamaskConnectorSpec.hpp"
+
+
+
+
+namespace margelo::nitro::nitrometamask {
+
+  using namespace facebook;
+
+  class JHybridMetamaskConnectorSpec: public jni::HybridClass<JHybridMetamaskConnectorSpec, JHybridObject>,
+                                      public virtual HybridMetamaskConnectorSpec {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrometamask/HybridMetamaskConnectorSpec;";
+    static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
+    static void registerNatives();
+
+  protected:
+    // C++ constructor (called from Java via `initHybrid()`)
+    explicit JHybridMetamaskConnectorSpec(jni::alias_ref<jhybridobject> jThis) :
+      HybridObject(HybridMetamaskConnectorSpec::TAG),
+      HybridBase(jThis),
+      _javaPart(jni::make_global(jThis)) {}
+
+  public:
+    ~JHybridMetamaskConnectorSpec() override {
+      // Hermes GC can destroy JS objects on a non-JNI Thread.
+      jni::ThreadScope::WithClassLoader([&] { _javaPart.reset(); });
+    }
+
+  public:
+    size_t getExternalMemorySize() noexcept override;
+    void dispose() noexcept override;
+    std::string toString() override;
+
+  public:
+    inline const jni::global_ref<JHybridMetamaskConnectorSpec::javaobject>& getJavaPart() const noexcept {
+      return _javaPart;
+    }
+
+  public:
+    // Properties
+    
+
+  public:
+    // Methods
+    std::shared_ptr<Promise<ConnectResult>> connect() override;
+    std::shared_ptr<Promise<std::string>> signMessage(const std::string& message) override;
+
+  private:
+    friend HybridBase;
+    using HybridBase::HybridBase;
+    jni::global_ref<JHybridMetamaskConnectorSpec::javaobject> _javaPart;
+  };
+
+} // namespace margelo::nitro::nitrometamask