@chipi-stack/chipi-react 14.16.0 → 14.17.0

package/dist/{index-Dbqp9oNS.d.mts → index-CUfzUBgv.d.mts}

@@ -2,7 +2,7 @@ import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletRes
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 import { SyntheticEvent } from 'react';
-import { MigrateChipiWalletToShhhParams, MigrationOutcome, Eip191Pubkey, WebAuthnPubkey, JwtAppleSubPubkey, NewOwnerInput, buildProposeAddOwnerCall, TIMELOCK_SECONDS, DEFAULT_OP_EXPIRY_SECONDS, ROLE_OWNER, ROLE_GUARDIAN, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ShhhSignerKind, MIN_THRESHOLD_OWNERS } from '@chipi-stack/backend';
+import { MigrateChipiWalletToShhhParams, MigrationOutcome, ChipiSDK, Eip191Pubkey, WebAuthnPubkey, JwtAppleSubPubkey, NewOwnerInput, buildProposeAddOwnerCall, TIMELOCK_SECONDS, DEFAULT_OP_EXPIRY_SECONDS, ROLE_OWNER, ROLE_GUARDIAN, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ShhhSignerKind, MIN_THRESHOLD_OWNERS } from '@chipi-stack/backend';
 import { Call as Call$2 } from 'starknet';
 import { TypedData, AccountDeploymentData } from '@starknet-io/types-js';
 import { ShieldResult } from '@chipi-stack/core';
@@ -1872,6 +1872,24 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
+type ExternalSignerExecuteInput = Parameters<ChipiSDK["executeWithExternalSigner"]>[0];
+/**
+ * Run calls on a SHHH wallet signed by an external Starknet wallet that is one
+ * of its `STARK_SNIP12` owners: Bramble, Braavos, Ready/Argent or another
+ * Chipi wallet. Pass the wallet's `wallet_signTypedData` as `signTypedData`;
+ * the key never leaves that wallet. Returns the tx hash (wait for it).
+ */
+declare function useExternalSignerExecute(): {
+    execute: (input: ExternalSignerExecuteInput) => void;
+    executeAsync: (input: ExternalSignerExecuteInput) => Promise<string>;
+    data: string | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    isSuccess: boolean;
+    reset: () => void;
+};
+
 /**
  * An approval the host (walletv2, the hosted web-wallet, or a harness) must
  * resolve before the SWO performs a sensitive action. Returning `false`
@@ -1968,7 +1986,12 @@ interface ChipiWindowObjectDeps {
     executeCalls: (calls: Call$2[]) => Promise<string>;
     /** Sign SNIP-12 typed data → signature felts (envelope-aware for SHHH). */
     signTypedData: (typedData: TypedData) => Promise<string[]>;
-    /** Counterfactual deployment data for an undeployed account. */
+    /**
+     * Counterfactual deployment data for an undeployed account. Throw
+     * `Error("account_already_deployed")` for a deployed account (the dApp gets
+     * 115) or `Error("account_deployment_data_unavailable")` when the data can't
+     * be derived (116). Any other error reaches the dApp as 163.
+     */
     getDeploymentData: () => Promise<AccountDeploymentData>;
     /** Optional: establish a session from a dApp-proposed policy (approve once). */
     createSession?: (policy: ChipiSessionPolicy) => Promise<void>;
@@ -1995,6 +2018,13 @@ interface UseChipiWalletObjectConfig {
     sessionPolicy?: ChipiSessionPolicy | null;
     /** Chain id felt; defaults to SN_MAIN. */
     chainId?: string;
+    /**
+     * Whether the account is deployed on-chain (e.g. `isDeployed` from the
+     * wallet row). Only `true` makes `wallet_deploymentData` answer 115
+     * ("already deployed"); otherwise it answers 116 ("deployment data is not
+     * available"), since this hook can't derive a Chipi account's deployment data.
+     */
+    isDeployed?: boolean;
     /**
      * Host approval gate (connect / execute / signTypedData / session). When
      * omitted, every approval is denied and a single `console.warn` explains
@@ -2592,7 +2622,7 @@ type Call = ReturnType<typeof buildProposeAddOwnerCall>;
  *   1. ADD DEVICE (user has wallet access, wants a second owner)
  *      a. `proposeAddOwner` (owner-signed OE)
  *      b. wait 48h timelock
- *      c. `executeAddOwner` (owner-signed OE, with the opId from 1a)
+ *      c. `executeAddOwner` (permissionless after the timelock: any account, or an owner OE; opId from 1a)
  *
  *   2. RECOVER VIA GUARDIAN (user lost key)
  *      a. `initiateRecovery` (guardian-signed OE)
@@ -2966,4 +2996,4 @@ declare function usePrivateBalance(input: PrivateBalanceInput): {
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, bigint>, Error>>;
 };
 
-export { type ThresholdSignState as $, useGetSkuPurchase as A, useGetSkuList as B, type ChipiWindowObjectDeps as C, useGetSku as D, useCallAnyContract as E, useSignTypedData as F, useChipiWalletObject as G, useRecordSendTransaction as H, useGetTokenBalance as I, useCreateSessionKey as J, useAddSessionKeyToContract as K, useRevokeSessionKey as L, useGetSessionData as M, useExecuteWithSession as N, useX402Payment as O, type UseX402PaymentConfig as P, type UseX402PaymentReturn as Q, type RegisterSessionConfig as R, type SessionState as S, useShhhSigner as T, type UseChipiWalletObjectConfig as U, type UseShhhSignerReturn as V, useGuardianRecovery as W, type UseGuardianRecoveryReturn as X, useThresholdSign as Y, type UseThresholdSignReturn as Z, type UseThresholdSignOptions as _, type ChipiApprovalRequest as a, useShield as a0, useUnshield as a1, usePrivateBalance as a2, derivePrivacyAccount as a3, netPrivateBalance as a4, type PrivacyConfig as a5, type PrivacyKeys as a6, type PrivacyStep as a7, type ShieldHookInput as a8, type PrivacyLedgerEvent as a9, type PrivateBalanceInput as aa, type ChipiSessionPolicy as b, type ChipiSessionSpendCap as c, type ChipiSessionSpendCapAmount as d, type ChipiSessionSpendCapPolicy as e, useGetWallet as f, useChipiWallet as g, type UseChipiWalletConfig as h, type UseChipiWalletReturn as i, type ChipiWalletData as j, useChipiSession as k, type UseChipiSessionConfig as l, type UseChipiSessionReturn as m, type SessionWallet as n, useMigrateWalletToPasskey as o, useUpdateWalletEncryption as p, useMigrateWalletToShhh as q, useTransfer as r, type UseTransferConfig as s, useApprove as t, useCreateWallet as u, useGetTransactionList as v, useGetTransaction as w, useGetTransactionStatus as x, useSyncOnChainTransfers as y, usePurchaseSku as z };
+export { type UseThresholdSignReturn as $, useGetSkuPurchase as A, useGetSkuList as B, type ChipiWindowObjectDeps as C, useGetSku as D, useCallAnyContract as E, useSignTypedData as F, useExternalSignerExecute as G, type ExternalSignerExecuteInput as H, useChipiWalletObject as I, useRecordSendTransaction as J, useGetTokenBalance as K, useCreateSessionKey as L, useAddSessionKeyToContract as M, useRevokeSessionKey as N, useGetSessionData as O, useExecuteWithSession as P, useX402Payment as Q, type RegisterSessionConfig as R, type SessionState as S, type UseX402PaymentConfig as T, type UseChipiWalletObjectConfig as U, type UseX402PaymentReturn as V, useShhhSigner as W, type UseShhhSignerReturn as X, useGuardianRecovery as Y, type UseGuardianRecoveryReturn as Z, useThresholdSign as _, type ChipiApprovalRequest as a, type UseThresholdSignOptions as a0, type ThresholdSignState as a1, useShield as a2, useUnshield as a3, usePrivateBalance as a4, derivePrivacyAccount as a5, netPrivateBalance as a6, type PrivacyConfig as a7, type PrivacyKeys as a8, type PrivacyStep as a9, type ShieldHookInput as aa, type PrivacyLedgerEvent as ab, type PrivateBalanceInput as ac, type ChipiSessionPolicy as b, type ChipiSessionSpendCap as c, type ChipiSessionSpendCapAmount as d, type ChipiSessionSpendCapPolicy as e, useGetWallet as f, useChipiWallet as g, type UseChipiWalletConfig as h, type UseChipiWalletReturn as i, type ChipiWalletData as j, useChipiSession as k, type UseChipiSessionConfig as l, type UseChipiSessionReturn as m, type SessionWallet as n, useMigrateWalletToPasskey as o, useUpdateWalletEncryption as p, useMigrateWalletToShhh as q, useTransfer as r, type UseTransferConfig as s, useApprove as t, useCreateWallet as u, useGetTransactionList as v, useGetTransaction as w, useGetTransactionStatus as x, useSyncOnChainTransfers as y, usePurchaseSku as z };

package/dist/{index-Dbqp9oNS.d.ts → index-CUfzUBgv.d.ts}

@@ -2,7 +2,7 @@ import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletRes
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 import { SyntheticEvent } from 'react';
-import { MigrateChipiWalletToShhhParams, MigrationOutcome, Eip191Pubkey, WebAuthnPubkey, JwtAppleSubPubkey, NewOwnerInput, buildProposeAddOwnerCall, TIMELOCK_SECONDS, DEFAULT_OP_EXPIRY_SECONDS, ROLE_OWNER, ROLE_GUARDIAN, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ShhhSignerKind, MIN_THRESHOLD_OWNERS } from '@chipi-stack/backend';
+import { MigrateChipiWalletToShhhParams, MigrationOutcome, ChipiSDK, Eip191Pubkey, WebAuthnPubkey, JwtAppleSubPubkey, NewOwnerInput, buildProposeAddOwnerCall, TIMELOCK_SECONDS, DEFAULT_OP_EXPIRY_SECONDS, ROLE_OWNER, ROLE_GUARDIAN, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ShhhSignerKind, MIN_THRESHOLD_OWNERS } from '@chipi-stack/backend';
 import { Call as Call$2 } from 'starknet';
 import { TypedData, AccountDeploymentData } from '@starknet-io/types-js';
 import { ShieldResult } from '@chipi-stack/core';
@@ -1872,6 +1872,24 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
+type ExternalSignerExecuteInput = Parameters<ChipiSDK["executeWithExternalSigner"]>[0];
+/**
+ * Run calls on a SHHH wallet signed by an external Starknet wallet that is one
+ * of its `STARK_SNIP12` owners: Bramble, Braavos, Ready/Argent or another
+ * Chipi wallet. Pass the wallet's `wallet_signTypedData` as `signTypedData`;
+ * the key never leaves that wallet. Returns the tx hash (wait for it).
+ */
+declare function useExternalSignerExecute(): {
+    execute: (input: ExternalSignerExecuteInput) => void;
+    executeAsync: (input: ExternalSignerExecuteInput) => Promise<string>;
+    data: string | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    isSuccess: boolean;
+    reset: () => void;
+};
+
 /**
  * An approval the host (walletv2, the hosted web-wallet, or a harness) must
  * resolve before the SWO performs a sensitive action. Returning `false`
@@ -1968,7 +1986,12 @@ interface ChipiWindowObjectDeps {
     executeCalls: (calls: Call$2[]) => Promise<string>;
     /** Sign SNIP-12 typed data → signature felts (envelope-aware for SHHH). */
     signTypedData: (typedData: TypedData) => Promise<string[]>;
-    /** Counterfactual deployment data for an undeployed account. */
+    /**
+     * Counterfactual deployment data for an undeployed account. Throw
+     * `Error("account_already_deployed")` for a deployed account (the dApp gets
+     * 115) or `Error("account_deployment_data_unavailable")` when the data can't
+     * be derived (116). Any other error reaches the dApp as 163.
+     */
     getDeploymentData: () => Promise<AccountDeploymentData>;
     /** Optional: establish a session from a dApp-proposed policy (approve once). */
     createSession?: (policy: ChipiSessionPolicy) => Promise<void>;
@@ -1995,6 +2018,13 @@ interface UseChipiWalletObjectConfig {
     sessionPolicy?: ChipiSessionPolicy | null;
     /** Chain id felt; defaults to SN_MAIN. */
     chainId?: string;
+    /**
+     * Whether the account is deployed on-chain (e.g. `isDeployed` from the
+     * wallet row). Only `true` makes `wallet_deploymentData` answer 115
+     * ("already deployed"); otherwise it answers 116 ("deployment data is not
+     * available"), since this hook can't derive a Chipi account's deployment data.
+     */
+    isDeployed?: boolean;
     /**
      * Host approval gate (connect / execute / signTypedData / session). When
      * omitted, every approval is denied and a single `console.warn` explains
@@ -2592,7 +2622,7 @@ type Call = ReturnType<typeof buildProposeAddOwnerCall>;
  *   1. ADD DEVICE (user has wallet access, wants a second owner)
  *      a. `proposeAddOwner` (owner-signed OE)
  *      b. wait 48h timelock
- *      c. `executeAddOwner` (owner-signed OE, with the opId from 1a)
+ *      c. `executeAddOwner` (permissionless after the timelock: any account, or an owner OE; opId from 1a)
  *
  *   2. RECOVER VIA GUARDIAN (user lost key)
  *      a. `initiateRecovery` (guardian-signed OE)
@@ -2966,4 +2996,4 @@ declare function usePrivateBalance(input: PrivateBalanceInput): {
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, bigint>, Error>>;
 };
 
-export { type ThresholdSignState as $, useGetSkuPurchase as A, useGetSkuList as B, type ChipiWindowObjectDeps as C, useGetSku as D, useCallAnyContract as E, useSignTypedData as F, useChipiWalletObject as G, useRecordSendTransaction as H, useGetTokenBalance as I, useCreateSessionKey as J, useAddSessionKeyToContract as K, useRevokeSessionKey as L, useGetSessionData as M, useExecuteWithSession as N, useX402Payment as O, type UseX402PaymentConfig as P, type UseX402PaymentReturn as Q, type RegisterSessionConfig as R, type SessionState as S, useShhhSigner as T, type UseChipiWalletObjectConfig as U, type UseShhhSignerReturn as V, useGuardianRecovery as W, type UseGuardianRecoveryReturn as X, useThresholdSign as Y, type UseThresholdSignReturn as Z, type UseThresholdSignOptions as _, type ChipiApprovalRequest as a, useShield as a0, useUnshield as a1, usePrivateBalance as a2, derivePrivacyAccount as a3, netPrivateBalance as a4, type PrivacyConfig as a5, type PrivacyKeys as a6, type PrivacyStep as a7, type ShieldHookInput as a8, type PrivacyLedgerEvent as a9, type PrivateBalanceInput as aa, type ChipiSessionPolicy as b, type ChipiSessionSpendCap as c, type ChipiSessionSpendCapAmount as d, type ChipiSessionSpendCapPolicy as e, useGetWallet as f, useChipiWallet as g, type UseChipiWalletConfig as h, type UseChipiWalletReturn as i, type ChipiWalletData as j, useChipiSession as k, type UseChipiSessionConfig as l, type UseChipiSessionReturn as m, type SessionWallet as n, useMigrateWalletToPasskey as o, useUpdateWalletEncryption as p, useMigrateWalletToShhh as q, useTransfer as r, type UseTransferConfig as s, useApprove as t, useCreateWallet as u, useGetTransactionList as v, useGetTransaction as w, useGetTransactionStatus as x, useSyncOnChainTransfers as y, usePurchaseSku as z };
+export { type UseThresholdSignReturn as $, useGetSkuPurchase as A, useGetSkuList as B, type ChipiWindowObjectDeps as C, useGetSku as D, useCallAnyContract as E, useSignTypedData as F, useExternalSignerExecute as G, type ExternalSignerExecuteInput as H, useChipiWalletObject as I, useRecordSendTransaction as J, useGetTokenBalance as K, useCreateSessionKey as L, useAddSessionKeyToContract as M, useRevokeSessionKey as N, useGetSessionData as O, useExecuteWithSession as P, useX402Payment as Q, type RegisterSessionConfig as R, type SessionState as S, type UseX402PaymentConfig as T, type UseChipiWalletObjectConfig as U, type UseX402PaymentReturn as V, useShhhSigner as W, type UseShhhSignerReturn as X, useGuardianRecovery as Y, type UseGuardianRecoveryReturn as Z, useThresholdSign as _, type ChipiApprovalRequest as a, type UseThresholdSignOptions as a0, type ThresholdSignState as a1, useShield as a2, useUnshield as a3, usePrivateBalance as a4, derivePrivacyAccount as a5, netPrivateBalance as a6, type PrivacyConfig as a7, type PrivacyKeys as a8, type PrivacyStep as a9, type ShieldHookInput as aa, type PrivacyLedgerEvent as ab, type PrivateBalanceInput as ac, type ChipiSessionPolicy as b, type ChipiSessionSpendCap as c, type ChipiSessionSpendCapAmount as d, type ChipiSessionSpendCapPolicy as e, useGetWallet as f, useChipiWallet as g, type UseChipiWalletConfig as h, type UseChipiWalletReturn as i, type ChipiWalletData as j, useChipiSession as k, type UseChipiSessionConfig as l, type UseChipiSessionReturn as m, type SessionWallet as n, useMigrateWalletToPasskey as o, useUpdateWalletEncryption as p, useMigrateWalletToShhh as q, useTransfer as r, type UseTransferConfig as s, useApprove as t, useCreateWallet as u, useGetTransactionList as v, useGetTransaction as w, useGetTransactionStatus as x, useSyncOnChainTransfers as y, usePurchaseSku as z };

package/dist/index.d.mts

@@ -4,8 +4,8 @@ import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
 import { ChipiSDKConfig, WalletType } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken } from '@chipi-stack/types';
-import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-Dbqp9oNS.mjs';
-export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, c as ChipiSessionSpendCap, d as ChipiSessionSpendCapAmount, e as ChipiSessionSpendCapPolicy, j as ChipiWalletData, a5 as PrivacyConfig, a6 as PrivacyKeys, a9 as PrivacyLedgerEvent, a7 as PrivacyStep, aa as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, n as SessionWallet, a8 as ShieldHookInput, $ as ThresholdSignState, l as UseChipiSessionConfig, m as UseChipiSessionReturn, h as UseChipiWalletConfig, i as UseChipiWalletReturn, X as UseGuardianRecoveryReturn, V as UseShhhSignerReturn, _ as UseThresholdSignOptions, Z as UseThresholdSignReturn, s as UseTransferConfig, P as UseX402PaymentConfig, Q as UseX402PaymentReturn, a3 as derivePrivacyAccount, a4 as netPrivateBalance, K as useAddSessionKeyToContract, t as useApprove, E as useCallAnyContract, k as useChipiSession, g as useChipiWallet, G as useChipiWalletObject, J as useCreateSessionKey, u as useCreateWallet, N as useExecuteWithSession, M as useGetSessionData, D as useGetSku, B as useGetSkuList, A as useGetSkuPurchase, I as useGetTokenBalance, w as useGetTransaction, v as useGetTransactionList, x as useGetTransactionStatus, f as useGetWallet, W as useGuardianRecovery, o as useMigrateWalletToPasskey, q as useMigrateWalletToShhh, a2 as usePrivateBalance, z as usePurchaseSku, H as useRecordSendTransaction, L as useRevokeSessionKey, T as useShhhSigner, a0 as useShield, F as useSignTypedData, y as useSyncOnChainTransfers, Y as useThresholdSign, r as useTransfer, a1 as useUnshield, p as useUpdateWalletEncryption, O as useX402Payment } from './index-Dbqp9oNS.mjs';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-CUfzUBgv.mjs';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, c as ChipiSessionSpendCap, d as ChipiSessionSpendCapAmount, e as ChipiSessionSpendCapPolicy, j as ChipiWalletData, H as ExternalSignerExecuteInput, a7 as PrivacyConfig, a8 as PrivacyKeys, ab as PrivacyLedgerEvent, a9 as PrivacyStep, ac as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, n as SessionWallet, aa as ShieldHookInput, a1 as ThresholdSignState, l as UseChipiSessionConfig, m as UseChipiSessionReturn, h as UseChipiWalletConfig, i as UseChipiWalletReturn, Z as UseGuardianRecoveryReturn, X as UseShhhSignerReturn, a0 as UseThresholdSignOptions, $ as UseThresholdSignReturn, s as UseTransferConfig, T as UseX402PaymentConfig, V as UseX402PaymentReturn, a5 as derivePrivacyAccount, a6 as netPrivateBalance, M as useAddSessionKeyToContract, t as useApprove, E as useCallAnyContract, k as useChipiSession, g as useChipiWallet, I as useChipiWalletObject, L as useCreateSessionKey, u as useCreateWallet, P as useExecuteWithSession, G as useExternalSignerExecute, O as useGetSessionData, D as useGetSku, B as useGetSkuList, A as useGetSkuPurchase, K as useGetTokenBalance, w as useGetTransaction, v as useGetTransactionList, x as useGetTransactionStatus, f as useGetWallet, Y as useGuardianRecovery, o as useMigrateWalletToPasskey, q as useMigrateWalletToShhh, a4 as usePrivateBalance, z as usePurchaseSku, J as useRecordSendTransaction, N as useRevokeSessionKey, W as useShhhSigner, a2 as useShield, F as useSignTypedData, y as useSyncOnChainTransfers, _ as useThresholdSign, r as useTransfer, a3 as useUnshield, p as useUpdateWalletEncryption, Q as useX402Payment } from './index-CUfzUBgv.mjs';
 import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
 import 'starknet';
@@ -212,7 +212,7 @@ interface RecoverProps {
     /**
      * Optional cancel handler. When omitted the cancel button is hidden.
      * Add-device uses `cancel_pending_op` (any owner); guardian-recovery
-     * uses `cancel_recovery` (the original owner, if they resurface).
+     * uses `cancel_recovery` (any non-revoked owner, signing with its own owner id).
      */
     onCancel?: (opId: bigint | string) => Promise<void>;
     /**

package/dist/index.d.ts

@@ -4,8 +4,8 @@ import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
 import { ChipiSDKConfig, WalletType } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken } from '@chipi-stack/types';
-import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-Dbqp9oNS.js';
-export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, c as ChipiSessionSpendCap, d as ChipiSessionSpendCapAmount, e as ChipiSessionSpendCapPolicy, j as ChipiWalletData, a5 as PrivacyConfig, a6 as PrivacyKeys, a9 as PrivacyLedgerEvent, a7 as PrivacyStep, aa as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, n as SessionWallet, a8 as ShieldHookInput, $ as ThresholdSignState, l as UseChipiSessionConfig, m as UseChipiSessionReturn, h as UseChipiWalletConfig, i as UseChipiWalletReturn, X as UseGuardianRecoveryReturn, V as UseShhhSignerReturn, _ as UseThresholdSignOptions, Z as UseThresholdSignReturn, s as UseTransferConfig, P as UseX402PaymentConfig, Q as UseX402PaymentReturn, a3 as derivePrivacyAccount, a4 as netPrivateBalance, K as useAddSessionKeyToContract, t as useApprove, E as useCallAnyContract, k as useChipiSession, g as useChipiWallet, G as useChipiWalletObject, J as useCreateSessionKey, u as useCreateWallet, N as useExecuteWithSession, M as useGetSessionData, D as useGetSku, B as useGetSkuList, A as useGetSkuPurchase, I as useGetTokenBalance, w as useGetTransaction, v as useGetTransactionList, x as useGetTransactionStatus, f as useGetWallet, W as useGuardianRecovery, o as useMigrateWalletToPasskey, q as useMigrateWalletToShhh, a2 as usePrivateBalance, z as usePurchaseSku, H as useRecordSendTransaction, L as useRevokeSessionKey, T as useShhhSigner, a0 as useShield, F as useSignTypedData, y as useSyncOnChainTransfers, Y as useThresholdSign, r as useTransfer, a1 as useUnshield, p as useUpdateWalletEncryption, O as useX402Payment } from './index-Dbqp9oNS.js';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-CUfzUBgv.js';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, c as ChipiSessionSpendCap, d as ChipiSessionSpendCapAmount, e as ChipiSessionSpendCapPolicy, j as ChipiWalletData, H as ExternalSignerExecuteInput, a7 as PrivacyConfig, a8 as PrivacyKeys, ab as PrivacyLedgerEvent, a9 as PrivacyStep, ac as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, n as SessionWallet, aa as ShieldHookInput, a1 as ThresholdSignState, l as UseChipiSessionConfig, m as UseChipiSessionReturn, h as UseChipiWalletConfig, i as UseChipiWalletReturn, Z as UseGuardianRecoveryReturn, X as UseShhhSignerReturn, a0 as UseThresholdSignOptions, $ as UseThresholdSignReturn, s as UseTransferConfig, T as UseX402PaymentConfig, V as UseX402PaymentReturn, a5 as derivePrivacyAccount, a6 as netPrivateBalance, M as useAddSessionKeyToContract, t as useApprove, E as useCallAnyContract, k as useChipiSession, g as useChipiWallet, I as useChipiWalletObject, L as useCreateSessionKey, u as useCreateWallet, P as useExecuteWithSession, G as useExternalSignerExecute, O as useGetSessionData, D as useGetSku, B as useGetSkuList, A as useGetSkuPurchase, K as useGetTokenBalance, w as useGetTransaction, v as useGetTransactionList, x as useGetTransactionStatus, f as useGetWallet, Y as useGuardianRecovery, o as useMigrateWalletToPasskey, q as useMigrateWalletToShhh, a4 as usePrivateBalance, z as usePurchaseSku, J as useRecordSendTransaction, N as useRevokeSessionKey, W as useShhhSigner, a2 as useShield, F as useSignTypedData, y as useSyncOnChainTransfers, _ as useThresholdSign, r as useTransfer, a3 as useUnshield, p as useUpdateWalletEncryption, Q as useX402Payment } from './index-CUfzUBgv.js';
 import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
 import 'starknet';
@@ -212,7 +212,7 @@ interface RecoverProps {
     /**
      * Optional cancel handler. When omitted the cancel button is hidden.
      * Add-device uses `cancel_pending_op` (any owner); guardian-recovery
-     * uses `cancel_recovery` (the original owner, if they resurface).
+     * uses `cancel_recovery` (any non-revoked owner, signing with its own owner id).
      */
     onCancel?: (opId: bigint | string) => Promise<void>;
     /**

package/dist/index.js

@@ -1340,6 +1340,22 @@ function useSignTypedData() {
     reset: mutation.reset
   };
 }
+function useExternalSignerExecute() {
+  const { chipiSDK } = useChipiContext();
+  const mutation = reactQuery.useMutation({
+    mutationFn: async (input) => chipiSDK.executeWithExternalSigner(input)
+  });
+  return {
+    execute: mutation.mutate,
+    executeAsync: mutation.mutateAsync,
+    data: mutation.data,
+    isLoading: mutation.isPending,
+    isError: mutation.isError,
+    error: mutation.error,
+    isSuccess: mutation.isSuccess,
+    reset: mutation.reset
+  };
+}
 
 // ../node_modules/.pnpm/@starknet-io+types-js@0.9.2/node_modules/@starknet-io/types-js/dist/esm/index.js
 var esm_exports = {};
@@ -20549,7 +20565,8 @@ function useChipiWalletObject(config3) {
         return signTypedDataAsync({ encryptKey, wallet, typedData });
       },
       getDeploymentData: async () => {
-        throw new Error("account_already_deployed");
+        if (cfg.current.isDeployed === true) throw new Error("account_already_deployed");
+        throw new Error("account_deployment_data_unavailable");
       },
       createSession: async (policy) => {
         await createSession(policy);
@@ -21243,6 +21260,7 @@ var RpcError2 = class extends Error {
 var USER_REFUSED_OP = 113;
 var INVALID_REQUEST_PAYLOAD = 114;
 var ACCOUNT_ALREADY_DEPLOYED = 115;
+var NO_DEPLOYMENT_DATA = 116;
 var UNKNOWN_ERROR = 163;
 var MISSING_APPROVAL_WARNING = "[ChipiSDK:Connect] No `requestApproval` was provided, so every approval (connect, execute, signTypedData, session) is denied. Pass `requestApproval` to show the user an approval UI and resolve true/false.";
 function normalizeChainId(value) {
@@ -21312,15 +21330,19 @@ function createChipiWindowObject(deps) {
       case "wallet_signTypedData": {
         const typedData = call.params;
         const domainChainId = typedData?.domain?.chainId;
-        if (domainChainId !== void 0 && domainChainId !== null) {
-          const expected = normalizeChainId(deps.chainId);
-          const actual = normalizeChainId(domainChainId);
-          if (actual === null || expected === null || actual !== expected) {
-            throw new RpcError2(
-              INVALID_REQUEST_PAYLOAD,
-              `wallet_signTypedData: domain.chainId ${String(domainChainId)} does not match the wallet chain ${deps.chainId}`
-            );
-          }
+        if (domainChainId === void 0 || domainChainId === null) {
+          throw new RpcError2(
+            INVALID_REQUEST_PAYLOAD,
+            `wallet_signTypedData: domain.chainId is required (the wallet chain is ${deps.chainId})`
+          );
+        }
+        const expected = normalizeChainId(deps.chainId);
+        const actual = normalizeChainId(domainChainId);
+        if (actual === null || expected === null || actual !== expected) {
+          throw new RpcError2(
+            INVALID_REQUEST_PAYLOAD,
+            `wallet_signTypedData: domain.chainId ${String(domainChainId)} does not match the wallet chain ${deps.chainId}`
+          );
         }
         await requireApproval({ type: "signTypedData", typedData });
         return deps.signTypedData(typedData);
@@ -21332,6 +21354,9 @@ function createChipiWindowObject(deps) {
           if (err2 instanceof Error && err2.message === "account_already_deployed") {
             throw new RpcError2(ACCOUNT_ALREADY_DEPLOYED, "Account already deployed");
           }
+          if (err2 instanceof Error && err2.message === "account_deployment_data_unavailable") {
+            throw new RpcError2(NO_DEPLOYMENT_DATA, "Account deployment data is not available");
+          }
           throw new RpcError2(
             UNKNOWN_ERROR,
             err2 instanceof Error ? err2.message : "Could not read deployment data"
@@ -21652,6 +21677,7 @@ exports.useChipiWalletObject = useChipiWalletObject;
 exports.useCreateSessionKey = useCreateSessionKey;
 exports.useCreateWallet = useCreateWallet;
 exports.useExecuteWithSession = useExecuteWithSession;
+exports.useExternalSignerExecute = useExternalSignerExecute;
 exports.useGetSessionData = useGetSessionData;
 exports.useGetSku = useGetSku;
 exports.useGetSkuList = useGetSkuList;