@coinbase/cdp-sdk 1.50.0 → 1.51.0

package/src/openapi-client/generated/transfers/transfers.ts

@@ -0,0 +1,131 @@
+/**
+ * Generated by orval v7.21.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 {
+  DepositTravelRuleRequest,
+  DepositTravelRuleResponse,
+  ListTransfers200,
+  ListTransfersParams,
+  Transfer,
+  TransferRequest,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+import { cdpApiClient } from "../../cdpApiClient.js";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+/**
+ * Create a new transfer to move funds from a source to a target.
+All transfers first transition to `quoted`. If `execute: false`, the transfer stays quoted until you call `/v2/transfers/{transferId}/execute`.
+If `execute: true`, quoted status emits momentarily before the transfer moves to `processing`, where execution proceeds. Subscribe to the transfers webhook to  follow progress in real time instead of polling.
+ * @summary Create transfer
+ */
+export const createTransfer = (
+  transferRequest: TransferRequest,
+  options?: SecondParameter<typeof cdpApiClient<Transfer>>,
+) => {
+  return cdpApiClient<Transfer>(
+    {
+      url: `/v2/transfers`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: transferRequest,
+    },
+    options,
+  );
+};
+/**
+ * List transfers for your organization. Use this to view and monitor your transfer activity.
+
+**Status Filtering**: Filter by specific status to efficiently manage transfers:
+* `?status=processing` - Monitor active transfers.
+* `?status=quoted` - Find transfers awaiting execution.
+* `?status=failed` - Review failed transfers for troubleshooting.
+* `?status=completed` - Find completed transfers.
+
+**Account Filtering**: Filter by account ID to find transfers involving a specific account:
+* `?accountId=<ID>` - All transfers where the account is either source or target (OR semantics).
+* `?sourceAccountId=<ID>` - Only transfers where the account is the source (outbound).
+* `?targetAccountId=<ID>` - Only transfers where the account is the target (inbound).
+Providing `accountId` together with `sourceAccountId` or `targetAccountId` is a validation error and returns HTTP 400.
+
+**Date Range Filtering**: Filter by creation or last-updated time for reconciliation:
+* `?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z` - Transfers created within a date range.
+* `?updatedAfter=2026-01-01T00:00:00Z` - Transfers updated since a given time. Useful for incremental sync.
+
+**Asset Filtering**: Filter by source or target asset symbol:
+* `?sourceAsset=usd` - Transfers funded from a USD account.
+* `?targetAsset=usdc` - Transfers delivering USDC to the target.
+
+**Other Filters**:
+* `?sourceAddress=0x...` - Transfers from a specific on-chain source address.
+* `?targetAddress=0x...` - Transfers to a specific on-chain destination address.
+* `?targetEmail=user@example.com` - Transfers to a specific email recipient.
+* `?transferId=transfer_...` - Look up a single transfer by ID; bypasses pagination.
+ * @summary List transfers
+ */
+export const listTransfers = (
+  params?: ListTransfersParams,
+  options?: SecondParameter<typeof cdpApiClient<ListTransfers200>>,
+) => {
+  return cdpApiClient<ListTransfers200>({ url: `/v2/transfers`, method: "GET", params }, options);
+};
+/**
+ * Get a transfer by its ID.
+ * @summary Get transfer
+ */
+export const getTransferById = (
+  transferId: string,
+  options?: SecondParameter<typeof cdpApiClient<Transfer>>,
+) => {
+  return cdpApiClient<Transfer>({ url: `/v2/transfers/${transferId}`, method: "GET" }, options);
+};
+/**
+ * Executes a transfer which was created using the Create a transfer endpoint.
+ * @summary Execute transfer
+ */
+export const executeFundTransfer = (
+  transferId: string,
+  options?: SecondParameter<typeof cdpApiClient<Transfer>>,
+) => {
+  return cdpApiClient<Transfer>(
+    { url: `/v2/transfers/${transferId}/execute`, method: "POST" },
+    options,
+  );
+};
+/**
+ * Submit travel rule information for a deposit transfer held pending compliance review.
+
+Required fields vary by jurisdiction and may include originator name, address, date of birth, personal ID, and VASP information.
+
+If the submitted information satisfies all jurisdictional requirements, `status` will be `completed` and the transfer will proceed. Otherwise, `status` will be `incomplete` and `missingFields` will indicate which fields still need to be provided.
+ * @summary Submit deposit travel rule information
+ */
+export const submitDepositTravelRule = (
+  transferId: string,
+  depositTravelRuleRequest: DepositTravelRuleRequest,
+  options?: SecondParameter<typeof cdpApiClient<DepositTravelRuleResponse>>,
+) => {
+  return cdpApiClient<DepositTravelRuleResponse>(
+    {
+      url: `/v2/transfers/${transferId}/travel-rule`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: depositTravelRuleRequest,
+    },
+    options,
+  );
+};
+export type CreateTransferResult = NonNullable<Awaited<ReturnType<typeof createTransfer>>>;
+export type ListTransfersResult = NonNullable<Awaited<ReturnType<typeof listTransfers>>>;
+export type GetTransferByIdResult = NonNullable<Awaited<ReturnType<typeof getTransferById>>>;
+export type ExecuteFundTransferResult = NonNullable<
+  Awaited<ReturnType<typeof executeFundTransfer>>
+>;
+export type SubmitDepositTravelRuleResult = NonNullable<
+  Awaited<ReturnType<typeof submitDepositTravelRule>>
+>;

