@coinbase/agentkit 0.0.0-nightly-20250425210424 → 0.0.0-nightly-20250430210501

package/dist/wallet-providers/cdpV2Shared.d.ts

@@ -0,0 +1,41 @@
+import { CdpClient } from "@coinbase/cdp-sdk";
+export interface CdpV2ProviderConfig {
+    /**
+     * The CDP API Key ID.
+     */
+    apiKeyId?: string;
+    /**
+     * The CDP API Key Secret.
+     */
+    apiKeySecret?: string;
+    /**
+     * The CDP Wallet Secret.
+     */
+    walletSecret?: string;
+}
+/**
+ * Configuration options for the CDP Providers.
+ */
+export interface CdpV2WalletProviderConfig extends CdpV2ProviderConfig {
+    /**
+     * The address of the wallet.
+     */
+    address?: string;
+    /**
+     * The network of the wallet.
+     */
+    networkId?: string;
+    /**
+     * The idempotency key of the wallet. Only used when creating a new account.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * A wallet provider that can be used to interact with the CDP.
+ */
+export interface WalletProviderWithClient {
+    /**
+     * Gets the CDP client.
+     */
+    getClient(): CdpClient;
+}

package/dist/wallet-providers/cdpV2Shared.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/wallet-providers/cdpV2SolanaWalletProvider.d.ts

@@ -0,0 +1,111 @@
+import { CdpClient } from "@coinbase/cdp-sdk";
+import { Connection, PublicKey, RpcResponseAndContext, SignatureResult, SignatureStatus, SignatureStatusConfig, VersionedTransaction } from "@solana/web3.js";
+import { Network } from "../network";
+import { WalletProviderWithClient, CdpV2WalletProviderConfig } from "./cdpV2Shared";
+import { SvmWalletProvider } from "./svmWalletProvider";
+/**
+ * A wallet provider that uses the Coinbase SDK.
+ */
+export declare class CdpV2SolanaWalletProvider extends SvmWalletProvider implements WalletProviderWithClient {
+    #private;
+    /**
+     * Constructs a new CdpWalletProvider.
+     *
+     * @param config - The configuration options for the CdpWalletProvider.
+     */
+    private constructor();
+    /**
+     * Configures a new CdpWalletProvider with a wallet.
+     *
+     * @param config - Optional configuration parameters
+     * @returns A Promise that resolves to a new CdpWalletProvider instance
+     * @throws Error if required environment variables are missing or wallet initialization fails
+     */
+    static configureWithWallet(config?: CdpV2WalletProviderConfig): Promise<CdpV2SolanaWalletProvider>;
+    /**
+     * Get the connection instance
+     *
+     * @returns The Solana connection instance
+     */
+    getConnection(): Connection;
+    /**
+     * Get the public key of the wallet
+     *
+     * @returns The wallet's public key
+     */
+    getPublicKey(): PublicKey;
+    /**
+     * Get the address of the wallet
+     *
+     * @returns The base58 encoded address of the wallet
+     */
+    getAddress(): string;
+    /**
+     * Get the network
+     *
+     * @returns The network
+     */
+    getNetwork(): Network;
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The name of the wallet provider.
+     */
+    getName(): string;
+    /**
+     * Sign a transaction
+     *
+     * @param transaction - The transaction to sign
+     * @returns The signed transaction
+     */
+    signTransaction(transaction: VersionedTransaction): Promise<VersionedTransaction>;
+    /**
+     * Send a transaction
+     *
+     * @param transaction - The transaction to send
+     * @returns The signature
+     */
+    sendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Sign and send a transaction
+     *
+     * @param transaction - The transaction to sign and send
+     * @returns The signature
+     */
+    signAndSendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Get the status of a transaction
+     *
+     * @param signature - The signature
+     * @param options - The options for the status
+     * @returns The status
+     */
+    getSignatureStatus(signature: string, options?: SignatureStatusConfig): Promise<RpcResponseAndContext<SignatureStatus | null>>;
+    /**
+     * Wait for signature receipt
+     *
+     * @param signature - The signature
+     * @returns The confirmation response
+     */
+    waitForSignatureResult(signature: string): Promise<RpcResponseAndContext<SignatureResult>>;
+    /**
+     * Get the balance of the wallet
+     *
+     * @returns The balance of the wallet
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Gets the CDP client.
+     *
+     * @returns The CDP client.
+     */
+    getClient(): CdpClient;
+    /**
+     * Transfer SOL from the wallet to another address
+     *
+     * @param to - The base58 encoded address to transfer the SOL to
+     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @returns The signature
+     */
+    nativeTransfer(to: string, value: string): Promise<string>;
+}

package/dist/wallet-providers/cdpV2SolanaWalletProvider.js

@@ -0,0 +1,247 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CdpV2SolanaWalletProvider_connection, _CdpV2SolanaWalletProvider_serverAccount, _CdpV2SolanaWalletProvider_cdp, _CdpV2SolanaWalletProvider_network;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdpV2SolanaWalletProvider = void 0;
+const cdp_sdk_1 = require("@coinbase/cdp-sdk");
+const web3_js_1 = require("@solana/web3.js");
+const svm_1 = require("../network/svm");
+const svmWalletProvider_1 = require("./svmWalletProvider");
+/**
+ * A wallet provider that uses the Coinbase SDK.
+ */
+class CdpV2SolanaWalletProvider extends svmWalletProvider_1.SvmWalletProvider {
+    /**
+     * Constructs a new CdpWalletProvider.
+     *
+     * @param config - The configuration options for the CdpWalletProvider.
+     */
+    constructor(config) {
+        super();
+        _CdpV2SolanaWalletProvider_connection.set(this, void 0);
+        _CdpV2SolanaWalletProvider_serverAccount.set(this, void 0);
+        _CdpV2SolanaWalletProvider_cdp.set(this, void 0);
+        _CdpV2SolanaWalletProvider_network.set(this, void 0);
+        __classPrivateFieldSet(this, _CdpV2SolanaWalletProvider_serverAccount, config.serverAccount, "f");
+        __classPrivateFieldSet(this, _CdpV2SolanaWalletProvider_cdp, config.cdp, "f");
+        __classPrivateFieldSet(this, _CdpV2SolanaWalletProvider_connection, config.connection, "f");
+        __classPrivateFieldSet(this, _CdpV2SolanaWalletProvider_network, config.network, "f");
+    }
+    /**
+     * Configures a new CdpWalletProvider with a wallet.
+     *
+     * @param config - Optional configuration parameters
+     * @returns A Promise that resolves to a new CdpWalletProvider instance
+     * @throws Error if required environment variables are missing or wallet initialization fails
+     */
+    static async configureWithWallet(config = {}) {
+        const apiKeyId = config.apiKeyId || process.env.CDP_API_KEY_ID;
+        const apiKeySecret = config.apiKeySecret || process.env.CDP_API_KEY_SECRET;
+        const walletSecret = config.walletSecret || process.env.CDP_WALLET_SECRET;
+        const idempotencyKey = config.idempotencyKey || process.env.IDEMPOTENCY_KEY;
+        if (!apiKeyId || !apiKeySecret || !walletSecret) {
+            throw new Error("Missing required environment variables. CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET are required.");
+        }
+        const networkId = config.networkId || process.env.NETWORK_ID || "solana-devnet";
+        let network;
+        let rpcUrl;
+        switch (networkId) {
+            case svm_1.SOLANA_MAINNET_NETWORK_ID:
+                network = svm_1.SOLANA_MAINNET_NETWORK;
+                rpcUrl = (0, web3_js_1.clusterApiUrl)("mainnet-beta");
+                break;
+            case svm_1.SOLANA_DEVNET_NETWORK_ID:
+                network = svm_1.SOLANA_DEVNET_NETWORK;
+                rpcUrl = (0, web3_js_1.clusterApiUrl)("devnet");
+                break;
+            case svm_1.SOLANA_TESTNET_NETWORK_ID:
+                network = svm_1.SOLANA_TESTNET_NETWORK;
+                rpcUrl = (0, web3_js_1.clusterApiUrl)("testnet");
+                break;
+            default:
+                throw new Error(`${networkId} is not a valid SVM networkId`);
+        }
+        const cdpClient = new cdp_sdk_1.CdpClient({
+            apiKeyId,
+            apiKeySecret,
+            walletSecret,
+        });
+        const connection = new web3_js_1.Connection(rpcUrl);
+        const serverAccount = await (config.address
+            ? cdpClient.solana.getAccount({ address: config.address })
+            : cdpClient.solana.createAccount({ idempotencyKey }));
+        return new CdpV2SolanaWalletProvider({
+            connection,
+            cdp: cdpClient,
+            serverAccount,
+            network,
+        });
+    }
+    /**
+     * Get the connection instance
+     *
+     * @returns The Solana connection instance
+     */
+    getConnection() {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f");
+    }
+    /**
+     * Get the public key of the wallet
+     *
+     * @returns The wallet's public key
+     */
+    getPublicKey() {
+        return new web3_js_1.PublicKey(__classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_serverAccount, "f").address);
+    }
+    /**
+     * Get the address of the wallet
+     *
+     * @returns The base58 encoded address of the wallet
+     */
+    getAddress() {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_serverAccount, "f").address;
+    }
+    /**
+     * Get the network
+     *
+     * @returns The network
+     */
+    getNetwork() {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_network, "f");
+    }
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The name of the wallet provider.
+     */
+    getName() {
+        return "cdp_v2_solana_wallet_provider";
+    }
+    /**
+     * Sign a transaction
+     *
+     * @param transaction - The transaction to sign
+     * @returns The signed transaction
+     */
+    async signTransaction(transaction) {
+        const serializedTransaction = transaction.serialize();
+        const encodedSerializedTransaction = Buffer.from(serializedTransaction).toString("base64");
+        const signedTransaction = await __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_cdp, "f").solana.signTransaction({
+            transaction: encodedSerializedTransaction,
+            address: __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_serverAccount, "f").address,
+        });
+        transaction.addSignature(this.getPublicKey(), Buffer.from(signedTransaction.signature, "base64"));
+        return transaction;
+    }
+    /**
+     * Send a transaction
+     *
+     * @param transaction - The transaction to send
+     * @returns The signature
+     */
+    async sendTransaction(transaction) {
+        const signature = await __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").sendTransaction(transaction);
+        await this.waitForSignatureResult(signature);
+        return signature;
+    }
+    /**
+     * Sign and send a transaction
+     *
+     * @param transaction - The transaction to sign and send
+     * @returns The signature
+     */
+    async signAndSendTransaction(transaction) {
+        const signedTransaction = await this.signTransaction(transaction);
+        return this.sendTransaction(signedTransaction);
+    }
+    /**
+     * Get the status of a transaction
+     *
+     * @param signature - The signature
+     * @param options - The options for the status
+     * @returns The status
+     */
+    async getSignatureStatus(signature, options) {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").getSignatureStatus(signature, options);
+    }
+    /**
+     * Wait for signature receipt
+     *
+     * @param signature - The signature
+     * @returns The confirmation response
+     */
+    async waitForSignatureResult(signature) {
+        const { blockhash, lastValidBlockHeight } = await __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").getLatestBlockhash();
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").confirmTransaction({
+            signature: signature,
+            lastValidBlockHeight,
+            blockhash,
+        });
+    }
+    /**
+     * Get the balance of the wallet
+     *
+     * @returns The balance of the wallet
+     */
+    getBalance() {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").getBalance(this.getPublicKey()).then(balance => BigInt(balance));
+    }
+    /**
+     * Gets the CDP client.
+     *
+     * @returns The CDP client.
+     */
+    getClient() {
+        return __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_cdp, "f");
+    }
+    /**
+     * Transfer SOL from the wallet to another address
+     *
+     * @param to - The base58 encoded address to transfer the SOL to
+     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @returns The signature
+     */
+    async nativeTransfer(to, value) {
+        const initialBalance = await this.getBalance();
+        const solAmount = parseFloat(value);
+        const lamports = BigInt(Math.floor(solAmount * web3_js_1.LAMPORTS_PER_SOL));
+        // Check if we have enough balance (including estimated fees)
+        if (initialBalance < lamports + BigInt(5000)) {
+            throw new Error(`Insufficient balance. Have ${Number(initialBalance) / web3_js_1.LAMPORTS_PER_SOL} SOL, need ${solAmount + 0.000005} SOL (including fees)`);
+        }
+        const toPubkey = new web3_js_1.PublicKey(to);
+        const instructions = [
+            web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({
+                microLamports: 10000,
+            }),
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+                units: 2000,
+            }),
+            web3_js_1.SystemProgram.transfer({
+                fromPubkey: this.getPublicKey(),
+                toPubkey: toPubkey,
+                lamports: lamports,
+            }),
+        ];
+        const tx = new web3_js_1.VersionedTransaction(web3_js_1.MessageV0.compile({
+            payerKey: this.getPublicKey(),
+            instructions: instructions,
+            recentBlockhash: (await __classPrivateFieldGet(this, _CdpV2SolanaWalletProvider_connection, "f").getLatestBlockhash()).blockhash,
+        }));
+        const signature = await this.signAndSendTransaction(tx);
+        await this.waitForSignatureResult(signature);
+        return signature;
+    }
+}
+exports.CdpV2SolanaWalletProvider = CdpV2SolanaWalletProvider;
+_CdpV2SolanaWalletProvider_connection = new WeakMap(), _CdpV2SolanaWalletProvider_serverAccount = new WeakMap(), _CdpV2SolanaWalletProvider_cdp = new WeakMap(), _CdpV2SolanaWalletProvider_network = new WeakMap();

package/dist/wallet-providers/cdpV2SolanaWalletProvider.test.d.ts

@@ -0,0 +1 @@
+export {};