@coinbase/agentkit 0.0.0-nightly-20250903210403 → 0.0.0-nightly-20250905210407

package/README.md

@@ -272,6 +272,10 @@ const agent = createReactAgent({
     <td width="200"><code>transfer</code></td>
     <td width="768">Transfers a specified amount of ERC-20 tokens to a destination address.</td>
 </tr>
+<tr>
+    <td width="200"><code>get_erc20_token_address</code></td>
+    <td width="768">Gets the contract address for frequently used ERC20 tokens on different networks by token symbol.</td>
+</tr>
 </table>
 </details>
 <details>

package/dist/action-providers/across/acrossActionProvider.js

@@ -31,7 +31,7 @@ const schemas_1 = require("./schemas");
 const wallet_providers_1 = require("../../wallet-providers");
 const utils_1 = require("./utils");
 const accounts_1 = require("viem/accounts");
-const constants_1 = require("../erc20/constants");
+const viem_2 = require("viem");
 /**
  * AcrossActionProvider provides actions for cross-chain bridging via Across Protocol.
  */
@@ -141,7 +141,7 @@ class AcrossActionProvider extends actionProvider_1.ActionProvider {
                 // Check ERC20 token balance
                 const tokenBalance = (await walletProvider.readContract({
                     address: inputToken,
-                    abi: constants_1.abi,
+                    abi: viem_2.erc20Abi,
                     functionName: "balanceOf",
                     args: [address],
                 }));
@@ -194,7 +194,7 @@ class AcrossActionProvider extends actionProvider_1.ActionProvider {
                 approvalTxHash = await walletProvider.sendTransaction({
                     to: inputToken,
                     data: (0, viem_1.encodeFunctionData)({
-                        abi: constants_1.abi,
+                        abi: viem_2.erc20Abi,
                         functionName: "approve",
                         args: [quote.deposit.spokePoolAddress, quote.deposit.inputAmount],
                     }),

package/dist/action-providers/cdp/cdpEvmWalletActionProvider.js

@@ -337,7 +337,8 @@ It takes the following inputs:
 - slippageBps: (Optional) Maximum allowed slippage in basis points (100 = 1%)
 Important notes:
 - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
-- Use fromAmount units exactly as provided, do not convert to wei or any other units.
+- Use fromAmount units exactly as provided, do not convert to wei or any other units
+- Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
 `,
         schema: schemas_1.SwapSchema,
     }),
@@ -359,6 +360,7 @@ Important notes:
 - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
 - If needed, it will automatically approve the permit2 contract to spend the fromToken
 - Use fromAmount units exactly as provided, do not convert to wei or any other units.
+- Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
 `,
         schema: schemas_1.SwapSchema,
     }),

package/dist/action-providers/cdp/cdpSmartWalletActionProvider.js

@@ -319,7 +319,8 @@ It takes the following inputs:
 - slippageBps: (Optional) Maximum allowed slippage in basis points (100 = 1%)
 Important notes:
 - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
-- Use fromAmount units exactly as provided, do not convert to wei or any other units.
+- Use fromAmount units exactly as provided, do not convert to wei or any other units
+- Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
 `,
         schema: schemas_1.SwapSchema,
     }),
@@ -340,7 +341,8 @@ It takes the following inputs:
 Important notes:
 - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
 - If needed, it will automatically approve the permit2 contract to spend the fromToken
-- Use fromAmount units exactly as provided, do not convert to wei or any other units.
+- Use fromAmount units exactly as provided, do not convert to wei or any other units
+- Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
 `,
         schema: schemas_1.SwapSchema,
     }),

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

@@ -1,5 +1,5 @@
 import { Address } from "viem";
-import { abi as ERC20_ABI } from "../erc20/constants";
+import { erc20Abi as ERC20_ABI } from "viem";
 export declare const SUPPORTED_NETWORKS: string[];
 export declare const COMET_ADDRESSES: Record<string, Address>;
 export declare const ASSET_ADDRESSES: Record<string, Record<string, Address>>;

package/dist/action-providers/compound/constants.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PRICE_FEED_ABI = exports.COMET_ABI = exports.ERC20_ABI = exports.ASSET_ADDRESSES = exports.COMET_ADDRESSES = exports.SUPPORTED_NETWORKS = void 0;
-const constants_1 = require("../erc20/constants");
-Object.defineProperty(exports, "ERC20_ABI", { enumerable: true, get: function () { return constants_1.abi; } });
+const viem_1 = require("viem");
+Object.defineProperty(exports, "ERC20_ABI", { enumerable: true, get: function () { return viem_1.erc20Abi; } });
 exports.SUPPORTED_NETWORKS = ["base-mainnet", "base-sepolia"];
 exports.COMET_ADDRESSES = {
     "base-mainnet": "0xb125E6687d4313864e53df431d5425969c15Eb2F",

package/dist/action-providers/erc20/constants.d.ts

@@ -1,137 +1,37 @@
-export declare const abi: readonly [{
-    readonly type: "event";
-    readonly name: "Approval";
-    readonly inputs: readonly [{
-        readonly indexed: true;
-        readonly name: "owner";
-        readonly type: "address";
-    }, {
-        readonly indexed: true;
-        readonly name: "spender";
-        readonly type: "address";
-    }, {
-        readonly indexed: false;
-        readonly name: "value";
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "event";
-    readonly name: "Transfer";
-    readonly inputs: readonly [{
-        readonly indexed: true;
-        readonly name: "from";
-        readonly type: "address";
-    }, {
-        readonly indexed: true;
-        readonly name: "to";
-        readonly type: "address";
-    }, {
-        readonly indexed: false;
-        readonly name: "value";
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "allowance";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "owner";
-        readonly type: "address";
-    }, {
-        readonly name: "spender";
-        readonly type: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "approve";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly name: "spender";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "balanceOf";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "account";
-        readonly type: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "decimals";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint8";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "name";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "string";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "symbol";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "string";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "totalSupply";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "transfer";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly name: "recipient";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "transferFrom";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly name: "sender";
-        readonly type: "address";
-    }, {
-        readonly name: "recipient";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}];
 export declare const BaseTokenToAssetId: Map<string, string>;
 export declare const BaseSepoliaTokenToAssetId: Map<string, string>;
+export declare const TOKEN_ADDRESSES_BY_SYMBOLS: {
+    readonly "base-mainnet": {
+        readonly USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly EURC: "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42";
+        readonly CBBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
+        readonly CBETH: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22";
+        readonly WETH: "0x4200000000000000000000000000000000000006";
+        readonly ZORA: "0x1111111111166b7FE7bd91427724B487980aFc69";
+        readonly AERO: "0x940181a94a35a4569e4529a3cdfb74e38fd98631";
+        readonly BNKR: "0x22af33fe49fd1fa80c7149773dde5890d3c76f3b";
+        readonly CLANKER: "0x1bc0c42215582d5a085795f4badbac3ff36d1bcb";
+    };
+    readonly "base-sepolia": {
+        readonly USDC: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+        readonly EURC: "0x808456652fdb597867f38412077A9182bf77359F";
+        readonly CBBTC: "0xcbB7C0006F23900c38EB856149F799620fcb8A4a";
+        readonly WETH: "0x4200000000000000000000000000000000000006";
+    };
+    readonly "ethereum-mainnet": {
+        readonly USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+        readonly EURC: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c";
+        readonly CBBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
+        readonly WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
+        readonly CBETH: "0xBe9895146f7AF43049ca1c1AE358B0541Ea49704";
+    };
+    readonly "polygon-mainnet": {
+        readonly USDC: "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359";
+    };
+    readonly "arbitrum-mainnet": {
+        readonly USDC: "0xaf88d065e77c8cc2239327c5edb3a432268e5831";
+    };
+    readonly "optimism-mainnet": {
+        readonly USDC: "0x0b2c639c533813f4aa9d7837caf62653d097ff85";
+    };
+};

package/dist/action-providers/erc20/constants.js

@@ -1,195 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseSepoliaTokenToAssetId = exports.BaseTokenToAssetId = exports.abi = void 0;
+exports.TOKEN_ADDRESSES_BY_SYMBOLS = exports.BaseSepoliaTokenToAssetId = exports.BaseTokenToAssetId = void 0;
 const coinbase_sdk_1 = require("@coinbase/coinbase-sdk");
-exports.abi = [
-    {
-        type: "event",
-        name: "Approval",
-        inputs: [
-            {
-                indexed: true,
-                name: "owner",
-                type: "address",
-            },
-            {
-                indexed: true,
-                name: "spender",
-                type: "address",
-            },
-            {
-                indexed: false,
-                name: "value",
-                type: "uint256",
-            },
-        ],
-    },
-    {
-        type: "event",
-        name: "Transfer",
-        inputs: [
-            {
-                indexed: true,
-                name: "from",
-                type: "address",
-            },
-            {
-                indexed: true,
-                name: "to",
-                type: "address",
-            },
-            {
-                indexed: false,
-                name: "value",
-                type: "uint256",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "allowance",
-        stateMutability: "view",
-        inputs: [
-            {
-                name: "owner",
-                type: "address",
-            },
-            {
-                name: "spender",
-                type: "address",
-            },
-        ],
-        outputs: [
-            {
-                type: "uint256",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "approve",
-        stateMutability: "nonpayable",
-        inputs: [
-            {
-                name: "spender",
-                type: "address",
-            },
-            {
-                name: "amount",
-                type: "uint256",
-            },
-        ],
-        outputs: [
-            {
-                type: "bool",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "balanceOf",
-        stateMutability: "view",
-        inputs: [
-            {
-                name: "account",
-                type: "address",
-            },
-        ],
-        outputs: [
-            {
-                type: "uint256",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "decimals",
-        stateMutability: "view",
-        inputs: [],
-        outputs: [
-            {
-                type: "uint8",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "name",
-        stateMutability: "view",
-        inputs: [],
-        outputs: [
-            {
-                type: "string",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "symbol",
-        stateMutability: "view",
-        inputs: [],
-        outputs: [
-            {
-                type: "string",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "totalSupply",
-        stateMutability: "view",
-        inputs: [],
-        outputs: [
-            {
-                type: "uint256",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "transfer",
-        stateMutability: "nonpayable",
-        inputs: [
-            {
-                name: "recipient",
-                type: "address",
-            },
-            {
-                name: "amount",
-                type: "uint256",
-            },
-        ],
-        outputs: [
-            {
-                type: "bool",
-            },
-        ],
-    },
-    {
-        type: "function",
-        name: "transferFrom",
-        stateMutability: "nonpayable",
-        inputs: [
-            {
-                name: "sender",
-                type: "address",
-            },
-            {
-                name: "recipient",
-                type: "address",
-            },
-            {
-                name: "amount",
-                type: "uint256",
-            },
-        ],
-        outputs: [
-            {
-                type: "bool",
-            },
-        ],
-    },
-];
 exports.BaseTokenToAssetId = new Map([
     ["0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf", coinbase_sdk_1.Coinbase.assets.Cbbtc],
     ["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", coinbase_sdk_1.Coinbase.assets.Usdc],
@@ -200,3 +12,39 @@ exports.BaseSepoliaTokenToAssetId = new Map([
     ["0x036CbD53842c5426634e7929541eC2318f3dCF7e", coinbase_sdk_1.Coinbase.assets.Usdc],
     ["0x808456652fdb597867f38412077A9182bf77359F", coinbase_sdk_1.Coinbase.assets.Eurc],
 ]);
+// Token symbol to address mappings for frequently used tokens
+exports.TOKEN_ADDRESSES_BY_SYMBOLS = {
+    "base-mainnet": {
+        USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        EURC: "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+        CBBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
+        CBETH: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22",
+        WETH: "0x4200000000000000000000000000000000000006",
+        ZORA: "0x1111111111166b7FE7bd91427724B487980aFc69",
+        AERO: "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
+        BNKR: "0x22af33fe49fd1fa80c7149773dde5890d3c76f3b",
+        CLANKER: "0x1bc0c42215582d5a085795f4badbac3ff36d1bcb",
+    },
+    "base-sepolia": {
+        USDC: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        EURC: "0x808456652fdb597867f38412077A9182bf77359F",
+        CBBTC: "0xcbB7C0006F23900c38EB856149F799620fcb8A4a",
+        WETH: "0x4200000000000000000000000000000000000006",
+    },
+    "ethereum-mainnet": {
+        USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        EURC: "0x1abaea1f7c830bd89acc67ec4af516284b1bc33c",
+        CBBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
+        WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+        CBETH: "0xBe9895146f7AF43049ca1c1AE358B0541Ea49704",
+    },
+    "polygon-mainnet": {
+        USDC: "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
+    },
+    "arbitrum-mainnet": {
+        USDC: "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
+    },
+    "optimism-mainnet": {
+        USDC: "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
+    },
+};

package/dist/action-providers/erc20/erc20ActionProvider.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { ActionProvider } from "../actionProvider";
 import { Network } from "../../network";
-import { GetBalanceSchema, TransferSchema } from "./schemas";
+import { GetBalanceSchema, TransferSchema, GetTokenAddressSchema } from "./schemas";
 import { EvmWalletProvider } from "../../wallet-providers";
 /**
  * ERC20ActionProvider is an action provider for ERC20 tokens.
@@ -27,6 +27,14 @@ export declare class ERC20ActionProvider extends ActionProvider<EvmWalletProvide
      * @returns A message containing the transfer details.
      */
     transfer(walletProvider: EvmWalletProvider, args: z.infer<typeof TransferSchema>): Promise<string>;
+    /**
+     * Gets the contract address for a token symbol on the current network.
+     *
+     * @param walletProvider - The wallet provider to get the network from.
+     * @param args - The input arguments for the action.
+     * @returns A message containing the token address or an error if not found.
+     */
+    getTokenAddress(walletProvider: EvmWalletProvider, args: z.infer<typeof GetTokenAddressSchema>): Promise<string>;
     /**
      * Checks if the ERC20 action provider supports the given network.
      *