decane-connect-kit 2.2.7 → 2.3.0

package/dist/index.d.cts

@@ -294,6 +294,40 @@ interface BalanceResult {
     decimals: number;
 }
 
+interface Eip1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[] | object;
+    }): Promise<unknown>;
+    on(event: string, handler: (...args: unknown[]) => void): this;
+    removeListener(event: string, handler: (...args: unknown[]) => void): this;
+    /** Marks this as the Decane provider (parallel to wallets' isMetaMask etc.). */
+    readonly isDecane: true;
+}
+interface EthereumProviderOptions {
+    /** Initial chain id (numeric). Defaults to the first configured EVM chain, else 1. */
+    chainId?: number;
+    /** Per-chain RPC overrides ('evm:8453' -> url). Falls back to Decane's defaults. */
+    rpcUrls?: Record<string, string>;
+}
+/**
+ * Build an EIP-1193 provider over a connected Decane social client.
+ *
+ * `signAuthorization` (EIP-7702) is wired only when the client exposes it — that
+ * requires the TEE signer to support the authorization signing path.
+ */
+declare function createEthereumProvider(client: DecaneConnect & {
+    signAuthorization?: (req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }) => Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
+}, opts?: EthereumProviderOptions): Eip1193Provider;
+
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
     /** Dashboard project ID (public). Sent with every request so the backend can
@@ -328,6 +362,13 @@ interface DecaneConnectConfig {
     rpName?: string;
     rpcUrls?: Record<string, string>;
     teeUrl?: string;
+    /**
+     * Persist the live session (handle + JWT) in sessionStorage so a page RELOAD
+     * silently resumes it — no repeat passkey/sign-in. Survives reloads, cleared
+     * on tab close. Default true. Set false to require a fresh unlock on every
+     * page load (stricter, but the reload friction that motivated this returns).
+     */
+    persistSession?: boolean;
     /** Offer to save a recovery-share file at signup. Default true. Never blocks onboarding. */
     offerRecoveryAtSignup?: boolean;
     /** Ask the user whether they want a recovery share and, if so, a password for it. */
@@ -439,6 +480,30 @@ interface DecaneConnect {
     sendTransaction(req: SendTransactionRequest): Promise<string>;
     /** Sign EIP-712 typed data (EVM only). Throws on a Solana chain. */
     signTypedData(req: SignTypedDataRequest): Promise<string>;
+    /**
+     * A standard EIP-1193 Ethereum provider backed by this wallet — drop it into
+     * viem (`custom(provider)`), wagmi, or ethers (`BrowserProvider`). Signing
+     * goes through the TEE; reads are forwarded to the chain RPC. Memoized, so
+     * repeated calls return the same instance (safe for wagmi).
+     */
+    getEthereumProvider(opts?: {
+        chainId?: number;
+    }): Eip1193Provider;
+    /**
+     * Sign an EIP-7702 authorization, delegating this EOA to `address` on
+     * `chainId`. Enables account-abstraction / sponsored-gas flows: pair the
+     * returned {yParity, r, s} into a type-4 transaction's authorizationList.
+     * Requires a TEE signer that supports the 7702 path.
+     */
+    signAuthorization(req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }): Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
@@ -859,6 +924,18 @@ declare function useSocialWallet(): {
         chain: string;
         balance: BalanceResult | null;
     }[]>;
+    signAuthorization: (req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }) => Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
+    getEthereumProvider: (opts?: {
+        chainId?: number;
+    }) => Eip1193Provider;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -880,6 +957,9 @@ declare function useSocialBalance(chain?: string): {
     error: string | null;
     refetch: () => Promise<void>;
 };
+declare function useEthereumProvider(opts?: {
+    chainId?: number;
+}): Eip1193Provider | null;
 declare function useDecane(): {
     provider: DecaneProvider;
     wallets: UnifiedWalletAccount[];
@@ -952,4 +1032,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-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 };
+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, type Eip1193Provider, type EthereumProviderOptions, 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, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };

package/dist/index.d.ts

