@novastera-oss/nitro-metamask 0.6.2 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novastera-oss/nitro-metamask",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Native mobile MetaMask wallet integration for React Native. Part of Novastera CRM/ERP platform ecosystem. Provides secure authentication and message signing for Web3 mobile applications.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -12,8 +12,7 @@
     "clean": "git clean -dfX",
     "release": "semantic-release",
     "build": "npm run typecheck && bob build",
-    "codegen": "nitrogen --logLevel=\"debug\" && npm run build",
-    "build:ecies:all-abis": "cd example/android && ./gradlew :app:assembleRelease -PreactNativeArchitectures=arm64-v8a,armeabi-v7a,x86_64,x86 -PNitroMetamask_buildEciesFromSource=true --no-daemon --stacktrace"
+    "codegen": "nitrogen --logLevel=\"debug\" && npm run build"
   },
   "keywords": [
     "react-native",
@@ -49,6 +48,10 @@
     "android/proguard-rules.pro",
     "android/src",
     "android/src/main/jniLibs",
+    "android/src/main/java/io/metamask/**",
+    "android/src/main/aidl/**",
+    "ios/metamask-ios-sdk/**",
+    "ios/Frameworks/**",
     "ios/**/*.h",
     "ios/**/*.m",
     "ios/**/*.mm",
@@ -59,9 +62,7 @@
     "README.md",
     "rust/ecies-jni/Cargo.toml",
     "rust/ecies-jni/src",
-    "rust/ecies-jni/Cargo.lock",
-    "scripts/verify-16k-page-alignment.sh",
-    "scripts/verify-16k-page-alignment.py"
+    "rust/ecies-jni/Cargo.lock"
   ],
   "workspaces": [
     "example"
@@ -79,25 +80,29 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-typescript": "^7.28.5",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@types/jest": "^29.5.12",
     "@types/react": "19.2.0",
-    "nitrogen": "0.32.0",
+    "babel-jest": "^30.3.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "jest": "^30.3.0",
+    "nitrogen": "^0.35.5",
     "react": "19.2.0",
     "react-native": "0.83",
-    "react-native-builder-bob": "^0.40.17",
-    "react-native-nitro-modules": "0.32.0",
-    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "react-native-builder-bob": "^0.40.18",
+    "react-native-nitro-modules": "0.35.5",
     "semantic-release": "^25.0.2",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
+    "@expo/config-plugins": "*",
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "*",
-    "@expo/config-plugins": "*"
+    "react-native-nitro-modules": "*"
   },
   "eslintConfig": {
     "root": true,

package/rust/ecies-jni/Cargo.lock

@@ -82,12 +82,6 @@ version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33"
 
-[[package]]
-name = "cesu8"
-version = "1.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c"
-
 [[package]]
 name = "cfg-if"
 version = "1.0.4"
@@ -270,27 +264,32 @@ dependencies = [
 
 [[package]]
 name = "jni"
-version = "0.21.1"
+version = "0.22.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1a87aa2bb7d2af34197c04845522473242e1aa17c12f4935d5856491a7fb8c97"
+checksum = "5efd9a482cf3a427f00d6b35f14332adc7902ce91efb778580e180ff90fa3498"
 dependencies = [
- "cesu8",
  "cfg-if",
  "combine",
- "jni-sys 0.3.1",
+ "jni-macros",
+ "jni-sys",
  "log",
+ "simd_cesu8",
  "thiserror",
  "walkdir",
- "windows-sys 0.45.0",
+ "windows-link",
 ]
 
 [[package]]
-name = "jni-sys"
-version = "0.3.1"
+name = "jni-macros"
+version = "0.22.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41a652e1f9b6e0275df1f15b32661cf0d4b78d4d87ddec5e0c3c20f097433258"
+checksum = "a00109accc170f0bdb141fed3e393c565b6f5e072365c3bd58f5b062591560a3"
 dependencies = [
- "jni-sys 0.4.1",
+ "proc-macro2",
+ "quote",
+ "rustc_version",
+ "simd_cesu8",
+ "syn",
 ]
 
 [[package]]
@@ -497,6 +496,15 @@ dependencies = [
  "bitflags",
 ]
 
+[[package]]
+name = "rustc_version"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+dependencies = [
+ "semver",
+]
+
 [[package]]
 name = "rustversion"
 version = "1.0.22"
@@ -518,6 +526,12 @@ version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
+[[package]]
+name = "semver"
+version = "1.0.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a7852d02fc848982e0c167ef163aaff9cd91dc640ba85e263cb1ce46fae51cd"
+
 [[package]]
 name = "serde"
 version = "1.0.228"
@@ -559,6 +573,22 @@ dependencies = [
  "digest 0.10.7",
 ]
 
+[[package]]
+name = "simd_cesu8"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f90157bb87cddf702797c5dadfa0be7d266cdf49e22da2fcaa32eff75b2c33"
+dependencies = [
+ "rustc_version",
+ "simdutf8",
+]
+
+[[package]]
+name = "simdutf8"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3a9fe34e3e7a50316060351f37187a3f546bce95496156754b601a5fa71b76e"
+
 [[package]]
 name = "smallvec"
 version = "1.15.1"
@@ -584,18 +614,18 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.69"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.69"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -697,7 +727,7 @@ version = "0.1.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
 dependencies = [
- "windows-sys 0.61.2",
+ "windows-sys",
 ]
 
 [[package]]
@@ -706,15 +736,6 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
-[[package]]
-name = "windows-sys"
-version = "0.45.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0"
-dependencies = [
- "windows-targets",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.61.2"
@@ -723,60 +744,3 @@ checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
 dependencies = [
  "windows-link",
 ]
-
-[[package]]
-name = "windows-targets"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071"
-dependencies = [
- "windows_aarch64_gnullvm",
- "windows_aarch64_msvc",
- "windows_i686_gnu",
- "windows_i686_msvc",
- "windows_x86_64_gnu",
- "windows_x86_64_gnullvm",
- "windows_x86_64_msvc",
-]
-
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
-
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
-
-[[package]]
-name = "windows_i686_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
-
-[[package]]
-name = "windows_i686_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
-
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
-
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
-
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"

package/rust/ecies-jni/Cargo.toml

@@ -10,7 +10,7 @@ crate-type = ["cdylib"]
 name = "ecies"
 
 [dependencies]
-jni = "0.21"
+jni = "0.22"
 # Match ecies.org / MetaMask stack (secp256k1, AES-256-GCM); pure Rust AES for simpler Android linking
 ecies = { version = "0.2.10", default-features = false, features = ["std", "aes-rust"] }
 hex = "0.4"

package/rust/ecies-jni/src/lib.rs

@@ -1,127 +1,191 @@
 //! JNI bridge for `io.metamask.ecies.Ecies` (MetaMask Android SDK).
 //! Rebuilt with NDK r28+ / 16 KB page-size compatible linking (see Gradle + cargo-ndk).
+//!
+//! Symbol naming: Kotlin `@JvmStatic` methods in a `companion object` are exposed
+//! directly on the enclosing class by the JVM, so the JNI symbol is
+//! `Java_io_metamask_ecies_Ecies_<method>` — NOT `..._00024Companion_<method>`.
+//! Verified against upstream libecies.so exports via `nm -D`.
 
 use ecies::{decrypt, encrypt, utils::generate_keypair};
+use jni::errors::Result as JniResult;
+use jni::errors::ThrowRuntimeExAndDefault;
+use jni::objects::JClass;
 use jni::objects::JString;
 use jni::sys::jstring;
-use jni::JNIEnv;
+use jni::{Env, EnvUnowned};
 
-fn empty_jstring(env: &mut JNIEnv) -> jstring {
-    env.new_string("")
-        .expect("empty jstring")
-        .into_raw()
+fn empty_jstring<'local>(env: &mut Env<'local>) -> jstring {
+    env.new_string("").expect("empty jstring").into_raw()
 }
 
-fn jstring_to_string(env: &mut JNIEnv, j: JString) -> Result<String, jni::errors::Error> {
-    Ok(env.get_string(&j)?.into())
+fn jstring_to_string<'local>(
+    _env: &mut Env<'local>,
+    j: JString<'local>,
+) -> Result<String, jni::errors::Error> {
+    Ok(j.to_string())
 }
 
-/// Kotlin: `Ecies.companion.generateSecretKey`
+/// Kotlin: `Ecies.generateSecretKey()` (@JvmStatic in companion object)
 #[no_mangle]
-pub extern "system" fn Java_io_metamask_ecies_Ecies_00024Companion_generateSecretKey(
-    mut env: JNIEnv,
-    _class: jni::objects::JClass,
+pub extern "system" fn Java_io_metamask_ecies_Ecies_generateSecretKey<'local>(
+    mut unowned_env: EnvUnowned<'local>,
+    _class: JClass<'local>,
 ) -> jstring {
-    let (sk, _pk) = generate_keypair();
-    let hex = hex::encode(sk.serialize());
-    match env.new_string(hex) {
-        Ok(s) => s.into_raw(),
-        Err(_) => empty_jstring(&mut env),
-    }
+    unowned_env
+        .with_env(|mut env| -> JniResult<jstring> {
+        let (sk, _pk) = generate_keypair();
+        let hex = hex::encode(sk.serialize());
+        match env.new_string(hex) {
+            Ok(s) => Ok(s.into_raw()),
+            Err(_) => Ok(empty_jstring(&mut env)),
+        }
+    })
+    .resolve::<ThrowRuntimeExAndDefault>()
 }
 
-/// Kotlin: `Ecies.companion.derivePublicKeyFrom`
+/// Kotlin: `Ecies.derivePublicKeyFrom(secret)` (@JvmStatic in companion object)
 #[no_mangle]
-pub extern "system" fn Java_io_metamask_ecies_Ecies_00024Companion_derivePublicKeyFrom(
-    mut env: JNIEnv,
-    _class: jni::objects::JClass,
-    secret: JString,
+pub extern "system" fn Java_io_metamask_ecies_Ecies_derivePublicKeyFrom<'local>(
+    mut unowned_env: EnvUnowned<'local>,
+    _class: JClass<'local>,
+    secret: JString<'local>,
 ) -> jstring {
-    let secret_str = match jstring_to_string(&mut env, secret) {
-        Ok(s) => s,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let sk_bytes = match hex::decode(secret_str.trim()) {
-        Ok(b) => b,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let sk = match ecies::SecretKey::parse_slice(&sk_bytes) {
-        Ok(k) => k,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let pk = ecies::PublicKey::from_secret_key(&sk);
-    let hex = hex::encode(pk.serialize());
-    match env.new_string(hex) {
-        Ok(s) => s.into_raw(),
-        Err(_) => empty_jstring(&mut env),
-    }
+    unowned_env
+        .with_env(|mut env| -> JniResult<jstring> {
+        let secret_str = match jstring_to_string(&mut env, secret) {
+            Ok(s) => s,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let sk_bytes = match hex::decode(secret_str.trim()) {
+            Ok(b) => b,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let sk = match ecies::SecretKey::parse_slice(&sk_bytes) {
+            Ok(k) => k,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let pk = ecies::PublicKey::from_secret_key(&sk);
+        let hex = hex::encode(pk.serialize());
+        match env.new_string(hex) {
+            Ok(s) => Ok(s.into_raw()),
+            Err(_) => Ok(empty_jstring(&mut env)),
+        }
+    })
+    .resolve::<ThrowRuntimeExAndDefault>()
 }
 
-/// Kotlin: `Ecies.companion.encryptMessage`
+/// Kotlin: `Ecies.encryptMessage(public, message)` (@JvmStatic in companion object)
 #[no_mangle]
-pub extern "system" fn Java_io_metamask_ecies_Ecies_00024Companion_encryptMessage(
-    mut env: JNIEnv,
-    _class: jni::objects::JClass,
-    public: JString,
-    message: JString,
+pub extern "system" fn Java_io_metamask_ecies_Ecies_encryptMessage<'local>(
+    mut unowned_env: EnvUnowned<'local>,
+    _class: JClass<'local>,
+    public: JString<'local>,
+    message: JString<'local>,
 ) -> jstring {
-    let pub_hex = match jstring_to_string(&mut env, public) {
-        Ok(s) => s,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let msg_str = match jstring_to_string(&mut env, message) {
-        Ok(s) => s,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let pk_bytes = match hex::decode(pub_hex.trim()) {
-        Ok(b) => b,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let ct = match encrypt(&pk_bytes, msg_str.as_bytes()) {
-        Ok(c) => c,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let hex = hex::encode(ct);
-    match env.new_string(hex) {
-        Ok(s) => s.into_raw(),
-        Err(_) => empty_jstring(&mut env),
-    }
+    unowned_env
+        .with_env(|mut env| -> JniResult<jstring> {
+        let pub_hex = match jstring_to_string(&mut env, public) {
+            Ok(s) => s,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let msg_str = match jstring_to_string(&mut env, message) {
+            Ok(s) => s,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let pk_bytes = match hex::decode(pub_hex.trim()) {
+            Ok(b) => b,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let ct = match encrypt(&pk_bytes, msg_str.as_bytes()) {
+            Ok(c) => c,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let hex = hex::encode(ct);
+        match env.new_string(hex) {
+            Ok(s) => Ok(s.into_raw()),
+            Err(_) => Ok(empty_jstring(&mut env)),
+        }
+    })
+    .resolve::<ThrowRuntimeExAndDefault>()
 }
 
-/// Kotlin: `Ecies.companion.decryptMessage`
+/// Kotlin: `Ecies.decryptMessage(secret, message)` (@JvmStatic in companion object)
 #[no_mangle]
-pub extern "system" fn Java_io_metamask_ecies_Ecies_00024Companion_decryptMessage(
-    mut env: JNIEnv,
-    _class: jni::objects::JClass,
-    secret: JString,
-    message: JString,
+pub extern "system" fn Java_io_metamask_ecies_Ecies_decryptMessage<'local>(
+    mut unowned_env: EnvUnowned<'local>,
+    _class: JClass<'local>,
+    secret: JString<'local>,
+    message: JString<'local>,
 ) -> jstring {
-    let sec_hex = match jstring_to_string(&mut env, secret) {
-        Ok(s) => s,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let ct_hex = match jstring_to_string(&mut env, message) {
-        Ok(s) => s,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let sk_bytes = match hex::decode(sec_hex.trim()) {
-        Ok(b) => b,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let ct_bytes = match hex::decode(ct_hex.trim()) {
-        Ok(b) => b,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let plain = match decrypt(&sk_bytes, &ct_bytes) {
-        Ok(p) => p,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    let text = match String::from_utf8(plain) {
-        Ok(t) => t,
-        Err(_) => return empty_jstring(&mut env),
-    };
-    match env.new_string(text) {
-        Ok(s) => s.into_raw(),
-        Err(_) => empty_jstring(&mut env),
+    unowned_env
+        .with_env(|mut env| -> JniResult<jstring> {
+        let sec_hex = match jstring_to_string(&mut env, secret) {
+            Ok(s) => s,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let ct_hex = match jstring_to_string(&mut env, message) {
+            Ok(s) => s,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let sk_bytes = match hex::decode(sec_hex.trim()) {
+            Ok(b) => b,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let ct_bytes = match hex::decode(ct_hex.trim()) {
+            Ok(b) => b,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let plain = match decrypt(&sk_bytes, &ct_bytes) {
+            Ok(p) => p,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        let text = match String::from_utf8(plain) {
+            Ok(t) => t,
+            Err(_) => return Ok(empty_jstring(&mut env)),
+        };
+        match env.new_string(text) {
+            Ok(s) => Ok(s.into_raw()),
+            Err(_) => Ok(empty_jstring(&mut env)),
+        }
+    })
+    .resolve::<ThrowRuntimeExAndDefault>()
+}
+
+#[cfg(test)]
+mod tests {
+    macro_rules! assert_jni_symbol {
+        ($fn_name:ident) => {{
+            let name = stringify!($fn_name);
+            assert!(
+                !name.contains("_00024Companion_"),
+                "Symbol `{}` must NOT contain `_00024Companion_`",
+                name
+            );
+            assert!(
+                name.starts_with("Java_io_metamask_ecies_Ecies_"),
+                "Symbol `{}` must start with `Java_io_metamask_ecies_Ecies_`",
+                name
+            );
+        }};
+    }
+
+    #[test]
+    fn generate_secret_key_symbol_has_no_companion_mangling() {
+        assert_jni_symbol!(Java_io_metamask_ecies_Ecies_generateSecretKey);
+    }
+
+    #[test]
+    fn derive_public_key_from_symbol_has_no_companion_mangling() {
+        assert_jni_symbol!(Java_io_metamask_ecies_Ecies_derivePublicKeyFrom);
+    }
+
+    #[test]
+    fn encrypt_message_symbol_has_no_companion_mangling() {
+        assert_jni_symbol!(Java_io_metamask_ecies_Ecies_encryptMessage);
+    }
+
+    #[test]
+    fn decrypt_message_symbol_has_no_companion_mangling() {
+        assert_jni_symbol!(Java_io_metamask_ecies_Ecies_decryptMessage);
     }
 }

package/src/__tests__/parseNitroError.test.ts

@@ -0,0 +1,35 @@
+import { parseNitroError } from '../index'
+
+// Mock the NitroModules dependency so the module can be imported in a Node/Jest environment
+jest.mock('react-native-nitro-modules', () => ({
+  NitroModules: {
+    createHybridObject: () => ({}),
+  },
+}))
+
+describe('parseNitroError', () => {
+  it('parses "[2] MetaMask is not installed" into code 2 and the message', () => {
+    const result = parseNitroError(new Error('[2] MetaMask is not installed'))
+    expect(result).toEqual({ code: 2, message: 'MetaMask is not installed' })
+  })
+
+  it('returns null for a plain error message with no [code] prefix', () => {
+    const result = parseNitroError(new Error('Something went wrong'))
+    expect(result).toBeNull()
+  })
+
+  it('parses "[0] some error" into code 0 and the message', () => {
+    const result = parseNitroError(new Error('[0] some error'))
+    expect(result).toEqual({ code: 0, message: 'some error' })
+  })
+
+  it('parses a string input with [code] prefix', () => {
+    const result = parseNitroError('[42] timeout')
+    expect(result).toEqual({ code: 42, message: 'timeout' })
+  })
+
+  it('returns null for a non-string, non-Error input', () => {
+    const result = parseNitroError(null)
+    expect(result).toBeNull()
+  })
+})