@coinbase/cdp-sdk 1.33.0 → 1.34.1

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

@@ -5,30 +5,103 @@
  * The Coinbase Developer Platform APIs - leading the world's transition onchain.
  * OpenAPI spec version: 2.0.0
  */
-export interface EvmAccount {
-  /**
-   * The 0x-prefixed, checksum EVM address.
-   * @pattern ^0x[0-9a-fA-F]{40}$
-   */
-  address: string;
+/**
+ * The type of authentication information.
+ */
+export type EmailAuthenticationType =
+  (typeof EmailAuthenticationType)[keyof typeof EmailAuthenticationType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const EmailAuthenticationType = {
+  email: "email",
+} as const;
+
+/**
+ * Information about an end user who authenticates using a one-time password sent to their email address.
+ */
+export interface EmailAuthentication {
+  /** The type of authentication information. */
+  type: EmailAuthenticationType;
+  /** The email address of the end user. */
+  email: string;
+}
+
+/**
+ * The type of authentication information.
+ */
+export type SmsAuthenticationType =
+  (typeof SmsAuthenticationType)[keyof typeof SmsAuthenticationType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const SmsAuthenticationType = {
+  sms: "sms",
+} as const;
+
+/**
+ * Information about an end user who authenticates using a one-time password sent to their phone number via SMS.
+ */
+export interface SmsAuthentication {
+  /** The type of authentication information. */
+  type: SmsAuthenticationType;
   /**
-   * An optional name for the account.
-Account names can consist of alphanumeric characters and hyphens, and be between 2 and 36 characters long.
-Account names are guaranteed to be unique across all EVM accounts in the developer's CDP Project.
-   * @pattern ^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   * The phone number of the end user in E.164 format.
+   * @pattern ^\+[1-9]\d{1,14}$
    */
-  name?: string;
-  /** The list of policy IDs that apply to the account. This will include both the project-level policy and the account-level policy, if one exists. */
-  policies?: string[];
-  /** The UTC ISO 8601 timestamp at which the account was created. */
-  createdAt?: string;
-  /** The UTC ISO 8601 timestamp at which the account was last updated. */
-  updatedAt?: string;
+  phoneNumber: string;
 }
 
-export interface ListResponse {
-  /** The token for the next page of items, if any. */
-  nextPageToken?: string;
+/**
+ * The type of authentication information.
+ */
+export type DeveloperJWTAuthenticationType =
+  (typeof DeveloperJWTAuthenticationType)[keyof typeof DeveloperJWTAuthenticationType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const DeveloperJWTAuthenticationType = {
+  jwt: "jwt",
+} as const;
+
+/**
+ * Information about an end user who authenticates using a JWT issued by the developer.
+ */
+export interface DeveloperJWTAuthentication {
+  /** The type of authentication information. */
+  type: DeveloperJWTAuthenticationType;
+  /** The key ID of the JWK used to sign the JWT. */
+  kid: string;
+  /** The unique identifier for the end user that is captured in the `sub` claim of the JWT. */
+  sub: string;
+}
+
+/**
+ * Information about how the end user is authenticated.
+ */
+export type AuthenticationMethod =
+  | EmailAuthentication
+  | SmsAuthentication
+  | DeveloperJWTAuthentication;
+
+/**
+ * The list of valid authentication methods linked to the end user.
+ */
+export type AuthenticationMethods = AuthenticationMethod[];
+
+/**
+ * Information about the end user.
+ */
+export interface EndUser {
+  /**
+   * A stable, unique identifier for the end user. The `userId` must be unique across all end users in the developer's CDP Project. It must be between 1 and 100 characters long and can only contain alphanumeric characters and hyphens.
+   * @pattern ^[a-zA-Z0-9-]{1,100}$
+   */
+  userId: string;
+  authenticationMethods: AuthenticationMethods;
+  /** The list of EVM accounts associated with the end user. Currently, only one EVM account is supported per end user. */
+  evmAccounts: string[];
+  /** The list of EVM smart accounts associated with the end user. Currently, only one EVM smart account is supported per end user. */
+  evmSmartAccounts: string[];
+  /** The list of Solana accounts associated with the end user. Currently, only one Solana account is supported per end user. */
+  solanaAccounts: string[];
 }
 
 /**
@@ -45,6 +118,7 @@ export const ErrorType = {
   idempotency_error: "idempotency_error",
   internal_server_error: "internal_server_error",
   invalid_request: "invalid_request",
+  invalid_sql_query: "invalid_sql_query",
   invalid_signature: "invalid_signature",
   malformed_transaction: "malformed_transaction",
   not_found: "not_found",
@@ -78,6 +152,32 @@ export interface Error {
   errorLink?: string;
 }
 
+export interface EvmAccount {
+  /**
+   * The 0x-prefixed, checksum EVM address.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  address: string;
+  /**
+   * An optional name for the account.
+Account names can consist of alphanumeric characters and hyphens, and be between 2 and 36 characters long.
+Account names are guaranteed to be unique across all EVM accounts in the developer's CDP Project.
+   * @pattern ^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  name?: string;
+  /** The list of policy IDs that apply to the account. This will include both the project-level policy and the account-level policy, if one exists. */
+  policies?: string[];
+  /** The UTC ISO 8601 timestamp at which the account was created. */
+  createdAt?: string;
+  /** The UTC ISO 8601 timestamp at which the account was last updated. */
+  updatedAt?: string;
+}
+
+export interface ListResponse {
+  /** The token for the next page of items, if any. */
+  nextPageToken?: string;
+}
+
 /**
  * The domain of the EIP-712 typed data.
  */
@@ -202,6 +302,20 @@ export interface UserOperationReceiptRevert {
  */
 export interface UserOperationReceipt {
   revert?: UserOperationReceiptRevert;
+  /**
+   * The hash of this transaction as 0x-prefixed string.
+   * @pattern ^0x[a-fA-F0-9]{64}$
+   */
+  transactionHash?: string;
+  /**
+   * The block hash of the block including the transaction as 0x-prefixed string.
+   * @pattern ^0x[0-9a-fA-F]{64}$|^$
+   */
+  blockHash?: string;
+  /** The block height (number) of the block including the transaction. */
+  blockNumber?: number;
+  /** The gas used for landing this user operation. */
+  gasUsed?: string;
 }
 
 /**
@@ -240,21 +354,33 @@ export interface EvmUserOperation {
   receipts?: UserOperationReceipt[];
 }
 
+/**
+ * The network the spend permission is on.
+ */
+export type SpendPermissionNetwork =
+  (typeof SpendPermissionNetwork)[keyof typeof SpendPermissionNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const SpendPermissionNetwork = {
+  base: "base",
+  "base-sepolia": "base-sepolia",
+  ethereum: "ethereum",
+  "ethereum-sepolia": "ethereum-sepolia",
+  optimism: "optimism",
+  arbitrum: "arbitrum",
+  avalanche: "avalanche",
+  polygon: "polygon",
+} as const;
+
 export interface CreateSpendPermissionRequest {
-  /** The network of the spend permission. */
-  network: string;
-  /**
-   * Smart account this spend permission is valid for.
-   * @pattern ^0x[a-fA-F0-9]{40}$
-   */
-  account: string;
+  network: SpendPermissionNetwork;
   /**
-   * Entity that can spend account's tokens.
+   * Entity that can spend account's tokens. Can be either a Smart Account or an EOA.
    * @pattern ^0x[a-fA-F0-9]{40}$
    */
   spender: string;
   /**
-   * Token address (ERC-7528 native token address or ERC-20 contract).
+   * ERC-7528 native token address (e.g. "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE" for native ETH), or an  ERC-20 contract address.
    * @pattern ^0x[a-fA-F0-9]{40}$
    */
   token: string;
@@ -296,32 +422,31 @@ export interface SpendPermission {
   /** Maximum allowed value to spend, in atomic units for the specified token, within each period. */
   allowance: string;
   /** Time duration for resetting used allowance on a recurring basis (seconds). */
-  period?: string;
+  period: string;
   /** The start time for this spend permission, in Unix seconds. */
-  start?: string;
+  start: string;
   /** The expiration time for this spend permission, in Unix seconds. */
-  end?: string;
+  end: string;
   /** An arbitrary salt to differentiate unique spend permissions with otherwise identical data. */
-  salt?: string;
+  salt: string;
   /** Arbitrary data to include in the permission. */
-  extraData?: string;
+  extraData: string;
 }
 
 export interface SpendPermissionResponseObject {
-  permission?: SpendPermission;
+  permission: SpendPermission;
   /** Unique hash identifier for this permission. */
-  permissionHash?: string;
+  permissionHash: string;
   /** Whether this permission has been revoked. */
-  revoked?: boolean;
+  revoked: boolean;
   /** The UTC ISO 8601 timestamp when the permission was revoked (if applicable). */
   revokedAt?: string;
   /** The UTC ISO 8601 timestamp when the permission was created. */
-  createdAt?: string;
+  createdAt: string;
 }
 
 export interface RevokeSpendPermissionRequest {
-  /** The network of the spend permission. */
-  network: string;
+  network: SpendPermissionNetwork;
   /** The hash of the spend permission to revoke. */
   permissionHash: string;
   /** The paymaster URL of the spend permission. */
@@ -1032,6 +1157,14 @@ export type EvmNetworkCriterionNetworksItem =
 export const EvmNetworkCriterionNetworksItem = {
   "base-sepolia": "base-sepolia",
   base: "base",
+  ethereum: "ethereum",
+  "ethereum-sepolia": "ethereum-sepolia",
+  avalanche: "avalanche",
+  polygon: "polygon",
+  optimism: "optimism",
+  arbitrum: "arbitrum",
+  zora: "zora",
+  bnb: "bnb",
 } as const;
 
 /**
@@ -1847,6 +1980,355 @@ export interface SolanaTokenBalance {
   token: SolanaToken;
 }
 
+/**
+ * Request to execute a SQL query against indexed blockchain data.
+ */
+export interface OnchainDataQuery {
+  /**
+   * SQL query to execute against the indexed blockchain data.
+   * @minLength 1
+   * @maxLength 10000
+   */
+  sql: string;
+}
+
+/**
+ * Row data with column names as keys.
+ */
+export type OnchainDataResultResultItem = { [key: string]: unknown };
+
+/**
+ * Column data type (ClickHouse types).
+ */
+export type OnchainDataResultSchemaColumnsItemType =
+  (typeof OnchainDataResultSchemaColumnsItemType)[keyof typeof OnchainDataResultSchemaColumnsItemType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const OnchainDataResultSchemaColumnsItemType = {
+  String: "String",
+  UInt8: "UInt8",
+  UInt16: "UInt16",
+  UInt32: "UInt32",
+  UInt64: "UInt64",
+  UInt128: "UInt128",
+  UInt256: "UInt256",
+  Int8: "Int8",
+  Int16: "Int16",
+  Int32: "Int32",
+  Int64: "Int64",
+  Int128: "Int128",
+  Int256: "Int256",
+  Float32: "Float32",
+  Float64: "Float64",
+  Bool: "Bool",
+  Date: "Date",
+  DateTime: "DateTime",
+  DateTime64: "DateTime64",
+  UUID: "UUID",
+} as const;
+
+export type OnchainDataResultSchemaColumnsItem = {
+  /** Column name. */
+  name?: string;
+  /** Column data type (ClickHouse types). */
+  type?: OnchainDataResultSchemaColumnsItemType;
+};
+
+/**
+ * Schema information for the query result. This is a derived schema from the query result, so types may not match the underlying table.
+
+ */
+export type OnchainDataResultSchema = {
+  /** Column definitions. */
+  columns?: OnchainDataResultSchemaColumnsItem[];
+};
+
+/**
+ * Metadata about query execution.
+ */
+export type OnchainDataResultMetadata = {
+  /** Whether the result was served from cache. */
+  cached?: boolean;
+  /** Query execution time in milliseconds. */
+  executionTimeMs?: number;
+  /** Number of rows returned. */
+  rowCount?: number;
+};
+
+/**
+ * Result of executing a SQL query.
+ */
+export interface OnchainDataResult {
+  /** Query result as an array of objects representing rows. */
+  result?: OnchainDataResultResultItem[];
+  /** Schema information for the query result. This is a derived schema from the query result, so types may not match the underlying table.
+   */
+  schema?: OnchainDataResultSchema;
+  /** Metadata about query execution. */
+  metadata?: OnchainDataResultMetadata;
+}
+
+/**
+ * Response containing token addresses that an account has received.
+ */
+export interface AccountTokenAddressesResponse {
+  /** The account address that was queried. */
+  accountAddress?: string;
+  /** List of token contract addresses that the account has received. */
+  tokenAddresses?: string[];
+  /**
+   * Total number of unique token addresses discovered.
+   * @minimum 0
+   */
+  totalCount?: number;
+}
+
+/**
+ * The version of the x402 protocol.
+ */
+export type X402Version = (typeof X402Version)[keyof typeof X402Version];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402Version = {
+  NUMBER_1: 1,
+} as const;
+
+/**
+ * The authorization data for the ERC-3009 authorization message.
+ */
+export type X402ExactEvmPayloadAuthorization = {
+  /**
+   * The 0x-prefixed, checksum EVM address of the sender of the payment.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  from: string;
+  /**
+   * The 0x-prefixed, checksum EVM address of the recipient of the payment.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  to: string;
+  /** The value of the payment, in atomic units of the payment asset. */
+  value: string;
+  /** The unix timestamp after which the payment is valid. */
+  validAfter: string;
+  /** The unix timestamp before which the payment is valid. */
+  validBefore: string;
+  /** The hex-encoded nonce of the payment. */
+  nonce: string;
+};
+
+/**
+ * The x402 protocol exact scheme payload for EVM networks. The scheme is implemented using ERC-3009. For more details, please see [EVM Exact Scheme Details](https://github.com/coinbase/x402/blob/main/specs/schemes/exact/scheme_exact_evm.md).
+ */
+export interface X402ExactEvmPayload {
+  /** The EIP-712 hex-encoded signature of the ERC-3009 authorization message. */
+  signature: string;
+  /** The authorization data for the ERC-3009 authorization message. */
+  authorization: X402ExactEvmPayloadAuthorization;
+}
+
+/**
+ * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
+ */
+export type X402PaymentPayloadScheme =
+  (typeof X402PaymentPayloadScheme)[keyof typeof X402PaymentPayloadScheme];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402PaymentPayloadScheme = {
+  exact: "exact",
+} as const;
+
+/**
+ * The network of the blockchain to send payment on.
+ */
+export type X402PaymentPayloadNetwork =
+  (typeof X402PaymentPayloadNetwork)[keyof typeof X402PaymentPayloadNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402PaymentPayloadNetwork = {
+  "base-sepolia": "base-sepolia",
+  base: "base",
+} as const;
+
+/**
+ * The x402 protocol payment payload that the client attaches to x402-paid API requests to the resource server in the X-PAYMENT header.
+ */
+export interface X402PaymentPayload {
+  x402Version: X402Version;
+  /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
+  scheme: X402PaymentPayloadScheme;
+  /** The network of the blockchain to send payment on. */
+  network: X402PaymentPayloadNetwork;
+  /** The payload of the payment depending on the x402Version, scheme, and network. */
+  payload: X402ExactEvmPayload;
+}
+
+/**
+ * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
+ */
+export type X402PaymentRequirementsScheme =
+  (typeof X402PaymentRequirementsScheme)[keyof typeof X402PaymentRequirementsScheme];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402PaymentRequirementsScheme = {
+  exact: "exact",
+} as const;
+
+/**
+ * The network of the blockchain to send payment on.
+ */
+export type X402PaymentRequirementsNetwork =
+  (typeof X402PaymentRequirementsNetwork)[keyof typeof X402PaymentRequirementsNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402PaymentRequirementsNetwork = {
+  "base-sepolia": "base-sepolia",
+  base: "base",
+} as const;
+
+/**
+ * The optional JSON schema describing the resource output.
+ */
+export type X402PaymentRequirementsOutputSchema = { [key: string]: unknown };
+
+/**
+ * The optional additional scheme-specific payment info.
+ */
+export type X402PaymentRequirementsExtra = { [key: string]: unknown };
+
+/**
+ * The x402 protocol payment requirements that the resource server expects the client's payment payload to meet.
+ */
+export interface X402PaymentRequirements {
+  /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
+  scheme: X402PaymentRequirementsScheme;
+  /** The network of the blockchain to send payment on. */
+  network: X402PaymentRequirementsNetwork;
+  /** The maximum amount required to pay for the resource in atomic units of the payment asset. */
+  maxAmountRequired: string;
+  /** The URL of the resource to pay for. */
+  resource: string;
+  /** The description of the resource. */
+  description: string;
+  /** The MIME type of the resource response. */
+  mimeType: string;
+  /** The optional JSON schema describing the resource output. */
+  outputSchema?: X402PaymentRequirementsOutputSchema;
+  /**
+   * The destination to pay value to.
+
+For EVM networks, payTo will be a 0x-prefixed, checksum EVM address.
+
+For Solana-based networks, payTo will be a base58-encoded Solana address.
+   * @pattern ^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  payTo: string;
+  /** The maximum time in seconds for the resource server to respond. */
+  maxTimeoutSeconds: number;
+  /**
+   * The asset to pay with.
+
+For EVM networks, the asset will be a 0x-prefixed, checksum EVM address.
+
+For Solana-based networks, the asset will be a base58-encoded Solana address.
+   * @pattern ^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  asset: string;
+  /** The optional additional scheme-specific payment info. */
+  extra?: X402PaymentRequirementsExtra;
+}
+
+/**
+ * The reason the payment is invalid on the x402 protocol.
+ */
+export type X402VerifyInvalidReason =
+  (typeof X402VerifyInvalidReason)[keyof typeof X402VerifyInvalidReason];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402VerifyInvalidReason = {
+  insufficient_funds: "insufficient_funds",
+  invalid_scheme: "invalid_scheme",
+  invalid_network: "invalid_network",
+  invalid_x402_version: "invalid_x402_version",
+  invalid_payment_requirements: "invalid_payment_requirements",
+  invalid_payload: "invalid_payload",
+  invalid_exact_evm_payload_authorization_value: "invalid_exact_evm_payload_authorization_value",
+  invalid_exact_evm_payload_authorization_valid_after:
+    "invalid_exact_evm_payload_authorization_valid_after",
+  invalid_exact_evm_payload_authorization_valid_before:
+    "invalid_exact_evm_payload_authorization_valid_before",
+  invalid_exact_evm_payload_authorization_typed_data_message:
+    "invalid_exact_evm_payload_authorization_typed_data_message",
+  invalid_exact_evm_payload_authorization_from_address_kyt:
+    "invalid_exact_evm_payload_authorization_from_address_kyt",
+  invalid_exact_evm_payload_authorization_to_address_kyt:
+    "invalid_exact_evm_payload_authorization_to_address_kyt",
+  invalid_exact_evm_payload_signature: "invalid_exact_evm_payload_signature",
+  invalid_exact_evm_payload_signature_address: "invalid_exact_evm_payload_signature_address",
+} as const;
+
+/**
+ * The reason the payment settlement errored on the x402 protocol.
+ */
+export type X402SettleErrorReason =
+  (typeof X402SettleErrorReason)[keyof typeof X402SettleErrorReason];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402SettleErrorReason = {
+  insufficient_funds: "insufficient_funds",
+  invalid_scheme: "invalid_scheme",
+  invalid_network: "invalid_network",
+  invalid_x402_version: "invalid_x402_version",
+  invalid_payment_requirements: "invalid_payment_requirements",
+  invalid_payload: "invalid_payload",
+  invalid_exact_evm_payload_authorization_value: "invalid_exact_evm_payload_authorization_value",
+  invalid_exact_evm_payload_authorization_valid_after:
+    "invalid_exact_evm_payload_authorization_valid_after",
+  invalid_exact_evm_payload_authorization_valid_before:
+    "invalid_exact_evm_payload_authorization_valid_before",
+  invalid_exact_evm_payload_authorization_typed_data_message:
+    "invalid_exact_evm_payload_authorization_typed_data_message",
+  invalid_exact_evm_payload_authorization_from_address_kyt:
+    "invalid_exact_evm_payload_authorization_from_address_kyt",
+  invalid_exact_evm_payload_authorization_to_address_kyt:
+    "invalid_exact_evm_payload_authorization_to_address_kyt",
+  invalid_exact_evm_payload_signature_address: "invalid_exact_evm_payload_signature_address",
+} as const;
+
+/**
+ * The scheme of the payment protocol.
+ */
+export type X402SupportedPaymentKindScheme =
+  (typeof X402SupportedPaymentKindScheme)[keyof typeof X402SupportedPaymentKindScheme];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402SupportedPaymentKindScheme = {
+  exact: "exact",
+} as const;
+
+/**
+ * The network of the blockchain.
+ */
+export type X402SupportedPaymentKindNetwork =
+  (typeof X402SupportedPaymentKindNetwork)[keyof typeof X402SupportedPaymentKindNetwork];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402SupportedPaymentKindNetwork = {
+  "base-sepolia": "base-sepolia",
+  base: "base",
+} as const;
+
+/**
+ * The supported payment kind for the x402 protocol. A kind is comprised of a scheme and a network, which together uniquely identify a way to move money on the x402 protocol. For more details, please see [x402 Schemes](https://github.com/coinbase/x402?tab=readme-ov-file#schemes).
+ */
+export interface X402SupportedPaymentKind {
+  x402Version: X402Version;
+  /** The scheme of the payment protocol. */
+  scheme: X402SupportedPaymentKindScheme;
+  /** The network of the blockchain. */
+  network: X402SupportedPaymentKindNetwork;
+}
+
 /**
  * The action of the payment method.
  */
@@ -2211,11 +2693,65 @@ export type IdempotencyErrorResponse = Error;
  */
 export type AlreadyExistsErrorResponse = Error;
 
+/**
+ * The underlying SQL string is invalid.
+ */
+export type InvalidSQLQueryErrorResponse = Error;
+
 /**
  * Unauthorized.
  */
 export type UnauthorizedErrorResponse = Error;
 
+/**
+ * The request timed out.
+ */
+export type TimedOutErrorResponse = Error;
+
+export type X402VerifyResponseResponse = {
+  /** Indicates whether the payment is valid. */
+  isValid: boolean;
+  invalidReason?: X402VerifyInvalidReason;
+  /**
+   * The onchain address of the client that is paying for the resource.
+
+For EVM networks, the payer will be a 0x-prefixed, checksum EVM address.
+
+For Solana-based networks, the payer will be a base58-encoded Solana address.
+   * @pattern ^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  payer: string;
+};
+
+export type X402SettleResponseResponse = {
+  /** Indicates whether the payment settlement is successful. */
+  success: boolean;
+  errorReason?: X402SettleErrorReason;
+  /**
+   * The onchain address of the client that is paying for the resource.
+
+For EVM networks, the payer will be a 0x-prefixed, checksum EVM address.
+
+For Solana-based networks, the payer will be a base58-encoded Solana address.
+   * @pattern ^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  payer: string;
+  /**
+   * The transaction of the settlement.
+For EVM networks, the transaction will be a 0x-prefixed, EVM transaction hash.
+For Solana-based networks, the transaction will be a base58-encoded Solana signature.
+   * @pattern ^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  transaction: string;
+  /** The network where the settlement occurred. */
+  network: string;
+};
+
+export type X402SupportedPaymentKindsResponseResponse = {
+  /** The list of supported payment kinds. */
+  kinds: X402SupportedPaymentKind[];
+};
+
 /**
  * Rate limit exceeded.
  */
@@ -2237,6 +2773,14 @@ Refer to our [Idempotency docs](https://docs.cdp.coinbase.com/api-reference/v2/i
  */
 export type IdempotencyKeyParameter = string;
 
+/**
+ * The request body for a developer to verify an end user's access token.
+ */
+export type ValidateEndUserAccessTokenBody = {
+  /** The access token in JWT format to verify. */
+  accessToken: string;
+};
+
 export type ListEvmAccountsParams = {
   /**
    * The number of accounts to return per page.
@@ -2806,6 +3350,36 @@ export type ListSolanaTokenBalances200AllOf = {
 
 export type ListSolanaTokenBalances200 = ListSolanaTokenBalances200AllOf & ListResponse;
 
+export type ListDataTokenBalancesParams = {
+  /**
+   * 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 ListDataTokenBalances200AllOf = {
+  /** The list of EVM token balances. */
+  balances: TokenBalance[];
+};
+
+export type ListDataTokenBalances200 = ListDataTokenBalances200AllOf & ListResponse;
+
+export type VerifyX402PaymentBody = {
+  x402Version: X402Version;
+  paymentPayload: X402PaymentPayload;
+  paymentRequirements: X402PaymentRequirements;
+};
+
+export type SettleX402PaymentBody = {
+  x402Version: X402Version;
+  paymentPayload: X402PaymentPayload;
+  paymentRequirements: X402PaymentRequirements;
+};
+
 export type GetCryptoRailsParams = {
   /**
    * Comma separated list of networks to filter the rails by.