@coinbase/cdp-sdk 1.48.2 → 1.49.0

package/openapi-client/generated/embedded-wallets/embedded-wallets.ts

@@ -7,13 +7,21 @@
  */
 import type {
   BlockchainAddress,
+  CreateDelegationForEndUserAccount201,
+  CreateDelegationForEndUserAccountBody,
+  CreateDelegationForEndUserAccountParams,
   CreateEvmEip7702DelegationWithEndUserAccount201,
   CreateEvmEip7702DelegationWithEndUserAccountBody,
   CreateEvmEip7702DelegationWithEndUserAccountParams,
   EvmUserOperation,
   GetDelegationForEndUser200,
+  GetDelegationForEndUserAccount200,
+  GetDelegationForEndUserAccountParams,
   GetDelegationForEndUserParams,
+  RevokeDelegationForEndUserAccountBody,
+  RevokeDelegationForEndUserAccountParams,
   RevokeDelegationForEndUserBody,
+  RevokeDelegationForEndUserParams,
   SendEvmAssetWithEndUserAccount200,
   SendEvmAssetWithEndUserAccountBody,
   SendEvmAssetWithEndUserAccountParams,
@@ -208,6 +216,7 @@ export const getDelegationForEndUser = (
 export const revokeDelegationForEndUser = (
   userId: string,
   revokeDelegationForEndUserBody: RevokeDelegationForEndUserBody,
+  params?: RevokeDelegationForEndUserParams,
   options?: SecondParameter<typeof cdpApiClient<void>>,
 ) => {
   return cdpApiClient<void>(
@@ -216,6 +225,74 @@ export const revokeDelegationForEndUser = (
       method: "DELETE",
       headers: { "Content-Type": "application/json" },
       data: revokeDelegationForEndUserBody,
+      params,
+    },
+    options,
+  );
+};
+/**
+ * Creates an account-scoped delegation that allows a developer to sign on behalf of an end user for a single blockchain account (identified by its address) for the specified duration. The end user must be authenticated to authorize this delegation.
+Multiple account-scoped delegations may exist concurrently for a single end user (one per canonical account address). Account-scoped and user-scoped delegations cannot coexist for the same user.
+When the address corresponds to an EVM Smart Account, the delegation is scoped to the Smart Account's owner EOA rather than the Smart Account address itself. This means `/address/{smartAccountAddress}/delegation` and `/address/{ownerEoaAddress}/delegation` resolve to the same delegation, and the 409 `account_scoped_delegation_active` error may be returned when creating via either address if one already exists for the canonical owner.
+ * @summary Create account-scoped delegation for an end user account
+ */
+export const createDelegationForEndUserAccount = (
+  userId: string,
+  address: BlockchainAddress,
+  createDelegationForEndUserAccountBody: CreateDelegationForEndUserAccountBody,
+  params?: CreateDelegationForEndUserAccountParams,
+  options?: SecondParameter<typeof cdpApiClient<CreateDelegationForEndUserAccount201>>,
+) => {
+  return cdpApiClient<CreateDelegationForEndUserAccount201>(
+    {
+      url: `/v2/embedded-wallet-api/end-users/${userId}/address/${address}/delegation`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: createDelegationForEndUserAccountBody,
+      params,
+    },
+    options,
+  );
+};
+/**
+ * Returns the active account-scoped delegation for the specified end user account, if one exists. Useful for showing delegation status in a UI.
+When the address corresponds to an EVM Smart Account, this returns the delegation for the Smart Account's owner EOA.
+ * @summary Get account-scoped delegation for an end user account
+ */
+export const getDelegationForEndUserAccount = (
+  userId: string,
+  address: BlockchainAddress,
+  params?: GetDelegationForEndUserAccountParams,
+  options?: SecondParameter<typeof cdpApiClient<GetDelegationForEndUserAccount200>>,
+) => {
+  return cdpApiClient<GetDelegationForEndUserAccount200>(
+    {
+      url: `/v2/embedded-wallet-api/end-users/${userId}/address/${address}/delegation`,
+      method: "GET",
+      params,
+    },
+    options,
+  );
+};
+/**
+ * Revokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This operation can be performed by the end user themselves or by a developer using their API key.
+When the address corresponds to an EVM Smart Account, this revokes the delegation for the Smart Account's owner EOA.
+ * @summary Revoke account-scoped delegation for an end user account
+ */
+export const revokeDelegationForEndUserAccount = (
+  userId: string,
+  address: BlockchainAddress,
+  revokeDelegationForEndUserAccountBody: RevokeDelegationForEndUserAccountBody,
+  params?: RevokeDelegationForEndUserAccountParams,
+  options?: SecondParameter<typeof cdpApiClient<void>>,
+) => {
+  return cdpApiClient<void>(
+    {
+      url: `/v2/embedded-wallet-api/end-users/${userId}/address/${address}/delegation`,
+      method: "DELETE",
+      headers: { "Content-Type": "application/json" },
+      data: revokeDelegationForEndUserAccountBody,
+      params,
     },
     options,
   );
@@ -400,6 +477,15 @@ export type GetDelegationForEndUserResult = NonNullable<
 export type RevokeDelegationForEndUserResult = NonNullable<
   Awaited<ReturnType<typeof revokeDelegationForEndUser>>
 >;
+export type CreateDelegationForEndUserAccountResult = NonNullable<
+  Awaited<ReturnType<typeof createDelegationForEndUserAccount>>
+>;
+export type GetDelegationForEndUserAccountResult = NonNullable<
+  Awaited<ReturnType<typeof getDelegationForEndUserAccount>>
+>;
+export type RevokeDelegationForEndUserAccountResult = NonNullable<
+  Awaited<ReturnType<typeof revokeDelegationForEndUserAccount>>
+>;
 export type CreateEvmEip7702DelegationWithEndUserAccountResult = NonNullable<
   Awaited<ReturnType<typeof createEvmEip7702DelegationWithEndUserAccount>>
 >;

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

@@ -17,6 +17,8 @@ import type {
   ImportEndUserBody,
   ListEndUsers200,
   ListEndUsersParams,
+  LookupEndUser200,
+  LookupEndUserParams,
   ValidateEndUserAccessTokenBody,
 } from "../coinbaseDeveloperPlatformAPIs.schemas.js";
 
@@ -86,6 +88,33 @@ export const getEndUser = (
 ) => {
   return cdpApiClient<EndUser>({ url: `/v2/end-users/${userId}`, method: "GET" }, options);
 };
+/**
+ * Looks up end users. Exactly one lookup type must be provided per request:
+
+- **email**: searches across all email-based authentication methods
+  (email, Google, Apple, GitHub). May return multiple end users if the
+  same email address appears across different auth methods.
+
+- **oauthProvider + oauthSubject**: looks up a user by their OAuth
+  provider and subject (the `sub` claim from the provider's ID token).
+  Both params must be provided together.
+
+- **phoneNumber**: looks up a user by their SMS-verified phone number.
+
+Returns all matching end users. If no end users match, an empty array is returned.
+
+This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
+ * @summary Look up end users by identity
+ */
+export const lookupEndUser = (
+  params?: LookupEndUserParams,
+  options?: SecondParameter<typeof cdpApiClient<LookupEndUser200>>,
+) => {
+  return cdpApiClient<LookupEndUser200>(
+    { url: `/v2/end-users/lookup`, method: "GET", params },
+    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.
@@ -127,7 +156,7 @@ export const addEndUserEvmSmartAccount = (
   );
 };
 /**
- * Adds a new Solana account to an existing end user. End users can have  up to 10 Solana accounts.
+ * 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
  */
@@ -172,6 +201,7 @@ export type ValidateEndUserAccessTokenResult = NonNullable<
   Awaited<ReturnType<typeof validateEndUserAccessToken>>
 >;
 export type GetEndUserResult = NonNullable<Awaited<ReturnType<typeof getEndUser>>>;
+export type LookupEndUserResult = NonNullable<Awaited<ReturnType<typeof lookupEndUser>>>;
 export type AddEndUserEvmAccountResult = NonNullable<
   Awaited<ReturnType<typeof addEndUserEvmAccount>>
 >;

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

@@ -13,6 +13,7 @@ import type {
   GetOnrampOrderById200,
   GetOnrampUserLimits200,
   GetOnrampUserLimitsBody,
+  OnrampLimitUpgradeRequest,
 } from "../coinbaseDeveloperPlatformAPIs.schemas.js";
 
 import { cdpApiClient } from "../../cdpApiClient.js";
@@ -108,6 +109,33 @@ export const getOnrampUserLimits = (
     options,
   );
 };
+/**
+ * Requests a limit upgrade for an onramp user by submitting identity information. Only phone number is currently supported as a userId. 
+
+The verification process is asynchronous. After calling this endpoint, use the [Get Onramp User Limits](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits) endpoint to check the status in the `limitUpgradeOptions` array.
+
+**Prerequisites:**
+- The phone number must have been previously verified by your app via OTP. - Upgrades may not be available until a certain number of successful transactions by the user.
+
+**Supported fields:**
+- `ssnLast4`: Last 4 digits of the Social Security Number (no dashes or spaces).
+- `dateOfBirth`: Date of birth (day, month, year as zero-padded strings).
+ * @summary Request limit upgrade
+ */
+export const requestLimitsUpgrade = (
+  onrampLimitUpgradeRequest: OnrampLimitUpgradeRequest,
+  options?: SecondParameter<typeof cdpApiClient<void>>,
+) => {
+  return cdpApiClient<void>(
+    {
+      url: `/v2/onramp/limits/upgrade`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: onrampLimitUpgradeRequest,
+    },
+    options,
+  );
+};
 export type CreateOnrampOrderResult = NonNullable<Awaited<ReturnType<typeof createOnrampOrder>>>;
 export type GetOnrampOrderByIdResult = NonNullable<Awaited<ReturnType<typeof getOnrampOrderById>>>;
 export type CreateOnrampSessionResult = NonNullable<
@@ -116,3 +144,6 @@ export type CreateOnrampSessionResult = NonNullable<
 export type GetOnrampUserLimitsResult = NonNullable<
   Awaited<ReturnType<typeof getOnrampUserLimits>>
 >;
+export type RequestLimitsUpgradeResult = NonNullable<
+  Awaited<ReturnType<typeof requestLimitsUpgrade>>
+>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.48.2",
+  "version": "1.49.0",
   "description": "SDK for interacting with the Coinbase Developer Platform Wallet API",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
@@ -24,6 +24,7 @@
     "abitype": "1.0.6",
     "axios": "1.13.6",
     "axios-retry": "^4.5.0",
+    "bs58": "^6.0.0",
     "jose": "^6.2.0",
     "md5": "^2.3.0",
     "uncrypto": "^0.1.3",

package/policies/evmSchema.ts

@@ -855,3 +855,85 @@ export const SignEndUserEvmTypedDataRuleSchema = z.object({
   criteria: SignEndUserEvmTypedDataCriteriaSchema,
 });
 export type SignEndUserEvmTypedDataRule = z.infer<typeof SignEndUserEvmTypedDataRuleSchema>;
+
+/**
+ * Schema for criteria used in SendEndUserEvmAsset operations
+ */
+export const SendEndUserEvmAssetCriteriaSchema = z
+  .array(
+    z.discriminatedUnion("type", [
+      SendEvmTransactionEvmNetworkCriterionSchema,
+      EvmDataCriterionSchema,
+      NetUSDChangeCriterionSchema,
+    ]),
+  )
+  .max(10)
+  .min(1);
+/**
+ * Type representing a set of criteria for the sendEndUserEvmAsset operation.
+ */
+export type SendEndUserEvmAssetCriteria = z.infer<typeof SendEndUserEvmAssetCriteriaSchema>;
+
+/**
+ * Type representing a 'sendEndUserEvmAsset' policy rule that can accept or reject specific operations
+ * based on a set of criteria.
+ */
+export const SendEndUserEvmAssetRuleSchema = 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 "sendEndUserEvmAsset".
+   */
+  operation: z.literal("sendEndUserEvmAsset"),
+  /**
+   * The set of criteria that must be matched for this rule to apply.
+   * Must be compatible with the specified operation type.
+   */
+  criteria: SendEndUserEvmAssetCriteriaSchema,
+});
+export type SendEndUserEvmAssetRule = z.infer<typeof SendEndUserEvmAssetRuleSchema>;
+
+/**
+ * Schema for criteria used in CreateEndUserEvmSwap operations
+ */
+export const CreateEndUserEvmSwapCriteriaSchema = z
+  .array(
+    z.discriminatedUnion("type", [
+      SendEvmTransactionEvmNetworkCriterionSchema,
+      EvmDataCriterionSchema,
+      NetUSDChangeCriterionSchema,
+    ]),
+  )
+  .max(10)
+  .min(1);
+/**
+ * Type representing a set of criteria for the createEndUserEvmSwap operation.
+ */
+export type CreateEndUserEvmSwapCriteria = z.infer<typeof CreateEndUserEvmSwapCriteriaSchema>;
+
+/**
+ * Type representing a 'createEndUserEvmSwap' policy rule that can accept or reject specific operations
+ * based on a set of criteria.
+ */
+export const CreateEndUserEvmSwapRuleSchema = 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 "createEndUserEvmSwap".
+   */
+  operation: z.literal("createEndUserEvmSwap"),
+  /**
+   * The set of criteria that must be matched for this rule to apply.
+   * Must be compatible with the specified operation type.
+   */
+  criteria: CreateEndUserEvmSwapCriteriaSchema,
+});
+export type CreateEndUserEvmSwapRule = z.infer<typeof CreateEndUserEvmSwapRuleSchema>;

package/policies/solanaSchema.ts

@@ -600,3 +600,45 @@ export const SignEndUserSolMessageRuleSchema = z.object({
   criteria: SignEndUserSolMessageCriteriaSchema,
 });
 export type SignEndUserSolMessageRule = z.infer<typeof SignEndUserSolMessageRuleSchema>;
+
+/**
+ * Schema for criteria used in SendEndUserSolAsset operations
+ */
+export const SendEndUserSolAssetCriteriaSchema = z
+  .array(
+    z.discriminatedUnion("type", [
+      SplAddressCriterionSchema,
+      SplValueCriterionSchema,
+      SolDataCriterionSchema,
+      SolNetworkCriterionSchema,
+    ]),
+  )
+  .max(10)
+  .min(1);
+/**
+ * Type representing a set of criteria for the sendEndUserSolAsset operation.
+ */
+export type SendEndUserSolAssetCriteria = z.infer<typeof SendEndUserSolAssetCriteriaSchema>;
+
+/**
+ * Type representing a 'sendEndUserSolAsset' policy rule that can accept or reject specific operations
+ * based on a set of criteria.
+ */
+export const SendEndUserSolAssetRuleSchema = 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 "sendEndUserSolAsset".
+   */
+  operation: z.literal("sendEndUserSolAsset"),
+  /**
+   * The set of criteria that must be matched for this rule to apply.
+   * Must be compatible with the specified operation type.
+   */
+  criteria: SendEndUserSolAssetCriteriaSchema,
+});
+export type SendEndUserSolAssetRule = z.infer<typeof SendEndUserSolAssetRuleSchema>;