@@ -294,6 +294,40 @@ interface BalanceResult {
     decimals: number;
 }
 
+interface Eip1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[] | object;
+    }): Promise<unknown>;
+    on(event: string, handler: (...args: unknown[]) => void): this;
+    removeListener(event: string, handler: (...args: unknown[]) => void): this;
+    /** Marks this as the Decane provider (parallel to wallets' isMetaMask etc.). */
+    readonly isDecane: true;
+}
+interface EthereumProviderOptions {
+    /** Initial chain id (numeric). Defaults to the first configured EVM chain, else 1. */
+    chainId?: number;
+    /** Per-chain RPC overrides ('evm:8453' -> url). Falls back to Decane's defaults. */
+    rpcUrls?: Record<string, string>;
+}
+/**
+ * Build an EIP-1193 provider over a connected Decane social client.
+ *
+ * `signAuthorization` (EIP-7702) is wired only when the client exposes it — that
+ * requires the TEE signer to support the authorization signing path.
+ */
+declare function createEthereumProvider(client: DecaneConnect & {
+    signAuthorization?: (req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }) => Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
+}, opts?: EthereumProviderOptions): Eip1193Provider;
+
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
     /** Dashboard project ID (public). Sent with every request so the backend can
@@ -328,6 +362,13 @@ interface DecaneConnectConfig {
     rpName?: string;
     rpcUrls?: Record<string, string>;
     teeUrl?: string;
+    /**
+     * Persist the live session (handle + JWT) in sessionStorage so a page RELOAD
+     * silently resumes it — no repeat passkey/sign-in. Survives reloads, cleared
+     * on tab close. Default true. Set false to require a fresh unlock on every
+     * page load (stricter, but the reload friction that motivated this returns).
+     */
+    persistSession?: boolean;
     /** Offer to save a recovery-share file at signup. Default true. Never blocks onboarding. */
     offerRecoveryAtSignup?: boolean;
     /** Ask the user whether they want a recovery share and, if so, a password for it. */
@@ -439,6 +480,30 @@ interface DecaneConnect {
     sendTransaction(req: SendTransactionRequest): Promise<string>;
     /** Sign EIP-712 typed data (EVM only). Throws on a Solana chain. */
     signTypedData(req: SignTypedDataRequest): Promise<string>;
+    /**
+     * A standard EIP-1193 Ethereum provider backed by this wallet — drop it into
+     * viem (`custom(provider)`), wagmi, or ethers (`BrowserProvider`). Signing
+     * goes through the TEE; reads are forwarded to the chain RPC. Memoized, so
+     * repeated calls return the same instance (safe for wagmi).
+     */
+    getEthereumProvider(opts?: {
+        chainId?: number;
+    }): Eip1193Provider;
+    /**
+     * Sign an EIP-7702 authorization, delegating this EOA to `address` on
+     * `chainId`. Enables account-abstraction / sponsored-gas flows: pair the
+     * returned {yParity, r, s} into a type-4 transaction's authorizationList.
+     * Requires a TEE signer that supports the 7702 path.
+     */
+    signAuthorization(req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }): Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
@@ -859,6 +924,18 @@ declare function useSocialWallet(): {
         chain: string;
         balance: BalanceResult | null;
     }[]>;
+    signAuthorization: (req: {
+        chainId: number;
+        address: string;
+        nonce: number;
+    }) => Promise<{
+        yParity: number;
+        r: string;
+        s: string;
+    }>;
+    getEthereumProvider: (opts?: {
+        chainId?: number;
+    }) => Eip1193Provider;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -880,6 +957,9 @@ declare function useSocialBalance(chain?: string): {
     error: string | null;
     refetch: () => Promise<void>;
 };
+declare function useEthereumProvider(opts?: {
+    chainId?: number;
+}): Eip1193Provider | null;
 declare function useDecane(): {
     provider: DecaneProvider;
     wallets: UnifiedWalletAccount[];
@@ -952,4 +1032,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-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 };
+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, type Eip1193Provider, type EthereumProviderOptions, 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, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };