@coinbase/cdp-sdk 1.2.0 → 1.3.1

package/client/evm/evm.types.ts

@@ -1,18 +1,19 @@
-import { SendUserOperationReturnType } from "../../actions/evm/sendUserOperation.js";
-import { Call, Calls } from "../../types/calls.js";
-import { Address, Hex } from "../../types/misc.js";
-import { WaitOptions } from "../../utils/wait.js";
-
-import type {
+import {
   EvmAccount as Account,
   EvmServerAccount as ServerAccount,
   EvmSmartAccount as SmartAccount,
 } from "../../accounts/types.js";
-import type {
+import { SendUserOperationReturnType } from "../../actions/evm/sendUserOperation.js";
+import {
   EvmUserOperationNetwork,
   EvmUserOperationStatus,
   OpenApiEvmMethods,
+  ListEvmTokenBalancesNetwork,
+  SendEvmTransactionBodyNetwork,
 } from "../../openapi-client/index.js";
+import { Call, Calls } from "../../types/calls.js";
+import { Address, Hex, TransactionRequestEIP1559 } from "../../types/misc.js";
+import { WaitOptions } from "../../utils/wait.js";
 
 /**
  * The EvmClient type, where all OpenApiEvmMethods methods are wrapped.
@@ -25,15 +26,16 @@ export type EvmClientInterface = Omit<
   | "getEvmAccountByName" // mapped to getAccount
   | "getEvmSmartAccount" // mapped to getSmartAccount
   | "getUserOperation"
-  | "listEVMBalances" // omit
   | "listEvmAccounts" // mapped to listAccounts
   | "listEvmSmartAccounts" // mapped to listSmartAccounts
+  | "listEvmTokenBalances" // mapped to listTokenBalances
   | "prepareUserOperation"
   | "requestEvmFaucet" // mapped to requestFaucet
   | "sendUserOperation"
   | "signEvmHash" // mapped to signHash
   | "signEvmMessage" // mapped to signMessage
   | "signEvmTransaction" // mapped to signTransaction
+  | "sendEvmTransaction" // mapped to sendTransaction
 > & {
   createAccount: (options: CreateServerAccountOptions) => Promise<ServerAccount>;
   createSmartAccount: (options: CreateSmartAccountOptions) => Promise<SmartAccount>;
@@ -42,8 +44,10 @@ export type EvmClientInterface = Omit<
   getUserOperation: (options: GetUserOperationOptions) => Promise<UserOperation>;
   listAccounts: (options: ListServerAccountsOptions) => Promise<ListServerAccountResult>;
   listSmartAccounts: (options: ListSmartAccountsOptions) => Promise<ListSmartAccountResult>;
+  listTokenBalances: (options: ListTokenBalancesOptions) => Promise<ListTokenBalancesResult>;
   prepareUserOperation: (options: PrepareUserOperationOptions) => Promise<UserOperation>;
   requestFaucet: (options: RequestFaucetOptions) => Promise<RequestFaucetResult>;
+  sendTransaction: (options: SendTransactionOptions) => Promise<TransactionResult>;
   sendUserOperation: (options: SendUserOperationOptions) => Promise<SendUserOperationReturnType>;
   signHash: (options: SignHashOptions) => Promise<SignatureResult>;
   signMessage: (options: SignMessageOptions) => Promise<SignatureResult>;
@@ -230,6 +234,29 @@ export interface RequestFaucetResult {
   transactionHash: Hex;
 }
 
+/**
+ * Options for sending an EVM transaction.
+ */
+export interface SendTransactionOptions {
+  /** The address of the account. */
+  address: Address;
+  /**
+   * The transaction to send. The chainId is ignored in favor of the `network` field.
+   *
+   * This can be either:
+   * - An RLP-encoded transaction to sign and send, as a 0x-prefixed hex string, or
+   * - An EIP-1559 transaction request object.
+   */
+  transaction: Hex | TransactionRequestEIP1559;
+  /**
+   * The network to send the transaction to.
+   * The chainId in the `transaction` field is ignored in favor of this field.
+   */
+  network: SendEvmTransactionBodyNetwork;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+}
+
 /**
  * Options for sending a user operation.
  */
@@ -290,6 +317,14 @@ export interface SignatureResult {
   signature: Hex;
 }
 
+/**
+ * Result of a transaction
+ */
+export interface TransactionResult {
+  /** The hash of the transaction. */
+  transactionHash: Hex;
+}
+
 /**
  * Options for waiting for a user operation.
  */
@@ -301,3 +336,73 @@ export interface WaitForUserOperationOptions {
   /** The wait options. */
   waitOptions?: WaitOptions;
 }
+
+/**
+ * Options for listing EVM token balances.
+ */
+export interface ListTokenBalancesOptions {
+  /** The address of the account. */
+  address: Address;
+  /** The network. */
+  network: ListEvmTokenBalancesNetwork;
+  /** The page size to paginate through the token balances. */
+  pageSize?: number;
+  /** The page token to paginate through the token balances. */
+  pageToken?: string;
+}
+
+/**
+ * A token on an EVM network, which is either an ERC-20 or a native token (i.e. ETH).
+ */
+export interface EvmToken {
+  /**
+   * The contract address of the token. For Ether, the contract address is 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
+   * per EIP-7528. For ERC-20 tokens, this is the contract address where the token is deployed.
+   */
+  contractAddress: Address;
+  /** The network the token is on. */
+  network: ListEvmTokenBalancesNetwork;
+  /**
+   * The symbol of the token, which is optional and non-unique. Note: This field
+   * may not be present for most tokens while the API is still under development.
+   */
+  symbol?: string;
+  /**
+   * The name of the token, which is optional and non-unique. Note: This field
+   * may not be present for most tokens while the API is still under development.
+   */
+  name?: string;
+}
+
+/**
+ * A token amount on an EVM network.
+ */
+export interface EvmTokenAmount {
+  /** The amount of the token in the smallest indivisible unit of the token. */
+  amount: bigint;
+  /** The number of decimals in the token. */
+  decimals: bigint;
+}
+
+/**
+ * An EVM token balance.
+ */
+export interface EvmTokenBalance {
+  /** The token. */
+  token: EvmToken;
+  /** The amount of the token. */
+  amount: EvmTokenAmount;
+}
+
+/**
+ * The result of listing EVM token balances.
+ */
+export interface ListTokenBalancesResult {
+  /** The token balances. */
+  balances: EvmTokenBalance[];
+  /**
+   * The next page token to paginate through the token balances.
+   * If undefined, there are no more token balances to paginate through.
+   */
+  nextPageToken?: string;
+}

package/openapi-client/cdpApiClient.ts

@@ -1,9 +1,15 @@
 // eslint-disable-next-line import/no-named-as-default
-import Axios, { AxiosInstance, AxiosRequestConfig, HttpStatusCode } from "axios";
+import Axios, { AxiosInstance, AxiosRequestConfig } from "axios";
 
-import { APIError, isOpenAPIError, HttpErrorType } from "./errors.js";
 import { withAuth } from "../auth/hooks/axios/index.js";
 import { ERROR_DOCS_PAGE_URL } from "../constants.js";
+import {
+  isOpenAPIError,
+  APIError,
+  HttpErrorType,
+  UnknownApiError,
+  UnknownError,
+} from "./errors.js";
 
 /**
  * The options for the CDP API.
@@ -115,6 +121,15 @@ export const cdpApiClient = async <T>(
     const response = await axiosInstance(configWithIdempotencyKey);
     return response.data as T;
   } catch (error) {
+    // eslint-disable-next-line import/no-named-as-default-member
+    if (Axios.isAxiosError(error) && !error.response) {
+      throw new UnknownApiError(
+        HttpErrorType.unknown,
+        error.cause instanceof Error ? error.cause.message : error.message,
+        error.cause,
+      );
+    }
+
     // eslint-disable-next-line import/no-named-as-default-member
     if (Axios.isAxiosError(error) && error.response) {
       if (isOpenAPIError(error.response.data)) {
@@ -124,6 +139,7 @@ export const cdpApiClient = async <T>(
           error.response.data.errorMessage,
           error.response.data.correlationId,
           error.response.data.errorLink,
+          error.cause,
         );
       } else {
         const statusCode = error.response.status;
@@ -135,6 +151,7 @@ export const cdpApiClient = async <T>(
               "Unauthorized.",
               undefined,
               `${ERROR_DOCS_PAGE_URL}#unauthorized`,
+              error.cause,
             );
           case 404:
             throw new APIError(
@@ -143,6 +160,7 @@ export const cdpApiClient = async <T>(
               "API not found.",
               undefined,
               `${ERROR_DOCS_PAGE_URL}#not_found`,
+              error.cause,
             );
           case 502:
             throw new APIError(
@@ -151,6 +169,7 @@ export const cdpApiClient = async <T>(
               "Bad gateway.",
               undefined,
               `${ERROR_DOCS_PAGE_URL}`,
+              error.cause,
             );
           case 503:
             throw new APIError(
@@ -159,6 +178,7 @@ export const cdpApiClient = async <T>(
               "Service unavailable. Please try again later.",
               undefined,
               `${ERROR_DOCS_PAGE_URL}`,
+              error.cause,
             );
           default:
             throw new APIError(
@@ -167,29 +187,16 @@ export const cdpApiClient = async <T>(
               "An unexpected error occurred.",
               undefined,
               `${ERROR_DOCS_PAGE_URL}`,
+              error.cause,
             );
         }
       }
-      // eslint-disable-next-line import/no-named-as-default-member
-    } else if (Axios.isAxiosError(error) && error.request) {
-      throw new APIError(
-        HttpStatusCode.ServiceUnavailable,
-        HttpErrorType.service_unavailable,
-        "Network error, unable to reach the service.",
-        undefined,
-        `${ERROR_DOCS_PAGE_URL}`,
-      );
-    } else {
-      throw new APIError(
-        HttpStatusCode.InternalServerError,
-        HttpErrorType.unexpected_error,
-        error instanceof Error
-          ? error.message
-          : `An unexpected error occurred: ${JSON.stringify(error, Object.getOwnPropertyNames(error))}`,
-        undefined,
-        `${ERROR_DOCS_PAGE_URL}`,
-      );
     }
+
+    throw new UnknownError(
+      "Something went wrong. Please reach out at https://discord.com/channels/1220414409550336183/1271495764580896789 for help.",
+      error instanceof Error ? error : undefined,
+    );
   }
 };
 

package/openapi-client/errors.ts

@@ -9,6 +9,7 @@ export const HttpErrorType = {
   not_found: "not_found",
   bad_gateway: "bad_gateway",
   service_unavailable: "service_unavailable",
+  unknown: "unknown",
 } as const;
 
 export type HttpErrorType = (typeof HttpErrorType)[keyof typeof HttpErrorType];
@@ -36,6 +37,7 @@ export class APIError extends Error {
    * @param errorMessage - The error message
    * @param correlationId - The correlation ID
    * @param errorLink - URL to documentation about this error
+   * @param cause - The cause of the error
    */
   constructor(
     statusCode: number,
@@ -43,8 +45,9 @@ export class APIError extends Error {
     errorMessage: string,
     correlationId?: string,
     errorLink?: string,
+    cause?: Error,
   ) {
-    super(errorMessage);
+    super(errorMessage, { cause });
     this.name = "APIError";
     this.statusCode = statusCode;
     this.errorType = errorType;
@@ -78,6 +81,39 @@ export class APIError extends Error {
   }
 }
 
+/**
+ * Error thrown when an Axios request is made but no response is received
+ */
+export class UnknownApiError extends APIError {
+  /**
+   * Constructor for the UnknownApiError class
+   *
+   * @param errorType - The type of error
+   * @param errorMessage - The error message
+   * @param cause - The cause of the error
+   */
+  constructor(errorType: APIErrorType, errorMessage: string, cause?: Error) {
+    super(0, errorType, errorMessage, undefined, undefined, cause);
+    this.name = "UnknownApiError";
+  }
+}
+
+/**
+ * Error thrown when an error is not known
+ */
+export class UnknownError extends Error {
+  /**
+   * Constructor for the UnknownError class
+   *
+   * @param message - The error message
+   * @param cause - The cause of the error
+   */
+  constructor(message: string, cause?: Error) {
+    super(message, { cause });
+    this.name = "UnknownError";
+  }
+}
+
 /**
  * Type guard to check if an object is an OpenAPIError
  *

package/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.ts

@@ -45,6 +45,7 @@ export const ErrorType = {
   request_canceled: "request_canceled",
   timed_out: "timed_out",
   unauthorized: "unauthorized",
+  policy_violation: "policy_violation",
 } as const;
 
 /**
@@ -138,6 +139,64 @@ export interface EvmUserOperation {
   transactionHash?: string;
 }
 
+/**
+ * The name of the supported EVM networks in human-readable format.
+ */
+export type ListEvmTokenBalancesNetwork =
+  (typeof ListEvmTokenBalancesNetwork)[keyof typeof ListEvmTokenBalancesNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const ListEvmTokenBalancesNetwork = {
+  base: "base",
+  "base-sepolia": "base-sepolia",
+} as const;
+
+/**
+ * Amount of a given token.
+ */
+export interface TokenAmount {
+  /**
+   * The amount is denominated in the smallest indivisible unit of the token. For ETH, the smallest indivisible unit is Wei (10^-18 ETH). For ERC-20s, the smallest unit is the unit returned from `function totalSupply() public view returns (uint256)`.
+   * @pattern ^[0-9]+$
+   */
+  amount: string;
+  /** 'decimals' is the exponential value N that satisfies the equation `amount * 10^-N = standard_denomination`. The standard denomination is the most commonly used denomination for the token.
+- In the case of the native gas token, `decimals` is defined via convention. As an example, for ETH of Ethereum mainnet, the standard denomination is 10^-18 the smallest denomination (Wei). As such, for ETH on Ethereum mainnet, `decimals` is 18. - In the case of ERC-20 tokens, `decimals` is defined via configuration. `decimals` will be the number returned by `function decimals() public view returns (uint8)` on the underlying token contract.
+Not all tokens have a `decimals` field, as this function is [optional in the ERC-20 specification](https://eips.ethereum.org/EIPS/eip-20#decimals). This field will be left empty if the underlying token contract doesn't implement `decimals`.
+Further, this endpoint will only populate this value for a small subset of whitelisted ERC-20 tokens at this time. We intend to improve coverage in the future. */
+  decimals: number;
+}
+
+/**
+ * General information about a token. Includes the type, the network, and other identifying information.
+ */
+export interface Token {
+  network: ListEvmTokenBalancesNetwork;
+  /** The symbol of this token (ex: SOL, ETH, USDC).
+The token symbol is not unique. It is possible for two different tokens to have the same symbol.
+For native gas tokens, this symbol is defined via convention. As an example, for ETH on Ethereum mainnet, the symbol is "ETH". For ERC-20 tokens, this symbol is defined via configuration. `symbol` will be the string returned by `function symbol() public view returns (string)` on the underlying token contract.
+Not all tokens have a symbol, as this function is [optional in the ERC-20 specification](https://eips.ethereum.org/EIPS/eip-20#symbol). This field will only be populated when the token's underlying ERC-20 contract has a `symbol()` function.
+Further, this endpoint will only populate this value for a small subset of whitelisted ERC-20 tokens at this time. We intend to improve coverage in the future. */
+  symbol?: string;
+  /** The name of this token (ex: "Solana", "Ether", "USD Coin").
+The token name is not unique. It is possible for two different tokens to have the same name.
+For native gas tokens, this name is defined via convention. As an example, for ETH on Ethereum mainnet, the name is "Ether". For ERC-20 tokens, this name is defined via configuration. `name` will be the string returned by `function name() public view returns (string)` on the underlying token contract.
+Not all tokens have a name, as this function is [optional in the ERC-20 specification](https://eips.ethereum.org/EIPS/eip-20#name). This field will only be populated when the token's underlying ERC-20 contract has a `name()` function.
+Further, this endpoint will only populate this value for a small subset of whitelisted ERC-20 tokens at this time. We intend to improve coverage in the future. */
+  name?: string;
+  /**
+   * The contract address of the token.
+For Ether, the contract address is `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` per [EIP-7528](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-7528.md). For ERC-20 tokens, this is the contract address where the token is deployed.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  contractAddress: string;
+}
+
+export interface TokenBalance {
+  amount: TokenAmount;
+  token: Token;
+}
+
 export interface SolanaAccount {
   /**
    * The base58 encoded Solana address.
@@ -170,7 +229,7 @@ export type AlreadyExistsErrorResponse = Error;
 
 /**
  * A JWT signed using your Wallet Secret, encoded in base64. Refer to the
-[Generate a Wallet Token](https://docs.cdp.coinbase.com/api-v2/docs/authentication#3-generate-a-wallet-token)
+[Generate Wallet Token](https://docs.cdp.coinbase.com/api-v2/docs/authentication#2-generate-wallet-token)
 section of our Authentication docs for more details on how to generate your Wallet Token.
 
  */
@@ -212,6 +271,30 @@ Account names must be unique across all EVM accounts in the developer's CDP Proj
   name?: string;
 };
 
+/**
+ * The network to send the transaction to.
+ */
+export type SendEvmTransactionBodyNetwork =
+  (typeof SendEvmTransactionBodyNetwork)[keyof typeof SendEvmTransactionBodyNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const SendEvmTransactionBodyNetwork = {
+  base: "base",
+  "base-sepolia": "base-sepolia",
+} as const;
+
+export type SendEvmTransactionBody = {
+  /** The network to send the transaction to. */
+  network: SendEvmTransactionBodyNetwork;
+  /** The RLP-encoded transaction to sign and send, as a 0x-prefixed hex string. */
+  transaction: string;
+};
+
+export type SendEvmTransaction200 = {
+  /** The hash of the transaction, as a 0x-prefixed hex string. */
+  transactionHash: string;
+};
+
 export type SignEvmTransactionBody = {
   /** The RLP-encoded transaction to sign, as a 0x-prefixed hex string. */
   transaction: string;
@@ -287,10 +370,28 @@ export type PrepareUserOperationBody = {
 };
 
 export type SendUserOperationBody = {
-  /** The hex-encoded signature of the user operation. */
+  /** The hex-encoded signature of the user operation. This should be a 65-byte signature consisting of the `r`, `s`, and `v` values of the ECDSA signature. Note that the `v` value should conform to the `personal_sign` standard, which means it should be 27 or 28. */
   signature: string;
 };
 
+export type ListEvmTokenBalancesParams = {
+  /**
+   * The number of balances to return per page.
+   */
+  pageSize?: number;
+  /**
+   * The token for the next page of balances. Will be empty if there are no more balances to fetch.
+   */
+  pageToken?: string;
+};
+
+export type ListEvmTokenBalances200AllOf = {
+  /** The list of EVM token balances. */
+  balances: TokenBalance[];
+};
+
+export type ListEvmTokenBalances200 = ListEvmTokenBalances200AllOf & ListResponse;
+
 /**
  * The network to request funds from.
  */

package/openapi-client/generated/evm-accounts/evm-accounts.msw.ts

@@ -12,6 +12,7 @@ import { HttpResponse, delay, http } from "msw";
 import type {
   EvmAccount,
   ListEvmAccounts200,
+  SendEvmTransaction200,
   SignEvmHash200,
   SignEvmMessage200,
   SignEvmTransaction200,
@@ -65,6 +66,10 @@ export const getGetEvmAccountByNameResponseMock = (
   ...overrideResponse,
 });
 
+export const getSendEvmTransactionResponseMock = (
+  overrideResponse: Partial<SendEvmTransaction200> = {},
+): SendEvmTransaction200 => ({ transactionHash: faker.string.alpha(20), ...overrideResponse });
+
 export const getSignEvmTransactionResponseMock = (
   overrideResponse: Partial<SignEvmTransaction200> = {},
 ): SignEvmTransaction200 => ({ signedTransaction: faker.string.alpha(20), ...overrideResponse });
@@ -163,6 +168,29 @@ export const getGetEvmAccountByNameMockHandler = (
   });
 };
 
+export const getSendEvmTransactionMockHandler = (
+  overrideResponse?:
+    | SendEvmTransaction200
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<SendEvmTransaction200> | SendEvmTransaction200),
+) => {
+  return http.post("*/v2/evm/accounts/:address/send/transaction", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getSendEvmTransactionResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
 export const getSignEvmTransactionMockHandler = (
   overrideResponse?:
     | SignEvmTransaction200
@@ -236,6 +264,7 @@ export const getEvmAccountsMock = () => [
   getCreateEvmAccountMockHandler(),
   getGetEvmAccountMockHandler(),
   getGetEvmAccountByNameMockHandler(),
+  getSendEvmTransactionMockHandler(),
   getSignEvmTransactionMockHandler(),
   getSignEvmHashMockHandler(),
   getSignEvmMessageMockHandler(),

package/openapi-client/generated/evm-accounts/evm-accounts.ts

@@ -10,6 +10,8 @@ import type {
   EvmAccount,
   ListEvmAccounts200,
   ListEvmAccountsParams,
+  SendEvmTransaction200,
+  SendEvmTransactionBody,
   SignEvmHash200,
   SignEvmHashBody,
   SignEvmMessage200,
@@ -74,6 +76,50 @@ export const getEvmAccountByName = (
     options,
   );
 };
+/**
+ * Signs a transaction with the given EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/).
+
+The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).
+
+
+**Transaction fields and API behavior**
+
+- `to` *(Required)*: The address of the contract or account to send the transaction to.
+- `chainId` *(Ignored)*: The value of the `chainId` field in the transaction is ignored.
+  The transaction will be sent to the network indicated by the `network` field in the request body.
+
+- `nonce` *(Optional)*: The nonce to use for the transaction. If not provided, the API will assign
+   a nonce to the transaction based on the current state of the account.
+
+- `maxPriorityFeePerGas` *(Optional)*: The maximum priority fee per gas to use for the transaction.
+   If not provided, the API will estimate a value based on current network conditions.
+
+- `maxFeePerGas` *(Optional)*: The maximum fee per gas to use for the transaction.
+   If not provided, the API will estimate a value based on current network conditions.
+
+- `gasLimit` *(Optional)*: The gas limit to use for the transaction. If not provided, the API will estimate a value
+  based on the `to` and `data` fields of the transaction.
+
+- `value` *(Optional)*: The amount of ETH, in wei, to send with the transaction.
+- `data` *(Optional)*: The data to send with the transaction; only used for contract calls.
+- `accessList` *(Optional)*: The access list to use for the transaction.
+ * @summary Send a transaction
+ */
+export const sendEvmTransaction = (
+  address: string,
+  sendEvmTransactionBody: SendEvmTransactionBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<SendEvmTransaction200>(
+    {
+      url: `/v2/evm/accounts/${address}/send/transaction`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: sendEvmTransactionBody,
+    },
+    options,
+  );
+};
 /**
  * Signs a transaction with the given EVM account.
 The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/).
@@ -98,9 +144,6 @@ export const signEvmTransaction = (
 };
 /**
  * Signs an arbitrary 32 byte hash with the given EVM account.
-
-
-**WARNING: This API will likely be deprecated in the future.** It is recommended not to depend on it. Never sign a hash that you didn't generate, as it can be an arbitrary transaction. For example, it might send all of your funds to an attacker.
  * @summary Sign a hash
  */
 export const signEvmHash = (
@@ -145,6 +188,7 @@ export type GetEvmAccountResult = NonNullable<Awaited<ReturnType<typeof getEvmAc
 export type GetEvmAccountByNameResult = NonNullable<
   Awaited<ReturnType<typeof getEvmAccountByName>>
 >;
+export type SendEvmTransactionResult = NonNullable<Awaited<ReturnType<typeof sendEvmTransaction>>>;
 export type SignEvmTransactionResult = NonNullable<Awaited<ReturnType<typeof signEvmTransaction>>>;
 export type SignEvmHashResult = NonNullable<Awaited<ReturnType<typeof signEvmHash>>>;
 export type SignEvmMessageResult = NonNullable<Awaited<ReturnType<typeof signEvmMessage>>>;

package/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.ts

@@ -99,6 +99,7 @@ export const getUserOperation = (
 };
 /**
  * Sends a user operation with a signature.
+The signature that is sent should be 65 bytes, consisting of the `r`, `s`, and `v` values of the ECDSA signature. Note that the `v` value should conform to the `personal_sign` standard, which means it should be 27 or 28.
  * @summary Send a user operation
  */
 export const sendUserOperation = (

package/openapi-client/generated/evm-token-balances/evm-token-balances.msw.ts

@@ -0,0 +1,57 @@
+/**
+ * Generated by orval v7.6.0 🍺
+ * Do not edit manually.
+ * Coinbase Developer Platform APIs
+ * The Coinbase Developer Platform APIs - leading the world's transition onchain.
+ * OpenAPI spec version: 2.0.0
+ */
+import { faker } from "@faker-js/faker";
+
+import { HttpResponse, delay, http } from "msw";
+
+import { ListEvmTokenBalancesNetwork } from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+import type { ListEvmTokenBalances200 } from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+export const getListEvmTokenBalancesResponseMock = (): ListEvmTokenBalances200 => ({
+  ...{
+    balances: Array.from({ length: faker.number.int({ min: 1, max: 10 }) }, (_, i) => i + 1).map(
+      () => ({
+        amount: {
+          amount: faker.helpers.fromRegExp("^[0-9]+$"),
+          decimals: faker.number.int({ min: undefined, max: undefined }),
+        },
+        token: {
+          network: faker.helpers.arrayElement(Object.values(ListEvmTokenBalancesNetwork)),
+          symbol: faker.helpers.arrayElement([faker.string.alpha(20), undefined]),
+          name: faker.helpers.arrayElement([faker.string.alpha(20), undefined]),
+          contractAddress: faker.helpers.fromRegExp("^0x[0-9a-fA-F]{40}$"),
+        },
+      }),
+    ),
+  },
+  ...{ nextPageToken: faker.helpers.arrayElement([faker.string.alpha(20), undefined]) },
+});
+
+export const getListEvmTokenBalancesMockHandler = (
+  overrideResponse?:
+    | ListEvmTokenBalances200
+    | ((
+        info: Parameters<Parameters<typeof http.get>[1]>[0],
+      ) => Promise<ListEvmTokenBalances200> | ListEvmTokenBalances200),
+) => {
+  return http.get("*/v2/evm/token-balances/:network/:address", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getListEvmTokenBalancesResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+export const getEvmTokenBalancesMock = () => [getListEvmTokenBalancesMockHandler()];