@coinbase/cdp-sdk 1.45.0 → 1.46.0

package/actions/solana/types.ts

@@ -75,18 +75,44 @@ export type AccountActions = {
    * // Create a Solana account
    * const account = await cdp.solana.createAccount();
    *
-   * // Add your transaction instructions here
-   * const transaction = new Transaction()
-   *
-   * // Make sure to set requireAllSignatures to false, since signing will be done through the API
-   * const serializedTransaction = transaction.serialize({
-   *   requireAllSignatures: false,
-   * });
-   *
-   * // Base64 encode the serialized transaction
-   * const transaction = Buffer.from(serializedTransaction).toString("base64");
-   *
-   * // When you want to sign a transaction, you can do so by address and base64 encoded transaction
+   * // Build your transaction using @solana/kit
+   * import {
+   *   address as solanaAddress,
+   *   appendTransactionMessageInstructions,
+   *   compileTransaction,
+   *   createNoopSigner,
+   *   createSolanaRpc,
+   *   createTransactionMessage,
+   *   getBase64EncodedWireTransaction,
+   *   pipe,
+   *   setTransactionMessageFeePayer,
+   *   setTransactionMessageLifetimeUsingBlockhash,
+   * } from "@solana/kit";
+   * import { getTransferSolInstruction } from "@solana-program/system";
+   *
+   * const rpc = createSolanaRpc("https://api.devnet.solana.com");
+   * const { value: { blockhash, lastValidBlockHeight } } = await rpc.getLatestBlockhash().send();
+   *
+   * const txMsg = pipe(
+   *   createTransactionMessage({ version: 0 }),
+   *   (tx) => setTransactionMessageFeePayer(solanaAddress(account.address), tx),
+   *   (tx) => setTransactionMessageLifetimeUsingBlockhash(
+   *     { blockhash, lastValidBlockHeight },
+   *     tx,
+   *   ),
+   *   (tx) => appendTransactionMessageInstructions([
+   *     getTransferSolInstruction({
+   *       source: createNoopSigner(solanaAddress(account.address)),
+   *       destination: solanaAddress("3KzDtddx4i53FBkvCzuDmRbaMozTZoJBb1TToWhz3JfE"),
+   *       amount: 10000n,
+   *     }),
+   *   ], tx),
+   * );
+   *
+   * // Base64 encode the compiled transaction
+   * const transaction = getBase64EncodedWireTransaction(compileTransaction(txMsg));
+   *
+   * // Sign the transaction via the CDP API
    * const { signedTransaction } = await account.signTransaction({
    *   transaction,
    * });
@@ -111,18 +137,44 @@ export type AccountActions = {
    * // Create a Solana account
    * const account = await cdp.solana.createAccount();
    *
-   * // Add your transaction instructions here
-   * const transaction = new Transaction()
-   *
-   * // Make sure to set requireAllSignatures to false, since signing will be done through the API
-   * const serializedTransaction = transaction.serialize({
-   *   requireAllSignatures: false,
-   * });
-   *
-   * // Base64 encode the serialized transaction
-   * const transaction = Buffer.from(serializedTransaction).toString("base64");
-   *
-   * // When you want to sign a transaction, you can do so by address and base64 encoded transaction
+   * // Build your transaction using @solana/kit
+   * import {
+   *   address as solanaAddress,
+   *   appendTransactionMessageInstructions,
+   *   compileTransaction,
+   *   createNoopSigner,
+   *   createSolanaRpc,
+   *   createTransactionMessage,
+   *   getBase64EncodedWireTransaction,
+   *   pipe,
+   *   setTransactionMessageFeePayer,
+   *   setTransactionMessageLifetimeUsingBlockhash,
+   * } from "@solana/kit";
+   * import { getTransferSolInstruction } from "@solana-program/system";
+   *
+   * const rpc = createSolanaRpc("https://api.devnet.solana.com");
+   * const { value: { blockhash, lastValidBlockHeight } } = await rpc.getLatestBlockhash().send();
+   *
+   * const txMsg = pipe(
+   *   createTransactionMessage({ version: 0 }),
+   *   (tx) => setTransactionMessageFeePayer(solanaAddress(account.address), tx),
+   *   (tx) => setTransactionMessageLifetimeUsingBlockhash(
+   *     { blockhash, lastValidBlockHeight },
+   *     tx,
+   *   ),
+   *   (tx) => appendTransactionMessageInstructions([
+   *     getTransferSolInstruction({
+   *       source: createNoopSigner(solanaAddress(account.address)),
+   *       destination: solanaAddress("3KzDtddx4i53FBkvCzuDmRbaMozTZoJBb1TToWhz3JfE"),
+   *       amount: 10000n,
+   *     }),
+   *   ], tx),
+   * );
+   *
+   * // Base64 encode the compiled transaction
+   * const transaction = getBase64EncodedWireTransaction(compileTransaction(txMsg));
+   *
+   * // Send the transaction via the CDP API
    * const { transactionSignature } = await account.sendTransaction({
    *   transaction,
    * });
@@ -138,20 +190,18 @@ export type AccountActions = {
    * @param {TransferOptions} options - Parameters for the transfer.
    * @param {string} options.to - The base58 encoded Solana address of the destination account.
    * @param {sol|usdc|string} options.token - The token to transfer ("sol" or "usdc"), or mint address of the SPL token to transfer.
-   * @param {bigint} options.amount - The amount to transfer in atomic units of the token. For example, 0.01 * LAMPORTS_PER_SOL would transfer 0.01 SOL.
-   * @param {string | Connection} options.network - The network identifier to use, or a Solana Connection object.
+   * @param {bigint} options.amount - The amount to transfer in atomic units of the token. For example, 1 SOL = 1_000_000_000 lamports.
+   * @param {string | SolanaRpcClient} options.network - The network identifier ("mainnet" or "devnet") to use, or an existing Solana RPC client.
    *
    * @returns A promise that resolves to the transaction signature, which can be used to wait for the transaction result.
    *
    * @example
    * ```ts
-   * import { LAMPORTS_PER_SOL } from "@solana/web3.js";
-   *
    * const account = await cdp.solana.getAccount({ name: "Account" });
    *
    * const { signature } = await account.transfer({
    *   token: "sol",
-   *   amount: 5 * LAMPORTS_PER_SOL,
+   *   amount: 5_000_000_000n, // 5 SOL in lamports
    *   to: "3KzDtddx4i53FBkvCzuDmRbaMozTZoJBb1TToWhz3JfE",
    *   network: "devnet",
    * });

package/actions/solana/utils.ts

@@ -1,4 +1,4 @@
-import { Connection } from "@solana/web3.js";
+import { createSolanaRpc } from "@solana/kit";
 
 import {
   GENESIS_HASH_MAINNET,
@@ -9,27 +9,29 @@ import {
 
 export type Network = "mainnet" | "devnet";
 
+export type SolanaRpcClient = ReturnType<typeof createSolanaRpc>;
+
 type GetOrCreateConnectionOptions = {
-  networkOrConnection: Network | Connection;
+  networkOrConnection: Network | SolanaRpcClient;
 };
 
 /**
- * Get a connection for the Solana network
+ * Get a Solana RPC client for the given network or return the provided one
  *
  * @param options - The options for the connection
  *
- * @param options.networkOrConnection - The network to use or a connection
+ * @param options.networkOrConnection - The network to use or an existing RPC client
  *
- * @returns The connection
+ * @returns The RPC client
  */
 export function getOrCreateConnection({
   networkOrConnection,
-}: GetOrCreateConnectionOptions): Connection {
+}: GetOrCreateConnectionOptions): SolanaRpcClient {
   if (typeof networkOrConnection !== "string") {
     return networkOrConnection;
   }
 
-  return new Connection(
+  return createSolanaRpc(
     networkOrConnection === "mainnet"
       ? "https://api.mainnet-beta.solana.com"
       : "https://api.devnet.solana.com",
@@ -37,13 +39,13 @@ export function getOrCreateConnection({
 }
 
 /**
- * Legacy function for compatibility during migration
+ * Determine the network from the RPC client by checking the genesis hash
  *
- * @param connection - The Solana Connection instance
+ * @param rpc - The Solana RPC client
  * @returns The network type (mainnet or devnet)
  */
-export async function getConnectedNetwork(connection: Connection): Promise<Network> {
-  const genesisHash = await connection.getGenesisHash();
+export async function getConnectedNetwork(rpc: SolanaRpcClient): Promise<Network> {
+  const genesisHash = await rpc.getGenesisHash().send();
 
   if (genesisHash === GENESIS_HASH_MAINNET) {
     return "mainnet";

package/auth/utils/http.ts

@@ -134,6 +134,7 @@ function requiresWalletAuth(requestMethod: string, requestPath: string): boolean
     (requestPath?.includes("/accounts") ||
       requestPath?.includes("/spend-permissions") ||
       requestPath?.includes("/user-operations/prepare-and-send") ||
+      requestPath?.includes("/embedded-wallet-api/") ||
       requestPath?.endsWith("/end-users") ||
       requestPath?.endsWith("/end-users/import") ||
       /\/end-users\/[^/]+\/evm$/.test(requestPath) ||

package/client/cdp.ts

@@ -13,6 +13,8 @@ export interface CdpClientOptions {
   apiKeySecret?: string;
   /** The wallet secret. */
   walletSecret?: string;
+  /** The CDP project ID. Required for end-user delegation operations (signing, sending). */
+  projectId?: string;
   /** Whether to enable debugging. */
   debugging?: boolean;
   /** The host URL to connect to. */
@@ -50,6 +52,7 @@ export class CdpClient {
    * CDP_API_KEY_ID=your-api-key-id
    * CDP_API_KEY_SECRET=your-api-key-secret
    * CDP_WALLET_SECRET=your-wallet-secret
+   * CDP_PROJECT_ID=your-project-id
    * ```
    *
    * Or passed as options to the constructor:
@@ -59,6 +62,7 @@ export class CdpClient {
    *   apiKeyId: "your-api-key-id",
    *   apiKeySecret: "your-api-key-secret",
    *   walletSecret: "your-wallet-secret",
+   *   projectId: "your-project-id",
    * });
    * ```
    *
@@ -83,6 +87,7 @@ We recommend using https://github.com/Schniz/fnm for managing your Node.js versi
     const apiKeyId = options.apiKeyId ?? process.env.CDP_API_KEY_ID ?? process.env.CDP_API_KEY_NAME;
     const apiKeySecret = options.apiKeySecret ?? process.env.CDP_API_KEY_SECRET;
     const walletSecret = options.walletSecret ?? process.env.CDP_WALLET_SECRET;
+    const projectId = options.projectId ?? process.env.CDP_PROJECT_ID;
 
     if (!apiKeyId || !apiKeySecret) {
       throw new Error(`
@@ -135,6 +140,6 @@ For more information, see: https://github.com/coinbase/cdp-sdk/blob/main/typescr
     this.evm = new EvmClient();
     this.solana = new SolanaClient();
     this.policies = new PoliciesClient();
-    this.endUser = new CDPEndUserClient();
+    this.endUser = new CDPEndUserClient(projectId);
   }
 }