decane-connect-kit 2.3.0 → 2.3.1

package/dist/index.d.cts

@@ -316,17 +316,16 @@ interface EthereumProviderOptions {
  * `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;
+declare function createEthereumProvider(client: DecaneConnect, opts?: EthereumProviderOptions): Eip1193Provider;
+
+interface SignedAuthorization {
+    chainId: number;
+    address: string;
+    nonce: number;
+    yParity: number;
+    r: string;
+    s: string;
+}
 
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
@@ -490,20 +489,26 @@ interface DecaneConnect {
         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.
+     * Sign an EIP-7702 authorization, delegating this EOA to a smart-account
+     * implementation contract on `chainId`. Enables account-abstraction /
+     * sponsored-gas flows. Returns the full viem `SignedAuthorization` tuple, so
+     * it drops straight into a userOperation's `authorization` field or a type-4
+     * transaction's authorizationList. `address` and `contractAddress` are
+     * interchangeable (the latter matches Privy's/older viem's param name).
      */
     signAuthorization(req: {
         chainId: number;
-        address: string;
+        address?: string;
+        contractAddress?: string;
         nonce: number;
-    }): Promise<{
-        yParity: number;
-        r: string;
-        s: string;
-    }>;
+    }): Promise<SignedAuthorization>;
+    /**
+     * The current session's access token (the Decane JWT). Use it to authenticate
+     * the user to your own backend (e.g. a sponsored-bundler proxy); verify it
+     * server-side against backend.decane.app/.well-known/jwks.json. Null with no
+     * live session.
+     */
+    getAccessToken(): string | null;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
@@ -926,16 +931,14 @@ declare function useSocialWallet(): {
     }[]>;
     signAuthorization: (req: {
         chainId: number;
-        address: string;
+        address?: string;
+        contractAddress?: string;
         nonce: number;
-    }) => Promise<{
-        yParity: number;
-        r: string;
-        s: string;
-    }>;
+    }) => Promise<SignedAuthorization>;
     getEthereumProvider: (opts?: {
         chainId?: number;
     }) => Eip1193Provider;
+    getAccessToken: () => string | null;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -1032,4 +1035,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, 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 };
+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 SignedAuthorization, 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

@@ -316,17 +316,16 @@ interface EthereumProviderOptions {
  * `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;
+declare function createEthereumProvider(client: DecaneConnect, opts?: EthereumProviderOptions): Eip1193Provider;
+
+interface SignedAuthorization {
+    chainId: number;
+    address: string;
+    nonce: number;
+    yParity: number;
+    r: string;
+    s: string;
+}
 
 type Chain = `evm:${number}` | `solana:${'mainnet' | 'devnet'}`;
 interface DecaneConnectConfig {
@@ -490,20 +489,26 @@ interface DecaneConnect {
         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.
+     * Sign an EIP-7702 authorization, delegating this EOA to a smart-account
+     * implementation contract on `chainId`. Enables account-abstraction /
+     * sponsored-gas flows. Returns the full viem `SignedAuthorization` tuple, so
+     * it drops straight into a userOperation's `authorization` field or a type-4
+     * transaction's authorizationList. `address` and `contractAddress` are
+     * interchangeable (the latter matches Privy's/older viem's param name).
      */
     signAuthorization(req: {
         chainId: number;
-        address: string;
+        address?: string;
+        contractAddress?: string;
         nonce: number;
-    }): Promise<{
-        yParity: number;
-        r: string;
-        s: string;
-    }>;
+    }): Promise<SignedAuthorization>;
+    /**
+     * The current session's access token (the Decane JWT). Use it to authenticate
+     * the user to your own backend (e.g. a sponsored-bundler proxy); verify it
+     * server-side against backend.decane.app/.well-known/jwks.json. Null with no
+     * live session.
+     */
+    getAccessToken(): string | null;
     signSolanaTransaction(tx: Uint8Array): Promise<Uint8Array>;
     disconnect(): Promise<void>;
     getAddresses(): {
@@ -926,16 +931,14 @@ declare function useSocialWallet(): {
     }[]>;
     signAuthorization: (req: {
         chainId: number;
-        address: string;
+        address?: string;
+        contractAddress?: string;
         nonce: number;
-    }) => Promise<{
-        yParity: number;
-        r: string;
-        s: string;
-    }>;
+    }) => Promise<SignedAuthorization>;
     getEthereumProvider: (opts?: {
         chainId?: number;
     }) => Eip1193Provider;
