@naculus/connect-appkit-react 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import * as _naculus_connect_core from '@naculus/connect-core';
-import { UniversalWalletSession, SentDelegation, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyManagerConfig, SessionKeyInfo, SessionKeyScope, SessionKeyTransaction, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Hex, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
+import { UniversalWalletSession, SessionStorage, SentDelegation, SolanaSessionKeyInfo, SolanaSessionKeyScope, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyManagerConfig, SessionKeyInfo, SessionKeyScope, SessionKeyTransaction, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Hex, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
 export { LAMPORTS_PER_SOL, PassphraseCancelledError, PassphraseGate, PassphraseIntent, PassphraseRequest, SolanaBalance, SolanaConfirmationStatus, SolanaRpcError, formatSol, getLatestBlockhash, getSignatureStatus, getSolanaBalance, parseSol } from '@naculus/connect-core';
 import { PocketConfig, WalletAccount, WalletNamespace, WalletData, StorageSecurityReport } from '@naculus/connector-embedded';
 export { StorageSecurityFinding, StorageSecurityReport, WalletAccount, WalletData, WalletNamespace } from '@naculus/connector-embedded';
 import * as _naculus_connect_appkit_core from '@naculus/connect-appkit-core';
-import { CompareCostsInput, CostComparison, CompareCosts, ExecuteRouteError, ExecuteRouteOptions, ExecutableQuote, ExecuteRouteResult, ExecuteRoute, RouteQuote, RouteQuoteOptions, RouteQuoteInput, GetRouteQuotes, Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, PolicyExecutionAdapter, DelegationPolicyPreview, PolicyExecutionSubmission, NotificationSettingsStorage, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer, AddressValidationLevel } from '@naculus/connect-appkit-core';
+import { CompareCostsInput, CostComparison, CompareCosts, ExecuteRouteError, ExecuteRouteOptions, ExecutableQuote, ExecuteRouteResult, ExecuteRoute, RouteQuote, RouteQuoteOptions, RouteQuoteInput, GetRouteQuotes, Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, PaymentFetch, PaymentRecord, SolanaSessionKeyFlowDeps, PolicyExecutionAdapter, DelegationTypedData, DelegationPolicyPreview, PolicyExecutionSubmission, NotificationSettingsStorage, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer, AddressValidationLevel } from '@naculus/connect-appkit-core';
 export { AddressValidationLevel, AtomicSupport, ChainCapabilities, ChainInfo, ConnectionStatus, CostComparison, CostComparisonOperation, CostComparisonOptions, DelegationPolicyPreview, ExecuteRouteResult, PolicyExecutionAdapter, PolicyExecutionCheck, PolicyExecutionRoute, PolicyExecutionSubmission, PreparedPolicyExecution, SolanaIdentity, SolanaPayer, SolanaRoles, SolanaRolesAbsence, SolanaSigner, SolanaWalletFeatures, WalletChain, Web3State, buildDelegationPolicyMessage } from '@naculus/connect-appkit-core';
-import { Web3Client } from './client.cjs';
+import { NativeWalletConnectOptions, InjectedProviderRegistration, Web3Client } from './client.cjs';
 export { ClientConfig, clearClient, createClient, getClient } from './client.cjs';
 import { Address, PublicClient, WalletClient } from 'viem';
 import { SimulationResult } from '@naculus/wallet-engine';
@@ -193,6 +193,17 @@ interface Web3ConnectConfig {
      * When omitted, existing backward-compatible plaintext storage is used.
      */
     encryptionKey?: string;
+    /**
+     * Where the connected session persists. Defaults to localStorage; React
+     * Native supplies an AsyncStorage-backed one (`@naculus/connect-native`).
+     */
+    sessionStorage?: SessionStorage;
+    /** See `ClientConfig.walletConnect`. */
+    walletConnect?: NativeWalletConnectOptions;
+    /** See `ClientConfig.solanaWallets`. */
+    solanaWallets?: readonly unknown[];
+    /** See `ClientConfig.injectedProviders`. */
+    injectedProviders?: readonly InjectedProviderRegistration[];
 }
 interface Web3Actions {
     startPairing: () => Promise<string>;
@@ -342,6 +353,53 @@ interface UseDelegateReturn {
  */
 declare function useDelegate(options: UseDelegateOptions): UseDelegateReturn;
 
+interface UsePaymentFetchReturn {
+    /** Fetch through the paying fetch; resolves to its full result. */
+    payFetch: PaymentFetch;
+    /** True while any request is in flight. */
+    isPending: boolean;
+    /**
+     * The most recently completed payment. Every paid request is recorded, in
+     * completion order, until `reset()`.
+     */
+    lastPayment: PaymentRecord | null;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * State around a caller-owned paying fetch — `createX402Fetch`
+ * (`@naculus/payments-x402`) or `createMppFetch` (`@naculus/payments-mpp`),
+ * built with the session key and limits the app chooses. What may be paid is
+ * decided there and by the session key's policy, not here.
+ */
+declare function usePaymentFetch(pay: PaymentFetch): UsePaymentFetchReturn;
+
+interface UseSolanaSessionKeyReturn {
+    /** The connected owner's keys, newest first. */
+    keys: SolanaSessionKeyInfo[];
+    /** Create a key; the owner's wallet approves it once. */
+    create: (scope: SolanaSessionKeyScope) => Promise<{
+        key: SolanaSessionKeyInfo;
+        signature: string;
+    }>;
+    /** Stop a key; the owner's wallet signs the on-chain Revoke. */
+    revoke: (id: string) => Promise<{
+        signature: string;
+    }>;
+    refresh: () => Promise<void>;
+    isPending: boolean;
+    error: Error | null;
+}
+/**
+ * Solana session keys that pay x402 / MPP without a prompt (pass
+ * `{ sessionKey: { manager, id }, rpc }` to the paying fetch). The app owns
+ * the `SolanaSessionKeyManager` and the RPC; `owner` is the connected
+ * wallet's Solana signer role. Keep `manager`, `rpc` and `owner` stable
+ * (module scope or `useMemo`): a new object each render rebuilds the flow
+ * and refetches the keys every render.
+ */
+declare function useSolanaSessionKey(deps: SolanaSessionKeyFlowDeps | null): UseSolanaSessionKeyReturn;
+
 interface UseDelegationReturn extends DelegationStatus {
     isFetching: boolean;
     error: Error | null;
@@ -436,6 +494,14 @@ interface UseDelegationPolicyOptions {
     origin?: string;
     /** Concrete AA-module or EIP-7702 executor for promptless submissions. */
     adapter?: PolicyExecutionAdapter;
+    /**
+     * For `eip7702` policies: the wallet's EIP-712 signer. `message.salt` is a
+     * decimal string (JSON-safe, as `eth_signTypedData_v4` takes it); for viem's
+     * `signTypedData`, pass `{ ...t, message: { ...t.message, salt: BigInt(t.message.salt) } }`.
+     */
+    signTypedData?: (typedData: DelegationTypedData) => Promise<string>;
+    /** For `eip7702` policies: the connected EVM chain number. */
+    chainId?: number | null;
 }
 interface UseDelegationPolicyReturn {
     policies: SessionKeyInfo[];
@@ -2047,4 +2113,4 @@ declare const AppkitToggleGroup: StencilReactComponent<AppkitToggleGroup$1, Appk
 type AppkitTooltipEvents = NonNullable<unknown>;
 declare const AppkitTooltip: StencilReactComponent<AppkitTooltip$1, AppkitTooltipEvents, Components.AppkitTooltip>;
 
-export { type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, DEFAULT_EVM_CHAINS, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecutionPreview, type ExecutionRoute, type Locale, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegateOptions, type UseDelegateReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegate, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };
+export { type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, DEFAULT_EVM_CHAINS, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecutionPreview, type ExecutionRoute, InjectedProviderRegistration, type Locale, NativeWalletConnectOptions, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegateOptions, type UseDelegateReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UsePaymentFetchReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaSessionKeyReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegate, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, usePaymentFetch, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaSessionKey, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import * as _naculus_connect_core from '@naculus/connect-core';
-import { UniversalWalletSession, SentDelegation, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyManagerConfig, SessionKeyInfo, SessionKeyScope, SessionKeyTransaction, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Hex, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
+import { UniversalWalletSession, SessionStorage, SentDelegation, SolanaSessionKeyInfo, SolanaSessionKeyScope, DelegationStatus, ExecutionPlan, AtomicityRequirement, BatchCall, SessionKeyManagerConfig, SessionKeyInfo, SessionKeyScope, SessionKeyTransaction, TokenConfig, NameResolverConfig, NameResult, InAppChannel, NotificationItem, NotificationSettings, PassphraseRequest, PassphraseGate, AddressResult, ExecutionStrategy, CallsStatus, Address as Address$1, Hex, Call, SendUserOpOptions, UserOperationResponse, UserOperationReceipt, ActiveSessionBundle, ChainSession, SmartAccountInfo, SolanaBalance, SolanaConfirmationStatus, SessionManager, TokenListSource, TokenListEntry, TokenSearchResult } from '@naculus/connect-core';
 export { LAMPORTS_PER_SOL, PassphraseCancelledError, PassphraseGate, PassphraseIntent, PassphraseRequest, SolanaBalance, SolanaConfirmationStatus, SolanaRpcError, formatSol, getLatestBlockhash, getSignatureStatus, getSolanaBalance, parseSol } from '@naculus/connect-core';
 import { PocketConfig, WalletAccount, WalletNamespace, WalletData, StorageSecurityReport } from '@naculus/connector-embedded';
 export { StorageSecurityFinding, StorageSecurityReport, WalletAccount, WalletData, WalletNamespace } from '@naculus/connector-embedded';
 import * as _naculus_connect_appkit_core from '@naculus/connect-appkit-core';
-import { CompareCostsInput, CostComparison, CompareCosts, ExecuteRouteError, ExecuteRouteOptions, ExecutableQuote, ExecuteRouteResult, ExecuteRoute, RouteQuote, RouteQuoteOptions, RouteQuoteInput, GetRouteQuotes, Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, PolicyExecutionAdapter, DelegationPolicyPreview, PolicyExecutionSubmission, NotificationSettingsStorage, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer, AddressValidationLevel } from '@naculus/connect-appkit-core';
+import { CompareCostsInput, CostComparison, CompareCosts, ExecuteRouteError, ExecuteRouteOptions, ExecutableQuote, ExecuteRouteResult, ExecuteRoute, RouteQuote, RouteQuoteOptions, RouteQuoteInput, GetRouteQuotes, Web3State, WalletChain, ChainCapabilities, AtomicSupport, ChainInfo, PaymentFetch, PaymentRecord, SolanaSessionKeyFlowDeps, PolicyExecutionAdapter, DelegationTypedData, DelegationPolicyPreview, PolicyExecutionSubmission, NotificationSettingsStorage, SolanaRoles, SolanaRolesAbsence, SolanaIdentity, SolanaSigner, SolanaPayer, AddressValidationLevel } from '@naculus/connect-appkit-core';
 export { AddressValidationLevel, AtomicSupport, ChainCapabilities, ChainInfo, ConnectionStatus, CostComparison, CostComparisonOperation, CostComparisonOptions, DelegationPolicyPreview, ExecuteRouteResult, PolicyExecutionAdapter, PolicyExecutionCheck, PolicyExecutionRoute, PolicyExecutionSubmission, PreparedPolicyExecution, SolanaIdentity, SolanaPayer, SolanaRoles, SolanaRolesAbsence, SolanaSigner, SolanaWalletFeatures, WalletChain, Web3State, buildDelegationPolicyMessage } from '@naculus/connect-appkit-core';
-import { Web3Client } from './client.js';
+import { NativeWalletConnectOptions, InjectedProviderRegistration, Web3Client } from './client.js';
 export { ClientConfig, clearClient, createClient, getClient } from './client.js';
 import { Address, PublicClient, WalletClient } from 'viem';
 import { SimulationResult } from '@naculus/wallet-engine';
@@ -193,6 +193,17 @@ interface Web3ConnectConfig {
      * When omitted, existing backward-compatible plaintext storage is used.
      */
     encryptionKey?: string;
+    /**
+     * Where the connected session persists. Defaults to localStorage; React
+     * Native supplies an AsyncStorage-backed one (`@naculus/connect-native`).
+     */
+    sessionStorage?: SessionStorage;
+    /** See `ClientConfig.walletConnect`. */
+    walletConnect?: NativeWalletConnectOptions;
+    /** See `ClientConfig.solanaWallets`. */
+    solanaWallets?: readonly unknown[];
+    /** See `ClientConfig.injectedProviders`. */
+    injectedProviders?: readonly InjectedProviderRegistration[];
 }
 interface Web3Actions {
     startPairing: () => Promise<string>;
@@ -342,6 +353,53 @@ interface UseDelegateReturn {
  */
 declare function useDelegate(options: UseDelegateOptions): UseDelegateReturn;
 
+interface UsePaymentFetchReturn {
+    /** Fetch through the paying fetch; resolves to its full result. */
+    payFetch: PaymentFetch;
+    /** True while any request is in flight. */
+    isPending: boolean;
+    /**
+     * The most recently completed payment. Every paid request is recorded, in
+     * completion order, until `reset()`.
+     */
+    lastPayment: PaymentRecord | null;
+    error: Error | null;
+    reset: () => void;
+}
+/**
+ * State around a caller-owned paying fetch — `createX402Fetch`
+ * (`@naculus/payments-x402`) or `createMppFetch` (`@naculus/payments-mpp`),
+ * built with the session key and limits the app chooses. What may be paid is
+ * decided there and by the session key's policy, not here.
+ */
+declare function usePaymentFetch(pay: PaymentFetch): UsePaymentFetchReturn;
+
+interface UseSolanaSessionKeyReturn {
+    /** The connected owner's keys, newest first. */
+    keys: SolanaSessionKeyInfo[];
+    /** Create a key; the owner's wallet approves it once. */
+    create: (scope: SolanaSessionKeyScope) => Promise<{
+        key: SolanaSessionKeyInfo;
+        signature: string;
+    }>;
+    /** Stop a key; the owner's wallet signs the on-chain Revoke. */
+    revoke: (id: string) => Promise<{
+        signature: string;
+    }>;
+    refresh: () => Promise<void>;
+    isPending: boolean;
+    error: Error | null;
+}
+/**
+ * Solana session keys that pay x402 / MPP without a prompt (pass
+ * `{ sessionKey: { manager, id }, rpc }` to the paying fetch). The app owns
+ * the `SolanaSessionKeyManager` and the RPC; `owner` is the connected
+ * wallet's Solana signer role. Keep `manager`, `rpc` and `owner` stable
+ * (module scope or `useMemo`): a new object each render rebuilds the flow
+ * and refetches the keys every render.
+ */
+declare function useSolanaSessionKey(deps: SolanaSessionKeyFlowDeps | null): UseSolanaSessionKeyReturn;
+
 interface UseDelegationReturn extends DelegationStatus {
     isFetching: boolean;
     error: Error | null;
@@ -436,6 +494,14 @@ interface UseDelegationPolicyOptions {
     origin?: string;
     /** Concrete AA-module or EIP-7702 executor for promptless submissions. */
     adapter?: PolicyExecutionAdapter;
+    /**
+     * For `eip7702` policies: the wallet's EIP-712 signer. `message.salt` is a
+     * decimal string (JSON-safe, as `eth_signTypedData_v4` takes it); for viem's
+     * `signTypedData`, pass `{ ...t, message: { ...t.message, salt: BigInt(t.message.salt) } }`.
+     */
+    signTypedData?: (typedData: DelegationTypedData) => Promise<string>;
+    /** For `eip7702` policies: the connected EVM chain number. */
+    chainId?: number | null;
 }
 interface UseDelegationPolicyReturn {
     policies: SessionKeyInfo[];
@@ -2047,4 +2113,4 @@ declare const AppkitToggleGroup: StencilReactComponent<AppkitToggleGroup$1, Appk
 type AppkitTooltipEvents = NonNullable<unknown>;
 declare const AppkitTooltip: StencilReactComponent<AppkitTooltip$1, AppkitTooltipEvents, Components.AppkitTooltip>;
 
-export { type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, DEFAULT_EVM_CHAINS, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecutionPreview, type ExecutionRoute, type Locale, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegateOptions, type UseDelegateReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegate, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };
+export { type AddressValidationResult, AppkitAccordion, type AppkitAccordionEvents, AppkitAccountButton, type AppkitAccountButtonEvents, AppkitAlertDialog, type AppkitAlertDialogEvents, AppkitAvatar, type AppkitAvatarEvents, AppkitBadge, type AppkitBadgeEvents, AppkitButton, type AppkitButtonEvents, AppkitCard, AppkitCardContent, type AppkitCardContentEvents, AppkitCardDescription, type AppkitCardDescriptionEvents, type AppkitCardEvents, AppkitCardFooter, type AppkitCardFooterEvents, AppkitCardHeader, type AppkitCardHeaderEvents, AppkitCardTitle, type AppkitCardTitleEvents, AppkitCheckbox, type AppkitCheckboxEvents, AppkitCollapsible, type AppkitCollapsibleEvents, AppkitConnectButton, type AppkitConnectButtonEvents, AppkitDialog, type AppkitDialogEvents, AppkitDropdownMenu, type AppkitDropdownMenuEvents, AppkitInput, type AppkitInputEvents, AppkitPopover, type AppkitPopoverEvents, AppkitProgress, type AppkitProgressEvents, AppkitScrollArea, type AppkitScrollAreaEvents, AppkitSelect, type AppkitSelectEvents, AppkitSeparator, type AppkitSeparatorEvents, AppkitSkeleton, type AppkitSkeletonEvents, AppkitSwitch, type AppkitSwitchEvents, AppkitTabs, type AppkitTabsEvents, AppkitToggleGroup, type AppkitToggleGroupEvents, AppkitTooltip, type AppkitTooltipEvents, DEFAULT_EVM_CHAINS, type EmbeddedWalletAccountView, type EmbeddedWalletView, type EvmTransaction, type ExecuteError, type ExecuteOptions, type ExecutionPreview, type ExecutionRoute, InjectedProviderRegistration, type Locale, NativeWalletConnectOptions, type Quote, type QuoteOptions, type SIWxConfig, type SendCallsStatus, type TokenBalanceResult, type TokenInfo, TokenSelector, type TokenSelectorProps, TxMonitorContext, type TxMonitorLike, type TxStatus, type TxStatusEntry, type UseCapabilitiesReturn, type UseCompareCostsInput, type UseCompareCostsReturn, type UseCreateSessionKeyReturn, type UseDelegateOptions, type UseDelegateReturn, type UseDelegationPolicyOptions, type UseDelegationPolicyReturn, type UseDelegationReturn, type UseERC20AllowanceOptions, type UseERC20AllowanceReturn, type UseERC20ApproveOptions, type UseERC20ApproveReturn, type UseERC20TransferOptions, type UseERC20TransferReturn, type UseERC20TransferSimulationOptions, type UseERC20TransferSimulationReturn, type UseEmbeddedWalletReturn, type UseExecuteCallsOptions, type UseExecuteCallsReturn, type UseExecuteRouteReturn, type UseLastTxResult, type UseLookupAddressOptions, type UseLookupAddressResult, type UsePassphraseGateReturn, type UsePaymentFetchReturn, type UseResolveNameOptions, type UseResolveNameResult, type UseRevokeSessionReturn, type UseRouteQuoteInput, type UseRouteQuoteReturn, type UseSIWxLoginOptions, type UseSIWxLoginReturn, type UseSIWxSessionOptions, type UseSIWxSessionReturn, type UseSendUserOperationOptions, type UseSendUserOperationReturn, type UseSendWithSessionReturn, type UseSessionKeysReturn, type UseSessionReturn, type UseSignInWithEthereumOptions, type UseSignInWithEthereumReturn, type UseSignInWithXOptions, type UseSignInWithXReturn, type UseSimulateTransferOptions, type UseSimulateTransferReturn, type UseSiwxAuthSessionOptions, type UseSiwxAuthSessionReturn, type UseSmartAccountOptions, type UseSmartAccountReturn, type UseSolanaAccountReturn, type UseSolanaBalanceOptions, type UseSolanaBalanceReturn, type UseSolanaRolesReturn, type UseSolanaSessionKeyReturn, type UseSolanaTransactionReturn, type UseSwitchChainReturn, type UseTokenBalanceOptions, type UseTokenListOptions, type UseTokenListReturn, type UseTokenSearchReturn, type UseTransactionSimulationReturn, type UseTxHistoryResult, type UseTxMonitorResult, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseValidateDestinationOptions, type UseValidateDestinationReturn, type UseWalletReturn, type UseWeb3ErrorHandlerReturn, type UserFriendlyError, type UserOpStatus, WALLET_ERROR_DESCRIPTIONS, WALLET_ERROR_TITLES, type Web3Actions, Web3Client, type Web3ConnectConfig, Web3ConnectProvider, type Web3ConnectProviderProps, Web3Context, getChainById, getDefaultChains, getLocale, getUserFriendlyError, isRetryableError, resetSessionKeyManager, setLocale, t, useAccount, useBalance, useCapabilities, useChain, useCompareCosts, useConnect, useCreateSessionKey, useDelegate, useDelegation, useDelegationPolicy, useDisconnect, useERC20Allowance, useERC20Approve, useERC20Transfer, useERC20TransferSimulation, useEmbeddedWallet, useExecuteCalls, useExecuteRoute, useLastTx, useLookupAddress, useNotification, usePassphraseGate, usePaymentFetch, useResolveName, useRevokeSession, useRouteQuote, useSIWxLogin, useSIWxSession, useSendCalls, useSendTransaction, useSendUserOperation, useSendWithSession, useSession, useSessionKeys, useSignInWithEthereum, useSignInWithX, useSignMessage, useSimulateTransfer, useSiwxAuthSession, useSmartAccount, useSolanaAccount, useSolanaBalance, useSolanaRoles, useSolanaSessionKey, useSolanaTransaction, useSwitchChain, useTokenBalance, useTokenList, useTokenSearch, useTransactionSimulation, useTxHistory, useTxMonitor, useUserOpStatus, useValidateDestination, useViemClient, useWallet, useWeb3, useWeb3ErrorHandler, validateDestination };