@coinbase/cdp-sdk 1.43.1 → 1.44.0

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

@@ -270,8 +270,6 @@ export const ErrorType = {
   mfa_flow_expired: "mfa_flow_expired",
   mfa_required: "mfa_required",
   mfa_not_enrolled: "mfa_not_enrolled",
-  mfa_multiple_methods_available: "mfa_multiple_methods_available",
-  mfa_invalid_method: "mfa_invalid_method",
 } as const;
 
 /**
@@ -2563,6 +2561,20 @@ export interface AccountTokenAddressesResponse {
   totalCount?: number;
 }
 
+/**
+ * A human-readable description.
+ * @minLength 0
+ * @maxLength 500
+ */
+export type Description = string;
+
+/**
+ * Optional metadata as key-value pairs. Use this to store additional structured information on a resource, such as customer IDs, order references, or any application-specific data. Up to 50 key/value pairs may be provided.  Keys and values are both strings. Keys must be ≤ 40 characters; values must be ≤ 500 characters.
+ */
+export interface Metadata {
+  [key: string]: string;
+}
+
 /**
  * Additional headers to include in webhook requests.
  */
@@ -2580,10 +2592,7 @@ export interface WebhookTarget {
   headers?: WebhookTargetHeaders;
 }
 
-/**
- * Additional metadata for the subscription.
- */
-export type WebhookSubscriptionResponseMetadata = {
+export type WebhookSubscriptionResponseMetadataAllOf = {
   /**
    * Use the root-level `secret` field instead. Maintained for backward compatibility only.
    * @deprecated
@@ -2591,6 +2600,12 @@ export type WebhookSubscriptionResponseMetadata = {
   secret?: string;
 };
 
+/**
+ * Additional metadata for the subscription.
+ */
+export type WebhookSubscriptionResponseMetadata = Metadata &
+  WebhookSubscriptionResponseMetadataAllOf;
+
 /**
  * Multi-label filters using total overlap logic. Total overlap means the subscription only triggers when events contain ALL these key-value pairs.
 Present when subscription uses multi-label format.
@@ -2605,8 +2620,8 @@ export interface WebhookSubscriptionResponse {
   /** When the subscription was created. */
   createdAt: string;
   /** Description of the webhook subscription. */
-  description?: string;
-  /** Types of events to subscribe to. Event types follow a three-part dot-separated format: 
+  description?: Description;
+  /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
 service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
  */
   eventTypes: string[];
@@ -2653,11 +2668,6 @@ export type WebhookSubscriptionListResponseAllOf = {
 
 export type WebhookSubscriptionListResponse = WebhookSubscriptionListResponseAllOf & ListResponse;
 
-/**
- * Additional metadata for the subscription.
- */
-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 
@@ -2678,8 +2688,8 @@ and multi-label filtering formats.
 export type WebhookSubscriptionRequest =
   | (unknown & {
       /** Description of the webhook subscription. */
-      description?: string;
-      /** Types of events to subscribe to. Event types follow a three-part dot-separated format: 
+      description?: Description;
+      /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
 service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
 The subscription will only receive events matching these types AND the label filter(s).
  */
@@ -2687,8 +2697,7 @@ The subscription will only receive events matching these types AND the label fil
       /** Whether the subscription is enabled. */
       isEnabled?: boolean;
       target?: WebhookTarget;
-      /** Additional metadata for the subscription. */
-      metadata?: WebhookSubscriptionRequestMetadata;
+      metadata?: Metadata;
       /**
    * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
 
@@ -2725,8 +2734,8 @@ See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-refe
     })
   | (unknown & {
       /** Description of the webhook subscription. */
-      description?: string;
-      /** Types of events to subscribe to. Event types follow a three-part dot-separated format: 
+      description?: Description;
+      /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
 service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
 The subscription will only receive events matching these types AND the label filter(s).
  */
@@ -2734,8 +2743,7 @@ The subscription will only receive events matching these types AND the label fil
       /** Whether the subscription is enabled. */
       isEnabled?: boolean;
       target?: WebhookTarget;
-      /** Additional metadata for the subscription. */
-      metadata?: WebhookSubscriptionRequestMetadata;
+      metadata?: Metadata;
       /**
    * (Deprecated) Use `labels` instead for better filtering capabilities, including filtering on multiple labels simultaneously.
 
@@ -2771,11 +2779,6 @@ See [allowed labels for onchain webhooks](https://docs.cdp.coinbase.com/api-refe
       labels?: WebhookSubscriptionRequestLabels;
     });
 
-/**
- * Additional metadata for the subscription.
- */
-export type WebhookSubscriptionUpdateRequestMetadata = { [key: string]: unknown };
-
 /**
  * Multi-label filters that trigger only when an event contains ALL of these key-value pairs.
 
@@ -2794,16 +2797,15 @@ the original subscription format (traditional or multi-label).
 export type WebhookSubscriptionUpdateRequest =
   | (unknown & {
       /** Description of the webhook subscription. */
-      description?: string;
-      /** Types of events to subscribe to. Event types follow a three-part dot-separated format: 
+      description?: Description;
+      /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
 service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
  */
       eventTypes?: string[];
       /** Whether the subscription is enabled. */
       isEnabled?: boolean;
       target?: WebhookTarget;
-      /** Additional metadata for the subscription. */
-      metadata?: WebhookSubscriptionUpdateRequestMetadata;
+      metadata?: Metadata;
       /** 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.
@@ -2832,16 +2834,15 @@ Maintained for backward compatibility only.
     })
   | (unknown & {
       /** Description of the webhook subscription. */
-      description?: string;
-      /** Types of events to subscribe to. Event types follow a three-part dot-separated format: 
+      description?: Description;
+      /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
 service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
  */
       eventTypes?: string[];
       /** Whether the subscription is enabled. */
       isEnabled?: boolean;
       target?: WebhookTarget;
-      /** Additional metadata for the subscription. */
-      metadata?: WebhookSubscriptionUpdateRequestMetadata;
+      metadata?: Metadata;
       /** 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.
@@ -3021,8 +3022,8 @@ For Solana-based networks, payTo will be a base58-encoded Solana address.
 export interface X402ResourceInfo {
   /** The URL of the resource. */
   url?: string;
-  /** The description of the resource. */
-  description?: string;
+  /** A human-readable description of the resource. */
+  description?: Description;
   /** The MIME type of the resource response. */
   mimeType?: string;
 }
@@ -3102,8 +3103,8 @@ export interface X402V1PaymentRequirements {
   maxAmountRequired: string;
   /** The URL of the resource to pay for. */
   resource: string;
-  /** The description of the resource. */
-  description: string;
+  /** A human-readable description of the resource. */
+  description: Description;
   /** The MIME type of the resource response. */
   mimeType: string;
   /** The optional JSON schema describing the resource output. */
@@ -3352,6 +3353,10 @@ export const X402SupportedPaymentKindNetwork = {
   base: "base",
   "solana-devnet": "solana-devnet",
   solana: "solana",
+  "eip155:8453": "eip155:8453",
+  "eip155:84532": "eip155:84532",
+  "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
 } as const;
 
 /**
@@ -3372,6 +3377,13 @@ export interface X402SupportedPaymentKind {
   extra?: X402SupportedPaymentKindExtra;
 }
 
+/**
+ * A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).
+ * @minLength 1
+ * @maxLength 128
+ */
+export type BlockchainAddress = string;
+
 /**
  * The type of payment method to be used to complete an onramp order.
  */
@@ -3442,7 +3454,7 @@ export interface OnrampOrder {
   /** The exchange rate used to convert fiat to crypto i.e. the crypto value of one fiat. */
   exchangeRate: string;
   /** The destination address to send the crypto to. */
-  destinationAddress: string;
+  destinationAddress: BlockchainAddress;
   /** The network to send the crypto on. */
   destinationNetwork: string;
   status: OnrampOrderStatus;
@@ -3742,6 +3754,27 @@ export type ValidateEndUserAccessTokenBody = {
   accessToken: string;
 };
 
+export type AddEndUserEvmAccountBody = { [key: string]: unknown };
+
+export type AddEndUserEvmAccount201 = {
+  evmAccount: EndUserEvmAccount;
+};
+
+export type AddEndUserEvmSmartAccountBody = {
+  /** If true, enables spend permissions for the EVM smart account. */
+  enableSpendPermissions?: boolean;
+};
+
+export type AddEndUserEvmSmartAccount201 = {
+  evmSmartAccount: EndUserEvmSmartAccount;
+};
+
+export type AddEndUserSolanaAccountBody = { [key: string]: unknown };
+
+export type AddEndUserSolanaAccount201 = {
+  solanaAccount: EndUserSolanaAccount;
+};
+
 /**
  * The type of key being imported. Determines what type of account will be associated for the end user.
  */
@@ -4394,7 +4427,7 @@ export type CreateOnrampOrderBody = {
   /** The timestamp of when the user acknowledged that by using Coinbase Onramp they are accepting the Coinbase Terms  (https://www.coinbase.com/legal/guest-checkout/us), User Agreement (https://www.coinbase.com/legal/user_agreement),  and Privacy Policy (https://www.coinbase.com/legal/privacy). */
   agreementAcceptedAt: string;
   /** The address the purchased crypto will be sent to. */
-  destinationAddress: string;
+  destinationAddress: BlockchainAddress;
   /** The name of the crypto network the purchased currency will be sent on.
 
 Use the [Onramp Buy Options API](https://docs.cdp.coinbase.com/api-reference/rest-api/onramp-offramp/get-buy-options) to discover the supported networks for your user's location. */
@@ -4451,7 +4484,7 @@ Use the [Onramp Buy Options API](https://docs.cdp.coinbase.com/api-reference/res
 Use the [Onramp Buy Options API](https://docs.cdp.coinbase.com/api-reference/rest-api/onramp-offramp/get-buy-options) to discover the supported networks for your user's location. */
   destinationNetwork: string;
   /** The address the purchased crypto will be sent to. */
-  destinationAddress: string;
+  destinationAddress: BlockchainAddress;
   /** A string representing the amount of fiat the user wishes to pay in exchange for crypto. When using this parameter, the returned quote will be inclusive of fees i.e. the user  will pay this exact amount of the payment currency. */
   paymentAmount?: string;
   /** A string representing the amount of crypto the user wishes to purchase. When using  this parameter, the returned quote will be exclusive of fees i.e. the user will  receive this exact amount of the purchase currency. */

package/openapi-client/generated/end-user-accounts/end-user-accounts.ts

@@ -6,6 +6,12 @@
  * OpenAPI spec version: 2.0.0
  */
 import type {
+  AddEndUserEvmAccount201,
+  AddEndUserEvmAccountBody,
+  AddEndUserEvmSmartAccount201,
+  AddEndUserEvmSmartAccountBody,
+  AddEndUserSolanaAccount201,
+  AddEndUserSolanaAccountBody,
   CreateEndUserBody,
   EndUser,
   ImportEndUserBody,
@@ -77,6 +83,66 @@ This API is intended to be used by the developer's own backend, and is authentic
 export const getEndUser = (userId: string, options?: SecondParameter<typeof cdpApiClient>) => {
   return cdpApiClient<EndUser>({ url: `/v2/end-users/${userId}`, method: "GET" }, options);
 };
+/**
+ * Adds a new EVM EOA account to an existing end user. End users can have up to 10 EVM accounts.
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Add an EVM account to an end user
+ */
+export const addEndUserEvmAccount = (
+  userId: string,
+  addEndUserEvmAccountBody?: AddEndUserEvmAccountBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<AddEndUserEvmAccount201>(
+    {
+      url: `/v2/end-users/${userId}/evm`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: addEndUserEvmAccountBody,
+    },
+    options,
+  );
+};
+/**
+ * Creates an EVM smart account for an existing end user. The backend will create a new EVM EOA account to serve as the owner of the smart account.
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Add an EVM smart account to an end user
+ */
+export const addEndUserEvmSmartAccount = (
+  userId: string,
+  addEndUserEvmSmartAccountBody?: AddEndUserEvmSmartAccountBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<AddEndUserEvmSmartAccount201>(
+    {
+      url: `/v2/end-users/${userId}/evm-smart-account`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: addEndUserEvmSmartAccountBody,
+    },
+    options,
+  );
+};
+/**
+ * Adds a new Solana account to an existing end user. End users can have  up to 10 Solana accounts.
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Add a Solana account to an end user
+ */
+export const addEndUserSolanaAccount = (
+  userId: string,
+  addEndUserSolanaAccountBody?: AddEndUserSolanaAccountBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<AddEndUserSolanaAccount201>(
+    {
+      url: `/v2/end-users/${userId}/solana`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: addEndUserSolanaAccountBody,
+    },
+    options,
+  );
+};
 /**
  * Imports an existing private key for an end user into the developer's CDP Project. The private key must be encrypted using the CDP SDK's encryption scheme before being sent to this endpoint. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.
 
@@ -103,4 +169,13 @@ export type ValidateEndUserAccessTokenResult = NonNullable<
   Awaited<ReturnType<typeof validateEndUserAccessToken>>
 >;
 export type GetEndUserResult = NonNullable<Awaited<ReturnType<typeof getEndUser>>>;
+export type AddEndUserEvmAccountResult = NonNullable<
+  Awaited<ReturnType<typeof addEndUserEvmAccount>>
+>;
+export type AddEndUserEvmSmartAccountResult = NonNullable<
+  Awaited<ReturnType<typeof addEndUserEvmSmartAccount>>
+>;
+export type AddEndUserSolanaAccountResult = NonNullable<
+  Awaited<ReturnType<typeof addEndUserSolanaAccount>>
+>;
 export type ImportEndUserResult = NonNullable<Awaited<ReturnType<typeof importEndUser>>>;

package/openapi-client/generated/webhooks/webhooks.ts

@@ -54,12 +54,19 @@ export const listWebhookSubscriptions = (
 - `offramp.transaction.success`, `offramp.transaction.failed`
 - **No labels required** - maximum simplicity for transaction monitoring
 
+**Payments Transfers Events** - Transfer lifecycle notifications:
+- `payments.transfers.quoted`
+- `payments.transfers.processing`
+- `payments.transfers.completed`
+- `payments.transfers.failed`
+- **No labels required** - enable the transfers webhook to monitor status transitions
+
 **Wallet Events** - Wallet activity notifications:
 - `wallet.activity.detected`
 
 ### Webhook Signature Verification
 All webhooks include cryptographic signatures for security.
-The signature secret is returned in `metadata.secret` when creating a subscription.
+The signature secret is returned in `secret` field when creating a subscription.
 
 **Note:** Webhooks are in beta and this interface is subject to change.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.43.1",
+  "version": "1.44.0",
   "description": "SDK for interacting with the Coinbase Developer Platform Wallet API",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",

package/version.ts

@@ -1 +1 @@
-export const version = "1.43.1";
+export const version = "1.44.0";