@coinbase/cdp-sdk 1.38.6 → 1.40.0

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

@@ -6,6 +6,7 @@
  * OpenAPI spec version: 2.0.0
  */
 import type {
+  CreateEndUserBody,
   EndUser,
   ListEndUsers200,
   ListEndUsersParams,
@@ -16,6 +17,25 @@ import { cdpApiClient } from "../../cdpApiClient.js";
 
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
+/**
+ * Creates an end user. An end user is an entity that can own CDP EVM accounts, EVM smart accounts, and/or Solana accounts. 1 or more authentication methods must be associated with an end user. By default, no accounts are created unless the optional `evmAccount` and/or `solanaAccount` fields are provided.
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Create an end user
+ */
+export const createEndUser = (
+  createEndUserBody: CreateEndUserBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<EndUser>(
+    {
+      url: `/v2/end-users`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: createEndUserBody,
+    },
+    options,
+  );
+};
 /**
  * Lists the end users belonging to the developer's CDP Project.
 By default, the response is sorted by creation date in ascending order and paginated to 20 users per page.
@@ -47,7 +67,18 @@ export const validateEndUserAccessToken = (
     options,
   );
 };
+/**
+ * Gets an end user by ID.
+
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Get an end user
+ */
+export const getEndUser = (userId: string, options?: SecondParameter<typeof cdpApiClient>) => {
+  return cdpApiClient<EndUser>({ url: `/v2/end-users/${userId}`, method: "GET" }, options);
+};
+export type CreateEndUserResult = NonNullable<Awaited<ReturnType<typeof createEndUser>>>;
 export type ListEndUsersResult = NonNullable<Awaited<ReturnType<typeof listEndUsers>>>;
 export type ValidateEndUserAccessTokenResult = NonNullable<
   Awaited<ReturnType<typeof validateEndUserAccessToken>>
 >;
+export type GetEndUserResult = NonNullable<Awaited<ReturnType<typeof getEndUser>>>;

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

@@ -20,7 +20,7 @@ type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 /**
  * Create a new Onramp order or get a quote for an Onramp order. Either `paymentAmount` or `purchaseAmount` must be provided.
 
-This API currently only supports the payment method `GUEST_CHECKOUT_APPLE_PAY`, and the `paymentLink` returned will only work in iOS apps. We do not support web integration via iframes at this time.
+This API currently only supports the payment method `GUEST_CHECKOUT_APPLE_PAY`.
 
 For detailed integration instructions and to get access to this API, refer to the  [Apple Pay Onramp API docs](https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api).
  * @summary Create an onramp order

package/openapi-client/generated/sql-api-alpha/sql-api-alpha.ts

@@ -37,9 +37,8 @@ Queries are executed against optimized data structures for high-performance anal
 
 ### Query Limits
 
-  - Maximum result set: 10,000 rows
+  - Maximum result set: 100,000 rows
   - Query timeout: 30 seconds
-  - Maximum JOINs: 5
 
  * @summary Run SQL Query
  */

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

@@ -0,0 +1,185 @@
+/**
+ * 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 type {
+  ListWebhookSubscriptionsParams,
+  WebhookSubscriptionListResponse,
+  WebhookSubscriptionRequest,
+  WebhookSubscriptionResponse,
+  WebhookSubscriptionUpdateRequest,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+import { cdpApiClient } from "../../cdpApiClient.js";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+/**
+ * Retrieve a paginated list of webhook subscriptions for the authenticated project.
+Returns subscriptions for all CDP product events (onchain, onramp/offramp, wallet, etc.)
+in descending order by creation time.
+
+### Use Cases
+- Monitor all active webhook subscriptions across CDP products
+- Audit webhook configurations
+- Manage subscription lifecycle
+
+ * @summary List webhook subscriptions
+ */
+export const listWebhookSubscriptions = (
+  params?: ListWebhookSubscriptionsParams,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<WebhookSubscriptionListResponse>(
+    { url: `/v2/data/webhooks/subscriptions`, method: "GET", params },
+    options,
+  );
+};
+/**
+ * Subscribe to real-time events across CDP products using flexible filtering.
+
+### Event Types
+
+**Onchain Events** - Monitor Base mainnet with microsecond precision:
+- `onchain.activity.detected` - Smart contract events, transfers, swaps, NFT activity
+- **Requires** `labels` for filtering (e.g., `contract_address`, `event_name`)
+
+**Onramp/Offramp Events** - Transaction lifecycle notifications:
+- `onramp.transaction.created`, `onramp.transaction.updated`
+- `onramp.transaction.success`, `onramp.transaction.failed`
+- `offramp.transaction.created`, `offramp.transaction.updated`
+- `offramp.transaction.success`, `offramp.transaction.failed`
+- **No labels required** - maximum simplicity for transaction monitoring
+
+**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.
+
+**Note:** Webhooks are in beta and this interface is subject to change.
+
+See the [verification guide](https://docs.cdp.coinbase.com/onramp-&-offramp/webhooks#webhook-signature-verification) for implementation details.
+
+### Onchain Label Filtering
+
+For `onchain.activity.detected` events, use `labels` for precise filtering with AND logic (max 20 labels per webhook).
+
+**Allowed labels** (all in snake_case format):
+- `network` (required) - Blockchain network
+- `contract_address` - Smart contract address
+- `event_name` - Event name (e.g., "Transfer", "Burn")
+- `event_signature` - Event signature hash
+- `transaction_from` - Transaction sender address
+- `transaction_to` - Transaction recipient address
+- `params.*` - Any event parameter (e.g., `params.from`, `params.to`, `params.sender`, `params.tokenId`)
+
+**Examples**:
+- **Liquidity Pool Monitor**: `{"network": "base-mainnet", "contract_address": "0xcd1f9777571493aeacb7eae45cd30a226d3e612d", "event_name": "Burn"}`
+- **Price Oracle Tracker**: `{"network": "base-mainnet", "contract_address": "0xbac4a9428ea707c51f171ed9890c3c2fa810305d", "event_name": "PriceUpdated"}`
+- **DeFi Protocol Activity**: `{"network": "base-mainnet", "contract_address": "0x45c6e6a47a711b14d8357d5243f46704904578e3", "event_name": "Deposit"}`
+
+ * @summary Create webhook subscription
+ */
+export const createWebhookSubscription = (
+  webhookSubscriptionRequest: WebhookSubscriptionRequest,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<WebhookSubscriptionResponse>(
+    {
+      url: `/v2/data/webhooks/subscriptions`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: webhookSubscriptionRequest,
+    },
+    options,
+  );
+};
+/**
+ * Retrieve detailed information about a specific webhook subscription including
+configuration, status, creation timestamp, and webhook signature secret.
+
+### Response Includes
+- Subscription configuration and filters
+- Target URL and custom headers
+- Webhook signature secret for verification
+- Creation timestamp and status
+
+ * @summary Get webhook subscription details
+ */
+export const getWebhookSubscription = (
+  subscriptionId: string,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<WebhookSubscriptionResponse>(
+    { url: `/v2/data/webhooks/subscriptions/${subscriptionId}`, method: "GET" },
+    options,
+  );
+};
+/**
+ * Update an existing webhook subscription's configuration including
+event types, target URL, filtering criteria, and enabled status.
+All required fields must be provided, even if they are not being changed.
+
+### Common Updates
+- Change target URL or headers
+- Add/remove event type filters
+- Update multi-label filtering criteria
+- Enable/disable subscription
+
+ * @summary Update webhook subscription
+ */
+export const updateWebhookSubscription = (
+  subscriptionId: string,
+  webhookSubscriptionUpdateRequest: WebhookSubscriptionUpdateRequest,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<WebhookSubscriptionResponse>(
+    {
+      url: `/v2/data/webhooks/subscriptions/${subscriptionId}`,
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      data: webhookSubscriptionUpdateRequest,
+    },
+    options,
+  );
+};
+/**
+ * Permanently delete a webhook subscription and stop all event deliveries.
+This action cannot be undone.
+
+### Important Notes
+- All webhook deliveries will cease immediately
+- Subscription cannot be recovered after deletion
+- Consider disabling instead of deleting for temporary pauses
+
+ * @summary Delete webhook subscription
+ */
+export const deleteWebhookSubscription = (
+  subscriptionId: string,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<void>(
+    { url: `/v2/data/webhooks/subscriptions/${subscriptionId}`, method: "DELETE" },
+    options,
+  );
+};
+export type ListWebhookSubscriptionsResult = NonNullable<
+  Awaited<ReturnType<typeof listWebhookSubscriptions>>
+>;
+export type CreateWebhookSubscriptionResult = NonNullable<
+  Awaited<ReturnType<typeof createWebhookSubscription>>
+>;
+export type GetWebhookSubscriptionResult = NonNullable<
+  Awaited<ReturnType<typeof getWebhookSubscription>>
+>;
+export type UpdateWebhookSubscriptionResult = NonNullable<
+  Awaited<ReturnType<typeof updateWebhookSubscription>>
+>;
+export type DeleteWebhookSubscriptionResult = NonNullable<
+  Awaited<ReturnType<typeof deleteWebhookSubscription>>
+>;

package/openapi-client/index.ts

@@ -24,12 +24,14 @@ import * as onchainData from "./generated/onchain-data/onchain-data.js";
 import * as policies from "./generated/policy-engine/policy-engine.js";
 import * as solana from "./generated/solana-accounts/solana-accounts.js";
 import * as solanaTokenBalances from "./generated/solana-token-balances/solana-token-balances.js";
+import * as webhooks from "./generated/webhooks/webhooks.js";
 
 export const CdpOpenApiClient = {
   ...evm,
   ...evmSmartAccounts,
   ...evmSwaps,
   ...evmTokenBalances,
+  ...webhooks,
   ...solana,
   ...solanaTokenBalances,
   ...faucets,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.38.6",
+  "version": "1.40.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.38.6";
+export const version = "1.40.0";