@coinbase/cdp-sdk 1.45.0 → 1.46.1

package/_types/client/end-user/endUser.d.ts

@@ -1,9 +1,16 @@
-import { type ValidateAccessTokenOptions, type ListEndUsersOptions, type CreateEndUserOptions, type GetEndUserOptions, type ImportEndUserOptions, type AddEndUserEvmAccountOptions, type AddEndUserEvmAccountResult, type AddEndUserEvmSmartAccountOptions, type AddEndUserEvmSmartAccountResult, type AddEndUserSolanaAccountOptions, type AddEndUserSolanaAccountResult, type EndUserAccount } from "./endUser.types.js";
+import { type ValidateAccessTokenOptions, type ListEndUsersOptions, type CreateEndUserOptions, type GetEndUserOptions, type ImportEndUserOptions, type AddEndUserEvmAccountOptions, type AddEndUserEvmAccountResult, type AddEndUserEvmSmartAccountOptions, type AddEndUserEvmSmartAccountResult, type AddEndUserSolanaAccountOptions, type AddEndUserSolanaAccountResult, type RevokeDelegationForEndUserOptions, type SignEvmHashOptions, type SignEvmHashResult, type SignEvmTransactionOptions, type SignEvmTransactionResult, type SignEvmMessageOptions, type SignEvmMessageResult, type SignEvmTypedDataOptions, type SignEvmTypedDataResult, type SendEvmTransactionOptions, type SendEvmTransactionResult, type SendEvmAssetOptions, type SendEvmAssetResult, type SendUserOperationOptions, type SendUserOperationResult, type CreateEvmEip7702DelegationOptions, type CreateEvmEip7702DelegationForEndUserResult, type SignSolanaHashOptions, type SignSolanaHashResult, type SignSolanaMessageOptions, type SignSolanaMessageResult, type SignSolanaTransactionOptions, type SignSolanaTransactionResult, type SendSolanaTransactionOptions, type SendSolanaTransactionResult, type SendSolanaAssetOptions, type SendSolanaAssetResult, type EndUserAccount } from "./endUser.types.js";
 import { type ListEndUsers200 } from "../../openapi-client/index.js";
 /**
  * The CDP end user client.
  */
 export declare class CDPEndUserClient {
+    private projectId?;
+    /**
+     * Creates a new CDPEndUserClient.
+     *
+     * @param projectId - The CDP project ID. Required for delegation operations (signing, sending).
+     */
+    constructor(projectId?: string);
     /**
      * Creates an end user. An end user is an entity that can own CDP EVM accounts,
      * EVM smart accounts, and/or Solana accounts.
@@ -141,6 +148,264 @@ export declare class CDPEndUserClient {
      *          ```
      */
     addEndUserSolanaAccount(options: AddEndUserSolanaAccountOptions): Promise<AddEndUserSolanaAccountResult>;
+    /**
+     * 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.
+     *
+     * @param options - The options for revoking the delegation.
+     *
+     * @returns A promise that resolves when the delegation has been revoked.
+     *
+     * @example **Revoke all delegations for an end user**
+     *          ```ts
+     *          await cdp.endUser.revokeDelegationForEndUser({
+     *            userId: "user-123"
+     *          });
+     *          ```
+     */
+    revokeDelegationForEndUser(options: RevokeDelegationForEndUserOptions): Promise<void>;
+    /**
+     * Signs an EVM hash on behalf of an end user using a delegation.
+     * The end user must have previously created a delegation granting signing permissions.
+     *
+     * @param options - The options for signing an EVM hash.
+     *
+     * @returns A promise that resolves to the signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signEvmHash({
+     *   userId: "user-123",
+     *   hash: "0xabcdef...",
+     *   address: "0x1234..."
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    signEvmHash(options: SignEvmHashOptions): Promise<SignEvmHashResult>;
+    /**
+     * Signs an EVM transaction on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing an EVM transaction.
+     *
+     * @returns A promise that resolves to the signed transaction.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signEvmTransaction({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   transaction: "0x02..."
+     * });
+     * console.log(result.signedTransaction);
+     * ```
+     */
+    signEvmTransaction(options: SignEvmTransactionOptions): Promise<SignEvmTransactionResult>;
+    /**
+     * Signs an EVM message (EIP-191) on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing an EVM message.
+     *
+     * @returns A promise that resolves to the signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signEvmMessage({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   message: "Hello, World!"
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    signEvmMessage(options: SignEvmMessageOptions): Promise<SignEvmMessageResult>;
+    /**
+     * Signs EVM EIP-712 typed data on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing EVM typed data.
+     *
+     * @returns A promise that resolves to the signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signEvmTypedData({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   typedData: { domain: {}, types: {}, primaryType: "...", message: {} }
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    signEvmTypedData(options: SignEvmTypedDataOptions): Promise<SignEvmTypedDataResult>;
+    /**
+     * Sends an EVM transaction on behalf of an end user using a delegation.
+     *
+     * @param options - The options for sending an EVM transaction.
+     *
+     * @returns A promise that resolves to the transaction hash.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.sendEvmTransaction({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   transaction: "0x02...",
+     *   network: "base-sepolia"
+     * });
+     * console.log(result.transactionHash);
+     * ```
+     */
+    sendEvmTransaction(options: SendEvmTransactionOptions): Promise<SendEvmTransactionResult>;
+    /**
+     * Sends an EVM asset (e.g. USDC) on behalf of an end user using a delegation.
+     *
+     * @param options - The options for sending an EVM asset.
+     *
+     * @returns A promise that resolves to the transaction result.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.sendEvmAsset({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   to: "0xabcd...",
+     *   amount: "1000000",
+     *   network: "base-sepolia"
+     * });
+     * console.log(result.transactionHash);
+     * ```
+     */
+    sendEvmAsset(options: SendEvmAssetOptions): Promise<SendEvmAssetResult>;
+    /**
+     * Sends a user operation on behalf of an end user using a delegation.
+     *
+     * @param options - The options for sending a user operation.
+     *
+     * @returns A promise that resolves to the user operation result.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.sendUserOperation({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   network: "base-sepolia",
+     *   calls: [{ to: "0xabcd...", value: "0", data: "0x" }],
+     *   useCdpPaymaster: true
+     * });
+     * ```
+     */
+    sendUserOperation(options: SendUserOperationOptions): Promise<SendUserOperationResult>;
+    /**
+     * Creates an EVM EIP-7702 delegation on behalf of an end user.
+     *
+     * @param options - The options for creating an EIP-7702 delegation.
+     *
+     * @returns A promise that resolves to the delegation operation ID.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.createEvmEip7702Delegation({
+     *   userId: "user-123",
+     *   address: "0x1234...",
+     *   network: "base-sepolia"
+     * });
+     * console.log(result.delegationOperationId);
+     * ```
+     */
+    createEvmEip7702Delegation(options: CreateEvmEip7702DelegationOptions): Promise<CreateEvmEip7702DelegationForEndUserResult>;
+    /**
+     * Signs a Solana hash on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing a Solana hash.
+     *
+     * @returns A promise that resolves to the signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signSolanaHash({
+     *   userId: "user-123",
+     *   hash: "base64hash...",
+     *   address: "So1ana..."
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    signSolanaHash(options: SignSolanaHashOptions): Promise<SignSolanaHashResult>;
+    /**
+     * Signs a Solana message on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing a Solana message.
+     *
+     * @returns A promise that resolves to the signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signSolanaMessage({
+     *   userId: "user-123",
+     *   address: "So1ana...",
+     *   message: "base64message..."
+     * });
+     * console.log(result.signature);
+     * ```
+     */
+    signSolanaMessage(options: SignSolanaMessageOptions): Promise<SignSolanaMessageResult>;
+    /**
+     * Signs a Solana transaction on behalf of an end user using a delegation.
+     *
+     * @param options - The options for signing a Solana transaction.
+     *
+     * @returns A promise that resolves to the signed transaction.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.signSolanaTransaction({
+     *   userId: "user-123",
+     *   address: "So1ana...",
+     *   transaction: "base64tx..."
+     * });
+     * console.log(result.signedTransaction);
+     * ```
+     */
+    signSolanaTransaction(options: SignSolanaTransactionOptions): Promise<SignSolanaTransactionResult>;
+    /**
+     * Sends a Solana transaction on behalf of an end user using a delegation.
+     *
+     * @param options - The options for sending a Solana transaction.
+     *
+     * @returns A promise that resolves to the transaction signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.sendSolanaTransaction({
+     *   userId: "user-123",
+     *   address: "So1ana...",
+     *   transaction: "base64tx...",
+     *   network: "solana-devnet"
+     * });
+     * console.log(result.transactionSignature);
+     * ```
+     */
+    sendSolanaTransaction(options: SendSolanaTransactionOptions): Promise<SendSolanaTransactionResult>;
+    /**
+     * Sends a Solana asset (e.g. USDC) on behalf of an end user using a delegation.
+     *
+     * @param options - The options for sending a Solana asset.
+     *
+     * @returns A promise that resolves to the transaction signature.
+     *
+     * @example
+     * ```ts
+     * const result = await cdp.endUser.sendSolanaAsset({
+     *   userId: "user-123",
+     *   address: "So1ana...",
+     *   to: "Recipi...",
+     *   amount: "1000000",
+     *   network: "solana-devnet"
+     * });
+     * console.log(result.transactionSignature);
+     * ```
+     */
+    sendSolanaAsset(options: SendSolanaAssetOptions): Promise<SendSolanaAssetResult>;
     /**
      * Validates an end user's access token. Throws an error if the access token is invalid.
      *
@@ -179,5 +444,11 @@ export declare class CDPEndUserClient {
      *          ```
      */
     importEndUser(options: ImportEndUserOptions): Promise<EndUserAccount>;
+    /**
+     * Returns the configured project ID or throws if not configured.
+     *
+     * @returns The project ID.
+     */
+    private requireProjectId;
 }
 //# sourceMappingURL=endUser.d.ts.map

package/_types/client/end-user/endUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endUser.d.ts","sourceRoot":"","sources":["../../../client/end-user/endUser.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEvF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAe3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa/E;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAYrE;;;;;;;;;;;;;;OAcG;IACG,oBAAoB,CACxB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC;IAUtC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,yBAAyB,CAC7B,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,+BAA+B,CAAC;IAY3C;;;;;;;;;;;;;;OAcG;IACG,uBAAuB,CAC3B,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC;IAUzC;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,cAAc,CAAC;IAcvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CA2D5E"}
+{"version":3,"file":"endUser.d.ts","sourceRoot":"","sources":["../../../client/end-user/endUser.ts"],"names":[],"mappings":"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"}