decane-connect-kit 2.2.1 → 2.2.3

package/dist/index.d.cts

@@ -283,6 +283,17 @@ interface PortableBackup {
     createdAt: string;
 }
 
+interface BalanceResult {
+    /** Smallest unit — wei for EVM, lamports for Solana. */
+    raw: bigint;
+    /** Human-readable amount in whole native units, e.g. "1.2345". */
+    formatted: string;
+    /** Native currency symbol, e.g. "ETH", "MATIC", "SOL". */
+    symbol: string;
+    /** Decimals of the native currency (18 for EVM, 9 for Solana). */
+    decimals: number;
+}
+
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
     /** Dashboard project ID (public). Sent with every request so the backend can
@@ -369,6 +380,13 @@ interface SendTransactionRequest {
     gasLimit?: bigint;
     gasPrice?: bigint;
 }
+interface SignTypedDataRequest {
+    chain: Chain;
+    domain: Record<string, unknown>;
+    types: Record<string, unknown>;
+    message: Record<string, unknown>;
+    primaryType?: string;
+}
 type SdkEvent = 'connected' | 'disconnected' | 'session-expired' | 'session-started';
 interface DecaneConnect {
     connect(): Promise<ConnectResult>;
@@ -419,12 +437,26 @@ interface DecaneConnect {
     sessionExpiresAt(): number | null;
     signMessage(req: SignMessageRequest): Promise<string>;
     sendTransaction(req: SendTransactionRequest): Promise<string>;
+    /** Sign EIP-712 typed data (EVM only). Throws on a Solana chain. */
+    signTypedData(req: SignTypedDataRequest): Promise<string>;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
         evm?: string;
         solana?: string;
     } | null;
+    /**
+     * Native-token balance for a chain (defaults to the first configured EVM
+     * chain, else Solana). Read-only public data — works even while the wallet
+     * is locked. Returns raw (wei/lamports), a human `formatted` string, the
+     * native `symbol`, and `decimals`.
+     */
+    getBalance(chain?: string): Promise<BalanceResult>;
+    /** Native balances across every configured chain the wallet has an address for. */
+    getBalances(): Promise<Array<{
+        chain: string;
+        balance: BalanceResult | null;
+    }>>;
     /**
      * Voluntary share rotation — after a suspected device compromise, or just
      * to invalidate an old recovery file. Requires a fresh WebAuthn assertion.
@@ -733,6 +765,19 @@ interface SocialWalletModalProps {
 }
 declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onEmailStart, onEmailVerify, authMethods, customAuthLabel, onCustomAuthSignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
 
+declare function DecaneMark({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+declare function DecaneWordmark({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+declare function DecaneLogo({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+
 declare function useSocialAuth(): {
     isConnected: boolean;
     isUnlocked: boolean;
@@ -787,6 +832,18 @@ declare function useSocialWallet(): {
         gasPrice?: bigint;
     }) => Promise<string>;
     signSolanaTransaction: (tx: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
+    signTypedData: (req: {
+        chain: string;
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        message: Record<string, unknown>;
+        primaryType?: string;
+    }) => Promise<string>;
+    getBalance: (chain?: string) => Promise<BalanceResult>;
+    getBalances: () => Promise<{
+        chain: string;
+        balance: BalanceResult | null;
+    }[]>;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -802,6 +859,12 @@ declare function useSocialWallet(): {
     error: string | null;
     clearError: () => void;
 };
+declare function useSocialBalance(chain?: string): {
+    balance: BalanceResult | null;
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+};
 declare function useDecane(): {
     provider: DecaneProvider;
     wallets: UnifiedWalletAccount[];
@@ -874,4 +937,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, type DecaneProvider, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, startEmailAuth, useChainSwitch, useDecane, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialWallet, useWalletSelector, verifyEmailCode };
+export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, startEmailAuth, useChainSwitch, useDecane, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };

package/dist/index.d.ts

@@ -283,6 +283,17 @@ interface PortableBackup {
     createdAt: string;
 }
 
+interface BalanceResult {
+    /** Smallest unit — wei for EVM, lamports for Solana. */
+    raw: bigint;
+    /** Human-readable amount in whole native units, e.g. "1.2345". */
+    formatted: string;
+    /** Native currency symbol, e.g. "ETH", "MATIC", "SOL". */
+    symbol: string;
+    /** Decimals of the native currency (18 for EVM, 9 for Solana). */
+    decimals: number;
+}
+
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
     /** Dashboard project ID (public). Sent with every request so the backend can
@@ -369,6 +380,13 @@ interface SendTransactionRequest {
     gasLimit?: bigint;
     gasPrice?: bigint;
 }
+interface SignTypedDataRequest {
+    chain: Chain;
+    domain: Record<string, unknown>;
+    types: Record<string, unknown>;
+    message: Record<string, unknown>;
+    primaryType?: string;
+}
 type SdkEvent = 'connected' | 'disconnected' | 'session-expired' | 'session-started';
 interface DecaneConnect {
     connect(): Promise<ConnectResult>;
@@ -419,12 +437,26 @@ interface DecaneConnect {
     sessionExpiresAt(): number | null;
     signMessage(req: SignMessageRequest): Promise<string>;
     sendTransaction(req: SendTransactionRequest): Promise<string>;
+    /** Sign EIP-712 typed data (EVM only). Throws on a Solana chain. */
+    signTypedData(req: SignTypedDataRequest): Promise<string>;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
         evm?: string;
         solana?: string;
     } | null;