+    getAccessToken: () => string | null;
     rotateShares: (opts: {
         password: string;
         passwordHint?: string;
@@ -1032,4 +1035,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, 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 };
+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 SignedAuthorization, 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.js

@@ -2714,7 +2714,7 @@ async function signEvmAuthorization(tee, chainId, address, nonce, jwt) {
   const r = "0x" + hex.slice(0, 64);
   const s = "0x" + hex.slice(64, 128);
   const v = parseInt(hex.slice(128, 130), 16);
-  return { yParity: v >= 27 ? v - 27 : v, r, s };
+  return { chainId, address, nonce, yParity: v >= 27 ? v - 27 : v, r, s };
 }
 async function signEvmTypedData(tee, chain, typedData, jwt) {
   const payload = JSON.stringify(
@@ -2875,9 +2875,6 @@ function createEthereumProvider(client, opts = {}) {
       }
       case "eth_signAuthorization":
       case "wallet_sign7702Authorization": {
-        if (!client.signAuthorization) {
-          throw Object.assign(new Error("EIP-7702 is not supported by the connected signer."), { code: 4200 });
-        }
         const p = params[0];
         const cid = p.chainId != null ? Number(asBigInt(p.chainId)) : chainId;
         const address = p.address ?? p.contractAddress;
@@ -3731,7 +3728,16 @@ async function createDecaneConnect(config) {
     },
     async signAuthorization(req) {
       const tee = session.requireActive();
-      return signEvmAuthorization(tee, req.chainId, req.address, req.nonce, auth?.jwt);
+      const delegate = req.address ?? req.contractAddress;
+      if (!delegate) throw new CallSequenceError("signAuthorization requires `address` (the delegate contract).");
+      return signEvmAuthorization(tee, req.chainId, delegate, req.nonce, auth?.jwt);
+    },
+    // The current session's access token (the Decane JWT), for authenticating
+    // the user to your own backend — e.g. a sponsored-bundler proxy. Verify it
+    // server-side against https://backend.decane.app/.well-known/jwks.json.
+    // Null when there is no live session.
+    getAccessToken() {
+      return auth?.jwt ?? null;
     },
     getEthereumProvider(opts) {
       if (!ethProvider) {
@@ -5960,6 +5966,9 @@ function DecaneKit({ config, children }) {
     },
     []
   );
+  const socialGetAccessToken = useCallback3(() => {
+    return socialRef.current?.getAccessToken() ?? null;
+  }, []);
   const socialGetBalances = useCallback3(async () => {
     const sdk = socialRef.current;
     if (!sdk) throw new Error("Social wallet not connected");
@@ -6024,6 +6033,7 @@ function DecaneKit({ config, children }) {
         socialGetBalances,
         socialGetEthereumProvider,
         socialSignAuthorization,
+        socialGetAccessToken,
         socialSignSolanaTransaction,
         socialSignTypedData,
         socialRotateShares,
@@ -6248,6 +6258,7 @@ function useSocialWallet() {
     socialGetBalances,
     socialGetEthereumProvider,
     socialSignAuthorization,
+    socialGetAccessToken,
     socialRotateShares,
     socialExportPortableBackup,
     socialHasRecoveryShare,
@@ -6373,6 +6384,9 @@ function useSocialWallet() {
     signAuthorization,
     // An EIP-1193 provider for viem/wagmi/ethers (memoized).
     getEthereumProvider: socialGetEthereumProvider,
+    // The Decane JWT — authenticate the user to your own backend (bundler proxy,
+    // etc.); verify server-side against backend.decane.app/.well-known/jwks.json.
+    getAccessToken: socialGetAccessToken,
     // Recovery (2-of-3 Shamir share set)
     rotateShares,
     exportPortableBackup,