@coinbase/cdp-sdk 1.15.0 → 1.16.0

package/client/evm/evm.types.ts

@@ -106,14 +106,18 @@ export interface CreateSwapQuoteOptions {
   fromToken: Address;
   /** The amount to send in atomic units of the token. */
   fromAmount: bigint;
-  /** The address that will perform the swap. */
-  taker?: Address;
-  /** The signer address (only needed if taker is a smart contract). */
+  /** The address receiving the output of the swap. */
+  taker: Address;
+  /** The address signing the swap (only needed if taker is a smart contract, i.e. for smart account swaps). */
   signerAddress?: Address;
-  /** The gas price in Wei. */
+  /** The smart account object (required for smart account execution context only). */
+  smartAccount?: SmartAccount;
+  /** The price per unit of gas in wei. */
   gasPrice?: bigint;
   /** The slippage tolerance in basis points (0-10000). */
   slippageBps?: number;
+  /** The idempotency key. */
+  idempotencyKey?: string;
 }
 
 /**
@@ -136,6 +140,8 @@ export interface GetSwapPriceOptions {
   gasPrice?: bigint;
   /** The slippage tolerance in basis points (0-10000). */
   slippageBps?: number;
+  /** The idempotency key. */
+  idempotencyKey?: string;
 }
 
 /**
@@ -186,8 +192,14 @@ export interface ExecuteSwapQuoteOptions {
  * Result of executing a swap quote.
  */
 export interface ExecuteSwapQuoteResult {
-  /** The transaction hash of the executed swap. */
-  transactionHash: Hex;
+  /** The transaction hash of the executed swap (for EOA swaps). */
+  transactionHash?: Hex;
+  /** The user operation hash of the executed swap (for smart account swaps). */
+  userOpHash?: Hex;
+  /** The address of the smart account (for smart account swaps). */
+  smartAccountAddress?: Address;
+  /** The status of the user operation (for smart accounts swaps). */
+  status?: typeof EvmUserOperationStatus.broadcast;
 }
 
 /**
@@ -599,3 +611,18 @@ export type GetSwapQuoteOptions = GetSwapPriceOptions;
 export type GetSwapQuoteResult = GetSwapPriceResult;
 export type SwapQuoteUnavailableResult = SwapUnavailableResult;
 export type SwapPriceUnavailableResult = SwapUnavailableResult;
+
+/**
+ * Options for signing and wrapping EIP-712 typed data with a smart account.
+ * This method handles the full smart account signature flow including replay-safe hashing.
+ */
+export interface SmartAccountSignAndWrapTypedDataOptions {
+  /** The chain ID for the signature (used for replay protection). */
+  chainId: bigint;
+  /** The EIP-712 typed data message to sign. */
+  typedData: EIP712Message;
+  /** The index of the owner to sign with (defaults to 0). */
+  ownerIndex?: bigint;
+  /** Optional idempotency key for the signing request. */
+  idempotencyKey?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "SDK for interacting with the Coinbase Developer Platform Wallet API",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",

package/utils/uuidV4.ts

@@ -0,0 +1,23 @@
+import { createHash } from "crypto";
+
+/**
+ * Deterministically generates a UUIDv4 from a given input string.
+ * This is necessary when we need to generate downstream idempotency keys for operations that have multiple calls.
+ *
+ * @param input - The input string to derive from
+ * @param salt - Optional salt to append to the input (defaults to "salt")
+ * @returns A UUIDv4 formatted string
+ */
+export function createDeterministicUuidV4(input: string, salt = "salt"): string {
+  const hash = createHash("sha256")
+    .update(input + "-" + salt)
+    .digest("hex");
+  // Format as UUIDv4: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+  return [
+    hash.slice(0, 8),
+    hash.slice(8, 12),
+    "4" + hash.slice(13, 16), // Version 4
+    ((parseInt(hash.slice(16, 17), 16) & 0x3) | 0x8).toString(16) + hash.slice(17, 20), // Variant bits
+    hash.slice(20, 32),
+  ].join("-");
+}

package/version.ts

@@ -1 +1 @@
-export const version = "1.15.0";
+export const version = "1.16.0";