@coinbase/cdp-sdk 1.40.1 → 1.41.0

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

@@ -114,6 +114,66 @@ export type AuthenticationMethod =
  */
 export type AuthenticationMethods = AuthenticationMethod[];
 
+/**
+ * An object containing information about the end user's TOTP enrollment.
+ */
+export type MFAMethodsTotp = {
+  /** The date and time when the method was enrolled, in ISO 8601 format. */
+  enrolledAt: string;
+};
+
+/**
+ * Information about the end user's MFA enrollments.
+
+ */
+export interface MFAMethods {
+  /** The date and time when the end user was prompted for MFA enrollment, in ISO 8601 format. If the this field exists, and the user has no other enrolled MFA methods, then the user skipped MFA enrollment. */
+  enrollmentPromptedAt?: string;
+  /** An object containing information about the end user's TOTP enrollment. */
+  totp?: MFAMethodsTotp;
+}
+
+/**
+ * Information about an EVM account associated with an end user.
+ */
+export interface EndUserEvmAccount {
+  /**
+   * The address of the EVM account.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  address: string;
+  /** The date and time when the account was created, in ISO 8601 format. */
+  createdAt: string;
+}
+
+/**
+ * Information about an EVM smart account associated with an end user.
+ */
+export interface EndUserEvmSmartAccount {
+  /**
+   * The address of the EVM smart account.
+   * @pattern ^0x[0-9a-fA-F]{40}$
+   */
+  address: string;
+  /** The addresses of the EVM EOA accounts that own this smart account. Smart accounts can have multiple owners, such as when spend permissions are enabled. */
+  ownerAddresses: string[];
+  /** The date and time when the account was created, in ISO 8601 format. */
+  createdAt: string;
+}
+
+/**
+ * Information about a Solana account associated with an end user.
+ */
+export interface EndUserSolanaAccount {
+  /**
+   * The base58 encoded address of the Solana account.
+   * @pattern ^[1-9A-HJ-NP-Za-km-z]{32,44}$
+   */
+  address: string;
+  /** The date and time when the account was created, in ISO 8601 format. */
+  createdAt: string;
+}
+
 /**
  * Information about the end user.
  */
@@ -124,21 +184,28 @@ export interface EndUser {
    */
   userId: string;
   authenticationMethods: AuthenticationMethods;
+  mfaMethods?: MFAMethods;
   /**
    * **DEPRECATED**: Use `evmAccountObjects` instead for richer account information. The list of EVM account addresses associated with the end user. End users can have up to 10 EVM accounts.
    * @deprecated
    */
   evmAccounts: string[];
+  /** The list of EVM accounts associated with the end user. End users can have up to 10 EVM accounts. */
+  evmAccountObjects: EndUserEvmAccount[];
   /**
    * **DEPRECATED**: Use `evmSmartAccountObjects` instead for richer account information including owner relationships. The list of EVM smart account addresses associated with the end user. Each EVM EOA can own one smart account.
    * @deprecated
    */
   evmSmartAccounts: string[];
+  /** The list of EVM smart accounts associated with the end user. Each EVM EOA can own one smart account. */
+  evmSmartAccountObjects: EndUserEvmSmartAccount[];
   /**
    * **DEPRECATED**: Use `solanaAccountObjects` instead for richer account information. The list of Solana account addresses associated with the end user. End users can have up to 10 Solana accounts.
    * @deprecated
    */
   solanaAccounts: string[];
+  /** The list of Solana accounts associated with the end user. End users can have up to 10 Solana accounts. */
+  solanaAccountObjects: EndUserSolanaAccount[];
   /** The date and time when the end user was created, in ISO 8601 format. */
   createdAt: string;
 }
