@getpara/react-native-wallet 2.16.0 → 2.18.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from '@getpara/web-sdk';
 export { ParaMobile } from './react-native/ParaMobile.js';
-export * from '@getpara/viem-v2-integration';
+export * from '@getpara/viem-v2-integration/aa';

package/dist/index.js

@@ -1,4 +1,4 @@
 export * from '@getpara/web-sdk';
 export { ParaMobile } from './react-native/ParaMobile.js';
-// Smart Account types, errors, utilities — re-exported from viem-v2-integration
-export * from '@getpara/viem-v2-integration';
+// Smart Account types, errors, utilities — re-exported from viem-v2-integration/aa
+export * from '@getpara/viem-v2-integration/aa';

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

@@ -256,6 +256,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

@@ -23,7 +23,7 @@ export function ensureParaCrypto(): {
         pseudoRandomBytes: typeof import("react-native-quick-crypto/lib/typescript/src/random").randomBytes;
         prng: typeof import("react-native-quick-crypto/lib/typescript/src/random").randomBytes;
         pbkdf2(password: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, salt: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, iterations: number, keylen: number, digest: string, callback: (err: Error | null, derivedKey?: Buffer) => void): void;
-        pbkdf2Sync(password: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, salt: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, iterations: number, keylen: number, digest?: string): ArrayBuffer;
+        pbkdf2Sync(password: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, salt: import("react-native-quick-crypto/lib/typescript/src/Utils").BinaryLike, iterations: number, keylen: number, digest?: string): Buffer;
         pbkdf2DeriveBits(algorithm: import("react-native-quick-crypto/lib/typescript/src/keys").SubtleAlgorithm, baseKey: import("react-native-quick-crypto/lib/typescript/src/keys").CryptoKey, length: number): Promise<ArrayBuffer>;
         createHmac: typeof import("react-native-quick-crypto/lib/typescript/src/Hmac").createHmac;
         Hmac: typeof import("react-native-quick-crypto/lib/typescript/src/Hmac").createHmac;

package/package.json

@@ -1,30 +1,30 @@
 {
   "name": "@getpara/react-native-wallet",
   "description": "Para Wallet for React Native",
-  "version": "2.16.0",
+  "version": "2.18.0",
   "author": "Para Team <hello@getpara.com> (https://getpara.com)",
   "dependencies": {
-    "@getpara/core-sdk": "2.16.0",
-    "@getpara/user-management-client": "2.16.0",
-    "@getpara/viem-v2-integration": "2.16.0",
-    "@getpara/web-sdk": "2.16.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",
     "react-native-url-polyfill": "2.0.0",
     "text-encoding": "0.7.0"
   },
   "devDependencies": {
-    "@craftzdog/react-native-buffer": "6.0.5",
-    "@react-native-async-storage/async-storage": "2.1.2",
-    "@types/node-forge": "1.3.1",
-    "@types/react": "^18.0.31",
+    "@craftzdog/react-native-buffer": "^6.1.0",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "@types/node-forge": "^1.3.11",
+    "@types/react": "^18.3.3",
     "@types/react-native": "0.70.0",
     "@types/text-encoding": "0.0.39",
-    "react-native-keychain": "10.0.0",
-    "react-native-modpow": "1.1.0",
-    "react-native-passkey": "3.1.0",
-    "react-native-quick-base64": "2.1.2",
-    "react-native-quick-crypto": "0.7.12",
+    "react-native-keychain": "^10.0.0",
+    "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",
     "typescript": "^5.8.3"
   },
   "exports": {
@@ -52,16 +52,16 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "peerDependencies": {
-    "@craftzdog/react-native-buffer": "*",
-    "@react-native-async-storage/async-storage": "*",
-    "react": "*",
-    "react-native": "*",
-    "react-native-keychain": "*",
-    "react-native-modpow": "*",
-    "react-native-passkey": "*",
-    "react-native-quick-base64": "*",
-    "react-native-quick-crypto": "*",
-    "readable-stream": "*"
+    "@craftzdog/react-native-buffer": ">=6.0.0",
+    "@react-native-async-storage/async-storage": ">=2.0.0",
+    "react": ">=18",
+    "react-native": ">=0.70.0",
+    "react-native-keychain": ">=8.0.0",
+    "react-native-modpow": ">=1.0.0",
+    "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"
   },
   "publishConfig": {
     "access": "public"
@@ -93,5 +93,5 @@
       ]
     }
   },
-  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798"
+  "gitHead": "4481f6f4e108e682d14c74d4433696141c47fc58"
 }

package/src/index.ts

@@ -1,5 +1,5 @@
 export * from '@getpara/web-sdk';
 export { ParaMobile } from './react-native/ParaMobile.js';
 
-// Smart Account types, errors, utilities — re-exported from viem-v2-integration
-export * from '@getpara/viem-v2-integration';
+// Smart Account types, errors, utilities — re-exported from viem-v2-integration/aa
+export * from '@getpara/viem-v2-integration/aa';

package/src/react-native/ParaMobile.ts

@@ -326,6 +326,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 };
   }