@coinbase/agentkit 0.10.1 → 0.10.3

package/README.md

@@ -77,7 +77,7 @@ AgentKit is a framework for easily enabling AI agents to take actions onchain. I
 
 _Prerequisites_:
 
-- [Node.js 18+](https://nodejs.org/en/download/)
+- [Node.js v22+](https://nodejs.org/en/download/)
 - [CDP Secret API Key](https://docs.cdp.coinbase.com/get-started/docs/cdp-api-keys#creating-secret-api-keys)
 
 ## Installation
@@ -172,57 +172,32 @@ const agent = createReactAgent({
 ## Action Providers
 
 <details>
-<summary><strong>CDP EVM Wallet</strong></summary>
+<summary><strong>Across</strong></summary>
 <table width="100%">
 <tr>
-    <td width="200"><code>list_spend_permissions</code></td>
-    <td width="768">Lists spend permissions that have been granted to the current EVM wallet by a smart account.</td>
-</tr>
-<tr>
-    <td width="200"><code>use_spend_permission</code></td>
-    <td width="768">Uses a spend permission to spend tokens on behalf of a smart account that the current EVM wallet has permission to spend.</td>
-</tr>
-<tr>
-    <td width="200"><code>get_swap_price</code></td>
-    <td width="768">Fetches a price quote for swapping between two tokens using the CDP Swap API (does not execute swap).</td>
+    <td width="200"><code>bridge_token</code></td>
+    <td width="768">Bridges tokens between supported chains using Across Protocol.</td>
 </tr>
 <tr>
-    <td width="200"><code>swap</code></td>
-    <td width="768">Executes a token swap using the CDP Swap API with automatic token approvals.</td>
+    <td width="200"><code>check_deposit_status</code></td>
+    <td width="768">Checks the status of a cross-chain bridge deposit on the Across Protocol (mainnet networks only).</td>
 </tr>
 </table>
 </details>
 <details>
-<summary><strong>CDP Smart Wallet</strong></summary>
+<summary><strong>Base Account</strong></summary>
 <table width="100%">
 <tr>
-    <td width="200"><code>list_spend_permissions</code></td>
-    <td width="768">Lists spend permissions that have been granted to the current smart wallet by a smart account.</td>
+    <td width="200"><code>list_base_account_spend_permissions</code></td>
+    <td width="768">Lists spend permissions that have been granted to the current wallet by a Base Account, with support for any ERC20 token.</td>
 </tr>
 <tr>
-    <td width="200"><code>use_spend_permission</code></td>
-    <td width="768">Uses a spend permission to spend tokens on behalf of a smart account that the current smart wallet has permission to spend.</td>
-</tr>
-<tr>
-    <td width="200"><code>get_swap_price</code></td>
-    <td width="768">Fetches a price quote for swapping between two tokens using the CDP Swap API (does not execute swap).</td>
+    <td width="200"><code>spend_from_base_account_permission</code></td>
+    <td width="768">Uses a spend permission to transfer tokens from a Base Account to the current wallet, with support for any ERC20 token.</td>
 </tr>
 <tr>
-    <td width="200"><code>swap</code></td>
-    <td width="768">Executes a token swap using the CDP Swap API with automatic token approvals.</td>
-</tr>
-</table>
-</details>
-<details>
-<summary><strong>Across</strong></summary>
-<table width="100%">
-<tr>
-    <td width="200"><code>bridge_token</code></td>
-    <td width="768">Bridges tokens between supported chains using Across Protocol.</td>
-</tr>
-<tr>
-    <td width="200"><code>check_deposit_status</code></td>
-    <td width="768">Checks the status of a cross-chain bridge deposit on the Across Protocol (mainnet networks only).</td>
+    <td width="200"><code>revoke_base_account_spend_permission</code></td>
+    <td width="768">Revokes a spend permission that was previously granted by a Base Account, with support for any ERC20 token.</td>
 </tr>
 </table>
 </details>
@@ -270,6 +245,57 @@ const agent = createReactAgent({
 </table>
 </details>
 <details>
+<summary><strong>CDP API</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>request_faucet_funds</code></td>
+    <td width="768">Requests test tokens from the CDP faucet for base-sepolia, ethereum-sepolia, or solana-devnet networks.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>CDP EVM Wallet</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>list_spend_permissions</code></td>
+    <td width="768">Lists spend permissions that have been granted to the current EVM wallet by a smart account.</td>
+</tr>
+<tr>
+    <td width="200"><code>use_spend_permission</code></td>
+    <td width="768">Uses a spend permission to spend tokens on behalf of a smart account that the current EVM wallet has permission to spend.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_swap_price</code></td>
+    <td width="768">Fetches a price quote for swapping between two tokens using the CDP Swap API (does not execute swap).</td>
+</tr>
+<tr>
+    <td width="200"><code>swap</code></td>
+    <td width="768">Executes a token swap using the CDP Swap API with automatic token approvals.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>CDP Smart Wallet</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>list_spend_permissions</code></td>
+    <td width="768">Lists spend permissions that have been granted to the current smart wallet by a smart account.</td>
+</tr>
+<tr>
+    <td width="200"><code>use_spend_permission</code></td>
+    <td width="768">Uses a spend permission to spend tokens on behalf of a smart account that the current smart wallet has permission to spend.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_swap_price</code></td>
+    <td width="768">Fetches a price quote for swapping between two tokens using the CDP Swap API (does not execute swap).</td>
+</tr>
+<tr>
+    <td width="200"><code>swap</code></td>
+    <td width="768">Executes a token swap using the CDP Swap API with automatic token approvals.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>DefiLlama</strong></summary>
 <table width="100%">
 <tr>
@@ -287,6 +313,15 @@ const agent = createReactAgent({
 </table>
 </details>
 <details>
+<summary><strong>Enso</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>route</code></td>
+    <td width="768">Find and execute a route for entering or exiting any DeFi position or swapping any ERC20 tokens.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>ERC20</strong></summary>
 <table width="100%">
 <tr>
@@ -297,6 +332,14 @@ 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>approve</code></td>
+    <td width="768">Approves a spender to transfer ERC-20 tokens on behalf of the wallet.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_allowance</code></td>
+    <td width="768">Checks the allowance amount for a spender of an ERC-20 token.</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>
@@ -338,7 +381,7 @@ const agent = createReactAgent({
 <table width="100%">
 <tr>
     <td width="200"><code>flaunch</code></td>
-    <td width="768">Launches a new memecoin token with customizable name, symbol, image, and metadata.</td>
+    <td width="768">Launches a new memecoin token with customizable name, symbol, image, metadata, fair launch parameters, fee allocation, and premine options.</td>
 </tr>
 <tr>
     <td width="200"><code>buyCoinWithETHInput</code></td>
@@ -364,6 +407,19 @@ const agent = createReactAgent({
 </table>
 </details>
 <details>
+<summary><strong>Moonwell</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>mint</code></td>
+    <td width="768">Mints assets into a Moonwell MToken for lending and earning yield.</td>
+</tr>
+<tr>
+    <td width="200"><code>redeem</code></td>
+    <td width="768">Redeems assets from a Moonwell MToken to withdraw principal and earned interest.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>Morpho</strong></summary>
 <table width="100%">
 <tr>
@@ -407,7 +463,7 @@ const agent = createReactAgent({
 </tr>
 <tr>
     <td width="200"><code>fetch_price_feed_id</code></td>
-    <td width="768">Retrieves the unique price feed identifier for a given token symbol.</td>
+    <td width="768">Retrieves the unique price feed identifier for a given asset symbol.</td>
 </tr>
 </table>
 </details>
@@ -487,6 +543,43 @@ const agent = createReactAgent({
 </table>
 </details>
 <details>
+<summary><strong>Vaultsfyi</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>vaults</code></td>
+    <td width="768">Retrieves a list of available yield farming vaults with filtering and sorting options.</td>
+</tr>
+<tr>
+    <td width="200"><code>vault_details</code></td>
+    <td width="768">Fetches detailed information about a specific vault including description and rewards breakdown.</td>
+</tr>
+<tr>
+    <td width="200"><code>vault_historical_data</code></td>
+    <td width="768">Gets historical APY and TVL data for a specific vault over time.</td>
+</tr>
+<tr>
+    <td width="200"><code>deposit</code></td>
+    <td width="768">Deposits assets into a selected vault to start earning yield.</td>
+</tr>
+<tr>
+    <td width="200"><code>redeem</code></td>
+    <td width="768">Redeems assets from a vault to withdraw principal and earned yield.</td>
+</tr>
+<tr>
+    <td width="200"><code>claim</code></td>
+    <td width="768">Claims rewards from a vault without withdrawing the principal deposit.</td>
+</tr>
+<tr>
+    <td width="200"><code>balances</code></td>
+    <td width="768">Retrieves user's native token and ERC20 token balances across supported networks.</td>
+</tr>
+<tr>
+    <td width="200"><code>positions</code></td>
+    <td width="768">Gets user's current positions in vaults including balances and unclaimed rewards.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>Wallet</strong></summary>
 <table width="100%">
 <tr>
@@ -539,8 +632,25 @@ const agent = createReactAgent({
 </table>
 </details>
 <details>
+<summary><strong>SPL</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_balance</code></td>
+    <td width="768">Retrieves the balance of SPL tokens for a specified address on Solana.</td>
+</tr>
+<tr>
+    <td width="200"><code>transfer</code></td>
+    <td width="768">Transfers SPL tokens to another address on the Solana network.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>x402</strong></summary>
 <table width="100%">
+<tr>
+    <td width="200"><code>discover_x402_services</code></td>
+    <td width="768">Discover available x402 services with optional filtering by maximum USDC price.</td>
+</tr>
 <tr>
     <td width="200"><code>make_http_request</code></td>
     <td width="768">Makes a basic HTTP request to an API endpoint. If the endpoint requires payment (returns 402),
@@ -553,6 +663,35 @@ it will return payment details that can be used on retry.</td>
 <tr>
     <td width="200"><code>make_http_request_with_x402</code></td>
     <td width="768">Combines make_http_request and retry_http_request_with_x402 into a single step.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Yelay</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_vaults</code></td>
+    <td width="768">Fetches a list of available Yelay Vaults with their current APYs and contract addresses.</td>
+</tr>
+<tr>
+    <td width="200"><code>deposit</code></td>
+    <td width="768">Deposits assets into a specified Yelay Vault.</td>
+</tr>
+<tr>
+    <td width="200"><code>redeem</code></td>
+    <td width="768">Withdraws assets from a Yelay Vault.</td>
+</tr>
+<tr>
+    <td width="200"><code>claim</code></td>
+    <td width="768">Claims accumulated yield from a Yelay Vault.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_balance</code></td>
+    <td width="768">Gets the user's balance and yield information for a specific vault.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>ZeroX</strong></summary>
 <table width="100%">
 <tr>

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

@@ -17,8 +17,8 @@ export declare const BridgeTokenSchema: z.ZodObject<{
 }, {
     amount: string;
     destinationChainId: string;
-    inputTokenSymbol?: string | undefined;
     recipient?: string | undefined;
+    inputTokenSymbol?: string | undefined;
     maxSplippage?: number | undefined;
 }>;
 /**

package/dist/action-providers/baseAccount/baseAccountActionProvider.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { ActionProvider } from "../actionProvider";
+import { EvmWalletProvider } from "../../wallet-providers";
+import { Network } from "../../network";
+import { ListBaseAccountSpendPermissionsSchema, UseBaseAccountSpendPermissionSchema, RevokeBaseAccountSpendPermissionSchema } from "./schemas";
+/**
+ * BaseAccountActionProvider provides actions to interact with Base Account spend permissions.
+ */
+export declare class BaseAccountActionProvider extends ActionProvider<EvmWalletProvider> {
+    /**
+     * Constructor for the BaseAccountActionProvider.
+     */
+    constructor();
+    /**
+     * Lists spend permissions that have been granted to the current wallet by a Base Account.
+     *
+     * @param walletProvider - The wallet provider to use for listing permissions.
+     * @param args - The input arguments for listing spend permissions.
+     * @returns A JSON string with the list of spend permissions.
+     */
+    listBaseAccountSpendPermissions(walletProvider: EvmWalletProvider, args: z.infer<typeof ListBaseAccountSpendPermissionsSchema>): Promise<string>;
+    /**
+     * Uses a spend permission to transfer tokens from a Base Account to the current wallet.
+     *
+     * @param walletProvider - The wallet provider to use for the spend operation.
+     * @param args - The input arguments for using the spend permission.
+     * @returns A JSON string with the spend operation results.
+     */
+    spendFromBaseAccountPermission(walletProvider: EvmWalletProvider, args: z.infer<typeof UseBaseAccountSpendPermissionSchema>): Promise<string>;
+    /**
+     * Revokes a spend permission that was previously granted by a Base Account to the current wallet.
+     *
+     * @param walletProvider - The wallet provider to use for the revoke operation.
+     * @param args - The input arguments for revoking the spend permission.
+     * @returns A JSON string with the revoke operation results.
+     */
+    revokeBaseAccountSpendPermission(walletProvider: EvmWalletProvider, args: z.infer<typeof RevokeBaseAccountSpendPermissionSchema>): Promise<string>;
+    /**
+     * Checks if the Base Account action provider supports the given network.
+     *
+     * @param network - The network to check.
+     * @returns True if the Base Account action provider supports the network, false otherwise.
+     */
+    supportsNetwork: (network: Network) => boolean;
+}
+export declare const baseAccountActionProvider: () => BaseAccountActionProvider;