@coinbase/cdp-sdk 1.28.0 → 1.29.0

package/accounts/evm/toNetworkScopedEvmServerAccount.ts

@@ -8,9 +8,8 @@ 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 {
@@ -19,6 +18,7 @@ import type {
 } from "../../actions/evm/sendTransaction.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,
@@ -156,7 +156,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 +166,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,
         });

package/accounts/evm/toNetworkScopedEvmSmartAccount.ts

@@ -2,7 +2,6 @@ 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";
@@ -12,6 +11,7 @@ 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 +20,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,6 +32,7 @@ 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,
@@ -195,7 +195,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 +214,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",

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,
@@ -39,6 +33,11 @@ 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 type {
@@ -46,6 +45,7 @@ import type {
   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 +211,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>;
@@ -289,13 +293,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>;

package/accounts/solana/toSolanaAccount.ts

@@ -1,8 +1,17 @@
 import { Account, SolanaAccount } from "./types.js";
+import { SolanaQuote } from "../../actions/Quote.js";
+import { SolanaFundOptions, fund } from "../../actions/solana/fund/fund.js";
+import { SolanaQuoteFundOptions, quoteFund } from "../../actions/solana/fund/quoteFund.js";
 import { requestFaucet } from "../../actions/solana/requestFaucet.js";
 import { signMessage } from "../../actions/solana/signMessage.js";
 import { signTransaction } from "../../actions/solana/signTransaction.js";
 import { transfer, type TransferOptions } from "../../actions/solana/transfer.js";
+import { FundOperationResult } from "../../actions/types.js";
+import {
+  WaitForFundOperationOptions,
+  WaitForFundOperationResult,
+  waitForFundOperationReceipt,
+} from "../../actions/waitForFundOperationReceipt.js";
 import { Analytics } from "../../analytics.js";
 import {
   RequestFaucetOptions,
@@ -85,6 +94,38 @@ export function toSolanaAccount(
         from: account.address,
       });
     },
+    async quoteFund(options: Omit<SolanaQuoteFundOptions, "address">): Promise<SolanaQuote> {
+      Analytics.trackAction({
+        action: "quote_fund",
+        accountType: "solana",
+      });
+
+      return quoteFund(apiClient, {
+        ...options,
+        address: account.address,
+      });
+    },
+    async fund(options: Omit<SolanaFundOptions, "address">): Promise<FundOperationResult> {
+      Analytics.trackAction({
+        action: "fund",
+        accountType: "solana",
+      });
+
+      return fund(apiClient, {
+        ...options,
+        address: account.address,
+      });
+    },
+    async waitForFundOperationReceipt(
+      options: WaitForFundOperationOptions,
+    ): Promise<WaitForFundOperationResult> {
+      Analytics.trackAction({
+        action: "wait_for_fund_operation_receipt",
+        accountType: "solana",
+      });
+
+      return waitForFundOperationReceipt(apiClient, options);
+    },
   };
 
   return account;

package/actions/Quote.ts

@@ -0,0 +1,154 @@
+import { FundOperationResult } from "./types.js";
+import { CdpOpenApiClientType } from "../openapi-client/index.js";
+
+/**
+ * Base class representing a funding quote that can be executed.
+ */
+abstract class BaseQuote {
+  /** Quote for the transfer. */
+  public quoteId: string;
+  /** The amount in fiat currency. */
+  public fiatAmount: string;
+  /** The fiat currency. */
+  public fiatCurrency: string;
+  /** The amount in the token to transfer. */
+  public tokenAmount: string;
+  /** The token to transfer. */
+  public token: string;
+  /** Fees in the token to transfer. */
+  public fees: {
+    /** The type of fee. */
+    type: "exchange_fee" | "network_fee";
+    amount: string;
+    currency: string;
+  }[];
+
+  protected apiClient: CdpOpenApiClientType;
+
+  /**
+   * Creates a new BaseQuote instance.
+   *
+   * @param apiClient - The API client.
+   * @param quoteId - The quote ID.
+   * @param fiatAmount - The amount in fiat currency.
+   * @param fiatCurrency - The fiat currency.
+   * @param tokenAmount - The amount in the token to transfer.
+   * @param token - The token to transfer.
+   * @param fees - Fees for the transfer.
+   */
+  constructor(
+    apiClient: CdpOpenApiClientType,
+    quoteId: string,
+    fiatAmount: string,
+    fiatCurrency: string,
+    tokenAmount: string,
+    token: string,
+    fees: {
+      type: "exchange_fee" | "network_fee";
+      amount: string;
+      currency: string;
+    }[],
+  ) {
+    this.apiClient = apiClient;
+    this.quoteId = quoteId;
+    this.fiatAmount = fiatAmount;
+    this.fiatCurrency = fiatCurrency;
+    this.tokenAmount = tokenAmount;
+    this.token = token;
+    this.fees = fees;
+  }
+
+  /**
+   * Executes the quote to perform the actual fund transfer.
+   *
+   * @returns A promise that resolves to the result of the executed quote.
+   */
+  async execute(): Promise<FundOperationResult> {
+    const transfer = await this.apiClient.executePaymentTransferQuote(this.quoteId);
+
+    return {
+      id: transfer.id,
+      network: transfer.target.network,
+      targetAmount: transfer.targetAmount,
+      targetCurrency: transfer.targetCurrency,
+      status: transfer.status,
+      transactionHash: transfer.transactionHash,
+    };
+  }
+}
+
+/**
+ * A class representing an EVM funding quote that can be executed.
+ */
+export class EvmQuote extends BaseQuote {
+  /** Network to transfer the funds to (EVM networks). */
+  public network: "base" | "ethereum";
+
+  /**
+   * Creates a new EvmQuote instance.
+   *
+   * @param apiClient - The API client.
+   * @param quoteId - The quote ID.
+   * @param network - The EVM network to transfer funds to.
+   * @param fiatAmount - The amount in fiat currency.
+   * @param fiatCurrency - The fiat currency.
+   * @param tokenAmount - The amount in the token to transfer.
+   * @param token - The token to transfer.
+   * @param fees - Fees for the transfer.
+   */
+  constructor(
+    apiClient: CdpOpenApiClientType,
+    quoteId: string,
+    network: "base" | "ethereum",
+    fiatAmount: string,
+    fiatCurrency: string,
+    tokenAmount: string,
+    token: string,
+    fees: {
+      type: "exchange_fee" | "network_fee";
+      amount: string;
+      currency: string;
+    }[],
+  ) {
+    super(apiClient, quoteId, fiatAmount, fiatCurrency, tokenAmount, token, fees);
+    this.network = network;
+  }
+}
+
+/**
+ * A class representing a Solana funding quote that can be executed.
+ */
+export class SolanaQuote extends BaseQuote {
+  /** Network to transfer the funds to (Solana). */
+  public network: "solana";
+
+  /**
+   * Creates a new SolanaQuote instance.
+   *
+   * @param apiClient - The API client.
+   * @param quoteId - The quote ID.
+   * @param network - The Solana network to transfer funds to.
+   * @param fiatAmount - The amount in fiat currency.
+   * @param fiatCurrency - The fiat currency.
+   * @param tokenAmount - The amount in the token to transfer.
+   * @param token - The token to transfer.
+   * @param fees - Fees for the transfer.
+   */
+  constructor(
+    apiClient: CdpOpenApiClientType,
+    quoteId: string,
+    network: "solana",
+    fiatAmount: string,
+    fiatCurrency: string,
+    tokenAmount: string,
+    token: string,
+    fees: {
+      type: "exchange_fee" | "network_fee";
+      amount: string;
+      currency: string;
+    }[],
+  ) {
+    super(apiClient, quoteId, fiatAmount, fiatCurrency, tokenAmount, token, fees);
+    this.network = network;
+  }
+}

package/actions/evm/fund/fund.ts

@@ -1,23 +1,19 @@
 import { formatUnits } from "viem";
 
-import { FundOperationResult } from "./types.js";
 import { UserInputValidationError } from "../../../errors.js";
 import {
   CreatePaymentTransferQuoteBodySourceType,
   CreatePaymentTransferQuoteBodyTargetType,
   type CdpOpenApiClientType,
 } from "../../../openapi-client/index.js";
+import { BaseFundOptions, FundOperationResult } from "../../types.js";
 
 /**
  * Options for funding an EVM account.
  */
