@chipi-stack/chipi-react 14.13.1 → 14.15.0

package/dist/{index-D9-uVlda.d.mts → index-B8OIdrOX.d.mts}

@@ -1,6 +1,7 @@
-import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call as Call$1, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, SyncOnChainTransfersParams, SyncOnChainTransfersResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, SignTypedDataParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
+import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, SessionSpendingPolicy, Call as Call$1, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, SyncOnChainTransfersParams, SyncOnChainTransfersResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, SignTypedDataParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
 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 { Call as Call$2 } from 'starknet';
 import { TypedData, AccountDeploymentData } from '@starknet-io/types-js';
@@ -344,10 +345,25 @@ interface SessionWallet extends WalletData {
  * Configuration for useChipiSession hook
  */
 interface UseChipiSessionConfig {
-    /** Wallet data (must be a CHIPI wallet for session support) */
+    /** Wallet data (CHIPI, or SHHH with a STARK / ED25519 signer) */
     wallet: SessionWallet | null | undefined;
-    /** Encryption key (user's PIN) for signing operations */
-    encryptKey: string;
+    /**
+     * Encryption key for signing operations (a PIN, or a key you already hold).
+     * Optional when `getEncryptKey` is given.
+     */
+    encryptKey?: string;
+    /**
+     * Resolve the encryption key only when an action needs it, e.g. a passkey:
+     * `getEncryptKey: () => getWalletEncryptKey(credentialId)`. Used when
+     * `encryptKey` is not set. It runs before `getBearerToken`, so the token is
+     * fetched after the biometric prompt and is not stale.
+     *
+     * Every action that needs the key resolves it again: `createSession` and
+     * `executeWithSession` included, so with a passkey each browser-side session
+     * execution prompts too. For prompt-free execution, keep the session on your
+     * server and execute it there (register it here with `sessionPublicKey`).
+     */
+    getEncryptKey?: () => Promise<string | null | undefined>;
     /** Function to get the bearer token for API calls */
     getBearerToken: () => Promise<string | null | undefined>;
     /** Previously stored session data (from Clerk metadata, database, etc.) */
@@ -361,6 +377,13 @@ interface UseChipiSessionConfig {
     /** Whether to auto-check session status on mount */
     autoCheckStatus?: boolean;
 }
+/**
+ * Options for `registerSession`.
+ */
+type RegisterSessionConfig = Partial<SessionConfig> & {
+    /** Caps set in the same transaction as the registration (one signature). */
+    spendingPolicies?: SessionSpendingPolicy[];
+};
 /**
  * Session lifecycle state
  */
@@ -381,14 +404,23 @@ interface UseChipiSessionReturn {
     isSessionExpired: boolean;
     /** Remaining calls available for the session */
     remainingCalls: number | undefined;
-    /** Whether the wallet supports sessions (CHIPI wallet) */
+    /** Whether the wallet supports sessions (CHIPI, or SHHH with a STARK / ED25519 signer) */
     supportsSession: boolean;
     /** Create a new session keypair locally (does NOT register on-chain) */
     createSession: (config?: Partial<CreateSessionKeyParams>) => Promise<SessionKeyData>;
-    /** Register the current session on the blockchain */
-    registerSession: (config?: Partial<SessionConfig>) => Promise<string>;
-    /** Revoke the current session from the blockchain */
-    revokeSession: () => Promise<string>;
+    /**
+     * Register a session on the blockchain. Defaults to the current session; pass
+     * `sessionPublicKey` + `validUntil` to register one created elsewhere (e.g. on
+     * your server). With `spendingPolicies`, the session and its caps are set in
+     * one owner-signed transaction.
+     *
+     * `sessionState` and `remainingCalls` track the local session only. For a key
+     * registered from elsewhere, read its state where it lives (on your server,
+     * `sdk.sessions.getSessionData`).
+     */
+    registerSession: (config?: RegisterSessionConfig) => Promise<string>;
+    /** Revoke a session from the blockchain. Defaults to the current session. */
+    revokeSession: (sessionPublicKey?: string | SyntheticEvent) => Promise<string>;
     /** Execute calls using the session key (no owner signature needed) */
     executeWithSession: (calls: Call$1[]) => Promise<string>;
     /** Clear the current session from local state */
@@ -1207,7 +1239,7 @@ type SyncOnChainInput = SyncOnChainTransfersParams & {
     bearerToken: string;
 };
 /**
- * Hook for syncing on-chain transfers from Voyager into the DB.
+ * Hook for syncing on-chain transfers (Starknet Transfer events, read by the backend) into the DB.
  *
  * Discovers transactions not made through the SDK (e.g., external USDC receives
  * from Argent X or other wallets). After sync, useGetTransactionList returns
@@ -2858,4 +2890,4 @@ declare function usePrivateBalance(input: PrivateBalanceInput): {
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, bigint>, Error>>;
 };
 
-export { derivePrivacyAccount as $, useCallAnyContract as A, useSignTypedData as B, type ChipiWindowObjectDeps as C, useChipiWalletObject as D, useRecordSendTransaction as E, useGetTokenBalance as F, useCreateSessionKey as G, useAddSessionKeyToContract as H, useRevokeSessionKey as I, useGetSessionData as J, useExecuteWithSession as K, useX402Payment as L, type UseX402PaymentConfig as M, type UseX402PaymentReturn as N, useShhhSigner as O, type UseShhhSignerReturn as P, useGuardianRecovery as Q, type UseGuardianRecoveryReturn as R, type SessionState as S, useThresholdSign as T, type UseChipiWalletObjectConfig as U, type UseThresholdSignReturn as V, type UseThresholdSignOptions as W, type ThresholdSignState as X, useShield as Y, useUnshield as Z, usePrivateBalance as _, type ChipiApprovalRequest as a, netPrivateBalance as a0, type PrivacyConfig as a1, type PrivacyKeys as a2, type PrivacyStep as a3, type ShieldHookInput as a4, type PrivacyLedgerEvent as a5, type PrivateBalanceInput as a6, type ChipiSessionPolicy as b, useGetWallet as c, useChipiWallet as d, type UseChipiWalletConfig as e, type UseChipiWalletReturn as f, type ChipiWalletData as g, useChipiSession as h, type UseChipiSessionConfig as i, type UseChipiSessionReturn as j, type SessionWallet as k, useMigrateWalletToPasskey as l, useUpdateWalletEncryption as m, useMigrateWalletToShhh as n, useTransfer as o, type UseTransferConfig as p, useApprove as q, useGetTransactionList as r, useGetTransaction as s, useGetTransactionStatus as t, useCreateWallet as u, useSyncOnChainTransfers as v, usePurchaseSku as w, useGetSkuPurchase as x, useGetSkuList as y, useGetSku as z };
+export { usePrivateBalance as $, useCallAnyContract as A, useSignTypedData as B, type ChipiWindowObjectDeps as C, useChipiWalletObject as D, useRecordSendTransaction as E, useGetTokenBalance as F, useCreateSessionKey as G, useAddSessionKeyToContract as H, useRevokeSessionKey as I, useGetSessionData as J, useExecuteWithSession as K, useX402Payment as L, type UseX402PaymentConfig as M, type UseX402PaymentReturn as N, useShhhSigner as O, type UseShhhSignerReturn as P, useGuardianRecovery as Q, type RegisterSessionConfig as R, type SessionState as S, type UseGuardianRecoveryReturn as T, type UseChipiWalletObjectConfig as U, useThresholdSign as V, type UseThresholdSignReturn as W, type UseThresholdSignOptions as X, type ThresholdSignState as Y, useShield as Z, useUnshield as _, type ChipiApprovalRequest as a, derivePrivacyAccount as a0, netPrivateBalance as a1, type PrivacyConfig as a2, type PrivacyKeys as a3, type PrivacyStep as a4, type ShieldHookInput as a5, type PrivacyLedgerEvent as a6, type PrivateBalanceInput as a7, type ChipiSessionPolicy as b, useGetWallet as c, useChipiWallet as d, type UseChipiWalletConfig as e, type UseChipiWalletReturn as f, type ChipiWalletData as g, useChipiSession as h, type UseChipiSessionConfig as i, type UseChipiSessionReturn as j, type SessionWallet as k, useMigrateWalletToPasskey as l, useUpdateWalletEncryption as m, useMigrateWalletToShhh as n, useTransfer as o, type UseTransferConfig as p, useApprove as q, useGetTransactionList as r, useGetTransaction as s, useGetTransactionStatus as t, useCreateWallet as u, useSyncOnChainTransfers as v, usePurchaseSku as w, useGetSkuPurchase as x, useGetSkuList as y, useGetSku as z };

package/dist/{index-D9-uVlda.d.ts → index-B8OIdrOX.d.ts}

@@ -1,6 +1,7 @@
-import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call as Call$1, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, SyncOnChainTransfersParams, SyncOnChainTransfersResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, SignTypedDataParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
+import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, SessionSpendingPolicy, Call as Call$1, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, SyncOnChainTransfersParams, SyncOnChainTransfersResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, SignTypedDataParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
 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 { Call as Call$2 } from 'starknet';
 import { TypedData, AccountDeploymentData } from '@starknet-io/types-js';
@@ -344,10 +345,25 @@ interface SessionWallet extends WalletData {
  * Configuration for useChipiSession hook
  */
 interface UseChipiSessionConfig {
-    /** Wallet data (must be a CHIPI wallet for session support) */
+    /** Wallet data (CHIPI, or SHHH with a STARK / ED25519 signer) */
     wallet: SessionWallet | null | undefined;
-    /** Encryption key (user's PIN) for signing operations */
-    encryptKey: string;
+    /**
+     * Encryption key for signing operations (a PIN, or a key you already hold).
+     * Optional when `getEncryptKey` is given.
+     */
+    encryptKey?: string;
+    /**
+     * Resolve the encryption key only when an action needs it, e.g. a passkey:
+     * `getEncryptKey: () => getWalletEncryptKey(credentialId)`. Used when
+     * `encryptKey` is not set. It runs before `getBearerToken`, so the token is
+     * fetched after the biometric prompt and is not stale.
+     *
+     * Every action that needs the key resolves it again: `createSession` and
+     * `executeWithSession` included, so with a passkey each browser-side session
+     * execution prompts too. For prompt-free execution, keep the session on your
+     * server and execute it there (register it here with `sessionPublicKey`).
+     */
+    getEncryptKey?: () => Promise<string | null | undefined>;
     /** Function to get the bearer token for API calls */
     getBearerToken: () => Promise<string | null | undefined>;
     /** Previously stored session data (from Clerk metadata, database, etc.) */
@@ -361,6 +377,13 @@ interface UseChipiSessionConfig {
     /** Whether to auto-check session status on mount */
     autoCheckStatus?: boolean;
 }
+/**
+ * Options for `registerSession`.
+ */
+type RegisterSessionConfig = Partial<SessionConfig> & {
+    /** Caps set in the same transaction as the registration (one signature). */
+    spendingPolicies?: SessionSpendingPolicy[];
+};
 /**
  * Session lifecycle state
  */
@@ -381,14 +404,23 @@ interface UseChipiSessionReturn {
     isSessionExpired: boolean;
     /** Remaining calls available for the session */
     remainingCalls: number | undefined;
-    /** Whether the wallet supports sessions (CHIPI wallet) */
+    /** Whether the wallet supports sessions (CHIPI, or SHHH with a STARK / ED25519 signer) */
     supportsSession: boolean;
     /** Create a new session keypair locally (does NOT register on-chain) */
     createSession: (config?: Partial<CreateSessionKeyParams>) => Promise<SessionKeyData>;
-    /** Register the current session on the blockchain */
-    registerSession: (config?: Partial<SessionConfig>) => Promise<string>;
-    /** Revoke the current session from the blockchain */
-    revokeSession: () => Promise<string>;
+    /**
+     * Register a session on the blockchain. Defaults to the current session; pass
+     * `sessionPublicKey` + `validUntil` to register one created elsewhere (e.g. on
+     * your server). With `spendingPolicies`, the session and its caps are set in
+     * one owner-signed transaction.
+     *
+     * `sessionState` and `remainingCalls` track the local session only. For a key
+     * registered from elsewhere, read its state where it lives (on your server,
+     * `sdk.sessions.getSessionData`).
+     */
+    registerSession: (config?: RegisterSessionConfig) => Promise<string>;
+    /** Revoke a session from the blockchain. Defaults to the current session. */
+    revokeSession: (sessionPublicKey?: string | SyntheticEvent) => Promise<string>;
     /** Execute calls using the session key (no owner signature needed) */
     executeWithSession: (calls: Call$1[]) => Promise<string>;
     /** Clear the current session from local state */
@@ -1207,7 +1239,7 @@ type SyncOnChainInput = SyncOnChainTransfersParams & {
     bearerToken: string;
 };
 /**
- * Hook for syncing on-chain transfers from Voyager into the DB.
+ * Hook for syncing on-chain transfers (Starknet Transfer events, read by the backend) into the DB.
  *
  * Discovers transactions not made through the SDK (e.g., external USDC receives
  * from Argent X or other wallets). After sync, useGetTransactionList returns
@@ -2858,4 +2890,4 @@ declare function usePrivateBalance(input: PrivateBalanceInput): {
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Record<string, bigint>, Error>>;
 };
 
-export { derivePrivacyAccount as $, useCallAnyContract as A, useSignTypedData as B, type ChipiWindowObjectDeps as C, useChipiWalletObject as D, useRecordSendTransaction as E, useGetTokenBalance as F, useCreateSessionKey as G, useAddSessionKeyToContract as H, useRevokeSessionKey as I, useGetSessionData as J, useExecuteWithSession as K, useX402Payment as L, type UseX402PaymentConfig as M, type UseX402PaymentReturn as N, useShhhSigner as O, type UseShhhSignerReturn as P, useGuardianRecovery as Q, type UseGuardianRecoveryReturn as R, type SessionState as S, useThresholdSign as T, type UseChipiWalletObjectConfig as U, type UseThresholdSignReturn as V, type UseThresholdSignOptions as W, type ThresholdSignState as X, useShield as Y, useUnshield as Z, usePrivateBalance as _, type ChipiApprovalRequest as a, netPrivateBalance as a0, type PrivacyConfig as a1, type PrivacyKeys as a2, type PrivacyStep as a3, type ShieldHookInput as a4, type PrivacyLedgerEvent as a5, type PrivateBalanceInput as a6, type ChipiSessionPolicy as b, useGetWallet as c, useChipiWallet as d, type UseChipiWalletConfig as e, type UseChipiWalletReturn as f, type ChipiWalletData as g, useChipiSession as h, type UseChipiSessionConfig as i, type UseChipiSessionReturn as j, type SessionWallet as k, useMigrateWalletToPasskey as l, useUpdateWalletEncryption as m, useMigrateWalletToShhh as n, useTransfer as o, type UseTransferConfig as p, useApprove as q, useGetTransactionList as r, useGetTransaction as s, useGetTransactionStatus as t, useCreateWallet as u, useSyncOnChainTransfers as v, usePurchaseSku as w, useGetSkuPurchase as x, useGetSkuList as y, useGetSku as z };
+export { usePrivateBalance as $, useCallAnyContract as A, useSignTypedData as B, type ChipiWindowObjectDeps as C, useChipiWalletObject as D, useRecordSendTransaction as E, useGetTokenBalance as F, useCreateSessionKey as G, useAddSessionKeyToContract as H, useRevokeSessionKey as I, useGetSessionData as J, useExecuteWithSession as K, useX402Payment as L, type UseX402PaymentConfig as M, type UseX402PaymentReturn as N, useShhhSigner as O, type UseShhhSignerReturn as P, useGuardianRecovery as Q, type RegisterSessionConfig as R, type SessionState as S, type UseGuardianRecoveryReturn as T, type UseChipiWalletObjectConfig as U, useThresholdSign as V, type UseThresholdSignReturn as W, type UseThresholdSignOptions as X, type ThresholdSignState as Y, useShield as Z, useUnshield as _, type ChipiApprovalRequest as a, derivePrivacyAccount as a0, netPrivateBalance as a1, type PrivacyConfig as a2, type PrivacyKeys as a3, type PrivacyStep as a4, type ShieldHookInput as a5, type PrivacyLedgerEvent as a6, type PrivateBalanceInput as a7, type ChipiSessionPolicy as b, useGetWallet as c, useChipiWallet as d, type UseChipiWalletConfig as e, type UseChipiWalletReturn as f, type ChipiWalletData as g, useChipiSession as h, type UseChipiSessionConfig as i, type UseChipiSessionReturn as j, type SessionWallet as k, useMigrateWalletToPasskey as l, useUpdateWalletEncryption as m, useMigrateWalletToShhh as n, useTransfer as o, type UseTransferConfig as p, useApprove as q, useGetTransactionList as r, useGetTransaction as s, useGetTransactionStatus as t, useCreateWallet as u, useSyncOnChainTransfers as v, usePurchaseSku as w, useGetSkuPurchase as x, useGetSkuList as y, useGetSku as z };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
-import { ChipiSDKConfig } from '@chipi-stack/types';
+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-D9-uVlda.mjs';
-export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a1 as PrivacyConfig, a2 as PrivacyKeys, a5 as PrivacyLedgerEvent, a3 as PrivacyStep, a6 as PrivateBalanceInput, S as SessionState, k as SessionWallet, a4 as ShieldHookInput, X as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, R as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, W as UseThresholdSignOptions, V as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, $ as derivePrivacyAccount, a0 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, _ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Y as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, T as useThresholdSign, o as useTransfer, Z as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-D9-uVlda.mjs';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-B8OIdrOX.mjs';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a2 as PrivacyConfig, a3 as PrivacyKeys, a6 as PrivacyLedgerEvent, a4 as PrivacyStep, a7 as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, k as SessionWallet, a5 as ShieldHookInput, Y as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, T as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, X as UseThresholdSignOptions, W as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, a0 as derivePrivacyAccount, a1 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, $ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Z as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, V as useThresholdSign, o as useTransfer, _ as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-B8OIdrOX.mjs';
 import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
 import 'starknet';
@@ -41,6 +41,20 @@ declare function ChipiProvider({ children, config, passkeyAdapter }: ChipiProvid
  */
 declare function useChipiContext(): ChipiContextValue;
 
+/**
+ * Whether a wallet can register and use SNIP-163 session keys through the SDK.
+ *
+ * CHIPI (v29+) and SHHH V8.4 both embed the sessions component. For SHHH the
+ * owner signature is built by the SDK only for STARK and ED25519 signers
+ * (`executeShhhSponsoredRaw`); a missing `signerKind` means STARK, the default
+ * for SDK-created SHHH wallets, including passkey-encrypted ones. READY (Argent
+ * X) has no sessions component.
+ */
+declare function walletSupportsSessions(wallet: {
+    walletType?: WalletType | string | null;
+    signerKind?: string | null;
+} | null | undefined): boolean;
+
 /**
  * Build a standards-compliant Starknet `StarknetWindowObject` backed by a Chipi
  * wallet. Framework-agnostic: all signing/execution/approval is injected via
@@ -115,9 +129,40 @@ declare function ChipiInjector({ children, ...config }: ChipiInjectorProps): Rea
  * (MetaMask connect, passkey enrollment, Apple Sign In) is intentionally
  * out of scope: caller computes `newOwner` upstream and passes it in.
  */
+/**
+ * Every user-facing string `<Recover />` renders. The built-in defaults are
+ * English developer copy — **not** end-user-ready (they say "timelock",
+ * "add-owner", etc.). Consumer apps MUST override these with their own
+ * localized, jargon-free copy (e.g. via next-intl). Pass a partial; unset
+ * fields fall back to `DEFAULT_RECOVER_LABELS`.
+ */
+interface RecoverLabels {
+    proposeAddDevice: string;
+    proposeRecovery: string;
+    executeAddDevice: string;
+    executeRecovery: string;
+    timelockAddDevice: string;
+    timelockRecovery: string;
+    submitting: string;
+    /** Formats the live countdown. Receives whole seconds remaining. */
+    secondsRemaining: (secondsRemaining: number) => string;
+    cancel: string;
+    timelockElapsed: string;
+    cancelling: string;
+    doneAddDevice: string;
+    doneRecovery: string;
+}
+/** Developer-facing English defaults. Override for real users. */
+declare const DEFAULT_RECOVER_LABELS: RecoverLabels;
 interface RecoverProps {
     /** Which flow this component renders. */
     mode: "add-device" | "guardian-recovery";
+    /**
+     * Override any/all user-facing strings. The defaults are developer English
+     * with protocol jargon and are unsuitable for end users — supply localized,
+     * job-named copy here (see `RecoverLabels`).
+     */
+    labels?: Partial<RecoverLabels>;
     /** The SHHH wallet being modified. */
     walletAddress: bigint | string;
     /**
@@ -170,4 +215,4 @@ interface RecoverProps {
 }
 declare function Recover(props: RecoverProps): React.ReactElement;
 
-export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext };
+export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, DEFAULT_RECOVER_LABELS, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverLabels, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext, walletSupportsSessions };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
-import { ChipiSDKConfig } from '@chipi-stack/types';
+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-D9-uVlda.js';
-export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a1 as PrivacyConfig, a2 as PrivacyKeys, a5 as PrivacyLedgerEvent, a3 as PrivacyStep, a6 as PrivateBalanceInput, S as SessionState, k as SessionWallet, a4 as ShieldHookInput, X as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, R as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, W as UseThresholdSignOptions, V as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, $ as derivePrivacyAccount, a0 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, _ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Y as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, T as useThresholdSign, o as useTransfer, Z as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-D9-uVlda.js';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-B8OIdrOX.js';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a2 as PrivacyConfig, a3 as PrivacyKeys, a6 as PrivacyLedgerEvent, a4 as PrivacyStep, a7 as PrivateBalanceInput, R as RegisterSessionConfig, S as SessionState, k as SessionWallet, a5 as ShieldHookInput, Y as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, T as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, X as UseThresholdSignOptions, W as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, a0 as derivePrivacyAccount, a1 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, $ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Z as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, V as useThresholdSign, o as useTransfer, _ as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-B8OIdrOX.js';
 import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
 import 'starknet';
@@ -41,6 +41,20 @@ declare function ChipiProvider({ children, config, passkeyAdapter }: ChipiProvid
  */
 declare function useChipiContext(): ChipiContextValue;
 
+/**
+ * Whether a wallet can register and use SNIP-163 session keys through the SDK.
+ *
+ * CHIPI (v29+) and SHHH V8.4 both embed the sessions component. For SHHH the
+ * owner signature is built by the SDK only for STARK and ED25519 signers
+ * (`executeShhhSponsoredRaw`); a missing `signerKind` means STARK, the default
+ * for SDK-created SHHH wallets, including passkey-encrypted ones. READY (Argent
+ * X) has no sessions component.
+ */
+declare function walletSupportsSessions(wallet: {
+    walletType?: WalletType | string | null;
+    signerKind?: string | null;
+} | null | undefined): boolean;
+
 /**
  * Build a standards-compliant Starknet `StarknetWindowObject` backed by a Chipi
  * wallet. Framework-agnostic: all signing/execution/approval is injected via
@@ -115,9 +129,40 @@ declare function ChipiInjector({ children, ...config }: ChipiInjectorProps): Rea
  * (MetaMask connect, passkey enrollment, Apple Sign In) is intentionally
  * out of scope: caller computes `newOwner` upstream and passes it in.
  */
+/**
+ * Every user-facing string `<Recover />` renders. The built-in defaults are
+ * English developer copy — **not** end-user-ready (they say "timelock",
+ * "add-owner", etc.). Consumer apps MUST override these with their own
+ * localized, jargon-free copy (e.g. via next-intl). Pass a partial; unset
+ * fields fall back to `DEFAULT_RECOVER_LABELS`.
+ */
+interface RecoverLabels {
+    proposeAddDevice: string;
+    proposeRecovery: string;
+    executeAddDevice: string;
+    executeRecovery: string;
+    timelockAddDevice: string;
+    timelockRecovery: string;
+    submitting: string;
+    /** Formats the live countdown. Receives whole seconds remaining. */
+    secondsRemaining: (secondsRemaining: number) => string;
+    cancel: string;
+    timelockElapsed: string;
+    cancelling: string;
+    doneAddDevice: string;
+    doneRecovery: string;
+}
+/** Developer-facing English defaults. Override for real users. */
+declare const DEFAULT_RECOVER_LABELS: RecoverLabels;
 interface RecoverProps {
     /** Which flow this component renders. */
     mode: "add-device" | "guardian-recovery";
+    /**
+     * Override any/all user-facing strings. The defaults are developer English
+     * with protocol jargon and are unsuitable for end users — supply localized,
+     * job-named copy here (see `RecoverLabels`).
+     */
+    labels?: Partial<RecoverLabels>;
     /** The SHHH wallet being modified. */
     walletAddress: bigint | string;
     /**
@@ -170,4 +215,4 @@ interface RecoverProps {
 }
 declare function Recover(props: RecoverProps): React.ReactElement;
 
-export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext };
+export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, DEFAULT_RECOVER_LABELS, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverLabels, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext, walletSupportsSessions };