@lumiapassport/ui-kit 1.9.2 → 1.10.0

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import React__default from 'react';
 import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as viem from 'viem';
-import { Chain, Hash as Hash$1, TransactionReceipt } from 'viem';
+import { Chain, Hash as Hash$1, TransactionReceipt, Address as Address$1, Hex } from 'viem';
 export { JwtTokens, LoginResponse, VerifyResponse, getValidTokens, jwtTokenManager, logout } from '@lumiapassport/core/auth';
 import * as wagmi from 'wagmi';
 import * as _tanstack_react_query from '@tanstack/react-query';
@@ -633,7 +633,7 @@ declare const wagmiConfig: wagmi.Config<readonly [viem.Chain], {
     [lumiaBeam.id]: viem.HttpTransport<undefined, false>;
 }, readonly wagmi.CreateConnectorFn[]>;
 
-interface Transaction {
+interface Transaction$1 {
     hash: Hash$1;
     from: string;
     to: string | null;
@@ -782,7 +782,7 @@ declare function useTransactions(): {
         transactionIndex: number;
     }>;
     getTransactionReceipt: (hash: Hash$1) => Promise<TransactionReceipt>;
-    getTransactionHistory: (address: `0x${string}`, limit?: number) => Promise<Transaction[]>;
+    getTransactionHistory: (address: `0x${string}`, limit?: number) => Promise<Transaction$1[]>;
     address: `0x${string}`;
     isConnected: boolean;
 };
@@ -1013,6 +1013,24 @@ declare function useLumiaPassportLinkedProfiles(): {
  * Implements postMessage protocol with HMAC authentication and replay protection
  */
 
+interface Transaction {
+    to: Address$1;
+    value: string;
+    data?: Hex;
+    gasLimit?: string;
+}
+interface IframeManagerConfig {
+    iframeUrl: string;
+    projectId: string;
+    debug?: boolean;
+    onWalletReady?: (status: WalletReadyStatus) => void;
+    themeColors?: {
+        background?: string;
+        text?: string;
+        textSecondary?: string;
+        border?: string;
+    };
+}
 interface WalletReadyStatus {
     ready: boolean;
     userId?: string;
@@ -1021,5 +1039,210 @@ interface WalletReadyStatus {
     hasSession: boolean;
     timestamp: number;
 }
+declare class IframeManager {
+    private iframe;
+    private iframeUrl;
+    private projectId;
+    private debug;
+    private sessionToken;
+    private isReady;
+    private readyPromise;
+    private readyResolve;
+    private onWalletReadyCallback?;
+    private themeColors?;
+    private pendingRequests;
+    private usedNonces;
+    private messageListener;
+    private readonly REQUEST_TIMEOUT;
+    private readonly NONCE_EXPIRY;
+    constructor(config: IframeManagerConfig);
+    /**
+     * Initialize iframe and wait for it to be ready
+     */
+    initialize(): Promise<void>;
+    /**
+     * Set the onWalletReady callback
+     */
+    setOnWalletReady(callback: (status: WalletReadyStatus) => void): void;
+    /**
+     * Authenticate SDK with iframe to establish session
+     */
+    private authenticateSDK;
+    /**
+     * Handle incoming postMessage events
+     */
+    private handleMessage;
+    /**
+     * Handle token refresh request from iframe
+     */
+    private handleTokenRefreshRequest;
+    /**
+     * Send secure message to iframe
+     */
+    private sendMessage;
+    /**
+     * Compute HMAC for message authentication
+     */
+    private computeHMAC;
+    /**
+     * Generate unique message ID
+     */
+    private generateMessageId;
+    /**
+     * Generate nonce for replay protection
+     */
+    private generateNonce;
+    /**
+     * Show iframe (for consent/confirmation UI)
+     */
+    showIframe(): void;
+    /**
+     * Hide iframe
+     */
+    hideIframe(): void;
+    /**
+     * Authenticate user with application
+     */
+    authenticate(userId: string): Promise<{
+        userId: string;
+        address: Address$1 | undefined;
+    }>;
+    /**
+     * Start DKG (Distributed Key Generation)
+     */
+    startDKG(userId: string, accessToken?: string): Promise<Address$1>;
+    /**
+     * Sign transaction
+     */
+    signTransaction(userId: string, transaction: Transaction, accessToken?: string): Promise<Hex>;
+    /**
+     * Sign EIP712 typed data
+     */
+    signTypedData(userId: string, typedData: {
+        domain: {
+            name?: string;
+            version?: string;
+            chainId?: number;
+            verifyingContract?: string;
+            salt?: string;
+        };
+        types: Record<string, Array<{
+            name: string;
+            type: string;
+        }>>;
+        primaryType: string;
+        message: Record<string, any>;
+    }, digest32: Hex, accessToken?: string): Promise<Hex>;
+    /**
+     * Get user's wallet address
+     */
+    getAddress(userId: string): Promise<Address$1 | undefined>;
+    /**
+     * Check if user has a keyshare
+     */
+    checkKeyshare(userId: string): Promise<{
+        hasKeyshare: boolean;
+        address?: Address$1;
+    }>;
+    /**
+     * Open social auth popup (Telegram, Discord, Twitter, etc.)
+     */
+    openSocialAuthPopup(provider: string, config?: Record<string, any>): Promise<{
+        provider: string;
+        success: boolean;
+        user?: any;
+        error?: string;
+    }>;
+    /**
+     * Get trusted apps for user
+     */
+    getTrustedApps(userId: string): Promise<Array<{
+        userId: string;
+        projectId: string;
+        origin: string;
+        trustedAt: number;
+    }>>;
+    /**
+     * Remove app from trusted list
+     */
+    removeTrustedApp(userId: string, projectId: string, origin: string): Promise<boolean>;
+    /**
+     * Create backup of keyshare
+     */
+    createBackup(userId: string, backupRequest: {
+        method: 'server' | 'cloud' | 'local';
+        password?: string;
+        cloudProvider?: string;
+    }, accessToken?: string): Promise<{
+        success: boolean;
+        method: string;
+        timestamp: number;
+        error?: string;
+    }>;
+    /**
+     * Restore keyshare from server backup
+     */
+    restoreFromServer(userId: string, password?: string, accessToken?: string): Promise<{
+        success: boolean;
+        timestamp: number;
+        error?: string;
+        data?: any;
+    }>;
+    /**
+     * Encrypt backup data without uploading (for cloud/local backups)
+     * Returns encrypted data that parent can upload/download
+     */
+    encryptBackupData(userId: string, password?: string): Promise<any>;
+    /**
+     * Restore keyshare from local file backup
+     */
+    restoreFromLocalFile(userId: string, fileContent: string, password?: string): Promise<{
+        success: boolean;
+        timestamp: number;
+        error?: string;
+        data?: any;
+    }>;
+    /**
+     * Get backup status for user
+     */
+    getBackupStatus(userId: string): Promise<{
+        server: {
+            lastBackup?: number;
+            error?: string;
+        };
+        cloud: {
+            lastBackup?: number;
+            error?: string;
+        };
+        local: {
+            lastBackup?: number;
+            error?: string;
+        };
+    }>;
+    /**
+     * Get available cloud providers
+     */
+    getCloudProviders(): Promise<Array<{
+        id: string;
+        name: string;
+        available: boolean;
+    }>>;
+    /**
+     * Cleanup and destroy iframe
+     */
+    destroy(): void;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+/**
+ * Get or create iframe manager singleton
+ */
+declare function getIframeManager(config?: IframeManagerConfig): IframeManager;
+/**
+ * Destroy iframe manager singleton
+ */
+declare function destroyIframeManager(): void;
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import React__default from 'react';
 import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as viem from 'viem';
-import { Chain, Hash as Hash$1, TransactionReceipt } from 'viem';
+import { Chain, Hash as Hash$1, TransactionReceipt, Address as Address$1, Hex } from 'viem';
 export { JwtTokens, LoginResponse, VerifyResponse, getValidTokens, jwtTokenManager, logout } from '@lumiapassport/core/auth';
 import * as wagmi from 'wagmi';
 import * as _tanstack_react_query from '@tanstack/react-query';
@@ -633,7 +633,7 @@ declare const wagmiConfig: wagmi.Config<readonly [viem.Chain], {
     [lumiaBeam.id]: viem.HttpTransport<undefined, false>;
 }, readonly wagmi.CreateConnectorFn[]>;
 
-interface Transaction {
+interface Transaction$1 {
     hash: Hash$1;
     from: string;
     to: string | null;
@@ -782,7 +782,7 @@ declare function useTransactions(): {
         transactionIndex: number;
     }>;
     getTransactionReceipt: (hash: Hash$1) => Promise<TransactionReceipt>;
-    getTransactionHistory: (address: `0x${string}`, limit?: number) => Promise<Transaction[]>;
+    getTransactionHistory: (address: `0x${string}`, limit?: number) => Promise<Transaction$1[]>;
     address: `0x${string}`;
     isConnected: boolean;
 };
@@ -1013,6 +1013,24 @@ declare function useLumiaPassportLinkedProfiles(): {
  * Implements postMessage protocol with HMAC authentication and replay protection
  */
 
+interface Transaction {
+    to: Address$1;
+    value: string;
+    data?: Hex;
+    gasLimit?: string;
+}
+interface IframeManagerConfig {
+    iframeUrl: string;
+    projectId: string;
+    debug?: boolean;
+    onWalletReady?: (status: WalletReadyStatus) => void;
+    themeColors?: {
+        background?: string;
+        text?: string;
+        textSecondary?: string;
+        border?: string;
+    };
+}
 interface WalletReadyStatus {
     ready: boolean;
     userId?: string;
@@ -1021,5 +1039,210 @@ interface WalletReadyStatus {
     hasSession: boolean;
     timestamp: number;
 }
+declare class IframeManager {
+    private iframe;
+    private iframeUrl;
+    private projectId;
+    private debug;
+    private sessionToken;
+    private isReady;
+    private readyPromise;
+    private readyResolve;
+    private onWalletReadyCallback?;
+    private themeColors?;
+    private pendingRequests;
+    private usedNonces;
+    private messageListener;
+    private readonly REQUEST_TIMEOUT;
+    private readonly NONCE_EXPIRY;
+    constructor(config: IframeManagerConfig);
+    /**
+     * Initialize iframe and wait for it to be ready
+     */
+    initialize(): Promise<void>;
+    /**
+     * Set the onWalletReady callback
+     */
+    setOnWalletReady(callback: (status: WalletReadyStatus) => void): void;
+    /**
+     * Authenticate SDK with iframe to establish session
+     */
+    private authenticateSDK;
+    /**
+     * Handle incoming postMessage events
+     */
+    private handleMessage;
+    /**
+     * Handle token refresh request from iframe
+     */
+    private handleTokenRefreshRequest;
+    /**
+     * Send secure message to iframe
+     */
+    private sendMessage;
+    /**
+     * Compute HMAC for message authentication
+     */
+    private computeHMAC;
+    /**
+     * Generate unique message ID
+     */
+    private generateMessageId;
+    /**
+     * Generate nonce for replay protection
+     */
+    private generateNonce;
+    /**
+     * Show iframe (for consent/confirmation UI)
+     */
+    showIframe(): void;
+    /**
+     * Hide iframe
+     */
+    hideIframe(): void;
+    /**
+     * Authenticate user with application
+     */
+    authenticate(userId: string): Promise<{
+        userId: string;
+        address: Address$1 | undefined;
+    }>;
+    /**
+     * Start DKG (Distributed Key Generation)
+     */
+    startDKG(userId: string, accessToken?: string): Promise<Address$1>;
+    /**
+     * Sign transaction
+     */
+    signTransaction(userId: string, transaction: Transaction, accessToken?: string): Promise<Hex>;
+    /**
+     * Sign EIP712 typed data
+     */
+    signTypedData(userId: string, typedData: {
+        domain: {
+            name?: string;
+            version?: string;
+            chainId?: number;
+            verifyingContract?: string;
+            salt?: string;
+        };
+        types: Record<string, Array<{
+            name: string;
+            type: string;
+        }>>;
+        primaryType: string;
+        message: Record<string, any>;
+    }, digest32: Hex, accessToken?: string): Promise<Hex>;
+    /**
+     * Get user's wallet address
+     */
+    getAddress(userId: string): Promise<Address$1 | undefined>;
+    /**
+     * Check if user has a keyshare
+     */
+    checkKeyshare(userId: string): Promise<{
+        hasKeyshare: boolean;
+        address?: Address$1;
+    }>;
+    /**
+     * Open social auth popup (Telegram, Discord, Twitter, etc.)
+     */
+    openSocialAuthPopup(provider: string, config?: Record<string, any>): Promise<{
+        provider: string;
+        success: boolean;
+        user?: any;
+        error?: string;
+    }>;
+    /**
+     * Get trusted apps for user
+     */
+    getTrustedApps(userId: string): Promise<Array<{
+        userId: string;
+        projectId: string;
+        origin: string;
+        trustedAt: number;
+    }>>;
+    /**
+     * Remove app from trusted list
+     */
+    removeTrustedApp(userId: string, projectId: string, origin: string): Promise<boolean>;
+    /**
+     * Create backup of keyshare
+     */
+    createBackup(userId: string, backupRequest: {
+        method: 'server' | 'cloud' | 'local';
+        password?: string;
+        cloudProvider?: string;
+    }, accessToken?: string): Promise<{
+        success: boolean;
+        method: string;
+        timestamp: number;
+        error?: string;
+    }>;
+    /**
+     * Restore keyshare from server backup
+     */
+    restoreFromServer(userId: string, password?: string, accessToken?: string): Promise<{
+        success: boolean;
+        timestamp: number;
+        error?: string;
+        data?: any;
+    }>;
+    /**
+     * Encrypt backup data without uploading (for cloud/local backups)
+     * Returns encrypted data that parent can upload/download
+     */
+    encryptBackupData(userId: string, password?: string): Promise<any>;
+    /**
+     * Restore keyshare from local file backup
+     */
+    restoreFromLocalFile(userId: string, fileContent: string, password?: string): Promise<{
+        success: boolean;
+        timestamp: number;
+        error?: string;
+        data?: any;
+    }>;
+    /**
+     * Get backup status for user
+     */
+    getBackupStatus(userId: string): Promise<{
+        server: {
+            lastBackup?: number;
+            error?: string;
+        };
+        cloud: {
+            lastBackup?: number;
+            error?: string;
+        };
+        local: {
+            lastBackup?: number;
+            error?: string;
+        };
+    }>;
+    /**
+     * Get available cloud providers
+     */
+    getCloudProviders(): Promise<Array<{
+        id: string;
+        name: string;
+        available: boolean;
+    }>>;
+    /**
+     * Cleanup and destroy iframe
+     */
+    destroy(): void;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+/**
+ * Get or create iframe manager singleton
+ */
+declare function getIframeManager(config?: IframeManagerConfig): IframeManager;
+/**
+ * Destroy iframe manager singleton
+ */
+declare function destroyIframeManager(): void;
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };