@coinbase/cdp-sdk 1.28.0 → 1.30.0

package/_types/spend-permissions/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../spend-permissions/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,+CAA+C,CAAC;AAE7F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAssB/B,CAAC"}

package/_types/spend-permissions/types.d.ts

@@ -0,0 +1,30 @@
+import type { Address, Hex } from "../types/misc.js";
+/**
+ * A spend permission structure that defines authorization for spending tokens
+ */
+export type SpendPermission = {
+    /** The account address that owns the tokens */
+    account: Address;
+    /** The address that is authorized to spend the tokens */
+    spender: Address;
+    /** The token contract address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for ETH) */
+    token: Address;
+    /** The maximum amount that can be spent (in wei for ETH, or token's smallest unit) */
+    allowance: bigint;
+    /** Time period in seconds for the spending allowance */
+    period: number;
+    /** Start timestamp for when the permission becomes valid */
+    start: number;
+    /** End timestamp for when the permission expires */
+    end: number;
+    /** Unique salt to prevent replay attacks */
+    salt: bigint;
+    /** Additional data for the permission */
+    extraData: Hex;
+};
+/**
+ * Networks that the SpendPermissionManager contract supports.
+ * From https://github.com/coinbase/spend-permissions/blob/main/README.md#deployments
+ */
+export type SpendPermissionNetworks = "base" | "base-sepolia" | "ethereum" | "ethereum-sepolia" | "optimism" | "optimism-sepolia" | "arbitrum" | "avalanche" | "binance" | "polygon" | "zora";
+//# sourceMappingURL=types.d.ts.map

package/_types/spend-permissions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../spend-permissions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,KAAK,EAAE,OAAO,CAAC;IACf,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,EAAE,GAAG,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,GACT,MAAM,CAAC"}

package/_types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.28.0";
+export declare const version = "1.30.0";
 //# sourceMappingURL=version.d.ts.map

package/accounts/evm/networkCapabilities.ts

