@enclave-hq/wallet-sdk 1.2.3 → 1.2.5

package/dist/react/index.d.mts

@@ -18,7 +18,9 @@ declare enum WalletType {
     COINBASE_WALLET = "coinbase-wallet",
     TRONLINK = "tronlink",
     WALLETCONNECT_TRON = "walletconnect-tron",
-    PRIVATE_KEY = "private-key"
+    PRIVATE_KEY = "private-key",
+    DEEP_LINK_EVM = "deep-link-evm",
+    DEEP_LINK_TRON = "deep-link-tron"
 }
 declare enum WalletState {
     DISCONNECTED = "disconnected",
@@ -47,14 +49,16 @@ interface IWalletAdapter extends ISigner {
     readonly icon?: string;
     state: WalletState;
     currentAccount: Account | null;
-    connect(chainId?: number): Promise<Account>;
+    connect(chainId?: number | number[]): Promise<Account>;
     disconnect(): Promise<void>;
     isAvailable(): Promise<boolean>;
+    isConnected(): boolean;
     signMessage(message: string): Promise<string>;
     signTransaction?(transaction: Transaction): Promise<string>;
     signTypedData?(typedData: any): Promise<string>;
     switchChain?(chainId: number): Promise<void>;
     addChain?(chainConfig: AddChainParams): Promise<void>;
+    requestSwitchAccount?(targetAddress?: string): Promise<Account>;
     readContract?<T = any>(params: ContractReadParams): Promise<T>;
     writeContract?(params: ContractWriteParams): Promise<string>;
     estimateGas?(params: ContractWriteParams): Promise<bigint>;
@@ -145,14 +149,63 @@ interface WalletManagerEvents extends Record<string, (...args: any[]) => void> {
     error: (error: Error) => void;
 }
 
+interface QRCodeSignerConfig {
+    requestId: string;
+    requestUrl: string;
+    pollUrl?: string;
+    pollInterval?: number;
+    timeout?: number;
+    pollFn?: (requestId: string) => Promise<QRCodeSignResult | null>;
+}
+interface QRCodeSignResult {
+    completed: boolean;
+    signature?: string;
+    error?: string;
+    signer?: string;
+}
+declare enum QRCodeSignStatus {
+    WAITING = "waiting",
+    PENDING = "pending",
+    SUCCESS = "success",
+    FAILED = "failed",
+    TIMEOUT = "timeout",
+    CANCELLED = "cancelled"
+}
+declare class QRCodeSigner {
+    private config;
+    private pollTimer;
+    private timeoutTimer;
+    private status;
+    private qrCodeDataUrl;
+    private result;
+    constructor(config: QRCodeSignerConfig);
+    generateQRCode(options?: {
+        width?: number;
+        margin?: number;
+        color?: {
+            dark?: string;
+            light?: string;
+        };
+    }): Promise<string>;
+    startPolling(onStatusChange?: (status: QRCodeSignStatus) => void, onResult?: (result: QRCodeSignResult) => void): Promise<string>;
+    private defaultPoll;
+    stopPolling(): void;
+    cancel(): void;
+    getStatus(): QRCodeSignStatus;
+    getQRCodeUrl(): string;
+    getResult(): QRCodeSignResult | null;
+    cleanup(): void;
+}
+
 declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
     private config;
     private registry;
     private primaryWallet;
     private connectedWallets;
     constructor(config?: WalletManagerConfig);
-    connect(type: WalletType, chainId?: number): Promise<Account>;
-    connectAdditional(type: WalletType, chainId?: number): Promise<Account>;
+    hasAdapter(type: WalletType): boolean;
+    connect(type: WalletType, chainId?: number | number[]): Promise<Account>;
+    connectAdditional(type: WalletType, chainId?: number | number[]): Promise<Account>;
     connectWithPrivateKey(privateKey: string, chainId?: number): Promise<Account>;
     disconnect(): Promise<void>;
     disconnectAll(): Promise<void>;
@@ -162,6 +215,10 @@ declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
     getWalletByChainType(chainType: ChainType): IWalletAdapter | null;
     signMessage(message: string): Promise<string>;
     signMessageWithChainType(message: string, chainType?: ChainType): Promise<string>;
+    createQRCodeSigner(message: string, config: Omit<QRCodeSignerConfig, 'requestId' | 'requestUrl'> & {
+        requestId: string;
+        requestUrl: string;
+    }): QRCodeSigner;
     signTypedData(typedData: any, chainType?: ChainType): Promise<string>;
     signTransaction(transaction: any): Promise<string>;
     signTransactionWithChainType(transaction: any, chainType?: ChainType): Promise<string>;
@@ -169,6 +226,8 @@ declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
         addChainIfNotExists?: boolean;
         chainConfig?: AddChainParams;
     }): Promise<Account>;