package/{openapi-client → src/openapi-client}/generated/webhooks/webhooks.ts

@@ -120,7 +120,7 @@ configuration, status, creation timestamp, and webhook signature secret.
 - Webhook signature secret for verification
 - Creation timestamp and status
 
- * @summary Get webhook subscription details
+ * @summary Get webhook subscription
  */
 export const getWebhookSubscription = (
   subscriptionId: string,

package/{openapi-client → src/openapi-client}/generated/x402-facilitator/x402-facilitator.ts

@@ -27,7 +27,7 @@ type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
  * Verify an x402 protocol payment with a specific scheme and network.
- * @summary Verify a payment
+ * @summary Verify payment
  */
 export const verifyX402Payment = (
   verifyX402PaymentBody: VerifyX402PaymentBody,
@@ -45,7 +45,7 @@ export const verifyX402Payment = (
 };
 /**
  * Settle an x402 protocol payment with a specific scheme and network.
- * @summary Settle a payment
+ * @summary Settle payment
  */
 export const settleX402Payment = (
   settleX402PaymentBody: SettleX402PaymentBody,
@@ -77,7 +77,7 @@ export const supportedX402PaymentKinds = (
  * Lists all active discovered x402 resources.
 This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their payment requirements and metadata.
 The response is paginated, and by default, returns 100 items per page.
- * @summary List discovered x402 resources
+ * @summary List x402 resources
  */
 export const listX402DiscoveryResources = (
   params?: ListX402DiscoveryResourcesParams,

package/{openapi-client → src/openapi-client}/index.ts

@@ -10,11 +10,10 @@ export * from "./generated/policy-engine/policy-engine.js";
 export * from "./generated/onramp/onramp.js";
 export * from "./generated/onchain-data/onchain-data.js";
 export * from "./generated/end-user-accounts/end-user-accounts.js";
-export * from "./generated/embedded-wallets/embedded-wallets.js";
 export * from "./generated/x402-facilitator/x402-facilitator.js";
 
 import { configure } from "./cdpApiClient.js";
-import * as embeddedWallets from "./generated/embedded-wallets/embedded-wallets.js";
+import * as endUserAccountManagement from "./generated/end-user-account-management/end-user-account-management.js";
 import * as endUserAccounts from "./generated/end-user-accounts/end-user-accounts.js";
 import * as evm from "./generated/evm-accounts/evm-accounts.js";
 import * as evmSmartAccounts from "./generated/evm-smart-accounts/evm-smart-accounts.js";
@@ -39,7 +38,7 @@ export const CdpOpenApiClient = {
   ...onchainData,
   ...policies,
   ...endUserAccounts,
-  ...embeddedWallets,
+  ...endUserAccountManagement,
   configure,
 };
 
@@ -62,3 +61,8 @@ export const OpenApiPoliciesMethods = {
 
 export type CdpOpenApiClientType = typeof CdpOpenApiClient;
 export * from "./generated/sql-api/sql-api.js";
+export * from "./generated/accounts/accounts.js";
+export * from "./generated/deposit-destinations/deposit-destinations.js";
+export * from "./generated/transfers/transfers.js";
+export * from "./generated/end-user-account-management/end-user-account-management.js";
+export * from "./generated/payment-methods/payment-methods.js";

package/{policies → src/policies}/evmSchema.ts

@@ -591,6 +591,8 @@ export const EvmOperationEnum = z.enum([
   "signEvmHash",
   "prepareUserOperation",
   "sendUserOperation",
+  "signEndUserEvmHash",
+  "sendEndUserOperation",
 ]);
 /**
  * Type representing the operations that can be governed by a policy.
@@ -649,6 +651,24 @@ export const SignEvmHashRuleSchema = z.object({
 });
 export type SignEvmHashRule = z.infer<typeof SignEvmHashRuleSchema>;
 
+/**
+ * Type representing a 'signEndUserEvmHash' policy rule that can accept or reject specific operations
+ * based on a set of criteria.
+ */
+export const SignEndUserEvmHashRuleSchema = z.object({
+  /**
+   * Determines whether matching the rule will cause a request to be rejected or accepted.
+   * "accept" will allow the signing, "reject" will block it.
+   */
+  action: ActionEnum,
+  /**
+   * The operation to which this rule applies.
+   * Must be "signEndUserEvmHash".
+   */
+  operation: z.literal("signEndUserEvmHash"),
+});
+export type SignEndUserEvmHashRule = z.infer<typeof SignEndUserEvmHashRuleSchema>;
+
 /**
  * Type representing a 'signEvmMessage' policy rule that can accept or reject specific operations
  * based on a set of criteria.
@@ -856,6 +876,49 @@ export const SignEndUserEvmTypedDataRuleSchema = z.object({
 });
 export type SignEndUserEvmTypedDataRule = z.infer<typeof SignEndUserEvmTypedDataRuleSchema>;
 
+/**
+ * Schema for criteria used in SendEndUserOperation operations
+ */
+export const SendEndUserOperationCriteriaSchema = z
+  .array(
+    z.discriminatedUnion("type", [
+      EthValueCriterionSchema,
+      EvmAddressCriterionSchema,
+      PrepareUserOperationEvmNetworkCriterionSchema,
+      EvmDataCriterionSchema,
+      NetUSDChangeCriterionSchema,
+    ]),
+  )
+  .max(10)
+  .min(1);
+/**
+ * Type representing a set of criteria for the sendEndUserOperation operation.
+ */
+export type SendEndUserOperationCriteria = z.infer<typeof SendEndUserOperationCriteriaSchema>;
+
+/**
+ * Type representing a 'sendEndUserOperation' policy rule that can accept or reject specific operations
+ * based on a set of criteria.
+ */
+export const SendEndUserOperationRuleSchema = z.object({
+  /**
+   * Determines whether matching the rule will cause a request to be rejected or accepted.
+   * "accept" will allow the operation, "reject" will block it.
+   */
+  action: ActionEnum,
+  /**
+   * The operation to which this rule applies.
+   * Must be "sendEndUserOperation".
+   */
+  operation: z.literal("sendEndUserOperation"),
+  /**
+   * The set of criteria that must be matched for this rule to apply.
+   * Must be compatible with the specified operation type.
+   */
+  criteria: SendEndUserOperationCriteriaSchema,
+});
+export type SendEndUserOperationRule = z.infer<typeof SendEndUserOperationRuleSchema>;
+
 /**
  * Schema for criteria used in SendEndUserEvmAsset operations
  */

package/{policies → src/policies}/types.ts

@@ -12,7 +12,9 @@ import {
   SendEndUserEvmTransactionRuleSchema,
   SignEndUserEvmMessageRuleSchema,
   SignEndUserEvmTypedDataRuleSchema,
+  SignEndUserEvmHashRuleSchema,
   SendEndUserEvmAssetRuleSchema,
+  SendEndUserOperationRuleSchema,
   CreateEndUserEvmSwapRuleSchema,
 } from "./evmSchema.js";
 import {
@@ -71,10 +73,12 @@ export const RuleSchema = z.discriminatedUnion("operation", [
   SendEndUserEvmTransactionRuleSchema,
   SignEndUserEvmMessageRuleSchema,
   SignEndUserEvmTypedDataRuleSchema,
+  SignEndUserEvmHashRuleSchema,
   SignEndUserSolTransactionRuleSchema,
   SendEndUserSolTransactionRuleSchema,
   SignEndUserSolMessageRuleSchema,
   SendEndUserEvmAssetRuleSchema,
+  SendEndUserOperationRuleSchema,
   CreateEndUserEvmSwapRuleSchema,
   SendEndUserSolAssetRuleSchema,
 ]);

package/src/version.ts

@@ -0,0 +1 @@
+export const version = "1.51.0";