@coinbase/cdp-sdk 1.48.0 → 1.48.1

package/actions/webhooks/createWebhookSubscription.ts

@@ -10,7 +10,12 @@ export type WebhookEventType =
   | "wallet.transaction.replaced"
   | "wallet.transaction.confirmed"
   | "wallet.transaction.failed"
-  | "wallet.transaction.signed";
+  | "wallet.transaction.signed"
+  | "wallet.typed_data.signed"
+  | "wallet.message.signed"
+  | "wallet.hash.signed"
+  | "wallet.delegation.created"
+  | "wallet.delegation.revoked";
 
 /**
  * Options for creating a webhook subscription.

package/client/end-user/endUser.ts

@@ -14,6 +14,8 @@ import {
   type AddEndUserEvmSmartAccountResult,
   type AddEndUserSolanaAccountOptions,
   type AddEndUserSolanaAccountResult,
+  type GetDelegationForEndUserOptions,
+  type GetDelegationForEndUserResult,
   type RevokeDelegationForEndUserOptions,
   type SignEvmTransactionOptions,
   type SignEvmTransactionResult,
@@ -258,6 +260,34 @@ export class EndUserClient {
     return CdpOpenApiClient.addEndUserSolanaAccount(userId, {});
   }
 
+  /**
+   * Gets the active delegation for the specified end user, if one exists.
+   * This operation can be performed by the end user themselves or by a developer using their API key.
+   *
+   * @param options - The options for getting the delegation.
+   *
+   * @returns A promise that resolves to the delegation details including its expiry.
+   *
+   * @example **Get the active delegation for an end user**
+   *          ```ts
+   *          const delegation = await cdp.endUser.getDelegationForEndUser({
+   *            userId: "user-123"
+   *          });
+   *          console.log(delegation.expiresAt);
+   *          ```
+   */
+  async getDelegationForEndUser(
+    options: GetDelegationForEndUserOptions,
+  ): Promise<GetDelegationForEndUserResult> {
+    Analytics.trackAction({
+      action: "get_delegation_for_end_user",
+    });
+
+    const { userId } = options;
+
+    return CdpOpenApiClient.getDelegationForEndUser(userId);
+  }
+
   /**
    * Revokes all active delegations for the specified end user.
    * This operation can be performed by the end user themselves or by a developer using their API key.

package/client/end-user/endUser.types.ts

@@ -7,6 +7,7 @@ import type {
   AddEndUserEvmSmartAccount201,
   AddEndUserSolanaAccount201,
   EndUser as OpenAPIEndUser,
+  GetDelegationForEndUser200,
   SignEvmTransactionWithEndUserAccount200,
   SignEvmMessageWithEndUserAccount200,
   SignEvmTypedDataWithEndUserAccount200,
@@ -139,6 +140,21 @@ export interface ImportEndUserOptions {
   encryptionPublicKey?: string;
 }
 
+/**
+ * The options for getting the active delegation for an end user.
+ */
+export interface GetDelegationForEndUserOptions {
+  /**
+   * The unique identifier of the end user.
+   */
+  userId: string;
+}
+
+/**
+ * The result of getting the active delegation for an end user.
+ */
+export type GetDelegationForEndUserResult = GetDelegationForEndUser200;
+
 /**
  * The options for revoking all active delegations for an end user.
  */