@@ -2505,10 +2572,10 @@ export interface WebhookTarget {
  * Additional metadata for the subscription.
  */
 export type WebhookSubscriptionResponseMetadata = {
-  /** Secret for webhook signature validation.
-
-**Note:** Webhooks are in beta and this interface is subject to change.
- */
+  /**
+   * Use the root-level `secret` field instead. Maintained for backward compatibility only.
+   * @deprecated
+   */
   secret?: string;
 };
 
@@ -2535,13 +2602,27 @@ service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detec
   isEnabled: boolean;
   /** Additional metadata for the subscription. */
   metadata?: WebhookSubscriptionResponseMetadata;
+  /** Secret for webhook signature validation. */
+  secret: string;
   /** Unique identifier for the subscription. */
   subscriptionId: string;
   target: WebhookTarget;
-  /** Label key for filtering events. Present when subscription uses traditional single-label format.
+  /**
+   * (Deprecated) Use `labels` field instead.
+
+Label key for filtering events. Present when subscription uses traditional single-label format.
+Maintained for backward compatibility only.
+
+   * @deprecated
    */
   labelKey?: string;
-  /** Label value for filtering events. Present when subscription uses traditional single-label format.
+  /**
+   * (Deprecated) Use `labels` field instead.
+
+Label value for filtering events. Present when subscription uses traditional single-label format.
+Maintained for backward compatibility only.
+
+   * @deprecated
    */
   labelValue?: string;
   /** Multi-label filters using total overlap logic. Total overlap means the subscription only triggers when events contain ALL these key-value pairs.
@@ -2569,7 +2650,10 @@ export type WebhookSubscriptionRequestMetadata = { [key: string]: unknown };
  * Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
 an event contains ALL the key-value pairs specified here. Additional labels on 
 the event are allowed and will not prevent matching.
-NOTE: Use either labels OR (labelKey + labelValue), not both.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
 
  */
 export type WebhookSubscriptionRequestLabels = { [key: string]: string };
@@ -2593,20 +2677,37 @@ The subscription will only receive events matching these types AND the label fil
       target?: WebhookTarget;
       /** Additional metadata for the subscription. */
       metadata?: WebhookSubscriptionRequestMetadata;
-      /** Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair 
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair 
 in addition to the event types. Only events matching both the event types AND this label filter will be delivered.
 NOTE: Use either (labelKey + labelValue) OR labels, not both.
- */
+
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
       labelKey?: string;
-      /** Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
 Only events with this exact label value will be delivered.
 NOTE: Use either (labelKey + labelValue) OR labels, not both.
- */
+
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
       labelValue?: string;
       /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
 an event contains ALL the key-value pairs specified here. Additional labels on 
 the event are allowed and will not prevent matching.
-NOTE: Use either labels OR (labelKey + labelValue), not both.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
  */
       labels?: WebhookSubscriptionRequestLabels;
     })
@@ -2623,20 +2724,37 @@ The subscription will only receive events matching these types AND the label fil
       target?: WebhookTarget;
       /** Additional metadata for the subscription. */
       metadata?: WebhookSubscriptionRequestMetadata;
-      /** Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair 
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair 
 in addition to the event types. Only events matching both the event types AND this label filter will be delivered.
 NOTE: Use either (labelKey + labelValue) OR labels, not both.
- */
+
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
       labelKey?: string;
-      /** Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
 Only events with this exact label value will be delivered.
 NOTE: Use either (labelKey + labelValue) OR labels, not both.
- */
+
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
       labelValue?: string;
       /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
 an event contains ALL the key-value pairs specified here. Additional labels on 
 the event are allowed and will not prevent matching.
-NOTE: Use either labels OR (labelKey + labelValue), not both.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
  */
       labels?: WebhookSubscriptionRequestLabels;
     });
@@ -2647,8 +2765,11 @@ NOTE: Use either labels OR (labelKey + labelValue), not both.
 export type WebhookSubscriptionUpdateRequestMetadata = { [key: string]: unknown };
 
 /**
- * Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
-an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+ * Multi-label filters that trigger only when an event contains ALL of these key-value pairs.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
 
  */
 export type WebhookSubscriptionUpdateRequestLabels = { [key: string]: string };
@@ -2671,16 +2792,31 @@ service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detec
       target?: WebhookTarget;
       /** Additional metadata for the subscription. */
       metadata?: WebhookSubscriptionUpdateRequestMetadata;
-      /** Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
-       */
-      labelKey?: string;
-      /** Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
-       */
-      labelValue?: string;
-      /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
-an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+      /** Multi-label filters that trigger only when an event contains ALL of these key-value pairs.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
  */
       labels?: WebhookSubscriptionUpdateRequestLabels;
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
+      labelKey?: string;
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
+      labelValue?: string;
     })
   | (unknown & {
       /** Description of the webhook subscription. */
@@ -2694,16 +2830,31 @@ service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detec
       target?: WebhookTarget;
       /** Additional metadata for the subscription. */
       metadata?: WebhookSubscriptionUpdateRequestMetadata;
-      /** Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
-       */
-      labelKey?: string;
-      /** Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
-       */
-      labelValue?: string;
-      /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when 
-an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+      /** Multi-label filters that trigger only when an event contains ALL of these key-value pairs.
+
+**Note:** Currently, labels are supported for onchain webhooks only.
+
+See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/webhooks/create-webhook-subscription#onchain-label-filtering).
  */
       labels?: WebhookSubscriptionUpdateRequestLabels;
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
+      labelKey?: string;
+      /**
+   * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
+
+Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+Maintained for backward compatibility only.
+
+   * @deprecated
+   */
+      labelValue?: string;
     });
 
 /**
@@ -2714,6 +2865,7 @@ export type X402Version = (typeof X402Version)[keyof typeof X402Version];
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 export const X402Version = {
   NUMBER_1: 1,
+  NUMBER_2: 2,
 } as const;
 
 /**
@@ -2761,22 +2913,22 @@ export interface X402ExactSolanaPayload {
 /**
  * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
  */
-export type X402PaymentPayloadScheme =
-  (typeof X402PaymentPayloadScheme)[keyof typeof X402PaymentPayloadScheme];
+export type X402V1PaymentPayloadScheme =
+  (typeof X402V1PaymentPayloadScheme)[keyof typeof X402V1PaymentPayloadScheme];
 
 // eslint-disable-next-line @typescript-eslint/no-redeclare
