@embarkai/ui-kit 0.1.5 → 0.2.0

package/dist/index.d.ts

@@ -136,7 +136,6 @@ declare function useTokenBalance(tokenAddress: `0x${string}`, userAddress?: `0x$
 declare global {
     interface Window {
         __EMBARK_SERVICES__?: Partial<{
-            bundlerUrl: string;
             tssUrl: string;
             shareVaultUrl: string;
             tssRequireWasm: boolean;
@@ -184,6 +183,7 @@ interface WatchToken {
     /** Logo URL (optional) */
     logo?: string;
 }
+type WalletMode = 'linked' | 'direct' | 'both';
 interface ProviderConfig {
     projectId: string;
     passkey: {
@@ -206,6 +206,10 @@ interface ProviderConfig {
         supportedChains?: number[];
         requireSignature: boolean;
         walletConnectProjectId?: string;
+        /** Operating mode: 'linked' = AA (current), 'direct' = external wallet signs, 'both' = user choice */
+        mode?: WalletMode;
+        /** Filter RainbowKit wallet list. undefined = show all wallets */
+        allowedWallets?: string[];
     };
     preferedColorMode?: 'light' | 'dark';
     projectAssets?: {
@@ -254,7 +258,6 @@ interface ProviderConfig {
         forceChain?: boolean;
     };
     services: {
-        bundlerUrl: string;
         tssUrl: string;
         shareVaultUrl: string;
         iframeUrl?: string;
@@ -897,6 +900,8 @@ interface SessionState {
     viemChain: Chain | null;
     /** Tracks if user explicitly selected a chain (vs using dApp config default) */
     walletReadyStatus: WalletReadyStatus | null;
+    /** Whether zustand persist has finished hydrating from localStorage */
+    hasHydrated: boolean;
     setUsePaymaster: (usePaymaster: boolean) => void;
     setIsIframeReady: (ready: boolean) => void;
     setSession: (s: AccountSession | null) => void;
@@ -932,6 +937,11 @@ declare const useSession: zustand.UseBoundStore<Omit<zustand.StoreApi<SessionSta
         }, unknown>>;
     };
 }>;
+/**
+ * Wait for zustand persist hydration to complete.
+ * Use in async functions to ensure activeChainId and other persisted state is available.
+ */
+declare function waitForStoreHydration(): Promise<void>;
 /**
  * Require active chain ID from session store (for non-React usage)
  * Throws an error if the chain ID is not yet set (e.g., before store hydration)
@@ -974,6 +984,7 @@ declare const useLoadingStatus: () => {
 declare const useRecoveryUserId: () => string;
 declare const useHasServerVault: () => boolean;
 declare const useActiveChainId: () => number;
+declare const useHydrated: () => boolean;
 
 declare enum PageKey {
     AUTH = "auth",
@@ -1203,6 +1214,75 @@ interface UseErc3643ComplianceResult {
  */
 declare function useErc3643Compliance(options: UseErc3643ComplianceOptions): UseErc3643ComplianceResult;
 
+interface UseWalletModeReturn {
+    /** Currently configured mode from provider config */
+    configMode: WalletMode;
+    /** Currently active mode (relevant when configMode='both') */
+    activeMode: WalletMode;
+    /** Switch active mode (only works when configMode='both') */
+    switchMode: (mode: 'linked' | 'direct') => void;
+    /** Whether the current active mode uses direct EOA signing */
+    isDirect: boolean;
+}
+declare function useWalletMode(): UseWalletModeReturn;
+
+interface UseDirectWalletReturn {
+    /** Connected external wallet address */
+    address: `0x${string}` | null;
+    /** Chain ID the external wallet is on */
+    chainId: number | null;
+    /** Whether external wallet is connected */
+    isConnected: boolean;
+    /** Wallet connector name (e.g. 'MetaMask') */
+    connectorName: string | null;
+    /** Connect + link: opens RainbowKit modal, signs, calls linkWallet API */
+    connect: () => void;
+    /** Reconnect only: opens RainbowKit modal to restore wagmi session (no re-linking) */
+    reconnect: () => void;
+    /** Disconnect the external wallet */
+    disconnect: () => void;
+}
+declare function useDirectWallet(): UseDirectWalletReturn;
+
+interface DirectTransactionParams {
+    to: `0x${string}`;
+    /** Amount in human-readable native currency units (e.g. '1.5' for 1.5 ETH), not wei */
+    value: string;
+    data?: `0x${string}`;
+    chainId?: number;
+}
+interface UseSendDirectTransactionReturn {
+    sendTransaction: (params: DirectTransactionParams) => Promise<`0x${string}` | null>;
+    isPending: boolean;
+    error: string | null;
+    txHash: `0x${string}` | null;
+    reset: () => void;
+}
+declare function useSendDirectTransaction(): UseSendDirectTransactionReturn;
+
+interface TransferToLinkedParams {
+    /** Token contract address, or 'native' for native currency */
+    token: `0x${string}` | 'native';
+    /** Human-readable amount (e.g. '1.5', '1000') */
+    amount: string;
+    /** Chain ID — transfer only works within same chain */
+    chainId: number;
+    /** Token decimals (default: 18). Required for ERC20 tokens */
+    decimals?: number;
+    /** Target linked wallet address. If omitted, uses first linked wallet */
+    toAddress?: `0x${string}`;
+}
+interface UseTransferToLinkedReturn {
+    transfer: (params: TransferToLinkedParams) => Promise<string | null>;
+    isPending: boolean;
+    error: string | null;
+    userOpHash: string | null;
+    /** List of linked wallet addresses from profile */
+    linkedWallets: `0x${string}`[];
+    reset: () => void;
+}
+declare function useTransferToLinkedWallet(): UseTransferToLinkedReturn;
+
 interface UseLogoutReturn {
     logout: () => Promise<void>;
 }
@@ -1718,126 +1798,126 @@ declare function useTransactions(): {
         input: viem.Hex;
         s: viem.Hex;
         value: bigint;
+        hash: Hash$1;
+        v: bigint;
+        r: viem.Hex;
         type: "legacy";
-        yParity?: undefined;
+        to: viem.Address | null;
         from: viem.Address;
         gas: bigint;
-        hash: Hash$1;
         nonce: number;
-        r: viem.Hex;
-        to: viem.Address | null;
-        typeHex: viem.Hex | null;
-        v: bigint;
-        accessList?: undefined;
-        authorizationList?: undefined;
         blobVersionedHashes?: undefined;
-        chainId?: number;
         gasPrice: bigint;
         maxFeePerBlobGas?: undefined;
         maxFeePerGas?: undefined;
         maxPriorityFeePerGas?: undefined;
-        blockHash: `0x${string}`;
+        accessList?: undefined;
+        authorizationList?: undefined;
+        yParity?: undefined;
+        typeHex: viem.Hex | null;
+        chainId?: number;
         blockNumber: bigint;
+        blockHash: `0x${string}`;
         transactionIndex: number;
     } | {
         input: viem.Hex;
         s: viem.Hex;
         value: bigint;
+        hash: Hash$1;
+        v: bigint;
+        r: viem.Hex;
         type: "eip2930";
-        yParity: number;
+        to: viem.Address | null;
         from: viem.Address;
         gas: bigint;
-        hash: Hash$1;
         nonce: number;
-        r: viem.Hex;
-        to: viem.Address | null;
-        typeHex: viem.Hex | null;
-        v: bigint;
-        accessList: viem.AccessList;
-        authorizationList?: undefined;
         blobVersionedHashes?: undefined;
-        chainId: number;
         gasPrice: bigint;
         maxFeePerBlobGas?: undefined;
         maxFeePerGas?: undefined;
         maxPriorityFeePerGas?: undefined;
-        blockHash: `0x${string}`;
+        accessList: viem.AccessList;
+        authorizationList?: undefined;
+        yParity: number;
+        typeHex: viem.Hex | null;
+        chainId: number;
         blockNumber: bigint;
+        blockHash: `0x${string}`;
         transactionIndex: number;
     } | {
         input: viem.Hex;
         s: viem.Hex;
         value: bigint;
+        hash: Hash$1;
+        v: bigint;
+        r: viem.Hex;
         type: "eip1559";
-        yParity: number;
+        to: viem.Address | null;
         from: viem.Address;
         gas: bigint;
-        hash: Hash$1;
         nonce: number;
-        r: viem.Hex;
-        to: viem.Address | null;
-        typeHex: viem.Hex | null;
-        v: bigint;
-        accessList: viem.AccessList;
-        authorizationList?: undefined;
         blobVersionedHashes?: undefined;
-        chainId: number;
         gasPrice?: undefined;
         maxFeePerBlobGas?: undefined;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        blockHash: `0x${string}`;
+        accessList: viem.AccessList;
+        authorizationList?: undefined;
+        yParity: number;
+        typeHex: viem.Hex | null;
+        chainId: number;
         blockNumber: bigint;
+        blockHash: `0x${string}`;
         transactionIndex: number;
     } | {
         input: viem.Hex;
         s: viem.Hex;
         value: bigint;
+        hash: Hash$1;
+        v: bigint;
+        r: viem.Hex;
         type: "eip4844";
-        yParity: number;
+        to: viem.Address | null;
         from: viem.Address;
         gas: bigint;
-        hash: Hash$1;
         nonce: number;
-        r: viem.Hex;
-        to: viem.Address | null;
-        typeHex: viem.Hex | null;
-        v: bigint;
-        accessList: viem.AccessList;
-        authorizationList?: undefined;
         blobVersionedHashes: readonly viem.Hex[];
-        chainId: number;
         gasPrice?: undefined;
         maxFeePerBlobGas: bigint;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        blockHash: `0x${string}`;
+        accessList: viem.AccessList;
+        authorizationList?: undefined;
+        yParity: number;
+        typeHex: viem.Hex | null;
+        chainId: number;
         blockNumber: bigint;
+        blockHash: `0x${string}`;
         transactionIndex: number;
     } | {
         input: viem.Hex;
         s: viem.Hex;
         value: bigint;
+        hash: Hash$1;
+        v: bigint;
+        r: viem.Hex;
         type: "eip7702";
-        yParity: number;
+        to: viem.Address | null;
         from: viem.Address;
         gas: bigint;
-        hash: Hash$1;
         nonce: number;
-        r: viem.Hex;
-        to: viem.Address | null;
-        typeHex: viem.Hex | null;
-        v: bigint;
-        accessList: viem.AccessList;
-        authorizationList: viem.SignedAuthorizationList;
         blobVersionedHashes?: undefined;
-        chainId: number;
         gasPrice?: undefined;
         maxFeePerBlobGas?: undefined;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        blockHash: `0x${string}`;
+        accessList: viem.AccessList;
+        authorizationList: viem.SignedAuthorizationList;
+        yParity: number;
+        typeHex: viem.Hex | null;
+        chainId: number;
         blockNumber: bigint;
+        blockHash: `0x${string}`;
         transactionIndex: number;
     }>;
     getTransactionReceipt: (hash: Hash$1) => Promise<TransactionReceipt>;
@@ -1864,126 +1944,126 @@ declare function useSmartAccountTransactions(): {
             input: viem.Hex;
             s: viem.Hex;
             value: bigint;
+            hash: Hash$1;
+            v: bigint;
+            r: viem.Hex;
             type: "legacy";
-            yParity?: undefined;
+            to: viem.Address | null;
             from: viem.Address;
             gas: bigint;
-            hash: Hash$1;
             nonce: number;
-            r: viem.Hex;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
-            v: bigint;
-            accessList?: undefined;
-            authorizationList?: undefined;
             blobVersionedHashes?: undefined;
-            chainId?: number;
             gasPrice: bigint;
             maxFeePerBlobGas?: undefined;
             maxFeePerGas?: undefined;
             maxPriorityFeePerGas?: undefined;
-            blockHash: `0x${string}`;
+            accessList?: undefined;
+            authorizationList?: undefined;
+            yParity?: undefined;
+            typeHex: viem.Hex | null;
+            chainId?: number;
             blockNumber: bigint;
+            blockHash: `0x${string}`;
             transactionIndex: number;
         } | {
             input: viem.Hex;
             s: viem.Hex;
             value: bigint;
+            hash: Hash$1;
+            v: bigint;
+            r: viem.Hex;
             type: "eip2930";
-            yParity: number;
+            to: viem.Address | null;
             from: viem.Address;
             gas: bigint;
-            hash: Hash$1;
             nonce: number;
-            r: viem.Hex;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
-            v: bigint;
-            accessList: viem.AccessList;
-            authorizationList?: undefined;
             blobVersionedHashes?: undefined;
-            chainId: number;
             gasPrice: bigint;
             maxFeePerBlobGas?: undefined;
             maxFeePerGas?: undefined;
             maxPriorityFeePerGas?: undefined;
-            blockHash: `0x${string}`;
+            accessList: viem.AccessList;
+            authorizationList?: undefined;
+            yParity: number;
+            typeHex: viem.Hex | null;
+            chainId: number;
             blockNumber: bigint;
+            blockHash: `0x${string}`;
             transactionIndex: number;
         } | {
             input: viem.Hex;
             s: viem.Hex;
             value: bigint;
+            hash: Hash$1;
+            v: bigint;
+            r: viem.Hex;
             type: "eip1559";
-            yParity: number;
+            to: viem.Address | null;
             from: viem.Address;
             gas: bigint;
-            hash: Hash$1;
             nonce: number;
-            r: viem.Hex;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
-            v: bigint;
-            accessList: viem.AccessList;
-            authorizationList?: undefined;
             blobVersionedHashes?: undefined;
-            chainId: number;
             gasPrice?: undefined;
             maxFeePerBlobGas?: undefined;
             maxFeePerGas: bigint;
             maxPriorityFeePerGas: bigint;
-            blockHash: `0x${string}`;
+            accessList: viem.AccessList;
+            authorizationList?: undefined;
+            yParity: number;
+            typeHex: viem.Hex | null;
+            chainId: number;
             blockNumber: bigint;
+            blockHash: `0x${string}`;
             transactionIndex: number;
         } | {
             input: viem.Hex;
             s: viem.Hex;
             value: bigint;
+            hash: Hash$1;
+            v: bigint;
+            r: viem.Hex;
             type: "eip4844";
-            yParity: number;
+            to: viem.Address | null;
             from: viem.Address;
             gas: bigint;
-            hash: Hash$1;
             nonce: number;
-            r: viem.Hex;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
-            v: bigint;
-            accessList: viem.AccessList;
-            authorizationList?: undefined;
             blobVersionedHashes: readonly viem.Hex[];
-            chainId: number;
             gasPrice?: undefined;
             maxFeePerBlobGas: bigint;
             maxFeePerGas: bigint;
             maxPriorityFeePerGas: bigint;
-            blockHash: `0x${string}`;
+            accessList: viem.AccessList;
+            authorizationList?: undefined;
+            yParity: number;
+            typeHex: viem.Hex | null;
+            chainId: number;
             blockNumber: bigint;
+            blockHash: `0x${string}`;
             transactionIndex: number;
         } | {
             input: viem.Hex;
             s: viem.Hex;
             value: bigint;
+            hash: Hash$1;
+            v: bigint;
+            r: viem.Hex;
             type: "eip7702";
-            yParity: number;
+            to: viem.Address | null;
             from: viem.Address;
             gas: bigint;
-            hash: Hash$1;
             nonce: number;
-            r: viem.Hex;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
-            v: bigint;
-            accessList: viem.AccessList;
-            authorizationList: viem.SignedAuthorizationList;
             blobVersionedHashes?: undefined;
-            chainId: number;
             gasPrice?: undefined;
             maxFeePerBlobGas?: undefined;
             maxFeePerGas: bigint;
             maxPriorityFeePerGas: bigint;
-            blockHash: `0x${string}`;
+            accessList: viem.AccessList;
+            authorizationList: viem.SignedAuthorizationList;
+            yParity: number;
+            typeHex: viem.Hex | null;
+            chainId: number;
             blockNumber: bigint;
+            blockHash: `0x${string}`;
             transactionIndex: number;
         };
         receipt: viem.TransactionReceipt;
@@ -2689,4 +2769,4 @@ declare function combineI18NResources(...resourses: TranslationResources[]): Tra
 declare function getAvailableLanguages(resourses: TranslationResources): string[];
 declare function getLanguageIcon(languageKey: string): string | null;
 
-export { AccountAbstractionError, type AccountSession, Address, type AddressProps, type Asset, type CallbacksConfig, ConnectWalletButton, type ConnectWalletButtonProps, ErrorCodes, type FingerprintVerificationResult, Hash, type HashProps, KeyshareBackupMenu as KeyshareBackup, LOCAL_STORAGE_I18N_KEY, LangToggle, type NicknameAvailability, type NicknameAvatar, type NicknameChangeResult, type NicknameInfo, type NicknameResolution, type NicknameResolveRequest, type NicknameResolvedTarget, type NicknameValidationResult, PASSPORT_TRANSLATIONS, PageKey, type PageOpenParams, Provider, type ProviderConfig, type ProviderDetail, type ProviderProps, type RegisterSmartAccountResult, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type SmartAccountEntry, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseErc3643ComplianceOptions, type UseErc3643ComplianceResult, type UseLogoutReturn, type UseNicknameResolveOptions, type UseNicknameResolveResult, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserOperationByHash, type UserOperationReceipt, UserOperationTimeoutError, type UserProfile, UserRejectedError, type WaitForReceiptOptions, type WalletReadyStatus, type WatchToken, combineI18NResources, createAccountAbstractionError, deployAccount, destroyIframeManager, generateFingerprint, getAllSmartAccounts, getAvailableLanguages, getIframeManager, getLanguageIcon, getSmartAccountForChain, getUserOperationByHash, getUserOperationReceipt, getUserProfile, looksLikeNickname, prepareUserOperation, requireActiveChainId, sendUserOperation, signTypedData, updateUserProfile, useAccountSession, useActiveChainId, useAddress, useAssets, useBalance, useColorMode, useErc3643Compliance, useError, useHasServerVault, useIFrameReady, useIsMobileView, useLinkedProfiles, useLoadingStatus, useLogout, useNicknameResolve, useOpenPage, useProviderConfig, useRecoveryUserId, useSendTransaction, useSession, useSmartAccountTransactions, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, verifyFingerprint, verifyFingerprintDetailed, wagmiConfig, waitForUserOperationReceipt };
+export { AccountAbstractionError, type AccountSession, Address, type AddressProps, type Asset, type CallbacksConfig, ConnectWalletButton, type ConnectWalletButtonProps, type DirectTransactionParams, ErrorCodes, type FingerprintVerificationResult, Hash, type HashProps, KeyshareBackupMenu as KeyshareBackup, LOCAL_STORAGE_I18N_KEY, LangToggle, type NicknameAvailability, type NicknameAvatar, type NicknameChangeResult, type NicknameInfo, type NicknameResolution, type NicknameResolveRequest, type NicknameResolvedTarget, type NicknameValidationResult, PASSPORT_TRANSLATIONS, PageKey, type PageOpenParams, Provider, type ProviderConfig, type ProviderDetail, type ProviderProps, type RegisterSmartAccountResult, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type SmartAccountEntry, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type TransferToLinkedParams, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseDirectWalletReturn, type UseErc3643ComplianceOptions, type UseErc3643ComplianceResult, type UseLogoutReturn, type UseNicknameResolveOptions, type UseNicknameResolveResult, type UseSendDirectTransactionReturn, type UseSendTransactionReturn, type UseTransferToLinkedReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UseWalletModeReturn, type UserOpMempool, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserOperationByHash, type UserOperationReceipt, UserOperationTimeoutError, type UserProfile, UserRejectedError, type WaitForReceiptOptions, type WalletMode, type WalletReadyStatus, type WatchToken, combineI18NResources, createAccountAbstractionError, deployAccount, destroyIframeManager, generateFingerprint, getAllSmartAccounts, getAvailableLanguages, getIframeManager, getLanguageIcon, getSmartAccountForChain, getUserOperationByHash, getUserOperationReceipt, getUserProfile, looksLikeNickname, prepareUserOperation, requireActiveChainId, sendUserOperation, signTypedData, updateUserProfile, useAccountSession, useActiveChainId, useAddress, useAssets, useBalance, useColorMode, useDirectWallet, useErc3643Compliance, useError, useHasServerVault, useHydrated, useIFrameReady, useIsMobileView, useLinkedProfiles, useLoadingStatus, useLogout, useNicknameResolve, useOpenPage, useProviderConfig, useRecoveryUserId, useSendDirectTransaction, useSendTransaction, useSession, useSmartAccountTransactions, useTokenBalance, useTokenInfo, useTransactions, useTransferToLinkedWallet, useUserOpStatus, useWalletMode, verifyFingerprint, verifyFingerprintDetailed, wagmiConfig, waitForStoreHydration, waitForUserOperationReceipt };