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

package/README.md

@@ -18,6 +18,7 @@ AgentKit is a framework for easily enabling AI agents to take actions onchain. I
   - [Adding Actions to your Action Provider that use a Wallet Provider](#adding-actions-to-your-action-provider-that-use-a-wallet-provider)
   - [Adding an Action Provider to your AgentKit instance](#adding-an-action-provider-to-your-agentkit-instance)
 - [EVM Wallet Providers](#evm-wallet-providers)
+  - [CdpV2EvmWalletProvider](#cdpv2evmwalletprovider)
   - [CdpWalletProvider](#cdpwalletprovider)
     - [Network Configuration](#network-configuration)
     - [Configuring from an existing CDP API Wallet](#configuring-from-an-existing-cdp-api-wallet)
@@ -36,6 +37,7 @@ AgentKit is a framework for easily enabling AI agents to take actions onchain. I
     - [Configuring from PrivyWalletProvider](#configuring-from-privywalletprovider)
     - [Configuring from ViemWalletProvider](#configuring-from-viemwalletprovider)
 - [SVM Wallet Providers](#svm-wallet-providers)
+  - [CdpV2SolanaWalletProvider](#cdpv2solanawalletprovider)
   - [SolanaKeypairWalletProvider](#solanakeypairwalletprovider)
     - [Network Configuration](#solana-network-configuration)
     - [RPC URL Configuration](#rpc-url-configuration)
@@ -537,11 +539,76 @@ const agentKit = new AgentKit({
 Wallet providers give an agent access to a wallet. AgentKit currently supports the following wallet providers:
 
 EVM:
+- [CdpV2EvmWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/cdpV2EvmWalletProvider.ts)
 - [CdpWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/cdpWalletProvider.ts)
 - [ViemWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/viemWalletProvider.ts)
 - [PrivyWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/privyWalletProvider.ts)
 - [ZeroDevWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/zeroDevWalletProvider.ts)
 
+### CdpV2EvmWalletProvider
+
+The `CdpV2EvmWalletProvider` is a wallet provider that uses the Coinbase Developer Platform (CDP) V2 API. It provides a more modern and streamlined interface for interacting with CDP wallets.
+
+#### Basic Configuration
+
+```typescript
+import { CdpV2EvmWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2EvmWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    networkId: "base-sepolia", // Optional, defaults to "base-sepolia"
+});
+```
+
+#### Using an Existing Wallet
+
+You can configure the provider with an existing wallet by providing the wallet's address:
+
+```typescript
+import { CdpV2EvmWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2EvmWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    address: "0x...", // The address of an existing wallet
+    networkId: "base-sepolia",
+});
+```
+
+#### Creating a New Wallet
+
+To create a new wallet, you can provide an idempotency key. The same idempotency key will always generate the same wallet address, and these keys are valid for 24 hours:
+
+```typescript
+import { CdpV2EvmWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2EvmWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    idempotencyKey: "unique-key-123", // Optional, if not provided a new wallet will be created
+    networkId: "base-sepolia",
+});
+```
+
+#### Environment Variables
+
+The provider can also be configured using environment variables:
+
+```typescript
+// Environment variables:
+// CDP_API_KEY_ID=your_api_key_id
+// CDP_API_KEY_SECRET=your_api_key_secret
+// CDP_WALLET_SECRET=your_wallet_secret
+// NETWORK_ID=base-sepolia (optional)
+// IDEMPOTENCY_KEY=unique-key-123 (optional)
+
+const walletProvider = await CdpV2EvmWalletProvider.configureWithWallet();
+```
+
 ### CdpWalletProvider
 
 The `CdpWalletProvider` is a wallet provider that uses the Coinbase Developer Platform (CDP) [API Wallet](https://docs.cdp.coinbase.com/wallet-api/docs/welcome).
@@ -877,10 +944,84 @@ const walletProvider = await ZeroDevWalletProvider.configureWithWallet({
 
 ## SVM Wallet Providers
 
+Wallet providers give an agent access to a wallet. AgentKit currently supports the following wallet providers:
+
 SVM:
+- [CdpV2SolanaWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/cdpV2SolanaWalletProvider.ts)
 - [SolanaKeypairWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/solanaKeypairWalletProvider.ts)
 - [PrivyWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/privySvmWalletProvider.ts)
 
+### CdpV2SolanaWalletProvider
+
+The `CdpV2SolanaWalletProvider` is a wallet provider that uses the Coinbase Developer Platform (CDP) V2 API for Solana. It provides a more modern and streamlined interface for interacting with CDP wallets on the Solana network.
+
+#### Basic Configuration
+
+```typescript
+import { CdpV2SolanaWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2SolanaWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    networkId: "solana-devnet", // Optional, defaults to "solana-devnet"
+});
+```
+
+#### Using an Existing Wallet
+
+You can configure the provider with an existing wallet by providing the wallet's address:
+
+```typescript
+import { CdpV2SolanaWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2SolanaWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    address: "your-solana-address", // The address of an existing wallet
+    networkId: "solana-devnet",
+});
+```
+
+#### Creating a New Wallet
+
+To create a new wallet, you can provide an idempotency key. The same idempotency key will always generate the same wallet address, and these keys are valid for 24 hours:
+
+```typescript
+import { CdpV2SolanaWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpV2SolanaWalletProvider.configureWithWallet({
+    apiKeyId: "CDP_API_KEY_ID",
+    apiKeySecret: "CDP_API_KEY_SECRET",
+    walletSecret: "CDP_WALLET_SECRET",
+    idempotencyKey: "unique-key-123", // Optional, if not provided a new wallet will be created
+    networkId: "solana-devnet",
+});
+```
+
+#### Environment Variables
+
+The provider can also be configured using environment variables:
+
+```typescript
+// Environment variables:
+// CDP_API_KEY_ID=your_api_key_id
+// CDP_API_KEY_SECRET=your_api_key_secret
+// CDP_WALLET_SECRET=your_wallet_secret
+// NETWORK_ID=solana-devnet (optional)
+// IDEMPOTENCY_KEY=unique-key-123 (optional)
+
+const walletProvider = await CdpV2SolanaWalletProvider.configureWithWallet();
+```
+
+#### Supported Networks
+
+The `CdpV2SolanaWalletProvider` supports the following Solana networks:
+- `solana-mainnet`
+- `solana-devnet`
+- `solana-testnet`
+
 ### SolanaKeypairWalletProvider
 
 The `SolanaKeypairWalletProvider` is a wallet provider that uses the API [Solana web3.js](https://solana-labs.github.io/solana-web3.js/).
@@ -931,6 +1072,7 @@ import { PrivyWalletProvider, PrivyWalletConfig } from "@coinbase/agentkit";
 const config: PrivyWalletConfig = {
     appId: "PRIVY_APP_ID",
     appSecret: "PRIVY_APP_SECRET",
+    connection,
     chainType: "solana", // optional, defaults to "evm". Make sure to set this to "solana" if you want to use Solana!
     networkId: "solana-devnet", // optional, defaults to "solana-devnet"
     walletId: "PRIVY_WALLET_ID", // optional, otherwise a new wallet will be created

package/dist/action-providers/cdp-v2/cdpApiV2ActionProvider.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { Network } from "../../network";
+import { WalletProvider } from "../../wallet-providers";
+import { WalletProviderWithClient } from "../../wallet-providers/cdpV2Shared";
+import { ActionProvider } from "../actionProvider";
+import { RequestFaucetFundsV2Schema } from "./schemas";
+type CdpV2WalletProviderWithClient = WalletProvider & WalletProviderWithClient;
+/**
+ * CdpApiActionProvider is an action provider for CDP API.
+ *
+ * This provider is used for any action that uses the CDP API, but does not require a CDP Wallet.
+ */
+export declare class CdpApiV2ActionProvider extends ActionProvider<CdpV2WalletProviderWithClient> {
+    /**
+     * Constructor for the CdpApiActionProvider class.
+     */
+    constructor();
+    /**
+     * Requests test tokens from the faucet for the default address in the wallet.
+     *
+     * @param walletProvider - The wallet provider to request funds from.
+     * @param args - The input arguments for the action.
+     * @returns A confirmation message with transaction details.
+     */
+    faucet(walletProvider: CdpV2WalletProviderWithClient, args: z.infer<typeof RequestFaucetFundsV2Schema>): Promise<string>;
+    /**
+     * Checks if the Cdp action provider supports the given network.
+     *
+     * NOTE: Network scoping is done at the action implementation level
+     *
+     * @param _ - The network to check.
+     * @returns True if the Cdp action provider supports the network, false otherwise.
+     */
+    supportsNetwork: (_: Network) => boolean;
+}
+export declare const cdpApiV2ActionProvider: () => CdpApiV2ActionProvider;
+export {};

package/dist/action-providers/cdp-v2/cdpApiV2ActionProvider.js

@@ -0,0 +1,91 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cdpApiV2ActionProvider = exports.CdpApiV2ActionProvider = void 0;
+const zod_1 = require("zod");
+const actionDecorator_1 = require("../actionDecorator");
+const actionProvider_1 = require("../actionProvider");
+const schemas_1 = require("./schemas");
+/**
+ * CdpApiActionProvider is an action provider for CDP API.
+ *
+ * This provider is used for any action that uses the CDP API, but does not require a CDP Wallet.
+ */
+class CdpApiV2ActionProvider extends actionProvider_1.ActionProvider {
+    /**
+     * Constructor for the CdpApiActionProvider class.
+     */
+    constructor() {
+        super("cdp_api_v2", []);
+        /**
+         * Checks if the Cdp action provider supports the given network.
+         *
+         * NOTE: Network scoping is done at the action implementation level
+         *
+         * @param _ - The network to check.
+         * @returns True if the Cdp action provider supports the network, false otherwise.
+         */
+        this.supportsNetwork = (_) => true;
+    }
+    /**
+     * Requests test tokens from the faucet for the default address in the wallet.
+     *
+     * @param walletProvider - The wallet provider to request funds from.
+     * @param args - The input arguments for the action.
+     * @returns A confirmation message with transaction details.
+     */
+    async faucet(walletProvider, args) {
+        const network = walletProvider.getNetwork();
+        const networkId = network.networkId;
+        if (network.protocolFamily === "evm") {
+            if (networkId !== "base-sepolia" && networkId !== "ethereum-sepolia") {
+                throw new Error("Faucet is only supported on 'base-sepolia' or 'ethereum-sepolia' evm networks.");
+            }
+            const faucetTx = await walletProvider.getClient().evm.requestFaucet({
+                address: walletProvider.getAddress(),
+                token: (args.assetId || "eth"),
+                network: networkId,
+            });
+            return `Received ${args.assetId || "ETH"} from the faucet. Transaction hash: ${faucetTx.transactionHash}`;
+        }
+        else if (network.protocolFamily === "svm") {
+            if (networkId !== "solana-devnet") {
+                throw new Error("Faucet is only supported on 'solana-devnet' solana networks.");
+            }
+            const faucetTx = await walletProvider.getClient().solana.requestFaucet({
+                address: walletProvider.getAddress(),
+                token: (args.assetId || "sol"),
+            });
+            return `Received ${args.assetId || "SOL"} from the faucet. Transaction signature hash: ${faucetTx.signature}`;
+        }
+        else {
+            throw new Error("Faucet is only supported on Ethereum and Solana protocol families.");
+        }
+    }
+}
+exports.CdpApiV2ActionProvider = CdpApiV2ActionProvider;
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "request_faucet_funds",
+        description: `This tool will request test tokens from the faucet for the default address in the wallet. It takes the wallet and asset ID as input.
+Faucet is only allowed on 'base-sepolia' or 'solana-devnet'.
+If fauceting on 'base-sepolia', user can only provide asset ID 'eth', 'usdc', 'eurc' or 'cbbtc', if no asset ID is provided, the faucet will default to 'eth'.
+If fauceting on 'solana-devnet', user can only provide asset ID 'sol' or 'usdc', if no asset ID is provided, the faucet will default to 'sol'.
+You are not allowed to faucet with any other network or asset ID. If you are on another network, suggest that the user sends you some ETH
+from another wallet and provide the user with your wallet details.`,
+        schema: schemas_1.RequestFaucetFundsV2Schema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, void 0]),
+    __metadata("design:returntype", Promise)
+], CdpApiV2ActionProvider.prototype, "faucet", null);
+const cdpApiV2ActionProvider = () => new CdpApiV2ActionProvider();
+exports.cdpApiV2ActionProvider = cdpApiV2ActionProvider;

package/dist/action-providers/cdp-v2/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schemas";
+export * from "./cdpApiV2ActionProvider";

package/dist/action-providers/cdp-v2/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./schemas"), exports);
+__exportStar(require("./cdpApiV2ActionProvider"), exports);

package/dist/action-providers/cdp-v2/schemas.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/**
+ * Input schema for request faucet funds action.
+ */
+export declare const RequestFaucetFundsV2Schema: z.ZodObject<{
+    assetId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    assetId?: string | undefined;
+}, {
+    assetId?: string | undefined;
+}>;

package/dist/action-providers/cdp-v2/schemas.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFaucetFundsV2Schema = void 0;
+const zod_1 = require("zod");
+/**
+ * Input schema for request faucet funds action.
+ */
+exports.RequestFaucetFundsV2Schema = zod_1.z
+    .object({
+    assetId: zod_1.z.string().optional().describe("The optional asset ID to request from faucet"),
+})
+    .strip()
+    .describe("Instructions for requesting faucet funds");

package/dist/action-providers/compound/schemas.d.ts

@@ -7,10 +7,10 @@ export declare const CompoundSupplySchema: z.ZodObject<{
     amount: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     amount: string;
-    assetId: "weth" | "cbeth" | "cbbtc" | "wsteth" | "usdc";
+    assetId: "usdc" | "cbbtc" | "weth" | "cbeth" | "wsteth";
 }, {
     amount: string;
-    assetId: "weth" | "cbeth" | "cbbtc" | "wsteth" | "usdc";
+    assetId: "usdc" | "cbbtc" | "weth" | "cbeth" | "wsteth";
 }>;
 /**
  * Input schema for Compound withdraw action.
@@ -20,10 +20,10 @@ export declare const CompoundWithdrawSchema: z.ZodObject<{
     amount: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     amount: string;
-    assetId: "weth" | "cbeth" | "cbbtc" | "wsteth" | "usdc";
+    assetId: "usdc" | "cbbtc" | "weth" | "cbeth" | "wsteth";
 }, {
     amount: string;
-    assetId: "weth" | "cbeth" | "cbbtc" | "wsteth" | "usdc";
+    assetId: "usdc" | "cbbtc" | "weth" | "cbeth" | "wsteth";
 }>;
 /**
  * Input schema for Compound borrow action.
@@ -33,10 +33,10 @@ export declare const CompoundBorrowSchema: z.ZodObject<{
     amount: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     amount: string;
-    assetId: "weth" | "usdc";
+    assetId: "usdc" | "weth";
 }, {
     amount: string;
-    assetId: "weth" | "usdc";
+    assetId: "usdc" | "weth";
 }>;
 /**
  * Input schema for Compound repay action.
@@ -46,10 +46,10 @@ export declare const CompoundRepaySchema: z.ZodObject<{
     amount: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     amount: string;
-    assetId: "weth" | "usdc";
+    assetId: "usdc" | "weth";
 }, {
     amount: string;
-    assetId: "weth" | "usdc";
+    assetId: "usdc" | "weth";
 }>;
 /**
  * Input schema for Compound get portfolio action.

package/dist/action-providers/flaunch/utils.js

@@ -313,7 +313,7 @@ const ethToMemecoin = (params) => {
     };
 };
 exports.ethToMemecoin = ethToMemecoin;
-// @notice Beofre calling the UniversalRouter the user must have:
+// @notice Before calling the UniversalRouter the user must have:
 // 1. Given the Permit2 contract allowance to spend the memecoin
 const memecoinToEthWithPermit2 = (params) => {
     const flETH = constants_1.FLETHAddress[params.chainId];

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

@@ -5,6 +5,7 @@ export * from "./across";
 export * from "./alchemy";
 export * from "./basename";
 export * from "./cdp";
+export * from "./cdp-v2";
 export * from "./compound";
 export * from "./defillama";
 export * from "./erc20";

package/dist/action-providers/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./across"), exports);
 __exportStar(require("./alchemy"), exports);
 __exportStar(require("./basename"), exports);
 __exportStar(require("./cdp"), exports);
+__exportStar(require("./cdp-v2"), exports);
 __exportStar(require("./compound"), exports);
 __exportStar(require("./defillama"), exports);
 __exportStar(require("./erc20"), exports);

package/dist/action-providers/twitter/twitterActionProvider.d.ts

@@ -29,7 +29,8 @@ export interface TwitterActionProviderConfig {
  * @augments ActionProvider
  */
 export declare class TwitterActionProvider extends ActionProvider {
-    private readonly client;
+    private client;
+    private config;
     /**
      * Constructor for the TwitterActionProvider class.
      *
@@ -72,6 +73,12 @@ export declare class TwitterActionProvider extends ActionProvider {
      * @returns Always returns true as Twitter actions are network-independent
      */
     supportsNetwork(_: Network): boolean;
+    /**
+     * Get the Twitter API client, initializing it if needed
+     *
+     * @returns The Twitter API client
+     */
+    private getClient;
 }
 /**
  * Factory function to create a new TwitterActionProvider instance.

package/dist/action-providers/twitter/twitterActionProvider.js

@@ -27,29 +27,29 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
      * @param config - The configuration options for the TwitterActionProvider
      */
     constructor(config = {}) {
+        var _a, _b, _c, _d;
         super("twitter", []);
-        config.apiKey || (config.apiKey = process.env.TWITTER_API_KEY);
-        config.apiSecret || (config.apiSecret = process.env.TWITTER_API_SECRET);
-        config.accessToken || (config.accessToken = process.env.TWITTER_ACCESS_TOKEN);
-        config.accessTokenSecret || (config.accessTokenSecret = process.env.TWITTER_ACCESS_TOKEN_SECRET);
-        if (!config.apiKey) {
+        this.client = null;
+        // Store config for later use but don't initialize the client yet
+        this.config = { ...config };
+        // Set defaults from environment variables
+        (_a = this.config).apiKey || (_a.apiKey = process.env.TWITTER_API_KEY);
+        (_b = this.config).apiSecret || (_b.apiSecret = process.env.TWITTER_API_SECRET);
+        (_c = this.config).accessToken || (_c.accessToken = process.env.TWITTER_ACCESS_TOKEN);
+        (_d = this.config).accessTokenSecret || (_d.accessTokenSecret = process.env.TWITTER_ACCESS_TOKEN_SECRET);
+        // Validate config
+        if (!this.config.apiKey) {
             throw new Error("TWITTER_API_KEY is not configured.");
         }
-        if (!config.apiSecret) {
+        if (!this.config.apiSecret) {
             throw new Error("TWITTER_API_SECRET is not configured.");
         }
-        if (!config.accessToken) {
+        if (!this.config.accessToken) {
             throw new Error("TWITTER_ACCESS_TOKEN is not configured.");
         }
-        if (!config.accessTokenSecret) {
+        if (!this.config.accessTokenSecret) {
             throw new Error("TWITTER_ACCESS_TOKEN_SECRET is not configured.");
         }
-        this.client = new twitter_api_v2_1.TwitterApi({
-            appKey: config.apiKey,
-            appSecret: config.apiSecret,
-            accessToken: config.accessToken,
-            accessSecret: config.accessTokenSecret,
-        });
     }
     /**
      * Get account details for the currently authenticated Twitter (X) user.
@@ -59,7 +59,7 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
      */
     async accountDetails(_) {
         try {
-            const response = await this.client.v2.me();
+            const response = await this.getClient().v2.me();
             response.data.url = `https://x.com/${response.data.username}`;
             return `Successfully retrieved authenticated user account details:\n${JSON.stringify(response)}`;
         }
@@ -75,7 +75,7 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
      */
     async accountMentions(args) {
         try {
-            const response = await this.client.v2.userMentionTimeline(args.userId);
+            const response = await this.getClient().v2.userMentionTimeline(args.userId);
             return `Successfully retrieved account mentions:\n${JSON.stringify(response)}`;
         }
         catch (error) {
@@ -90,7 +90,7 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
      */
     async postTweet(args) {
         try {
-            const response = await this.client.v2.tweet(args.tweet);
+            const response = await this.getClient().v2.tweet(args.tweet);
             return `Successfully posted to Twitter:\n${JSON.stringify(response)}`;
         }
         catch (error) {
@@ -105,7 +105,7 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
      */
     async postTweetReply(args) {
         try {
-            const response = await this.client.v2.tweet(args.tweetReply, {
+            const response = await this.getClient().v2.tweet(args.tweetReply, {
                 reply: { in_reply_to_tweet_id: args.tweetId },
             });
             return `Successfully posted reply to Twitter:\n${JSON.stringify(response)}`;
@@ -124,6 +124,24 @@ class TwitterActionProvider extends actionProvider_1.ActionProvider {
     supportsNetwork(_) {
         return true;
     }
+    /**
+     * Get the Twitter API client, initializing it if needed
+     *
+     * @returns The Twitter API client
+     */
+    getClient() {
+        if (!this.client) {
+            // Initialize client only when needed
+            const tokens = {
+                appKey: this.config.apiKey,
+                appSecret: this.config.apiSecret,
+                accessToken: this.config.accessToken,
+                accessSecret: this.config.accessTokenSecret,
+            };
+            this.client = new twitter_api_v2_1.TwitterApi(tokens);
+        }
+        return this.client;
+    }
 }
 exports.TwitterActionProvider = TwitterActionProvider;
 __decorate([

package/dist/action-providers/twitter/twitterActionProvider.test.js

@@ -44,6 +44,24 @@ describe("TwitterActionProvider", () => {
             delete process.env.TWITTER_ACCESS_TOKEN_SECRET;
             expect(() => new twitterActionProvider_1.TwitterActionProvider()).toThrow("TWITTER_API_KEY is not configured.");
         });
+        it("should implement lazy initialization", async () => {
+            // We'll check lazy initialization by observing that we can create an instance
+            // without error, and then use it to call methods successfully
+            const provider = new twitterActionProvider_1.TwitterActionProvider(MOCK_CONFIG);
+            // Mock a response for accountDetails
+            mockClient.me.mockResolvedValue({
+                data: {
+                    id: MOCK_ID,
+                    name: MOCK_NAME,
+                    username: MOCK_USERNAME,
+                },
+            });
+            // Call a method that should trigger initialization
+            const response = await provider.accountDetails({});
+            // Verify the method worked, which means initialization succeeded
+            expect(response).toContain("Successfully retrieved authenticated user account details");
+            expect(mockClient.me).toHaveBeenCalled();
+        });
     });
     describe("Account Details Action", () => {
         const mockResponse = {
@@ -182,4 +200,31 @@ describe("TwitterActionProvider", () => {
             expect(provider.supportsNetwork({ protocolFamily: "solana", networkId: "2" })).toBe(true);
         });
     });
+    describe("Next.js Integration", () => {
+        it("should work in a simulated Next.js environment", async () => {
+            // Create a clean instance of the provider
+            const provider = new twitterActionProvider_1.TwitterActionProvider(MOCK_CONFIG);
+            // Mock v2.me to test functionality
+            const mockResponse = {
+                data: {
+                    id: MOCK_ID,
+                    name: MOCK_NAME,
+                    username: MOCK_USERNAME,
+                },
+            };
+            const mockTwitterApi = {
+                v2: {
+                    me: jest.fn().mockResolvedValue(mockResponse),
+                },
+            };
+            // Override the getClient method to return our mocked API
+            jest
+                .spyOn(provider, "getClient")
+                .mockReturnValue(mockTwitterApi);
+            // Simulate a Next.js API route calling the provider
+            const result = await provider.accountDetails({});
+            expect(result).toContain("Successfully retrieved authenticated user account details");
+            expect(mockTwitterApi.v2.me).toHaveBeenCalled();
+        });
+    });
 });

package/dist/network/svm.d.ts

@@ -3,6 +3,7 @@ export declare const SOLANA_MAINNET_NETWORK_ID = "solana-mainnet";
 export declare const SOLANA_TESTNET_NETWORK_ID = "solana-testnet";
 export declare const SOLANA_DEVNET_NETWORK_ID = "solana-devnet";
 export type SOLANA_NETWORK_ID = typeof SOLANA_MAINNET_NETWORK_ID | typeof SOLANA_TESTNET_NETWORK_ID | typeof SOLANA_DEVNET_NETWORK_ID;
+export declare const SOLANA_NETWORK_IDS: SOLANA_NETWORK_ID[];
 export declare const SOLANA_PROTOCOL_FAMILY = "svm";
 export declare const SOLANA_MAINNET_GENESIS_BLOCK_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
 export declare const SOLANA_TESTNET_GENESIS_BLOCK_HASH = "4uhcVJyU9pJkvQyS88uRDiswHXSCkY3zQawwpjk2NsNY";

package/dist/network/svm.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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_NETWORK_IDS = 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";
 exports.SOLANA_DEVNET_NETWORK_ID = "solana-devnet";
+exports.SOLANA_NETWORK_IDS = [
+    exports.SOLANA_MAINNET_NETWORK_ID,
+    exports.SOLANA_TESTNET_NETWORK_ID,
+    exports.SOLANA_DEVNET_NETWORK_ID,
+];
 // AgentKit Protocol Family
 exports.SOLANA_PROTOCOL_FAMILY = "svm";
 // Chain IDs - Genesis Block Hashes