@coinbase/agentkit 0.2.0 → 0.2.2-nightly.20250221.1

package/dist/agentkit.js

@@ -49,10 +49,18 @@ class AgentKit {
      */
     getActions() {
         const actions = [];
+        const unsupported = [];
         for (const actionProvider of this.actionProviders) {
             if (actionProvider.supportsNetwork(this.walletProvider.getNetwork())) {
                 actions.push(...actionProvider.getActions(this.walletProvider));
             }
+            else {
+                unsupported.push(actionProvider.name);
+            }
+        }
+        if (unsupported.length > 0) {
+            console.log(`Warning: The following action providers are not supported on the current network and will be unavailable: ${unsupported.join(", ")}`);
+            console.log("Current network:", this.walletProvider.getNetwork());
         }
         return actions;
     }

package/dist/analytics/sendAnalyticsEvent.js

@@ -22,6 +22,7 @@ async function sendAnalyticsEvent(event) {
             platform: "server",
             project_name: "agentkit",
             time_start: timestamp,
+            agentkit_language: "typescript",
             ...event,
         },
     };

package/dist/network/svm.d.ts

@@ -12,3 +12,4 @@ export declare const SOLANA_MAINNET_NETWORK: Network;
 export declare const SOLANA_TESTNET_NETWORK: Network;
 export declare const SOLANA_DEVNET_NETWORK: Network;
 export declare const SOLANA_NETWORKS: Record<SOLANA_CLUSTER, Network>;
+export declare const SOLANA_CLUSTER_ID_BY_NETWORK_ID: Record<SOLANA_NETWORK_ID, string>;

package/dist/network/svm.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOLANA_NETWORKS = exports.SOLANA_DEVNET_NETWORK = exports.SOLANA_TESTNET_NETWORK = exports.SOLANA_MAINNET_NETWORK = exports.SOLANA_DEVNET_GENESIS_BLOCK_HASH = exports.SOLANA_TESTNET_GENESIS_BLOCK_HASH = exports.SOLANA_MAINNET_GENESIS_BLOCK_HASH = exports.SOLANA_PROTOCOL_FAMILY = exports.SOLANA_DEVNET_NETWORK_ID = exports.SOLANA_TESTNET_NETWORK_ID = exports.SOLANA_MAINNET_NETWORK_ID = void 0;
+exports.SOLANA_CLUSTER_ID_BY_NETWORK_ID = exports.SOLANA_NETWORKS = exports.SOLANA_DEVNET_NETWORK = exports.SOLANA_TESTNET_NETWORK = exports.SOLANA_MAINNET_NETWORK = exports.SOLANA_DEVNET_GENESIS_BLOCK_HASH = exports.SOLANA_TESTNET_GENESIS_BLOCK_HASH = exports.SOLANA_MAINNET_GENESIS_BLOCK_HASH = exports.SOLANA_PROTOCOL_FAMILY = exports.SOLANA_DEVNET_NETWORK_ID = exports.SOLANA_TESTNET_NETWORK_ID = exports.SOLANA_MAINNET_NETWORK_ID = void 0;
 // CDP Network IDs
 exports.SOLANA_MAINNET_NETWORK_ID = "solana-mainnet";
 exports.SOLANA_TESTNET_NETWORK_ID = "solana-testnet";
@@ -31,3 +31,8 @@ exports.SOLANA_NETWORKS = {
     [exports.SOLANA_TESTNET_GENESIS_BLOCK_HASH]: exports.SOLANA_TESTNET_NETWORK,
     [exports.SOLANA_DEVNET_GENESIS_BLOCK_HASH]: exports.SOLANA_DEVNET_NETWORK,
 };
+exports.SOLANA_CLUSTER_ID_BY_NETWORK_ID = {
+    [exports.SOLANA_MAINNET_NETWORK_ID]: "mainnet-beta",
+    [exports.SOLANA_TESTNET_NETWORK_ID]: "testnet",
+    [exports.SOLANA_DEVNET_NETWORK_ID]: "devnet",
+};

package/dist/wallet-providers/cdpWalletProvider.js

@@ -58,7 +58,7 @@ class CdpWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         if (config.apiKeyName && config.apiKeyPrivateKey) {
             coinbase_sdk_1.Coinbase.configure({
                 apiKeyName: config.apiKeyName,
-                privateKey: config.apiKeyPrivateKey,
+                privateKey: config.apiKeyPrivateKey?.replace(/\\n/g, "\n"),
                 source: "agentkit",
                 sourceVersion: package_json_1.version,
             });

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

@@ -5,3 +5,5 @@ export * from "./cdpWalletProvider";
 export * from "./svmWalletProvider";
 export * from "./solanaKeypairWalletProvider";
 export * from "./privyWalletProvider";
+export * from "./privyEvmWalletProvider";
+export * from "./privySvmWalletProvider";

package/dist/wallet-providers/index.js

@@ -21,3 +21,5 @@ __exportStar(require("./cdpWalletProvider"), exports);
 __exportStar(require("./svmWalletProvider"), exports);
 __exportStar(require("./solanaKeypairWalletProvider"), exports);
 __exportStar(require("./privyWalletProvider"), exports);
+__exportStar(require("./privyEvmWalletProvider"), exports);
+__exportStar(require("./privySvmWalletProvider"), exports);

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

@@ -0,0 +1,55 @@
+import { ViemWalletProvider } from "./viemWalletProvider";
+import { PrivyWalletConfig, PrivyWalletExport } from "./privyShared";
+/**
+ * Configuration options for the Privy wallet provider.
+ *
+ * @interface
+ */
+export interface PrivyEvmWalletConfig extends PrivyWalletConfig {
+    /** Optional chain ID to connect to */
+    chainId?: string;
+}
+/**
+ * A wallet provider that uses Privy's server wallet API.
+ * This provider extends the ViemWalletProvider to provide Privy-specific wallet functionality
+ * while maintaining compatibility with the base wallet provider interface.
+ */
+export declare class PrivyEvmWalletProvider extends ViemWalletProvider {
+    #private;
+    /**
+     * Private constructor to enforce use of factory method.
+     *
+     * @param walletClient - The Viem wallet client instance
+     * @param config - The configuration options for the Privy wallet
+     */
+    private constructor();
+    /**
+     * Creates and configures a new PrivyWalletProvider instance.
+     *
+     * @param config - The configuration options for the Privy wallet
+     * @returns A configured PrivyWalletProvider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = await PrivyWalletProvider.configureWithWallet({
+     *   appId: "your-app-id",
+     *   appSecret: "your-app-secret",
+     *   walletId: "wallet-id",
+     *   chainId: "84532"
+     * });
+     * ```
+     */
+    static configureWithWallet(config: PrivyEvmWalletConfig): Promise<PrivyEvmWalletProvider>;
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The string identifier for this wallet provider
+     */
+    getName(): string;
+    /**
+     * Exports the wallet data.
+     *
+     * @returns The wallet data
+     */
+    exportWallet(): PrivyWalletExport;
+}

package/dist/wallet-providers/privyEvmWalletProvider.js

@@ -0,0 +1,140 @@
+"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 _PrivyEvmWalletProvider_walletId, _PrivyEvmWalletProvider_authorizationPrivateKey;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivyEvmWalletProvider = void 0;
+const server_auth_1 = require("@privy-io/server-auth");
+const viem_1 = require("@privy-io/server-auth/viem");
+const viemWalletProvider_1 = require("./viemWalletProvider");
+const viem_2 = require("viem");
+const network_1 = require("../network/network");
+/**
+ * A wallet provider that uses Privy's server wallet API.
+ * This provider extends the ViemWalletProvider to provide Privy-specific wallet functionality
+ * while maintaining compatibility with the base wallet provider interface.
+ */
+class PrivyEvmWalletProvider extends viemWalletProvider_1.ViemWalletProvider {
+    /**
+     * Private constructor to enforce use of factory method.
+     *
+     * @param walletClient - The Viem wallet client instance
+     * @param config - The configuration options for the Privy wallet
+     */
+    constructor(walletClient, config) {
+        super(walletClient);
+        _PrivyEvmWalletProvider_walletId.set(this, void 0);
+        _PrivyEvmWalletProvider_authorizationPrivateKey.set(this, void 0);
+        __classPrivateFieldSet(this, _PrivyEvmWalletProvider_walletId, config.walletId, "f"); // Now guaranteed to exist
+        __classPrivateFieldSet(this, _PrivyEvmWalletProvider_authorizationPrivateKey, config.authorizationPrivateKey, "f");
+    }
+    /**
+     * Creates and configures a new PrivyWalletProvider instance.
+     *
+     * @param config - The configuration options for the Privy wallet
+     * @returns A configured PrivyWalletProvider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = await PrivyWalletProvider.configureWithWallet({
+     *   appId: "your-app-id",
+     *   appSecret: "your-app-secret",
+     *   walletId: "wallet-id",
+     *   chainId: "84532"
+     * });
+     * ```
+     */
+    static async configureWithWallet(config) {
+        const privy = new server_auth_1.PrivyClient(config.appId, config.appSecret, {
+            walletApi: config.authorizationPrivateKey
+                ? {
+                    authorizationPrivateKey: config.authorizationPrivateKey,
+                }
+                : undefined,
+        });
+        let walletId;
+        let address;
+        if (!config.walletId) {
+            if (config.authorizationPrivateKey && !config.authorizationKeyId) {
+                throw new Error("authorizationKeyId is required when creating a new wallet with an authorization key, this can be found in your Privy Dashboard");
+            }
+            if (config.authorizationKeyId && !config.authorizationPrivateKey) {
+                throw new Error("authorizationPrivateKey is required when creating a new wallet with an authorizationKeyId. " +
+                    "If you don't have it, you can create a new one in your Privy Dashboard, or delete the authorization key.");
+            }
+            try {
+                const wallet = await privy.walletApi.create({
+                    chainType: "ethereum",
+                    authorizationKeyIds: config.authorizationKeyId ? [config.authorizationKeyId] : undefined,
+                });
+                walletId = wallet.id;
+                address = wallet.address;
+            }
+            catch (error) {
+                console.error(error);
+                if (error instanceof Error &&
+                    error.message.includes("Missing `privy-authorization-signature` header")) {
+                    // Providing a more informative error message, see context: https://github.com/coinbase/agentkit/pull/242#discussion_r1956428617
+                    throw new Error("Privy error: you have an authorization key on your account which can create and modify wallets, please delete this key or pass it to the PrivyWalletProvider to create a new wallet");
+                }
+                throw new Error("Failed to create wallet");
+            }
+        }
+        else {
+            walletId = config.walletId;
+            const wallet = await privy.walletApi.getWallet({ id: walletId });
+            if (!wallet) {
+                throw new Error(`Wallet with ID ${walletId} not found`);
+            }
+            address = wallet.address;
+        }
+        const account = await (0, viem_1.createViemAccount)({
+            walletId,
+            address,
+            privy,
+        });
+        const chainId = config.chainId || "84532";
+        const chain = (0, network_1.getChain)(chainId);
+        if (!chain) {
+            throw new Error(`Chain with ID ${chainId} not found`);
+        }
+        const walletClient = (0, viem_2.createWalletClient)({
+            account,
+            chain,
+            transport: (0, viem_2.http)(),
+        });
+        return new PrivyEvmWalletProvider(walletClient, { ...config, walletId });
+    }
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The string identifier for this wallet provider
+     */
+    getName() {
+        return "privy_evm_wallet_provider";
+    }
+    /**
+     * Exports the wallet data.
+     *
+     * @returns The wallet data
+     */
+    exportWallet() {
+        return {
+            walletId: __classPrivateFieldGet(this, _PrivyEvmWalletProvider_walletId, "f"),
+            authorizationPrivateKey: __classPrivateFieldGet(this, _PrivyEvmWalletProvider_authorizationPrivateKey, "f"),
+            chainId: this.getNetwork().chainId,
+            networkId: this.getNetwork().networkId,
+        };
+    }
+}
+exports.PrivyEvmWalletProvider = PrivyEvmWalletProvider;
+_PrivyEvmWalletProvider_walletId = new WeakMap(), _PrivyEvmWalletProvider_authorizationPrivateKey = new WeakMap();

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

@@ -0,0 +1,40 @@
+import { PrivyClient, Wallet } from "@privy-io/server-auth";
+/**
+ * Configuration options for the Privy wallet provider.
+ *
+ * @interface
+ */
+export interface PrivyWalletConfig {
+    /** The Privy application ID */
+    appId: string;
+    /** The Privy application secret */
+    appSecret: string;
+    /** The ID of the wallet to use, if not provided a new wallet will be created */
+    walletId?: string;
+    /** Optional authorization key for the wallet API */
+    authorizationPrivateKey?: string;
+    /** Optional authorization key ID for creating new wallets */
+    authorizationKeyId?: string;
+    /** The chain type to create the wallet on */
+    chainType?: "ethereum" | "solana";
+}
+export type PrivyWalletExport = {
+    walletId: string;
+    authorizationPrivateKey: string | undefined;
+    chainId: string | undefined;
+    networkId: string | undefined;
+};
+type CreatePrivyWalletReturnType = {
+    wallet: Wallet & {
+        id: string;
+    };
+    privy: PrivyClient;
+};
+/**
+ * Create a Privy wallet
+ *
+ * @param config - The configuration options for the Privy wallet
+ * @returns The created Privy wallet
+ */
+export declare function createPrivyWallet(config: PrivyWalletConfig): Promise<CreatePrivyWalletReturnType>;
+export {};

package/dist/wallet-providers/privyShared.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrivyWallet = createPrivyWallet;
+const server_auth_1 = require("@privy-io/server-auth");
+/**
+ * Create a Privy wallet
+ *
+ * @param config - The configuration options for the Privy wallet
+ * @returns The created Privy wallet
+ */
+async function createPrivyWallet(config) {
+    const privy = new server_auth_1.PrivyClient(config.appId, config.appSecret, {
+        walletApi: config.authorizationPrivateKey
+            ? {
+                authorizationPrivateKey: config.authorizationPrivateKey,
+            }
+            : undefined,
+    });
+    if (config.walletId) {
+        const wallet = await privy.walletApi.getWallet({ id: config.walletId });
+        if (!wallet) {
+            throw new Error(`Wallet with ID ${config.walletId} not found`);
+        }
+        return { wallet, privy };
+    }
+    if (config.authorizationPrivateKey && !config.authorizationKeyId) {
+        throw new Error("authorizationKeyId is required when creating a new wallet with an authorization key, this can be found in your Privy Dashboard");
+    }
+    if (config.authorizationKeyId && !config.authorizationPrivateKey) {
+        throw new Error("authorizationPrivateKey is required when creating a new wallet with an authorizationKeyId. " +
+            "If you don't have it, you can create a new one in your Privy Dashboard, or delete the authorization key.");
+    }
+    try {
+        const wallet = await privy.walletApi.create({
+            chainType: config.chainType,
+            authorizationKeyIds: config.authorizationKeyId ? [config.authorizationKeyId] : undefined,
+        });
+        return { wallet, privy };
+    }
+    catch (error) {
+        console.error(error);
+        if (error instanceof Error &&
+            error.message.includes("Missing `privy-authorization-signature` header")) {
+            // Providing a more informative error message, see context: https://github.com/coinbase/agentkit/pull/242#discussion_r1956428617
+            throw new Error("Privy error: you have an authorization key on your account which can create and modify wallets, please delete this key or pass it to the PrivyWalletProvider to create a new wallet");
+        }
+        throw new Error("Failed to create wallet");
+    }
+}

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

@@ -0,0 +1,128 @@
+import { SvmWalletProvider } from "./svmWalletProvider";
+import { RpcResponseAndContext, SignatureStatus, VersionedTransaction, Connection, PublicKey, SignatureResult } from "@solana/web3.js";
+import { Network } from "../network/types";
+import { PrivyWalletConfig, PrivyWalletExport } from "./privyShared";
+/**
+ * Configuration options for the Privy Svm wallet provider.
+ */
+export interface PrivySvmWalletConfig extends PrivyWalletConfig {
+    /** The network ID to use for the wallet */
+    networkId?: string;
+    /** The connection to use for the wallet */
+    connection?: Connection;
+}
+/**
+ * A wallet provider that uses Privy's server wallet API.
+ * This provider extends the SvmWalletProvider to provide Privy-specific wallet functionality
+ * while maintaining compatibility with the base wallet provider interface.
+ */
+export declare class PrivySvmWalletProvider extends SvmWalletProvider {
+    #private;
+    /**
+     * Private constructor to enforce use of factory method.
+     *
+     * @param config - The configuration options for the Privy wallet
+     */
+    private constructor();
+    /**
+     * Creates and configures a new PrivySolanaWalletProvider instance.
+     *
+     * @param config - The configuration options for the Privy wallet
+     * @returns A configured PrivySolanaWalletProvider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = await PrivySolanaWalletProvider.configureWithWallet({
+     *   appId: "your-app-id",
+     *   appSecret: "your-app-secret",
+     *   walletId: "wallet-id",
+     * });
+     * ```
+     */
+    static configureWithWallet<T extends PrivySvmWalletProvider>(config: PrivySvmWalletConfig): Promise<T>;
+    /**
+     * Sign a transaction.
+     *
+     * @param transaction - The transaction to sign.
+     * @returns The signed transaction.
+     */
+    signTransaction(transaction: VersionedTransaction): Promise<VersionedTransaction>;
+    /**
+     * Sign and send a transaction.
+     *
+     * @param transaction - The transaction to send.
+     * @returns The transaction hash.
+     */
+    signAndSendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Send a transaction.
+     *
+     * @param _ - The transaction to send.
+     * @returns The transaction hash.
+     */
+    sendTransaction(_: VersionedTransaction): Promise<string>;
+    /**
+     * Exports the wallet data.
+     *
+     * @returns The wallet data
+     */
+    exportWallet(): PrivyWalletExport;
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The string identifier for this wallet provider
+     */
+    getName(): string;
+    /**
+     * Get the address of the wallet.
+     *
+     * @returns The address of the wallet.
+     */
+    getAddress(): string;
+    /**
+     * Get the network of the wallet.
+     *
+     * @returns The network of the wallet.
+     */
+    getNetwork(): Network;
+    /**
+     * Get the balance of the wallet.
+     *
+     * @returns The balance of the wallet.
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Transfer a native token.
+     *
+     * @param _ - The address to transfer the token to.
+     * @param arg2 - The value to transfer.
+     * @returns The transaction hash.
+     */
+    nativeTransfer(_: string, arg2: string): Promise<string>;
+    /**
+     * Get the status of a transaction.
+     *
+     * @param signature - The transaction signature.
+     * @returns The transaction status.
+     */
+    getSignatureStatus(signature: string): Promise<RpcResponseAndContext<SignatureStatus | null>>;
+    /**
+     * Wait for a signature result.
+     *
+     * @param signature - The signature to wait for.
+     * @returns The signature result.
+     */
+    waitForSignatureResult(signature: string): Promise<RpcResponseAndContext<SignatureResult>>;
+    /**
+     * Get the connection.
+     *
+     * @returns The connection.
+     */
+    getConnection(): Connection;
+    /**
+     * Get the public key.
+     *
+     * @returns The public key.
+     */
+    getPublicKey(): PublicKey;
+}