+    /**
+     * Native-token balance for a chain (defaults to the first configured EVM
+     * chain, else Solana). Read-only public data — works even while the wallet
+     * is locked. Returns raw (wei/lamports), a human `formatted` string, the
+     * native `symbol`, and `decimals`.
+     */
+    getBalance(chain?: string): Promise<BalanceResult>;
+    /** Native balances across every configured chain the wallet has an address for. */
+    getBalances(): Promise<Array<{
+        chain: string;
+        balance: BalanceResult | null;
+    }>>;
     /**
      * Voluntary share rotation — after a suspected device compromise, or just
      * to invalidate an old recovery file. Requires a fresh WebAuthn assertion.
@@ -733,6 +765,19 @@ interface SocialWalletModalProps {
 }
 declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onEmailStart, onEmailVerify, authMethods, customAuthLabel, onCustomAuthSignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
 
+declare function DecaneMark({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+declare function DecaneWordmark({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+declare function DecaneLogo({ size, muted }: {
+    size?: number;
+    muted?: boolean;
+}): React.JSX.Element;
+
 declare function useSocialAuth(): {
     isConnected: boolean;
     isUnlocked: boolean;
@@ -787,6 +832,18 @@ declare function useSocialWallet(): {
         gasPrice?: bigint;
     }) => Promise<string>;
     signSolanaTransaction: (tx: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
+    signTypedData: (req: {
+        chain: string;
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        message: Record<string, unknown>;
+        primaryType?: string;
+    }) => Promise<string>;
+    getBalance: (chain?: string) => Promise<BalanceResult>;
+    getBalances: () => Promise<{
+        chain: string;
+        balance: BalanceResult | null;
+    }[]>;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -802,6 +859,12 @@ declare function useSocialWallet(): {
     error: string | null;
     clearError: () => void;
 };
+declare function useSocialBalance(chain?: string): {
+    balance: BalanceResult | null;
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+};
 declare function useDecane(): {
     provider: DecaneProvider;
     wallets: UnifiedWalletAccount[];
@@ -874,4 +937,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, type DecaneProvider, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, startEmailAuth, useChainSwitch, useDecane, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialWallet, useWalletSelector, verifyEmailCode };
+export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, startEmailAuth, useChainSwitch, useDecane, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };