@coinbase/agentkit 0.8.2 → 0.9.0

package/dist/wallet-providers/{cdpV2EvmWalletProvider.js → cdpEvmWalletProvider.js}

@@ -10,9 +10,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _CdpV2EvmWalletProvider_instances, _CdpV2EvmWalletProvider_publicClient, _CdpV2EvmWalletProvider_serverAccount, _CdpV2EvmWalletProvider_cdp, _CdpV2EvmWalletProvider_network, _CdpV2EvmWalletProvider_getCdpSdkNetwork;
+var _CdpEvmWalletProvider_instances, _CdpEvmWalletProvider_publicClient, _CdpEvmWalletProvider_serverAccount, _CdpEvmWalletProvider_cdp, _CdpEvmWalletProvider_network, _CdpEvmWalletProvider_getCdpSdkNetwork;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CdpV2EvmWalletProvider = void 0;
+exports.CdpEvmWalletProvider = void 0;
 const cdp_sdk_1 = require("@coinbase/cdp-sdk");
 const viem_1 = require("viem");
 const network_1 = require("../network");
@@ -20,29 +20,29 @@ const evmWalletProvider_1 = require("./evmWalletProvider");
 /**
  * A wallet provider that uses the Coinbase SDK.
  */
-class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
+class CdpEvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     /**
-     * Constructs a new CdpWalletProvider.
+     * Constructs a new CdpEvmWalletProvider.
      *
-     * @param config - The configuration options for the CdpWalletProvider.
+     * @param config - The configuration options for the CdpEvmWalletProvider.
      */
     constructor(config) {
         super();
-        _CdpV2EvmWalletProvider_instances.add(this);
-        _CdpV2EvmWalletProvider_publicClient.set(this, void 0);
-        _CdpV2EvmWalletProvider_serverAccount.set(this, void 0);
-        _CdpV2EvmWalletProvider_cdp.set(this, void 0);
-        _CdpV2EvmWalletProvider_network.set(this, void 0);
-        __classPrivateFieldSet(this, _CdpV2EvmWalletProvider_serverAccount, config.serverAccount, "f");
-        __classPrivateFieldSet(this, _CdpV2EvmWalletProvider_cdp, config.cdp, "f");
-        __classPrivateFieldSet(this, _CdpV2EvmWalletProvider_publicClient, config.publicClient, "f");
-        __classPrivateFieldSet(this, _CdpV2EvmWalletProvider_network, config.network, "f");
+        _CdpEvmWalletProvider_instances.add(this);
+        _CdpEvmWalletProvider_publicClient.set(this, void 0);
+        _CdpEvmWalletProvider_serverAccount.set(this, void 0);
+        _CdpEvmWalletProvider_cdp.set(this, void 0);
+        _CdpEvmWalletProvider_network.set(this, void 0);
+        __classPrivateFieldSet(this, _CdpEvmWalletProvider_serverAccount, config.serverAccount, "f");
+        __classPrivateFieldSet(this, _CdpEvmWalletProvider_cdp, config.cdp, "f");
+        __classPrivateFieldSet(this, _CdpEvmWalletProvider_publicClient, config.publicClient, "f");
+        __classPrivateFieldSet(this, _CdpEvmWalletProvider_network, config.network, "f");
     }
     /**
-     * Configures a new CdpWalletProvider with a wallet.
+     * Configures a new CdpEvmWalletProvider with a wallet.
      *
      * @param config - Optional configuration parameters
-     * @returns A Promise that resolves to a new CdpWalletProvider instance
+     * @returns A Promise that resolves to a new CdpEvmWalletProvider instance
      * @throws Error if required environment variables are missing or wallet initialization fails
      */
     static async configureWithWallet(config = {}) {
@@ -71,13 +71,24 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             chain: network_1.NETWORK_ID_TO_VIEM_CHAIN[networkId],
             transport: (0, viem_1.http)(),
         });
-        return new CdpV2EvmWalletProvider({
+        return new CdpEvmWalletProvider({
             publicClient,
             cdp: cdpClient,
             serverAccount,
             network,
         });
     }
+    /**
+     * Exports the wallet.
+     *
+     * @returns The wallet's data.
+     */
+    async exportWallet() {
+        return {
+            name: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").name,
+            address: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address,
+        };
+    }
     /**
      * Signs a message.
      *
@@ -85,7 +96,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The signed message.
      */
     async signMessage(message) {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").signMessage({ message });
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").signMessage({ message });
     }
     /**
      * Signs a typed data object.
@@ -95,7 +106,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async signTypedData(typedData) {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").signTypedData(typedData);
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").signTypedData(typedData);
     }
     /**
      * Signs a transaction.
@@ -105,8 +116,8 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     async signTransaction(transaction) {
         const serializedTx = (0, viem_1.serializeTransaction)(transaction);
-        const signedTx = await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_cdp, "f").evm.signTransaction({
-            address: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").address,
+        const signedTx = await __classPrivateFieldGet(this, _CdpEvmWalletProvider_cdp, "f").evm.signTransaction({
+            address: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address,
             transaction: serializedTx,
         });
         return signedTx.signature;
@@ -120,17 +131,17 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     async sendTransaction(transaction) {
         const txWithGasParams = {
             ...transaction,
-            chainId: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_network, "f").chainId,
+            chainId: __classPrivateFieldGet(this, _CdpEvmWalletProvider_network, "f").chainId,
         };
         if (!txWithGasParams.maxFeePerGas && !txWithGasParams.gasPrice) {
-            const feeData = await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_publicClient, "f").estimateFeesPerGas();
+            const feeData = await __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f").estimateFeesPerGas();
             txWithGasParams.maxFeePerGas = feeData.maxFeePerGas;
             txWithGasParams.maxPriorityFeePerGas = feeData.maxPriorityFeePerGas;
         }
         if (!txWithGasParams.gas) {
             try {
-                txWithGasParams.gas = await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_publicClient, "f").estimateGas({
-                    account: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").address,
+                txWithGasParams.gas = await __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f").estimateGas({
+                    account: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address,
                     ...txWithGasParams,
                 });
             }
@@ -138,10 +149,10 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
                 console.warn("Failed to estimate gas, continuing without gas estimation", error);
             }
         }
-        const result = await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_cdp, "f").evm.sendTransaction({
-            address: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").address,
+        const result = await __classPrivateFieldGet(this, _CdpEvmWalletProvider_cdp, "f").evm.sendTransaction({
+            address: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address,
             transaction: (0, viem_1.serializeTransaction)(txWithGasParams),
-            network: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_instances, "m", _CdpV2EvmWalletProvider_getCdpSdkNetwork).call(this),
+            network: __classPrivateFieldGet(this, _CdpEvmWalletProvider_instances, "m", _CdpEvmWalletProvider_getCdpSdkNetwork).call(this),
         });
         return result.transactionHash;
     }
@@ -151,7 +162,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The address of the wallet.
      */
     getAddress() {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").address;
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address;
     }
     /**
      * Gets the network of the wallet.
@@ -159,7 +170,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The network of the wallet.
      */
     getNetwork() {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_network, "f");
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_network, "f");
     }
     /**
      * Gets the name of the wallet provider.
@@ -167,7 +178,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The name of the wallet provider.
      */
     getName() {
-        return "cdp_v2_wallet_provider";
+        return "cdp_evm_wallet_provider";
     }
     /**
      * Gets the CDP client.
@@ -175,7 +186,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The CDP client.
      */
     getClient() {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_cdp, "f");
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_cdp, "f");
     }
     /**
      * Gets the balance of the wallet.
@@ -183,7 +194,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The balance of the wallet in wei
      */
     async getBalance() {
-        return await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_publicClient, "f").getBalance({ address: __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_serverAccount, "f").address });
+        return await __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f").getBalance({ address: __classPrivateFieldGet(this, _CdpEvmWalletProvider_serverAccount, "f").address });
     }
     /**
      * Waits for a transaction receipt.
@@ -193,7 +204,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async waitForTransactionReceipt(txHash) {
-        return await __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_publicClient, "f").waitForTransactionReceipt({ hash: txHash });
+        return await __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f").waitForTransactionReceipt({ hash: txHash });
     }
     /**
      * Reads a contract.
@@ -202,7 +213,7 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The response from the contract.
      */
     async readContract(params) {
-        return __classPrivateFieldGet(this, _CdpV2EvmWalletProvider_publicClient, "f").readContract(params);
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f").readContract(params);
     }
     /**
      * Transfer the native asset of the network.
@@ -219,14 +230,14 @@ class CdpV2EvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         });
     }
 }
-exports.CdpV2EvmWalletProvider = CdpV2EvmWalletProvider;
-_CdpV2EvmWalletProvider_publicClient = new WeakMap(), _CdpV2EvmWalletProvider_serverAccount = new WeakMap(), _CdpV2EvmWalletProvider_cdp = new WeakMap(), _CdpV2EvmWalletProvider_network = new WeakMap(), _CdpV2EvmWalletProvider_instances = new WeakSet(), _CdpV2EvmWalletProvider_getCdpSdkNetwork = function _CdpV2EvmWalletProvider_getCdpSdkNetwork() {
-    switch (__classPrivateFieldGet(this, _CdpV2EvmWalletProvider_network, "f").networkId) {
+exports.CdpEvmWalletProvider = CdpEvmWalletProvider;
+_CdpEvmWalletProvider_publicClient = new WeakMap(), _CdpEvmWalletProvider_serverAccount = new WeakMap(), _CdpEvmWalletProvider_cdp = new WeakMap(), _CdpEvmWalletProvider_network = new WeakMap(), _CdpEvmWalletProvider_instances = new WeakSet(), _CdpEvmWalletProvider_getCdpSdkNetwork = function _CdpEvmWalletProvider_getCdpSdkNetwork() {
+    switch (__classPrivateFieldGet(this, _CdpEvmWalletProvider_network, "f").networkId) {
         case "base-sepolia":
             return "base-sepolia";
         case "base-mainnet":
             return "base";
         default:
-            throw new Error(`Unsupported network: ${__classPrivateFieldGet(this, _CdpV2EvmWalletProvider_network, "f").networkId}`);
+            throw new Error(`Unsupported network: ${__classPrivateFieldGet(this, _CdpEvmWalletProvider_network, "f").networkId}`);
     }
 };

package/dist/wallet-providers/{cdpV2EvmWalletProvider.test.js → cdpEvmWalletProvider.test.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const cdp_sdk_1 = require("@coinbase/cdp-sdk");
-const cdpV2EvmWalletProvider_1 = require("./cdpV2EvmWalletProvider");
+const cdpEvmWalletProvider_1 = require("./cdpEvmWalletProvider");
 // =========================================================
 // consts
 // =========================================================
@@ -95,7 +95,7 @@ const MOCK_NETWORK = {
 const MOCK_TRANSACTION_RECEIPT = {
     transactionHash: MOCK_TRANSACTION_HASH,
 };
-describe("CdpV2EvmWalletProvider", () => {
+describe("CdpEvmWalletProvider", () => {
     let provider;
     let mockCdpClient;
     let mockServerAccount;
@@ -131,7 +131,7 @@ describe("CdpV2EvmWalletProvider", () => {
         mockPublicClient.estimateGas.mockResolvedValue(BigInt(21000));
         mockPublicClient.getBalance.mockResolvedValue(MOCK_BALANCE);
         mockWalletClient.sendTransaction.mockResolvedValue(MOCK_TRANSACTION_HASH);
-        provider = await cdpV2EvmWalletProvider_1.CdpV2EvmWalletProvider.configureWithWallet({
+        provider = await cdpEvmWalletProvider_1.CdpEvmWalletProvider.configureWithWallet({
             apiKeyId: "test-key-id",
             apiKeySecret: "test-key-secret",
             walletSecret: "test-wallet-secret",
@@ -143,7 +143,7 @@ describe("CdpV2EvmWalletProvider", () => {
     // =========================================================
     describe("initialization", () => {
         it("should initialize with API keys", async () => {
-            const provider = await cdpV2EvmWalletProvider_1.CdpV2EvmWalletProvider.configureWithWallet({
+            const provider = await cdpEvmWalletProvider_1.CdpEvmWalletProvider.configureWithWallet({
                 apiKeyId: "test-key-id",
                 apiKeySecret: "test-key-secret",
                 walletSecret: "test-wallet-secret",
@@ -153,7 +153,7 @@ describe("CdpV2EvmWalletProvider", () => {
             expect(provider.getNetwork()).toEqual(MOCK_NETWORK);
         });
         it("should default to base-sepolia if network not provided", async () => {
-            const provider = await cdpV2EvmWalletProvider_1.CdpV2EvmWalletProvider.configureWithWallet({
+            const provider = await cdpEvmWalletProvider_1.CdpEvmWalletProvider.configureWithWallet({
                 apiKeyId: "test-key-id",
                 apiKeySecret: "test-key-secret",
                 walletSecret: "test-wallet-secret",
@@ -177,7 +177,7 @@ describe("CdpV2EvmWalletProvider", () => {
             mockCdpClient.evm = mockEvmClient;
             // Override the CdpClient constructor mock
             cdp_sdk_1.CdpClient.mockImplementation(() => mockCdpClient);
-            await expect(cdpV2EvmWalletProvider_1.CdpV2EvmWalletProvider.configureWithWallet({
+            await expect(cdpEvmWalletProvider_1.CdpEvmWalletProvider.configureWithWallet({
                 apiKeyId: "test-key-id",
                 apiKeySecret: "test-key-secret",
                 walletSecret: "test-wallet-secret",
@@ -196,7 +196,7 @@ describe("CdpV2EvmWalletProvider", () => {
             expect(provider.getNetwork()).toEqual(MOCK_NETWORK);
         });
         it("should get the name", () => {
-            expect(provider.getName()).toBe("cdp_v2_wallet_provider");
+            expect(provider.getName()).toBe("cdp_evm_wallet_provider");
         });
         it("should get the balance", async () => {
             const balance = await provider.getBalance();

package/dist/wallet-providers/{cdpV2Shared.d.ts → cdpShared.d.ts}

@@ -1,5 +1,6 @@
-import { CdpClient } from "@coinbase/cdp-sdk";
-export interface CdpV2ProviderConfig {
+import { CdpClient, type EvmServerAccount } from "@coinbase/cdp-sdk";
+import type { Address, LocalAccount } from "viem";
+export interface CdpProviderConfig {
     /**
      * The CDP API Key ID.
      */
@@ -16,11 +17,11 @@ export interface CdpV2ProviderConfig {
 /**
  * Configuration options for the CDP Providers.
  */
-export interface CdpV2WalletProviderConfig extends CdpV2ProviderConfig {
+export interface CdpWalletProviderConfig extends CdpProviderConfig {
     /**
      * The address of the wallet.
      */
-    address?: string;
+    address?: Address;
     /**
      * The network of the wallet.
      */
@@ -30,6 +31,16 @@ export interface CdpV2WalletProviderConfig extends CdpV2ProviderConfig {
      */
     idempotencyKey?: string;
 }
+export interface CdpSmartWalletProviderConfig extends CdpWalletProviderConfig {
+    /**
+     * The owner account of the smart wallet.
+     */
+    owner?: EvmServerAccount | LocalAccount | Address;
+    /**
+     * The name of the smart wallet.
+     */
+    smartAccountName?: string;
+}
 /**
  * A wallet provider that can be used to interact with the CDP.
  */

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

@@ -0,0 +1,115 @@
+import { CdpClient } from "@coinbase/cdp-sdk";
+import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
+import { Network } from "../network";
+import { EvmWalletProvider } from "./evmWalletProvider";
+import { WalletProviderWithClient, CdpSmartWalletProviderConfig } from "./cdpShared";
+/**
+ * A wallet provider that uses the Coinbase CDP SDK smart wallets.
+ */
+export declare class CdpSmartWalletProvider extends EvmWalletProvider implements WalletProviderWithClient {
+    #private;
+    /**
+     * Constructs a new CdpSmartWalletProvider.
+     *
+     * @param config - The configuration options for the CdpSmartWalletProvider.
+     */
+    private constructor();
+    /**
+     * Configures a new CdpSmartWalletProvider with a smart wallet.
+     *
+     * @param config - Optional configuration parameters
+     * @returns A Promise that resolves to a new CdpSmartWalletProvider instance
+     * @throws Error if required environment variables are missing or wallet initialization fails
+     */
+    static configureWithWallet(config?: CdpSmartWalletProviderConfig): Promise<CdpSmartWalletProvider>;
+    /**
+     * Exports the wallet.
+     *
+     * @returns The wallet's data.
+     */
+    exportWallet(): Promise<{
+        name: string | undefined;
+        address: Address;
+        ownerAddress: Address;
+    }>;
+    /**
+     * Signs a message using the owner account.
+     *
+     * @param _message - The message to sign.
+     * @returns The signed message.
+     */
+    signMessage(_message: string): Promise<Hex>;
+    /**
+     * Signs a typed data object using the owner account.
+     *
+     * @param typedData - The typed data object to sign.
+     * @returns The signed typed data object.
+     */
+    signTypedData(typedData: any): Promise<Hex>;
+    /**
+     * Signs a transaction using the owner account.
+     *
+     * @param _ - The transaction to sign.
+     * @returns The signed transaction.
+     */
+    signTransaction(_: TransactionRequest): Promise<Hex>;
+    /**
+     * Sends a user operation through the smart wallet.
+     *
+     * @param transaction - The transaction to send.
+     * @returns The user operation hash.
+     */
+    sendTransaction(transaction: TransactionRequest): Promise<Hex>;
+    /**
+     * Gets the address of the smart wallet.
+     *
+     * @returns The address of the smart wallet.
+     */
+    getAddress(): string;
+    /**
+     * Gets the network of the wallet.
+     *
+     * @returns The network of the wallet.
+     */
+    getNetwork(): Network;
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The name of the wallet provider.
+     */
+    getName(): string;
+    /**
+     * Gets the CDP client.
+     *
+     * @returns The CDP client.
+     */
+    getClient(): CdpClient;
+    /**
+     * Gets the balance of the smart wallet.
+     *
+     * @returns The balance of the wallet in wei
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Waits for a user operation receipt.
+     *
+     * @param userOpHash - The user operation hash to wait for.
+     * @returns The user operation receipt.
+     */
+    waitForTransactionReceipt(userOpHash: Hex): Promise<any>;
+    /**
+     * Reads a contract.
+     *
+     * @param params - The parameters to read the contract.
+     * @returns The response from the contract.
+     */
+    readContract<const abi extends Abi | readonly unknown[], functionName extends ContractFunctionName<abi, "pure" | "view">, const args extends ContractFunctionArgs<abi, "pure" | "view", functionName>>(params: ReadContractParameters<abi, functionName, args>): Promise<ReadContractReturnType<abi, functionName, args>>;
+    /**
+     * Transfer the native asset of the network using smart wallet.
+     *
+     * @param to - The destination address.
+     * @param value - The amount to transfer in Wei.
+     * @returns The user operation hash.
+     */
+    nativeTransfer(to: Address, value: string): Promise<Hex>;
+}