package/policies/types.ts

@@ -12,6 +12,8 @@ import {
   SendEndUserEvmTransactionRuleSchema,
   SignEndUserEvmMessageRuleSchema,
   SignEndUserEvmTypedDataRuleSchema,
+  SendEndUserEvmAssetRuleSchema,
+  CreateEndUserEvmSwapRuleSchema,
 } from "./evmSchema.js";
 import {
   SendSolTransactionRuleSchema,
@@ -20,6 +22,7 @@ import {
   SignEndUserSolTransactionRuleSchema,
   SendEndUserSolTransactionRuleSchema,
   SignEndUserSolMessageRuleSchema,
+  SendEndUserSolAssetRuleSchema,
 } from "./solanaSchema.js";
 
 /**
@@ -71,6 +74,9 @@ export const RuleSchema = z.discriminatedUnion("operation", [
   SignEndUserSolTransactionRuleSchema,
   SendEndUserSolTransactionRuleSchema,
   SignEndUserSolMessageRuleSchema,
+  SendEndUserEvmAssetRuleSchema,
+  CreateEndUserEvmSwapRuleSchema,
+  SendEndUserSolAssetRuleSchema,
 ]);
 
 /**

package/version.ts

@@ -1 +1 @@
-export const version = "1.48.2";
+export const version = "1.49.0";