+    requestSwitchAccount(targetAddress?: string): Promise<Account>;
+    ensureAccount(targetAddress: string): Promise<Account>;
     readContract<T = any>(address: string, abi: any[], functionName: string, args?: any[], chainType?: ChainType): Promise<T>;
     writeContract(address: string, abi: any[], functionName: string, args?: any[], options?: {
         value?: string;
@@ -197,8 +256,8 @@ interface WalletContextValue {
     isConnected: boolean;
     connectedWallets: ConnectedWallet[];
     isRestoring: boolean;
-    connect: (type: WalletType, chainId?: number) => Promise<Account>;
-    connectAdditional: (type: WalletType, chainId?: number) => Promise<Account>;
+    connect: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
+    connectAdditional: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
     disconnect: () => Promise<void>;
     switchPrimaryWallet: (chainType: ChainType) => Promise<Account>;
     signMessage: (message: string) => Promise<string>;
@@ -221,8 +280,8 @@ interface UseAccountResult {
 declare function useAccount(): UseAccountResult;
 
 interface UseConnectResult {
-    connect: (type: WalletType, chainId?: number) => Promise<Account>;
-    connectAdditional: (type: WalletType, chainId?: number) => Promise<Account>;
+    connect: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
+    connectAdditional: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
     isConnecting: boolean;
     error: Error | null;
 }
@@ -249,4 +308,27 @@ interface UseSignTransactionResult {
 }
 declare function useSignTransaction(): UseSignTransactionResult;
 
-export { type UseAccountResult, type UseConnectResult, type UseDisconnectResult, type UseSignMessageResult, type UseSignTransactionResult, type WalletContextValue, WalletProvider, type WalletProviderProps, useAccount, useConnect, useDisconnect, useSignMessage, useSignTransaction, useWallet };
+interface UseQRCodeSignerResult {
+    qrCodeDataUrl: string | null;
+    status: QRCodeSignStatus;
+    result: QRCodeSignResult | null;
+    isPolling: boolean;
+    startSign: () => Promise<string>;
+    stopPolling: () => void;
+    cancel: () => void;
+    error: Error | null;
+}
+declare function useQRCodeSigner(config: QRCodeSignerConfig): UseQRCodeSignerResult;
+
+interface QRCodeModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    qrCodeDataUrl: string | null;
+    status: QRCodeSignStatus;
+    error?: Error | null;
+    title?: string;
+    description?: string;
+}
+declare function QRCodeModal({ isOpen, onClose, qrCodeDataUrl, status, error, title, description, }: QRCodeModalProps): React.JSX.Element | null;
+
+export { QRCodeModal, type QRCodeModalProps, type UseAccountResult, type UseConnectResult, type UseDisconnectResult, type UseQRCodeSignerResult, type UseSignMessageResult, type UseSignTransactionResult, type WalletContextValue, WalletProvider, type WalletProviderProps, useAccount, useConnect, useDisconnect, useQRCodeSigner, useSignMessage, useSignTransaction, useWallet };

package/dist/react/index.d.ts

@@ -18,7 +18,9 @@ declare enum WalletType {
     COINBASE_WALLET = "coinbase-wallet",
     TRONLINK = "tronlink",
     WALLETCONNECT_TRON = "walletconnect-tron",
-    PRIVATE_KEY = "private-key"
+    PRIVATE_KEY = "private-key",
+    DEEP_LINK_EVM = "deep-link-evm",
+    DEEP_LINK_TRON = "deep-link-tron"
 }
 declare enum WalletState {
     DISCONNECTED = "disconnected",
@@ -47,14 +49,16 @@ interface IWalletAdapter extends ISigner {
     readonly icon?: string;
     state: WalletState;
     currentAccount: Account | null;
-    connect(chainId?: number): Promise<Account>;
+    connect(chainId?: number | number[]): Promise<Account>;
     disconnect(): Promise<void>;
     isAvailable(): Promise<boolean>;
+    isConnected(): boolean;
     signMessage(message: string): Promise<string>;
     signTransaction?(transaction: Transaction): Promise<string>;
     signTypedData?(typedData: any): Promise<string>;
     switchChain?(chainId: number): Promise<void>;
     addChain?(chainConfig: AddChainParams): Promise<void>;
+    requestSwitchAccount?(targetAddress?: string): Promise<Account>;
     readContract?<T = any>(params: ContractReadParams): Promise<T>;
     writeContract?(params: ContractWriteParams): Promise<string>;
     estimateGas?(params: ContractWriteParams): Promise<bigint>;
@@ -145,14 +149,63 @@ interface WalletManagerEvents extends Record<string, (...args: any[]) => void> {
     error: (error: Error) => void;
 }
 
+interface QRCodeSignerConfig {
+    requestId: string;
+    requestUrl: string;
+    pollUrl?: string;
+    pollInterval?: number;
+    timeout?: number;
+    pollFn?: (requestId: string) => Promise<QRCodeSignResult | null>;
+}
+interface QRCodeSignResult {
+    completed: boolean;
+    signature?: string;
+    error?: string;
+    signer?: string;
+}
+declare enum QRCodeSignStatus {
+    WAITING = "waiting",
+    PENDING = "pending",
+    SUCCESS = "success",
+    FAILED = "failed",
+    TIMEOUT = "timeout",
+    CANCELLED = "cancelled"
+}
+declare class QRCodeSigner {
+    private config;
+    private pollTimer;
+    private timeoutTimer;
+    private status;
+    private qrCodeDataUrl;
+    private result;
+    constructor(config: QRCodeSignerConfig);
+    generateQRCode(options?: {
+        width?: number;
+        margin?: number;
+        color?: {
+            dark?: string;
+            light?: string;
+        };
+    }): Promise<string>;
+    startPolling(onStatusChange?: (status: QRCodeSignStatus) => void, onResult?: (result: QRCodeSignResult) => void): Promise<string>;
+    private defaultPoll;
+    stopPolling(): void;
+    cancel(): void;
+    getStatus(): QRCodeSignStatus;
+    getQRCodeUrl(): string;
+    getResult(): QRCodeSignResult | null;
+    cleanup(): void;
+}
+
 declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
     private config;
     private registry;
     private primaryWallet;
     private connectedWallets;
     constructor(config?: WalletManagerConfig);
-    connect(type: WalletType, chainId?: number): Promise<Account>;
-    connectAdditional(type: WalletType, chainId?: number): Promise<Account>;
+    hasAdapter(type: WalletType): boolean;
+    connect(type: WalletType, chainId?: number | number[]): Promise<Account>;
+    connectAdditional(type: WalletType, chainId?: number | number[]): Promise<Account>;
     connectWithPrivateKey(privateKey: string, chainId?: number): Promise<Account>;
     disconnect(): Promise<void>;
     disconnectAll(): Promise<void>;
@@ -162,6 +215,10 @@ declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
     getWalletByChainType(chainType: ChainType): IWalletAdapter | null;
     signMessage(message: string): Promise<string>;
     signMessageWithChainType(message: string, chainType?: ChainType): Promise<string>;
+    createQRCodeSigner(message: string, config: Omit<QRCodeSignerConfig, 'requestId' | 'requestUrl'> & {
+        requestId: string;
+        requestUrl: string;
+    }): QRCodeSigner;
     signTypedData(typedData: any, chainType?: ChainType): Promise<string>;
     signTransaction(transaction: any): Promise<string>;
     signTransactionWithChainType(transaction: any, chainType?: ChainType): Promise<string>;
@@ -169,6 +226,8 @@ declare class WalletManager extends TypedEventEmitter<WalletManagerEvents> {
         addChainIfNotExists?: boolean;
         chainConfig?: AddChainParams;
     }): Promise<Account>;
+    requestSwitchAccount(targetAddress?: string): Promise<Account>;
+    ensureAccount(targetAddress: string): Promise<Account>;
     readContract<T = any>(address: string, abi: any[], functionName: string, args?: any[], chainType?: ChainType): Promise<T>;
     writeContract(address: string, abi: any[], functionName: string, args?: any[], options?: {
         value?: string;
@@ -197,8 +256,8 @@ interface WalletContextValue {
     isConnected: boolean;
     connectedWallets: ConnectedWallet[];
     isRestoring: boolean;
-    connect: (type: WalletType, chainId?: number) => Promise<Account>;
-    connectAdditional: (type: WalletType, chainId?: number) => Promise<Account>;
+    connect: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
+    connectAdditional: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
     disconnect: () => Promise<void>;
     switchPrimaryWallet: (chainType: ChainType) => Promise<Account>;
     signMessage: (message: string) => Promise<string>;
@@ -221,8 +280,8 @@ interface UseAccountResult {
 declare function useAccount(): UseAccountResult;
 
 interface UseConnectResult {
-    connect: (type: WalletType, chainId?: number) => Promise<Account>;
-    connectAdditional: (type: WalletType, chainId?: number) => Promise<Account>;
+    connect: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
+    connectAdditional: (type: WalletType, chainId?: number | number[]) => Promise<Account>;
     isConnecting: boolean;
     error: Error | null;
 }
@@ -249,4 +308,27 @@ interface UseSignTransactionResult {
 }
 declare function useSignTransaction(): UseSignTransactionResult;
 
-export { type UseAccountResult, type UseConnectResult, type UseDisconnectResult, type UseSignMessageResult, type UseSignTransactionResult, type WalletContextValue, WalletProvider, type WalletProviderProps, useAccount, useConnect, useDisconnect, useSignMessage, useSignTransaction, useWallet };
+interface UseQRCodeSignerResult {
+    qrCodeDataUrl: string | null;
+    status: QRCodeSignStatus;
+    result: QRCodeSignResult | null;
+    isPolling: boolean;
+    startSign: () => Promise<string>;
+    stopPolling: () => void;
+    cancel: () => void;
+    error: Error | null;
+}
+declare function useQRCodeSigner(config: QRCodeSignerConfig): UseQRCodeSignerResult;
+
+interface QRCodeModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    qrCodeDataUrl: string | null;
+    status: QRCodeSignStatus;
+    error?: Error | null;
+    title?: string;
+    description?: string;
+}
+declare function QRCodeModal({ isOpen, onClose, qrCodeDataUrl, status, error, title, description, }: QRCodeModalProps): React.JSX.Element | null;
+
+export { QRCodeModal, type QRCodeModalProps, type UseAccountResult, type UseConnectResult, type UseDisconnectResult, type UseQRCodeSignerResult, type UseSignMessageResult, type UseSignTransactionResult, type WalletContextValue, WalletProvider, type WalletProviderProps, useAccount, useConnect, useDisconnect, useQRCodeSigner, useSignMessage, useSignTransaction, useWallet };