@@ -18,6 +18,7 @@ export const NETWORK_CAPABILITIES = {
     sendTransaction: true,
     quoteSwap: true,
     swap: true,
+    useSpendPermission: true,
   },
   "base-sepolia": {
     listTokenBalances: true,
@@ -29,6 +30,7 @@ export const NETWORK_CAPABILITIES = {
     sendTransaction: true,
     quoteSwap: false,
     swap: false,
+    useSpendPermission: true,
   },
   ethereum: {
     listTokenBalances: true,
@@ -40,6 +42,7 @@ export const NETWORK_CAPABILITIES = {
     sendTransaction: true,
     quoteSwap: true,
     swap: true,
+    useSpendPermission: true,
   },
   "ethereum-sepolia": {
     listTokenBalances: false,
@@ -51,6 +54,7 @@ export const NETWORK_CAPABILITIES = {
     sendTransaction: true,
     quoteSwap: false,
     swap: false,
+    useSpendPermission: true,
   },
   "ethereum-hoodi": {
     listTokenBalances: false,
@@ -62,6 +66,103 @@ export const NETWORK_CAPABILITIES = {
     sendTransaction: true, // Always available (uses wallet client for non-base networks)
     quoteSwap: false,
     swap: false,
+    useSpendPermission: false,
+  },
+  optimism: {
+    listTokenBalances: false,
+    requestFaucet: false,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  "optimism-sepolia": {
+    listTokenBalances: false,
+    requestFaucet: true,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  arbitrum: {
+    listTokenBalances: false,
+    requestFaucet: true,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  "arbitrum-sepolia": {
+    listTokenBalances: false,
+    requestFaucet: true,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  avalanche: {
+    listTokenBalances: false,
+    requestFaucet: false,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  binance: {
+    listTokenBalances: false,
+    requestFaucet: false,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  polygon: {
+    listTokenBalances: false,
+    requestFaucet: false,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
+  },
+  zora: {
+    listTokenBalances: false,
+    requestFaucet: false,
+    quoteFund: false,
+    fund: false,
+    waitForFundOperationReceipt: false,
+    transfer: false,
+    sendTransaction: true, // Always available (uses wallet client for non-base networks)
+    quoteSwap: false,
+    swap: false,
+    useSpendPermission: true,
   },
 } as const;
 

package/accounts/evm/toEvmServerAccount.ts

@@ -8,15 +8,8 @@ import {
 } from "viem";
 
 import { toNetworkScopedEvmServerAccount } from "./toNetworkScopedEvmServerAccount.js";
-import { FundOptions, fund } from "../../actions/evm/fund/fund.js";
-import { Quote } from "../../actions/evm/fund/Quote.js";
-import { QuoteFundOptions, quoteFund } from "../../actions/evm/fund/quoteFund.js";
-import { FundOperationResult } from "../../actions/evm/fund/types.js";
-import {
-  WaitForFundOperationOptions,
-  WaitForFundOperationResult,
-  waitForFundOperationReceipt,
-} from "../../actions/evm/fund/waitForFundOperationReceipt.js";
+import { EvmFundOptions, fund } from "../../actions/evm/fund/fund.js";
+import { EvmQuoteFundOptions, quoteFund } from "../../actions/evm/fund/quoteFund.js";
 import {
   listTokenBalances,
   type ListTokenBalancesResult,
@@ -28,10 +21,19 @@ import {
   type RequestFaucetResult,
 } from "../../actions/evm/requestFaucet.js";
 import { sendTransaction } from "../../actions/evm/sendTransaction.js";
+import { useSpendPermission } from "../../actions/evm/spend-permissions/account.use.js";
+import { UseSpendPermissionOptions } from "../../actions/evm/spend-permissions/types.js";
 import { createSwapQuote } from "../../actions/evm/swap/createSwapQuote.js";
 import { sendSwapTransaction } from "../../actions/evm/swap/sendSwapTransaction.js";
 import { accountTransferStrategy } from "../../actions/evm/transfer/accountTransferStrategy.js";
 import { transfer } from "../../actions/evm/transfer/transfer.js";
+import { EvmQuote } from "../../actions/Quote.js";
+import { FundOperationResult } from "../../actions/types.js";
+import {
+  WaitForFundOperationOptions,
+  WaitForFundOperationResult,
+  waitForFundOperationReceipt,
+} from "../../actions/waitForFundOperationReceipt.js";
 import { Analytics } from "../../analytics.js";
 
 import type { EvmServerAccount, NetworkOrRpcUrl } from "./types.js";
@@ -189,7 +191,7 @@ export function toEvmServerAccount(
         address: this.address,
       });
     },
-    async quoteFund(options: Omit<QuoteFundOptions, "address">): Promise<Quote> {
+    async quoteFund(options: Omit<EvmQuoteFundOptions, "address">): Promise<EvmQuote> {
       Analytics.trackAction({
         action: "quote_fund",
         accountType: "evm_server",
@@ -203,7 +205,7 @@ export function toEvmServerAccount(
         address: this.address,
       });
     },
-    async fund(options: Omit<FundOptions, "address">): Promise<FundOperationResult> {
+    async fund(options: Omit<EvmFundOptions, "address">): Promise<FundOperationResult> {
       Analytics.trackAction({
         action: "fund",
         accountType: "evm_server",
@@ -256,6 +258,19 @@ export function toEvmServerAccount(
         taker: this.address, // Always use account's address as taker
       });
     },
+    async __experimental_useSpendPermission(
+      options: UseSpendPermissionOptions,
+    ): Promise<TransactionResult> {
+      Analytics.trackAction({
+        action: "use_spend_permission",
+        accountType: "evm_server",
+        properties: {
+          network: options.network,
+        },
+      });
+
+      return useSpendPermission(apiClient, this.address, options);
+    },
     name: options.account.name,
     type: "evm-server",
     policies: options.account.policies,

package/accounts/evm/toEvmSmartAccount.ts

@@ -1,14 +1,7 @@
 import { resolveNetworkToChain } from "./networkToChainResolver.js";
 import { toNetworkScopedEvmSmartAccount } from "./toNetworkScopedEvmSmartAccount.js";
-import { fund, FundOptions } from "../../actions/evm/fund/fund.js";
-import { Quote } from "../../actions/evm/fund/Quote.js";
-import { quoteFund, QuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
-import { FundOperationResult } from "../../actions/evm/fund/types.js";
-import {
-  WaitForFundOperationResult,
-  waitForFundOperationReceipt,
-  WaitForFundOperationOptions,
-} from "../../actions/evm/fund/waitForFundOperationReceipt.js";
+import { fund, EvmFundOptions } from "../../actions/evm/fund/fund.js";
+import { quoteFund, EvmQuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
 import { getUserOperation } from "../../actions/evm/getUserOperation.js";
 import {
   listTokenBalances,
@@ -26,6 +19,8 @@ import {
   sendUserOperation,
 } from "../../actions/evm/sendUserOperation.js";
 import { signAndWrapTypedDataForSmartAccount } from "../../actions/evm/signAndWrapTypedDataForSmartAccount.js";
+import { useSpendPermission } from "../../actions/evm/spend-permissions/smartAccount.use.js";
+import { UseSpendPermissionOptions } from "../../actions/evm/spend-permissions/types.js";
 import { createSwapQuote } from "../../actions/evm/swap/createSwapQuote.js";
 import { sendSwapOperation } from "../../actions/evm/swap/sendSwapOperation.js";
 import { smartAccountTransferStrategy } from "../../actions/evm/transfer/smartAccountTransferStrategy.js";
@@ -35,12 +30,23 @@ import {
   WaitForUserOperationOptions,
   WaitForUserOperationReturnType,
 } from "../../actions/evm/waitForUserOperation.js";
+import { EvmQuote } from "../../actions/Quote.js";
+import { FundOperationResult } from "../../actions/types.js";
+import {
+  WaitForFundOperationResult,
+  waitForFundOperationReceipt,
+  WaitForFundOperationOptions,
+} from "../../actions/waitForFundOperationReceipt.js";
 import { Analytics } from "../../analytics.js";
 import {
   GetUserOperationOptions,
   SignTypedDataOptions,
   UserOperation,
 } from "../../client/evm/evm.types.js";
+import {
+  type CdpOpenApiClientType,
+  type EvmSmartAccount as EvmSmartAccountModel,
+} from "../../openapi-client/index.js";
 
 import type { EvmAccount, EvmSmartAccount, KnownEvmNetworks } from "./types.js";
 import type {
@@ -49,10 +55,6 @@ import type {
   SmartAccountSwapOptions,
   SmartAccountSwapResult,
 } from "../../actions/evm/swap/types.js";
-import type {
-  CdpOpenApiClientType,
-  EvmSmartAccount as EvmSmartAccountModel,
-} from "../../openapi-client/index.js";
 import type { Address, Hex } from "../../types/misc.js";
 
 /**
@@ -170,7 +172,7 @@ export function toEvmSmartAccount(
         address: account.address,
       });
     },
-    async quoteFund(options: Omit<QuoteFundOptions, "address">): Promise<Quote> {
+    async quoteFund(options: Omit<EvmQuoteFundOptions, "address">): Promise<EvmQuote> {
       Analytics.trackAction({
         action: "quote_fund",
         accountType: "evm_smart",
@@ -184,7 +186,7 @@ export function toEvmSmartAccount(
         address: this.address,
       });
     },
-    async fund(options: Omit<FundOptions, "address">): Promise<FundOperationResult> {
+    async fund(options: Omit<EvmFundOptions, "address">): Promise<FundOperationResult> {
       Analytics.trackAction({
         action: "fund",
         accountType: "evm_smart",
@@ -258,6 +260,19 @@ export function toEvmSmartAccount(
       });
       return result.signature;
     },
+    async __experimental_useSpendPermission(
+      options: UseSpendPermissionOptions,
+    ): Promise<SendUserOperationReturnType> {
+      Analytics.trackAction({
+        action: "use_spend_permission",
+        accountType: "evm_smart",
+        properties: {
+          network: options.network,
+        },
+      });
+
+      return useSpendPermission(apiClient, account, options);
+    },
 
     name: options.smartAccount.name,
     type: "evm-smart",

package/accounts/evm/toNetworkScopedEvmServerAccount.ts

@@ -8,21 +8,23 @@ import { transferWithViem } from "../../actions/evm/transfer/transferWithViem.js
 import { Analytics } from "../../analytics.js";
 
 import type { EvmServerAccount, NetworkScopedEvmServerAccount } from "./types.js";
-import type { FundOptions } from "../../actions/evm/fund/fund.js";
-import type { QuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
-import type { WaitForFundOperationOptions } from "../../actions/evm/fund/waitForFundOperationReceipt.js";
+import type { EvmFundOptions } from "../../actions/evm/fund/fund.js";
+import type { EvmQuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
 import type { ListTokenBalancesOptions } from "../../actions/evm/listTokenBalances.js";
 import type { RequestFaucetOptions } from "../../actions/evm/requestFaucet.js";
 import type {
   SendTransactionOptions,
   TransactionResult,
 } from "../../actions/evm/sendTransaction.js";
+import type { UseSpendPermissionOptions } from "../../actions/evm/spend-permissions/types.js";
 import type { AccountQuoteSwapOptions, AccountSwapOptions } from "../../actions/evm/swap/types.js";
 import type { TransferOptions } from "../../actions/evm/transfer/types.js";
+import type { WaitForFundOperationOptions } from "../../actions/waitForFundOperationReceipt.js";
 import type {
   ListEvmTokenBalancesNetwork,
   SendEvmTransactionBodyNetwork,
 } from "../../openapi-client/index.js";
+import type { SpendPermissionNetworks } from "../../spend-permissions/types.js";
 import type { Address, TransactionRequestEIP1559 } from "../../types/misc.js";
 
 /**
@@ -156,7 +158,7 @@ export async function toNetworkScopedEvmServerAccount<Network extends string>(
 
   if (isMethodSupportedOnNetwork("quoteFund", resolvedNetworkName)) {
     Object.assign(account, {
-      quoteFund: async (quoteFundOptions: Omit<QuoteFundOptions, "address">) => {
+      quoteFund: async (quoteFundOptions: Omit<EvmQuoteFundOptions, "address">) => {
         return options.account.quoteFund({
           ...quoteFundOptions,
         });
@@ -166,7 +168,7 @@ export async function toNetworkScopedEvmServerAccount<Network extends string>(
 
   if (isMethodSupportedOnNetwork("fund", resolvedNetworkName)) {
     Object.assign(account, {
-      fund: async (fundOptions: Omit<FundOptions, "address">) => {
+      fund: async (fundOptions: Omit<EvmFundOptions, "address">) => {
         return options.account.fund({
           ...fundOptions,
         });
@@ -193,5 +195,18 @@ export async function toNetworkScopedEvmServerAccount<Network extends string>(
     });
   }
 
+  if (isMethodSupportedOnNetwork("useSpendPermission", resolvedNetworkName)) {
+    Object.assign(account, {
+      __experimental_useSpendPermission: async (
+        spendPermissionOptions: Omit<UseSpendPermissionOptions, "network">,
+      ) => {
+        return options.account.__experimental_useSpendPermission({
+          ...spendPermissionOptions,
+          network: options.network as SpendPermissionNetworks,
+        });
+      },
+    });
+  }
+
   return account;
 }

package/accounts/evm/toNetworkScopedEvmSmartAccount.ts

@@ -2,16 +2,17 @@ import { getBaseNodeRpcUrl } from "./getBaseNodeRpcUrl.js";
 import { isMethodSupportedOnNetwork } from "./networkCapabilities.js";
 import { fund } from "../../actions/evm/fund/fund.js";
 import { quoteFund } from "../../actions/evm/fund/quoteFund.js";
-import { waitForFundOperationReceipt } from "../../actions/evm/fund/waitForFundOperationReceipt.js";
 import { getUserOperation } from "../../actions/evm/getUserOperation.js";
 import { listTokenBalances } from "../../actions/evm/listTokenBalances.js";
 import { requestFaucet } from "../../actions/evm/requestFaucet.js";
 import { sendUserOperation } from "../../actions/evm/sendUserOperation.js";
+import { UseSpendPermissionOptions } from "../../actions/evm/spend-permissions/types.js";
 import { createSwapQuote } from "../../actions/evm/swap/createSwapQuote.js";
 import { sendSwapOperation } from "../../actions/evm/swap/sendSwapOperation.js";
 import { smartAccountTransferStrategy } from "../../actions/evm/transfer/smartAccountTransferStrategy.js";
 import { transfer } from "../../actions/evm/transfer/transfer.js";
 import { waitForUserOperation } from "../../actions/evm/waitForUserOperation.js";
+import { waitForFundOperationReceipt } from "../../actions/waitForFundOperationReceipt.js";
 import { Analytics } from "../../analytics.js";
 
 import type {
@@ -20,9 +21,8 @@ import type {
   KnownEvmNetworks,
   NetworkScopedEvmSmartAccount,
 } from "./types.js";
-import type { FundOptions } from "../../actions/evm/fund/fund.js";
-import type { QuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
-import type { WaitForFundOperationOptions } from "../../actions/evm/fund/waitForFundOperationReceipt.js";
+import type { EvmFundOptions } from "../../actions/evm/fund/fund.js";
+import type { EvmQuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
 import type { ListTokenBalancesOptions } from "../../actions/evm/listTokenBalances.js";
 import type { RequestFaucetOptions } from "../../actions/evm/requestFaucet.js";
 import type { SendUserOperationOptions } from "../../actions/evm/sendUserOperation.js";
@@ -33,12 +33,14 @@ import type {
 } from "../../actions/evm/swap/types.js";
 import type { SmartAccountTransferOptions } from "../../actions/evm/transfer/types.js";
 import type { WaitForUserOperationOptions } from "../../actions/evm/waitForUserOperation.js";
+import type { WaitForFundOperationOptions } from "../../actions/waitForFundOperationReceipt.js";
 import type { GetUserOperationOptions } from "../../client/evm/evm.types.js";
 import type {
   CdpOpenApiClientType,
   EvmUserOperationNetwork,
   ListEvmTokenBalancesNetwork,
 } from "../../openapi-client/index.js";
+import type { SpendPermissionNetworks } from "../../spend-permissions/types.js";
 
 /**
  * Options for converting a pre-existing EvmSmartAccount and owner to a NetworkScopedEvmSmartAccount
@@ -195,7 +197,7 @@ export async function toNetworkScopedEvmSmartAccount<Network extends KnownEvmNet
 
   if (isMethodSupportedOnNetwork("quoteFund", options.network)) {
     Object.assign(account, {
-      quoteFund: async (quoteOptions: Omit<QuoteFundOptions, "address">) => {
+      quoteFund: async (quoteOptions: Omit<EvmQuoteFundOptions, "address">) => {
         Analytics.trackAction({
           action: "quote_fund",
           accountType: "evm_smart",
@@ -214,7 +216,7 @@ export async function toNetworkScopedEvmSmartAccount<Network extends KnownEvmNet
 
   if (isMethodSupportedOnNetwork("fund", options.network)) {
     Object.assign(account, {
-      fund: async (fundOptions: Omit<FundOptions, "address">) => {
+      fund: async (fundOptions: Omit<EvmFundOptions, "address">) => {
         Analytics.trackAction({
           action: "fund",
           accountType: "evm_smart",
@@ -279,5 +281,18 @@ export async function toNetworkScopedEvmSmartAccount<Network extends KnownEvmNet
     });
   }
 
+  if (isMethodSupportedOnNetwork("useSpendPermission", options.network)) {
+    Object.assign(account, {
+      __experimental_useSpendPermission: async (
+        spendPermissionOptions: Omit<UseSpendPermissionOptions, "network">,
+      ) => {
+        return options.smartAccount.__experimental_useSpendPermission({
+          ...spendPermissionOptions,
+          network: options.network as SpendPermissionNetworks,
+        });
+      },
+    });
+  }
+
   return account;
 }

package/accounts/evm/types.ts

@@ -7,14 +7,8 @@ import {
   QuoteSwapNetworks,
   SwapNetworks,
 } from "./networkCapabilities.js";
-import { FundOptions } from "../../actions/evm/fund/fund.js";
-import { Quote } from "../../actions/evm/fund/Quote.js";
-import { QuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
-import { FundOperationResult } from "../../actions/evm/fund/types.js";
-import {
-  WaitForFundOperationOptions,
-  WaitForFundOperationResult,
-} from "../../actions/evm/fund/waitForFundOperationReceipt.js";
+import { EvmFundOptions } from "../../actions/evm/fund/fund.js";
+import { EvmQuoteFundOptions } from "../../actions/evm/fund/quoteFund.js";
 import {
   ListTokenBalancesOptions,
   ListTokenBalancesResult,
@@ -25,6 +19,7 @@ import {
   SendUserOperationOptions,
   SendUserOperationReturnType,
 } from "../../actions/evm/sendUserOperation.js";
+import { UseSpendPermissionOptions } from "../../actions/evm/spend-permissions/types.js";
 import {
   AccountQuoteSwapOptions,
   AccountQuoteSwapResult,
@@ -39,13 +34,20 @@ import {
   WaitForUserOperationOptions,
   WaitForUserOperationReturnType,
 } from "../../actions/evm/waitForUserOperation.js";
+import { FundOperationResult } from "../../actions/types.js";
+import {
+  WaitForFundOperationOptions,
+  WaitForFundOperationResult,
+} from "../../actions/waitForFundOperationReceipt.js";
 import { GetUserOperationOptions, UserOperation } from "../../client/evm/evm.types.js";
+import { SpendPermissionNetworks } from "../../spend-permissions/types.js";
 
 import type {
   SmartAccountTransferOptions,
   TransferOptions,
 } from "../../actions/evm/transfer/types.js";
 import type { AccountActions, SmartAccountActions } from "../../actions/evm/types.js";
+import type { EvmQuote } from "../../actions/Quote.js";
 import type { Address, Hash, Hex } from "../../types/misc.js";
 import type { Prettify } from "../../types/utils.js";
 import type {
@@ -211,13 +213,17 @@ export type NetworkSpecificSmartAccountActions<Network extends string> = Prettif
     // Conditionally include quoteFund
     (Network extends QuoteFundNetworks
       ? {
-          quoteFund: (options: Omit<QuoteFundOptions, "address" | "network">) => Promise<Quote>;
+          quoteFund: (
+            options: Omit<EvmQuoteFundOptions, "address" | "network">,
+          ) => Promise<EvmQuote>;
         }
       : EmptyObject) &
     // Conditionally include fund
     (Network extends FundNetworks
       ? {
-          fund: (options: Omit<FundOptions, "address" | "network">) => Promise<FundOperationResult>;
+          fund: (
+            options: Omit<EvmFundOptions, "address" | "network">,
+          ) => Promise<FundOperationResult>;
           waitForFundOperationReceipt: (
             options: Omit<WaitForFundOperationOptions, "network">,
           ) => Promise<WaitForFundOperationResult>;
@@ -238,6 +244,14 @@ export type NetworkSpecificSmartAccountActions<Network extends string> = Prettif
             options: DistributedOmit<SmartAccountSwapOptions, "network">,
           ) => Promise<SmartAccountSwapResult>;
         }
+      : EmptyObject) &
+    // Conditionally include useSpendPermission
+    (Network extends SpendPermissionNetworks
+      ? {
+          __experimental_useSpendPermission: (
+            options: Omit<UseSpendPermissionOptions, "network">,
+          ) => Promise<SendUserOperationReturnType>;
+        }
       : EmptyObject)
 >;
 
@@ -289,13 +303,13 @@ export type NetworkSpecificAccountActions<Network extends string> = Prettify<
     // Conditionally include quoteFund
     (Network extends QuoteFundNetworks
       ? {
-          quoteFund: (options: Omit<QuoteFundOptions, "address">) => Promise<Quote>;
+          quoteFund: (options: Omit<EvmQuoteFundOptions, "address">) => Promise<EvmQuote>;
         }
       : EmptyObject) &
     // Conditionally include fund
     (Network extends FundNetworks
       ? {
-          fund: (options: Omit<FundOptions, "address">) => Promise<FundOperationResult>;
+          fund: (options: Omit<EvmFundOptions, "address">) => Promise<FundOperationResult>;
           waitForFundOperationReceipt: (
             options: WaitForFundOperationOptions,
           ) => Promise<WaitForFundOperationResult>;
@@ -318,6 +332,14 @@ export type NetworkSpecificAccountActions<Network extends string> = Prettify<
       ? {
           swap: (options: AccountSwapOptions) => Promise<AccountSwapResult>;
         }
+      : EmptyObject) &
+    // Conditionally include useSpendPermission
+    (Network extends SpendPermissionNetworks
+      ? {
+          __experimental_useSpendPermission: (
+            options: Omit<UseSpendPermissionOptions, "network">,
+          ) => Promise<TransactionResult>;
+        }
       : EmptyObject)
 >;