@@ -595,6 +611,21 @@ export type EndUserAccountActions = {
    */
   addSolanaAccount: () => Promise<AddEndUserSolanaAccountResult>;
 
+  /**
+   * Gets the active delegation for this end user, if one exists.
+   *
+   * @returns A promise that resolves to the delegation details including its expiry.
+   *
+   * @example
+   * ```ts
+   * const endUser = await cdp.endUser.getEndUser({ userId: "user-123" });
+   *
+   * const delegation = await endUser.getDelegation();
+   * console.log(delegation.expiresAt);
+   * ```
+   */
+  getDelegation: () => Promise<GetDelegationForEndUserResult>;
+
   /**
    * Revokes all active delegations for this end user.
    * This operation can be performed by the end user themselves or by a developer using their API key.

package/client/end-user/toEndUserAccount.ts

@@ -6,6 +6,7 @@ import type {
   AddEndUserEvmSmartAccountResult,
   AddEndUserSolanaAccountResult,
   AddEvmSmartAccountOptions,
+  GetDelegationForEndUserResult,
   SignEvmTransactionResult,
   SignEvmMessageResult,
   SignEvmTypedDataResult,
@@ -143,6 +144,11 @@ export function toEndUserAccount(
       return apiClient.addEndUserSolanaAccount(endUser.userId, {});
     },
 
+    async getDelegation(): Promise<GetDelegationForEndUserResult> {
+      Analytics.trackAction({ action: "end_user_get_delegation" });
+      return apiClient.getDelegationForEndUser(endUser.userId);
+    },
+
     async revokeDelegation(): Promise<void> {
       Analytics.trackAction({ action: "end_user_revoke_delegation" });
       await apiClient.revokeDelegationForEndUser(endUser.userId, {});

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

@@ -284,7 +284,9 @@ export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 export const ErrorType = {
   already_exists: "already_exists",
+  authorization_expired: "authorization_expired",
   bad_gateway: "bad_gateway",
+  capture_expired: "capture_expired",
   client_closed_request: "client_closed_request",
   faucet_limit_exceeded: "faucet_limit_exceeded",
   forbidden: "forbidden",
@@ -315,6 +317,7 @@ export const ErrorType = {
   document_verification_failed: "document_verification_failed",
   recipient_allowlist_violation: "recipient_allowlist_violation",
   recipient_allowlist_pending: "recipient_allowlist_pending",
+  refund_expired: "refund_expired",
   travel_rules_recipient_violation: "travel_rules_recipient_violation",
   source_account_invalid: "source_account_invalid",
   target_account_invalid: "target_account_invalid",
@@ -4602,6 +4605,19 @@ export type SignEvmTypedDataWithEndUserAccount200 = {
   signature: string;
 };
 
+export type GetDelegationForEndUserParams = {
+  /**
+   * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
+   * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+   */
+  projectID?: ProjectIDOptionalParameter;
+};
+
+export type GetDelegationForEndUser200 = {
+  /** The date until which the delegation is valid. */
+  expiresAt: string;
+};
+
 export type RevokeDelegationForEndUserBody = {
   /**
    * When revoking with a wallet authentication scheme, the ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.

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

@@ -11,6 +11,8 @@ import type {
   CreateEvmEip7702DelegationWithEndUserAccountBody,
   CreateEvmEip7702DelegationWithEndUserAccountParams,
   EvmUserOperation,
+  GetDelegationForEndUser200,
+  GetDelegationForEndUserParams,
   RevokeDelegationForEndUserBody,
   SendEvmAssetWithEndUserAccount200,
   SendEvmAssetWithEndUserAccountBody,
@@ -185,6 +187,20 @@ export const signEvmTypedDataWithEndUserAccount = (
     options,
   );
 };
+/**
+ * Returns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using their API key.
+ * @summary Get delegation for end user
+ */
+export const getDelegationForEndUser = (
+  userId: string,
+  params?: GetDelegationForEndUserParams,
+  options?: SecondParameter<typeof cdpApiClient<GetDelegationForEndUser200>>,
+) => {
+  return cdpApiClient<GetDelegationForEndUser200>(
+    { url: `/v2/embedded-wallet-api/end-users/${userId}/delegation`, method: "GET", params },
+    options,
+  );
+};
 /**
  * Revokes all active delegations for the specified end user. This operation can be performed by the end user themselves or by a developer using their API key.
  * @summary Revoke delegation for end user
@@ -378,6 +394,9 @@ export type SignEvmMessageWithEndUserAccountResult = NonNullable<
 export type SignEvmTypedDataWithEndUserAccountResult = NonNullable<
   Awaited<ReturnType<typeof signEvmTypedDataWithEndUserAccount>>
 >;
+export type GetDelegationForEndUserResult = NonNullable<
+  Awaited<ReturnType<typeof getDelegationForEndUser>>
+>;
 export type RevokeDelegationForEndUserResult = NonNullable<
   Awaited<ReturnType<typeof revokeDelegationForEndUser>>
 >;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.48.0",
+  "version": "1.48.1",
   "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.48.0";
+export const version = "1.48.1";