-export interface FundOptions {
-  /** The address of the account. */
-  address: string;
+export interface EvmFundOptions extends BaseFundOptions {
   /** The network to request funds from. */
   network: "base" | "ethereum";
-  /** The amount to fund the account with, in atomic units (wei) of the token. */
-  amount: bigint;
   /** The token to request funds for. */
   token: "eth" | "usdc";
 }
@@ -32,8 +28,15 @@ export interface FundOptions {
  */
 export async function fund(
   apiClient: CdpOpenApiClientType,
-  options: FundOptions,
+  options: EvmFundOptions,
 ): Promise<FundOperationResult> {
+  if (options.token !== "eth" && options.token !== "usdc") {
+    throw new UserInputValidationError("Invalid token, must be eth or usdc");
+  }
+
+  const decimals = options.token === "eth" ? 18 : 6;
+  const amount = formatUnits(options.amount, decimals);
+
   const paymentMethods = await apiClient.getPaymentMethods();
   const cardPaymentMethod = paymentMethods.find(
     method => method.type === "card" && method.actions.includes("source"),
@@ -43,13 +46,6 @@ export async function fund(
     throw new Error("No card found to fund account");
   }
 
-  if (options.token !== "eth" && options.token !== "usdc") {
-    throw new UserInputValidationError("Invalid token, must be eth or usdc");
-  }
-
-  const decimals = options.token === "eth" ? 18 : 6;
-  const amount = formatUnits(options.amount, decimals);
-
   const response = await apiClient.createPaymentTransferQuote({
     sourceType: CreatePaymentTransferQuoteBodySourceType.payment_method,
     source: {

package/actions/evm/fund/quoteFund.ts

@@ -1,23 +1,20 @@
 import { formatUnits } from "viem";
 
-import { Quote } from "./Quote.js";
 import { UserInputValidationError } from "../../../errors.js";
 import {
   CreatePaymentTransferQuoteBodySourceType,
   CreatePaymentTransferQuoteBodyTargetType,
   type CdpOpenApiClientType,
 } from "../../../openapi-client/index.js";
+import { EvmQuote } from "../../Quote.js";
+import { BaseQuoteFundOptions } from "../../types.js";
 
 /**
  * Options for getting a quote to fund an EVM account.
  */
-export interface QuoteFundOptions {
-  /** The address of the account. */
-  address: string;
+export interface EvmQuoteFundOptions extends BaseQuoteFundOptions {
   /** The network to request funds from. */
   network: "base" | "ethereum";
-  /** The amount to fund the account with, in atomic units (wei) of the token. */
-  amount: bigint;
   /** The token to request funds for. */
   token: "eth" | "usdc";
 }
@@ -32,8 +29,15 @@ export interface QuoteFundOptions {
  */
 export async function quoteFund(
   apiClient: CdpOpenApiClientType,
-  options: QuoteFundOptions,
-): Promise<Quote> {
+  options: EvmQuoteFundOptions,
+): Promise<EvmQuote> {
+  if (options.token !== "eth" && options.token !== "usdc") {
+    throw new UserInputValidationError("Invalid token, must be eth or usdc");
+  }
+
+  const decimals = options.token === "eth" ? 18 : 6;
+  const amount = formatUnits(options.amount, decimals);
+
   const paymentMethods = await apiClient.getPaymentMethods();
   const cardPaymentMethod = paymentMethods.find(
     method => method.type === "card" && method.actions.includes("source"),
@@ -43,13 +47,6 @@ export async function quoteFund(
     throw new Error("No card found to fund account");
   }
 
-  if (options.token !== "eth" && options.token !== "usdc") {
-    throw new UserInputValidationError("Invalid token, must be eth or usdc");
-  }
-
-  const decimals = options.token === "eth" ? 18 : 6;
-  const amount = formatUnits(options.amount, decimals);
-
   const response = await apiClient.createPaymentTransferQuote({
     sourceType: CreatePaymentTransferQuoteBodySourceType.payment_method,
     source: {
@@ -65,7 +62,7 @@ export async function quoteFund(
     currency: options.token,
   });
 
-  return new Quote(
+  return new EvmQuote(
     apiClient,
     response.transfer.id,
     options.network,

package/actions/evm/transfer/accountTransferStrategy.ts

@@ -1,6 +1,7 @@
 import { encodeFunctionData, erc20Abi } from "viem";
 
 import { getErc20Address } from "./utils.js";
+import { SendEvmTransactionBodyNetwork } from "../../../openapi-client/index.js";
 import { serializeEIP1559Transaction } from "../../../utils/serializeTransaction.js";
 
 import type { TransferExecutionStrategy } from "./types.js";
@@ -9,6 +10,7 @@ import type { TransactionResult } from "../sendTransaction.js";
 
 export const accountTransferStrategy: TransferExecutionStrategy<EvmAccount> = {
   executeTransfer: async ({ apiClient, from, to, value, token, network }) => {
+    network = network as SendEvmTransactionBodyNetwork;
     if (token === "eth") {
       return apiClient.sendEvmTransaction(from.address, {
         transaction: serializeEIP1559Transaction({

package/actions/evm/types.ts

@@ -1,11 +1,10 @@
-import { FundOptions } from "./fund/fund.js";
-import { Quote } from "./fund/Quote.js";
-import { QuoteFundOptions } from "./fund/quoteFund.js";
-import { FundOperationResult } from "./fund/types.js";
+import { FundOperationResult } from "../types.js";
 import {
   WaitForFundOperationOptions,
   WaitForFundOperationResult,
-} from "./fund/waitForFundOperationReceipt.js";
+} from "../waitForFundOperationReceipt.js";
+import { EvmFundOptions } from "./fund/fund.js";
+import { EvmQuoteFundOptions } from "./fund/quoteFund.js";
 import { SendUserOperationOptions, SendUserOperationReturnType } from "./sendUserOperation.js";
 import { KnownEvmNetworks } from "../../accounts/evm/types.js";
 import {
@@ -14,6 +13,7 @@ import {
   UserOperation,
 } from "../../client/evm/evm.types.js";
 import { Hex } from "../../types/misc.js";
+import { EvmQuote } from "../Quote.js";
 
 import type { ListTokenBalancesOptions, ListTokenBalancesResult } from "./listTokenBalances.js";
 import type { RequestFaucetOptions, RequestFaucetResult } from "./requestFaucet.js";
@@ -95,7 +95,7 @@ export type Actions = {
    * });
    * ```
    */
-  quoteFund: (options: Omit<QuoteFundOptions, "address">) => Promise<Quote>;
+  quoteFund: (options: Omit<EvmQuoteFundOptions, "address">) => Promise<EvmQuote>;
 
   /**
    * Funds an EVM account with the specified token amount.
@@ -118,7 +118,7 @@ export type Actions = {
    * });
    * ```
    */
-  fund: (options: Omit<FundOptions, "address">) => Promise<FundOperationResult>;
+  fund: (options: Omit<EvmFundOptions, "address">) => Promise<FundOperationResult>;
 
   /**
    * Waits for a fund operation to complete and returns the transfer receipt.

package/actions/solana/fund/fund.ts

@@ -0,0 +1,71 @@
+import { formatUnits } from "viem";
+
+import { UserInputValidationError } from "../../../errors.js";
+import {
+  CreatePaymentTransferQuoteBodySourceType,
+  CreatePaymentTransferQuoteBodyTargetType,
+  type CdpOpenApiClientType,
+} from "../../../openapi-client/index.js";
+import { BaseFundOptions, FundOperationResult } from "../../types.js";
+
+/**
+ * Options for funding a Solana account.
+ */
+export interface SolanaFundOptions extends BaseFundOptions {
+  /** The token to request funds for. */
+  token: "sol" | "usdc";
+}
+
+/**
+ * Funds a Solana account.
+ *
+ * @param apiClient - The API client.
+ * @param options - The options for funding a Solana account.
+ *
+ * @returns A promise that resolves to the fund operation result.
+ */
+export async function fund(
+  apiClient: CdpOpenApiClientType,
+  options: SolanaFundOptions,
+): Promise<FundOperationResult> {
+  if (options.token !== "sol" && options.token !== "usdc") {
+    throw new UserInputValidationError("Invalid token, must be sol or usdc");
+  }
+
+  const decimals = options.token === "sol" ? 9 : 6;
+  const amount = formatUnits(options.amount, decimals);
+
+  const paymentMethods = await apiClient.getPaymentMethods();
+  const cardPaymentMethod = paymentMethods.find(
+    method => method.type === "card" && method.actions.includes("source"),
+  );
+
+  if (!cardPaymentMethod) {
+    throw new Error("No card found to fund account");
+  }
+
+  const response = await apiClient.createPaymentTransferQuote({
+    sourceType: CreatePaymentTransferQuoteBodySourceType.payment_method,
+    source: {
+      id: cardPaymentMethod.id,
+    },
+    targetType: CreatePaymentTransferQuoteBodyTargetType.crypto_rail,
+    target: {
+      currency: options.token,
+      network: "solana",
+      address: options.address,
+    },
+    amount,
+    currency: options.token,
+    execute: true,
+  });
+
+  return {
+    id: response.transfer.id,
+    network: response.transfer.target.network,
+    status: response.transfer.status,
+    targetAmount: response.transfer.targetAmount,
+    targetCurrency: response.transfer.targetCurrency,
+    transactionHash: response.transfer.transactionHash,
+  };
+}