@getpara/react-native-wallet 2.17.0 → 2.18.1

package/dist/react-native/ParaMobile.d.ts

@@ -34,6 +34,18 @@ export declare class ParaMobile extends ParaCore {
      * @returns {Promise<void>}
      */
     loginWithPasskey(): Promise<void>;
+    /**
+     * Sets a global handler for transaction review URLs. When a signing operation requires
+     * user approval (e.g., due to permissions policies), the SDK needs to open a review URL.
+     * On React Native, provide a handler that opens the URL in an in-app browser.
+     *
+     * @example
+     * ```ts
+     * import { openBrowserAsync } from 'expo-web-browser';
+     * para.setTransactionReviewHandler((url) => openBrowserAsync(url));
+     * ```
+     */
+    setTransactionReviewHandler(handler: (url: string) => void): void;
     /**
      * Handles a message from an in-app browser (WebView).
      * Call this from your WebView's `onMessage` callback to bridge portal events

package/dist/react-native/ParaMobile.js

@@ -13,7 +13,6 @@ import { Passkey, } from 'react-native-passkey';
 import { AuthMethodStatus } from '@getpara/user-management-client';
 import { setEnv } from '../config.js';
 import base64url from 'base64url';
-import { webcrypto } from 'crypto';
 const ES256_ALGORITHM = -7;
 const RS256_ALGORITHM = -257;
 /**
@@ -120,11 +119,11 @@ export class ParaMobile extends ParaCore {
             }
             const userId = this.assertUserId();
             const authInfo = this.assertIsAuthSet();
-            if (!webcrypto || !webcrypto.getRandomValues) {
+            if (!globalThis.crypto || !globalThis.crypto.getRandomValues) {
                 throw new Error('Web crypto is not available. Ensure you have imported the shim from @getpara/react-native-wallet.');
             }
             const userHandle = new Uint8Array(32);
-            webcrypto.getRandomValues(userHandle);
+            globalThis.crypto.getRandomValues(userHandle);
             const userHandleEncoded = base64url.encode(userHandle);
             const requestJson = {
                 authenticatorSelection: {
@@ -256,6 +255,20 @@ export class ParaMobile extends ParaCore {
             });
         });
     }
+    /**
+     * Sets a global handler for transaction review URLs. When a signing operation requires
+     * user approval (e.g., due to permissions policies), the SDK needs to open a review URL.
+     * On React Native, provide a handler that opens the URL in an in-app browser.
+     *
+     * @example
+     * ```ts
+     * import { openBrowserAsync } from 'expo-web-browser';
+     * para.setTransactionReviewHandler((url) => openBrowserAsync(url));
+     * ```
+     */
+    setTransactionReviewHandler(handler) {
+        this.platformUtils.transactionReviewHandler = handler;
+    }
     /**
      * Handles a message from an in-app browser (WebView).
      * Call this from your WebView's `onMessage` callback to bridge portal events

package/dist/react-native/ReactNativeUtils.d.ts

@@ -11,6 +11,7 @@ export declare class ReactNativeUtils implements PlatformUtils {
     sessionStorage: AsyncStorage;
     secureStorage: KeychainStorage;
     isSyncStorage: boolean;
+    transactionReviewHandler?: (url: string) => void;
     private eventHandlers;
     addEventListener<T = EventData>({ event, handler }: {
         ctx: Ctx;
@@ -45,7 +46,7 @@ export declare class ReactNativeUtils implements PlatformUtils {
         walletId: string;
     }>;
     getPrivateKey(_ctx: Ctx, _userId: string, _walletId: string, _share: string, _sessionCookie: string): Promise<string>;
-    openPopup(_popupUrl: string): any;
+    openPopup(popupUrl: string): any;
     private baseSignTransaction;
     sendTransaction(ctx: Ctx, userId: string, walletId: string, share: string, rlpEncodedTxBase64: string, chainId: string, _sessionCookie: string, isDKLS?: boolean): Promise<SignatureRes>;
     signHash(_address: string, _hash: string): Promise<{

package/dist/react-native/ReactNativeUtils.js

@@ -118,8 +118,12 @@ export class ReactNativeUtils {
     getPrivateKey(_ctx, _userId, _walletId, _share, _sessionCookie) {
         throw new Error('Method not implemented.');
     }
-    openPopup(_popupUrl) {
-        throw new Error('Method not implemented.');
+    openPopup(popupUrl) {
+        if (this.transactionReviewHandler) {
+            this.transactionReviewHandler(popupUrl);
+            return;
+        }
+        throw new Error('openPopup is not supported on React Native. Use setTransactionReviewHandler() to handle transaction review URLs.');
     }
     baseSignTransaction(ctx, userId, walletId, protocolId, share, rlpEncodedTxBase64, chainId, isDKLS) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -135,11 +139,14 @@ export class ReactNativeUtils {
     }
     sendTransaction(ctx, userId, walletId, share, rlpEncodedTxBase64, chainId, _sessionCookie, isDKLS) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { protocolId } = (yield ctx.client.sendTransaction(userId, walletId, {
+            const { data } = yield ctx.client.sendTransaction(userId, walletId, {
                 transaction: rlpEncodedTxBase64,
                 chainId,
-            })).data;
-            return this.baseSignTransaction(ctx, userId, walletId, protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
+            });
+            if (data.pendingTransactionId) {
+                return { pendingTransactionId: data.pendingTransactionId };
+            }
+            return this.baseSignTransaction(ctx, userId, walletId, data.protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
         });
     }
     signHash(_address, _hash) {
@@ -151,6 +158,9 @@ export class ReactNativeUtils {
     _sessionCookie, isDKLS) {
         return __awaiter(this, void 0, void 0, function* () {
             const res = yield ctx.client.preSignMessage(userId, walletId, messageBase64);
+            if (res.pendingTransactionId) {
+                return { pendingTransactionId: res.pendingTransactionId };
+            }
             if (ctx.mpcComputationClient && !isDKLS) {
                 const signature = (yield signMessageRequest(ctx, userId, walletId, res.protocolId, messageBase64, share)).signature;
                 return { signature };
@@ -166,11 +176,14 @@ export class ReactNativeUtils {
     signTransaction(ctx, userId, walletId, share, rlpEncodedTxBase64, // base64 encoding of rlp encoded tx
     chainId, _sessionCookie, isDKLS) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { protocolId } = (yield ctx.client.signTransaction(userId, walletId, {
+            const { data } = yield ctx.client.signTransaction(userId, walletId, {
                 transaction: rlpEncodedTxBase64,
                 chainId,
-            })).data;
-            return this.baseSignTransaction(ctx, userId, walletId, protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
+            });
+            if (data.pendingTransactionId) {
+                return { pendingTransactionId: data.pendingTransactionId };
+            }
+            return this.baseSignTransaction(ctx, userId, walletId, data.protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
         });
     }
     ed25519Keygen(ctx, userId, _sessionCookie, _emailProps) {
@@ -197,8 +210,11 @@ export class ReactNativeUtils {
     }
     ed25519Sign(ctx, userId, walletId, share, base64Bytes, _sessionCookie) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { protocolId } = yield ctx.client.preSignMessage(userId, walletId, base64Bytes, 'ED25519');
-            const base64Sig = yield ParaSignerModule.ed25519Sign(protocolId, share, base64Bytes);
+            const res = yield ctx.client.preSignMessage(userId, walletId, base64Bytes, 'ED25519');
+            if (res.pendingTransactionId) {
+                return { pendingTransactionId: res.pendingTransactionId };
+            }
+            const base64Sig = yield ParaSignerModule.ed25519Sign(res.protocolId, share, base64Bytes);
             return { signature: base64Sig };
         });
     }

package/dist/shim.d.ts

@@ -1,5 +1,5 @@
 export function ensureParaCrypto(): {
-    baseCrypto: webcrypto.Crypto | {
+    baseCrypto: import("crypto").webcrypto.Crypto | {
         getCiphers: () => string[];
         getHashes: () => string[];
         webcrypto: {
@@ -125,6 +125,5 @@ export function ensureParaCrypto(): {
     peculiarCrypto: PeculiarCrypto;
 };
 export function ensureCreateECDH(): any;
-import { webcrypto } from 'crypto';
 import { Buffer } from '@craftzdog/react-native-buffer';
 import { Crypto as PeculiarCrypto } from '@peculiar/webcrypto';

package/dist/shim.js

@@ -1,5 +1,4 @@
 import quickCrypto from 'react-native-quick-crypto';
-import { webcrypto } from 'crypto';
 import { Crypto as PeculiarCrypto } from '@peculiar/webcrypto';
 import { ec as EllipticEC } from 'elliptic';
 import Forge from 'node-forge';
@@ -246,8 +245,26 @@ const ensureParaCrypto = () => {
 };
 const setupCryptoPolyfills = () => {
     const { peculiarCrypto } = ensureParaCrypto();
-    if (webcrypto && typeof webcrypto === 'object') {
-        webcrypto.getRandomValues = peculiarCrypto.getRandomValues.bind(peculiarCrypto);
+    // Ensure `import { webcrypto } from 'crypto'` works regardless of quick-crypto version.
+    // quick-crypto 1.x (Nitro) removed the webcrypto export that 0.7.x had.
+    try {
+        const cryptoModule = require('crypto');
+        if (!cryptoModule.webcrypto || typeof cryptoModule.webcrypto !== 'object') {
+            Object.defineProperty(cryptoModule, 'webcrypto', {
+                get() {
+                    return globalThis.crypto;
+                },
+                configurable: true,
+                enumerable: true,
+            });
+        }
+        if (cryptoModule.webcrypto && typeof cryptoModule.webcrypto === 'object') {
+            cryptoModule.webcrypto.getRandomValues = peculiarCrypto.getRandomValues.bind(peculiarCrypto);
+        }
+        // eslint-disable-next-line no-unused-vars
+    }
+    catch (_err) {
+        // crypto module not available
     }
     if (typeof Forge === 'undefined') {
         throw new Error('node-forge not loaded');

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@getpara/react-native-wallet",
   "description": "Para Wallet for React Native",
-  "version": "2.17.0",
+  "version": "2.18.1",
   "author": "Para Team <hello@getpara.com> (https://getpara.com)",
   "dependencies": {
-    "@getpara/core-sdk": "2.17.0",
-    "@getpara/user-management-client": "2.17.0",
-    "@getpara/viem-v2-integration": "2.17.0",
-    "@getpara/web-sdk": "2.17.0",
+    "@getpara/core-sdk": "2.18.0",
+    "@getpara/user-management-client": "2.18.0",
+    "@getpara/viem-v2-integration": "2.18.0",
+    "@getpara/web-sdk": "2.18.0",
     "@peculiar/webcrypto": "^1.5.0",
     "@ungap/structured-clone": "1.3.0",
+    "readable-stream": "^4.5.2",
     "react-native-url-polyfill": "2.0.0",
     "text-encoding": "0.7.0"
   },
@@ -24,7 +25,8 @@
     "react-native-modpow": "^1.1.0",
     "react-native-passkey": "^3.1.0",
     "react-native-quick-base64": "^2.2.0",
-    "react-native-quick-crypto": "^0.7.14",
+    "react-native-nitro-modules": "^0.29.1",
+    "react-native-quick-crypto": "^1.0.0",
     "typescript": "^5.8.3"
   },
   "exports": {
@@ -58,10 +60,10 @@
     "react-native": ">=0.70.0",
     "react-native-keychain": ">=8.0.0",
     "react-native-modpow": ">=1.0.0",
+    "react-native-nitro-modules": ">=0.29.1",
     "react-native-passkey": ">=3.0.0",
     "react-native-quick-base64": ">=2.0.0",
-    "react-native-quick-crypto": ">=0.7.0",
-    "readable-stream": ">=4.0.0"
+    "react-native-quick-crypto": ">=1.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -92,6 +94,5 @@
         "./dist/index.d.ts"
       ]
     }
-  },
-  "gitHead": "3ed1f835b97ae720f1ac747611296e3b86f61138"
+  }
 }

package/src/react-native/ParaMobile.ts

@@ -26,7 +26,6 @@ import {
 import { CurrentWalletIds, AuthMethodStatus, TWalletScheme } from '@getpara/user-management-client';
 import { setEnv } from '../config.js';
 import base64url from 'base64url';
-import { webcrypto } from 'crypto';
 
 const ES256_ALGORITHM = -7;
 const RS256_ALGORITHM = -257;
@@ -159,11 +158,11 @@ export class ParaMobile extends ParaCore {
     const userId = this.assertUserId();
     const authInfo = this.assertIsAuthSet();
 
-    if (!webcrypto || !webcrypto.getRandomValues) {
+    if (!globalThis.crypto || !globalThis.crypto.getRandomValues) {
       throw new Error('Web crypto is not available. Ensure you have imported the shim from @getpara/react-native-wallet.');
     }
     const userHandle = new Uint8Array(32);
-    webcrypto.getRandomValues(userHandle);
+    globalThis.crypto.getRandomValues(userHandle);
     const userHandleEncoded = base64url.encode(userHandle as any);
 
     const requestJson: PasskeyCreateRequest = {
@@ -326,6 +325,21 @@ export class ParaMobile extends ParaCore {
     });
   }
 
+  /**
+   * Sets a global handler for transaction review URLs. When a signing operation requires
+   * user approval (e.g., due to permissions policies), the SDK needs to open a review URL.
+   * On React Native, provide a handler that opens the URL in an in-app browser.
+   *
+   * @example
+   * ```ts
+   * import { openBrowserAsync } from 'expo-web-browser';
+   * para.setTransactionReviewHandler((url) => openBrowserAsync(url));
+   * ```
+   */
+  setTransactionReviewHandler(handler: (url: string) => void): void {
+    (this.platformUtils as ReactNativeUtils).transactionReviewHandler = handler;
+  }
+
   /**
    * Handles a message from an in-app browser (WebView).
    * Call this from your WebView's `onMessage` callback to bridge portal events

package/src/react-native/ReactNativeUtils.ts

@@ -62,6 +62,8 @@ export class ReactNativeUtils implements PlatformUtils {
   secureStorage = new KeychainStorage();
   isSyncStorage = false;
 
+  transactionReviewHandler?: (url: string) => void;
+
   private eventHandlers = new Map<string, Set<EventHandler>>();
 
   addEventListener<T = EventData>({ event, handler }: { ctx: Ctx; event: string; handler: EventHandler<T> }): void {
@@ -158,8 +160,14 @@ export class ReactNativeUtils implements PlatformUtils {
     throw new Error('Method not implemented.');
   }
 
-  openPopup(_popupUrl: string): any {
-    throw new Error('Method not implemented.');
+  openPopup(popupUrl: string): any {
+    if (this.transactionReviewHandler) {
+      this.transactionReviewHandler(popupUrl);
+      return;
+    }
+    throw new Error(
+      'openPopup is not supported on React Native. Use setTransactionReviewHandler() to handle transaction review URLs.',
+    );
   }
 
   private async baseSignTransaction(
@@ -193,13 +201,16 @@ export class ReactNativeUtils implements PlatformUtils {
     _sessionCookie: string,
     isDKLS?: boolean,
   ): Promise<SignatureRes> {
-    const { protocolId } = (
-      await ctx.client.sendTransaction(userId, walletId, {
-        transaction: rlpEncodedTxBase64,
-        chainId,
-      })
-    ).data;
-    return this.baseSignTransaction(ctx, userId, walletId, protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
+    const { data } = await ctx.client.sendTransaction(userId, walletId, {
+      transaction: rlpEncodedTxBase64,
+      chainId,
+    });
+
+    if (data.pendingTransactionId) {
+      return { pendingTransactionId: data.pendingTransactionId };
+    }
+
+    return this.baseSignTransaction(ctx, userId, walletId, data.protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
   }
 
   async signHash(_address: string, _hash: string): Promise<{ v: number; r: Buffer; s: Buffer }> {
@@ -217,6 +228,10 @@ export class ReactNativeUtils implements PlatformUtils {
   ): Promise<SignatureRes> {
     const res = await ctx.client.preSignMessage(userId, walletId, messageBase64);
 
+    if (res.pendingTransactionId) {
+      return { pendingTransactionId: res.pendingTransactionId };
+    }
+
     if (ctx.mpcComputationClient && !isDKLS) {
       const signature = (await signMessageRequest(ctx, userId, walletId, res.protocolId, messageBase64, share)).signature;
       return { signature };
@@ -241,13 +256,16 @@ export class ReactNativeUtils implements PlatformUtils {
     _sessionCookie: string,
     isDKLS?: boolean,
   ): Promise<SignatureRes> {
-    const { protocolId } = (
-      await ctx.client.signTransaction(userId, walletId, {
-        transaction: rlpEncodedTxBase64,
-        chainId,
-      })
-    ).data;
-    return this.baseSignTransaction(ctx, userId, walletId, protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
+    const { data } = await ctx.client.signTransaction(userId, walletId, {
+      transaction: rlpEncodedTxBase64,
+      chainId,
+    });
+
+    if (data.pendingTransactionId) {
+      return { pendingTransactionId: data.pendingTransactionId };
+    }
+
+    return this.baseSignTransaction(ctx, userId, walletId, data.protocolId, share, rlpEncodedTxBase64, chainId, isDKLS);
   }
 
   async ed25519Keygen(
@@ -296,9 +314,13 @@ export class ReactNativeUtils implements PlatformUtils {
     base64Bytes: string,
     _sessionCookie: string,
   ): Promise<SignatureRes> {
-    const { protocolId } = await ctx.client.preSignMessage(userId, walletId, base64Bytes, 'ED25519');
+    const res = await ctx.client.preSignMessage(userId, walletId, base64Bytes, 'ED25519');
+
+    if (res.pendingTransactionId) {
+      return { pendingTransactionId: res.pendingTransactionId };
+    }
 
-    const base64Sig = await ParaSignerModule.ed25519Sign(protocolId, share, base64Bytes);
+    const base64Sig = await ParaSignerModule.ed25519Sign(res.protocolId, share, base64Bytes);
     return { signature: base64Sig };
   }
 

package/src/shim.js

@@ -1,5 +1,4 @@
 import quickCrypto from 'react-native-quick-crypto';
-import { webcrypto } from 'crypto';
 import { Crypto as PeculiarCrypto } from '@peculiar/webcrypto';
 import { ec as EllipticEC } from 'elliptic';
 import Forge from 'node-forge';
@@ -281,8 +280,25 @@ const ensureParaCrypto = () => {
 const setupCryptoPolyfills = () => {
   const { peculiarCrypto } = ensureParaCrypto();
 
-  if (webcrypto && typeof webcrypto === 'object') {
-    webcrypto.getRandomValues = peculiarCrypto.getRandomValues.bind(peculiarCrypto);
+  // Ensure `import { webcrypto } from 'crypto'` works regardless of quick-crypto version.
+  // quick-crypto 1.x (Nitro) removed the webcrypto export that 0.7.x had.
+  try {
+    const cryptoModule = require('crypto');
+    if (!cryptoModule.webcrypto || typeof cryptoModule.webcrypto !== 'object') {
+      Object.defineProperty(cryptoModule, 'webcrypto', {
+        get() {
+          return globalThis.crypto;
+        },
+        configurable: true,
+        enumerable: true,
+      });
+    }
+    if (cryptoModule.webcrypto && typeof cryptoModule.webcrypto === 'object') {
+      cryptoModule.webcrypto.getRandomValues = peculiarCrypto.getRandomValues.bind(peculiarCrypto);
+    }
+    // eslint-disable-next-line no-unused-vars
+  } catch (_err) {
+    // crypto module not available
   }
 
   if (typeof Forge === 'undefined') {