-export const X402PaymentPayloadScheme = {
+export const X402V1PaymentPayloadScheme = {
   exact: "exact",
 } as const;
 
 /**
  * The network of the blockchain to send payment on.
  */
-export type X402PaymentPayloadNetwork =
-  (typeof X402PaymentPayloadNetwork)[keyof typeof X402PaymentPayloadNetwork];
+export type X402V1PaymentPayloadNetwork =
+  (typeof X402V1PaymentPayloadNetwork)[keyof typeof X402V1PaymentPayloadNetwork];
 
 // eslint-disable-next-line @typescript-eslint/no-redeclare
-export const X402PaymentPayloadNetwork = {
+export const X402V1PaymentPayloadNetwork = {
   "base-sepolia": "base-sepolia",
   base: "base",
   "solana-devnet": "solana-devnet",
@@ -2786,40 +2938,130 @@ export const X402PaymentPayloadNetwork = {
 /**
  * The payload of the payment depending on the x402Version, scheme, and network.
  */
-export type X402PaymentPayloadPayload = X402ExactEvmPayload | X402ExactSolanaPayload;
+export type X402V1PaymentPayloadPayload = X402ExactEvmPayload | X402ExactSolanaPayload;
 
 /**
  * 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 {
+export interface X402V1PaymentPayload {
   x402Version: X402Version;
   /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
-  scheme: X402PaymentPayloadScheme;
+  scheme: X402V1PaymentPayloadScheme;
   /** The network of the blockchain to send payment on. */
-  network: X402PaymentPayloadNetwork;
+  network: X402V1PaymentPayloadNetwork;
+  /** The payload of the payment depending on the x402Version, scheme, and network. */
+  payload: X402V1PaymentPayloadPayload;
+}
+
+/**
+ * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
+ */
+export type X402V2PaymentRequirementsScheme =
+  (typeof X402V2PaymentRequirementsScheme)[keyof typeof X402V2PaymentRequirementsScheme];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const X402V2PaymentRequirementsScheme = {
+  exact: "exact",
+} as const;
+
+/**
+ * The optional additional scheme-specific payment info.
+ */
+export type X402V2PaymentRequirementsExtra = { [key: string]: unknown };
+
+/**
+ * The x402 protocol payment requirements that the resource server expects the client's payment payload to meet.
+ */
+export interface X402V2PaymentRequirements {
+  /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
+  scheme: X402V2PaymentRequirementsScheme;
+  /** The network of the blockchain to send payment on in caip2 format. */
+  network: string;
+  /**
+   * 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}|[1-9A-HJ-NP-Za-km-z]{32,44})$
+   */
+  asset: string;
+  /** The amount to pay for the resource in atomic units of the payment asset. */
+  amount: string;
+  /**
+   * 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}|[1-9A-HJ-NP-Za-km-z]{32,44})$
+   */
+  payTo: string;
+  /** The maximum time in seconds for the resource server to respond. */
+  maxTimeoutSeconds: number;
+  /** The optional additional scheme-specific payment info. */
+  extra?: X402V2PaymentRequirementsExtra;
+}
+
+/**
+ * Describes the resource being accessed in x402 protocol.
+ */
+export interface X402ResourceInfo {
+  /** The URL of the resource. */
+  url?: string;
+  /** The description of the resource. */
+  description?: string;
+  /** The MIME type of the resource response. */
+  mimeType?: string;
+}
+
+/**
+ * The payload of the payment depending on the x402Version, scheme, and network.
+ */
+export type X402V2PaymentPayloadPayload = X402ExactEvmPayload | X402ExactSolanaPayload;
+
+/**
+ * Optional protocol extensions.
+ */
+export type X402V2PaymentPayloadExtensions = { [key: string]: unknown };
+
+/**
+ * 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 X402V2PaymentPayload {
+  x402Version: X402Version;
   /** The payload of the payment depending on the x402Version, scheme, and network. */
-  payload: X402PaymentPayloadPayload;
+  payload: X402V2PaymentPayloadPayload;
+  accepted: X402V2PaymentRequirements;
+  resource?: X402ResourceInfo;
+  /** Optional protocol extensions. */
+  extensions?: X402V2PaymentPayloadExtensions;
 }
 
+/**
+ * The x402 protocol payment payload that the client attaches to x402-paid API requests to the resource server in the X-PAYMENT header.
+ */
+export type X402PaymentPayload = X402V1PaymentPayload | X402V2PaymentPayload;
+
 /**
  * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
  */
-export type X402PaymentRequirementsScheme =
-  (typeof X402PaymentRequirementsScheme)[keyof typeof X402PaymentRequirementsScheme];
+export type X402V1PaymentRequirementsScheme =
+  (typeof X402V1PaymentRequirementsScheme)[keyof typeof X402V1PaymentRequirementsScheme];
 
 // eslint-disable-next-line @typescript-eslint/no-redeclare
-export const X402PaymentRequirementsScheme = {
+export const X402V1PaymentRequirementsScheme = {
   exact: "exact",
 } as const;
 
 /**
  * The network of the blockchain to send payment on.
  */
-export type X402PaymentRequirementsNetwork =
-  (typeof X402PaymentRequirementsNetwork)[keyof typeof X402PaymentRequirementsNetwork];
+export type X402V1PaymentRequirementsNetwork =
+  (typeof X402V1PaymentRequirementsNetwork)[keyof typeof X402V1PaymentRequirementsNetwork];
 
 // eslint-disable-next-line @typescript-eslint/no-redeclare
-export const X402PaymentRequirementsNetwork = {
+export const X402V1PaymentRequirementsNetwork = {
   "base-sepolia": "base-sepolia",
   base: "base",
   "solana-devnet": "solana-devnet",
@@ -2829,38 +3071,38 @@ export const X402PaymentRequirementsNetwork = {
 /**
  * The optional JSON schema describing the resource output.
  */
-export type X402PaymentRequirementsOutputSchema = { [key: string]: unknown };
+export type X402V1PaymentRequirementsOutputSchema = { [key: string]: unknown };
 
 /**
  * The optional additional scheme-specific payment info.
  */
-export type X402PaymentRequirementsExtra = { [key: string]: unknown };
+export type X402V1PaymentRequirementsExtra = { [key: string]: unknown };
 
 /**
  * The x402 protocol payment requirements that the resource server expects the client's payment payload to meet.
  */
-export interface X402PaymentRequirements {
+export interface X402V1PaymentRequirements {
   /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
-  scheme: X402PaymentRequirementsScheme;
+  scheme: X402V1PaymentRequirementsScheme;
   /** The network of the blockchain to send payment on. */
-  network: X402PaymentRequirementsNetwork;
+  network: X402V1PaymentRequirementsNetwork;
   /** 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: Url;
+  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;
+  outputSchema?: X402V1PaymentRequirementsOutputSchema;
   /**
    * 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]$
+   * @pattern ^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
    */
   payTo: string;
   /** The maximum time in seconds for the resource server to respond. */
@@ -2871,13 +3113,18 @@ For Solana-based networks, payTo will be a base58-encoded Solana address.
 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]$
+   * @pattern ^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
    */
   asset: string;
   /** The optional additional scheme-specific payment info. */
-  extra?: X402PaymentRequirementsExtra;
+  extra?: X402V1PaymentRequirementsExtra;
 }
 
+/**
+ * The x402 protocol payment requirements that the resource server expects the client's payment payload to meet.
+ */
+export type X402PaymentRequirements = X402V1PaymentRequirements | X402V2PaymentRequirements;
+
 /**
  * The reason the payment is invalid on the x402 protocol.
  */
@@ -2948,6 +3195,24 @@ export const X402VerifyInvalidReason = {
     "invalid_exact_svm_payload_transaction_fee_payer_transferring_funds",
 } as const;
 
+/**
+ * The result when x402 payment verification fails.
+ */
+export interface X402VerifyPaymentRejection {
+  /** 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}|[1-9A-HJ-NP-Za-km-z]{32,44})$
+   */
+  payer?: string;
+}
+
 /**
  * The reason the payment settlement errored on the x402 protocol.
  */
@@ -2974,11 +3239,42 @@ export const X402SettleErrorReason = {
   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",
+  settle_exact_evm_transaction_confirmation_timed_out:
+    "settle_exact_evm_transaction_confirmation_timed_out",
+  settle_exact_node_failure: "settle_exact_node_failure",
+  settle_exact_failed_onchain: "settle_exact_failed_onchain",
   settle_exact_svm_block_height_exceeded: "settle_exact_svm_block_height_exceeded",
   settle_exact_svm_transaction_confirmation_timed_out:
     "settle_exact_svm_transaction_confirmation_timed_out",
 } as const;
 
+/**
+ * The result when x402 payment settlement fails.
+ */
+export interface X402SettlePaymentRejection {
+  /** 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}|[1-9A-HJ-NP-Za-km-z]{32,44})$
+   */
+  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]{64}|[1-9A-HJ-NP-Za-km-z]{87,88})$
+   */
+  transaction?: string;
+  /** The network where the settlement occurred. */
+  network?: string;
+}
+
 /**
  * The scheme of the payment protocol.
  */
@@ -3144,6 +3440,14 @@ export const OnrampQuotePaymentMethodTypeId = {
   CRYPTO_WALLET: "CRYPTO_WALLET",
 } as const;
 
+/**
+ * A valid URI.
+ * @minLength 5
+ * @maxLength 2048
+ * @pattern ^.*://.*$
+ */
+export type Uri = string;
+
 /**
  * An onramp session containing a ready-to-use onramp URL.
  */
@@ -3229,11 +3533,16 @@ export type X402VerifyResponseResponse = {
 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]$
+   * @pattern ^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
    */
   payer: string;
 };
 
+/**
+ * Invalid payment verification on the x402 protocol.
+ */
+export type X402VerifyInvalidErrorResponse = X402VerifyPaymentRejection;
+
 export type X402SettleResponseResponse = {
   /** Indicates whether the payment settlement is successful. */
   success: boolean;
@@ -3244,23 +3553,37 @@ export type X402SettleResponseResponse = {
 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]$
+   * @pattern ^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
    */
   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]$
+   * @pattern ^(0x[a-fA-F0-9]{64}|[1-9A-HJ-NP-Za-km-z]{87,88})$
    */
   transaction: string;
   /** The network where the settlement occurred. */
   network: string;
 };
 
+/**
+ * Unsuccessful payment settlement on the x402 protocol.
+ */
+export type X402SettleErrorResponse = X402SettlePaymentRejection;
+
+/**
+ * A map of CAIP-2 network or protocol family patterns to their supported signer addresses.
+ */
+export type X402SupportedPaymentKindsResponseResponseSigners = { [key: string]: string[] };
+
 export type X402SupportedPaymentKindsResponseResponse = {
   /** The list of supported payment kinds. */
   kinds: X402SupportedPaymentKind[];
+  /** The list of supported x402 extensions. */
+  extensions: string[];
+  /** A map of CAIP-2 network or protocol family patterns to their supported signer addresses. */
+  signers: X402SupportedPaymentKindsResponseResponseSigners;
 };
 
 /**
@@ -3300,6 +3623,8 @@ export type PageTokenParameter = string;
 export type CreateEndUserBodyEvmAccount = {
   /** If true, creates an EVM smart account and a default EVM EOA account as the owner. If false, only a EVM EOA account is created. */
   createSmartAccount?: boolean;
+  /** If true, enables spend permissions for the EVM smart account. */
+  enableSpendPermissions?: boolean;
 };
 
 /**
@@ -4057,11 +4382,11 @@ Use the [Onramp Buy Options API](https://docs.cdp.coinbase.com/api-reference/res
   country?: string;
   /** The ISO 3166-2 two letter state code (e.g. NY). Only required for US. */
   subdivision?: string;
-  /** URL to redirect the user to when they successfully complete a transaction. This URL will be embedded in the returned onramp URL as a query parameter. */
-  redirectUrl?: Url;
+  /** URI to redirect the user to when they successfully complete a transaction. This URI will be embedded in the returned onramp URI as a query parameter. */
+  redirectUrl?: Uri;
   /** The IP address of the end user requesting the onramp transaction. */
   clientIp?: string;
-  /** A unique string that represents the user in your app. This can be used to link individual transactions  together so you can retrieve the transaction history for your users. Prefix this string with “sandbox-”  (e.g. "sandbox-user-1234") to perform a sandbox transaction which will allow you to test your integration  without any real transfer of funds.
+  /** A unique string that represents the user in your app. This can be used to link individual transactions together so you can retrieve the transaction history for your users. Prefix this string with “sandbox-”  (e.g. "sandbox-user-1234") to perform a sandbox transaction which will allow you to test your integration  without any real transfer of funds.
 
 This value can be used with with [Onramp User Transactions API](https://docs.cdp.coinbase.com/api-reference/rest-api/onramp-offramp/get-onramp-transactions-by-id) to retrieve all transactions created by the user. */
   partnerUserRef?: string;