@coinbase/agentkit 0.1.1 → 0.2.0

package/README.md

@@ -8,18 +8,32 @@ AgentKit is a framework for easily enabling AI agents to take actions onchain. I
 - [Getting Started](#getting-started)
 - [Installation](#installation)
 - [Usage](#usage)
-  - [Create an AgentKit instance](##create-an-agentkit-instance-if-no-wallet-or-action-providers-are-specified-the-agent-will-use-the-cdpwalletprovider-and-walletprovider-action-provider)
+  - [Create an AgentKit instance](#create-an-agentkit-instance)
   - [Create an AgentKit instance with a specified wallet provider](#create-an-agentkit-instance-with-a-specified-wallet-provider)
   - [Create an AgentKit instance with a specified action providers](#create-an-agentkit-instance-with-a-specified-action-providers)
   - [Use the agent's actions with a framework extension. For example, using LangChain + OpenAI](#use-the-agents-actions-with-a-framework-extension-for-example-using-langchain--openai)
-- [Wallet Providers](#wallet-providers)
+- [Action Providers](#action-providers)
+- [Creating an Action Provider](#creating-an-action-provider)
+  - [Adding Actions to your Action Provider](#adding-actions-to-your-action-provider)
+  - [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)
   - [CdpWalletProvider](#cdpwalletprovider)
     - [Network Configuration](#network-configuration)
     - [Configuring from an existing CDP API Wallet](#configuring-from-an-existing-cdp-api-wallet)
     - [Configuring from a mnemonic phrase](#configuring-from-a-mnemonic-phrase)
     - [Exporting a wallet](#exporting-a-wallet)
     - [Importing a wallet from WalletData JSON string](#importing-a-wallet-from-walletdata-json-string)
+    - [Configuring gas parameters](#configuring-cdpwalletprovider-gas-parameters)
   - [ViemWalletProvider](#viemwalletprovider)
+    - [Configuring gas parameters](#configuring-viemwalletprovider-gas-parameters)
+  - [PrivyWalletProvider](#privywalletprovider)
+    - [Authorization Keys](#authorization-keys)
+    - [Exporting Privy Wallet information](#exporting-privy-wallet-information)
+- [SVM Wallet Providers](#svm-wallet-providers)
+  - [SolanaKeypairWalletProvider](#solanakeypairwalletprovider)
+    - [Network Configuration](#solana-network-configuration)
+    - [RPC URL Configuration](#rpc-url-configuration)
 - [Contributing](#contributing)
 
 ## Getting Started
@@ -45,6 +59,17 @@ const agentKit = await AgentKit.from({
 });
 ```
 
+### Create an AgentKit instance
+
+If no wallet or action provider are specified, the agent will use the `CdpWalletProvider` and `WalletActionProvider` action provider by default.
+
+```typescript
+const agentKit = await AgentKit.from({
+  cdpApiKeyName: "CDP API KEY NAME",
+  cdpApiKeyPrivate: "CDP API KEY PRIVATE KEY",
+});
+```
+
 ### Create an AgentKit instance with a specified wallet provider.
 
 ```typescript
@@ -105,6 +130,167 @@ const agent = createReactAgent({
 });
 ```
 
+## Action Providers
+<details>
+<summary><strong>Basename</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>register_basename</code></td>
+    <td width="768">Registers a custom .base.eth or .basetest.eth domain name for the wallet address.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>CDP Wallet</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>deploy_contract</code></td>
+    <td width="768">Deploys a custom smart contract using specified Solidity version and constructor arguments.</td>
+</tr>
+<tr>
+    <td width="200"><code>deploy_nft</code></td>
+    <td width="768">Deploys a standard ERC-721 NFT contract with configurable name, symbol, and metadata URI.</td>
+</tr>
+<tr>
+    <td width="200"><code>deploy_token</code></td>
+    <td width="768">Deploys a standard ERC-20 token contract with configurable name, symbol, and initial supply.</td>
+</tr>
+<tr>
+    <td width="200"><code>trade</code></td>
+    <td width="768">Executes a token swap between two assets at current market rates on mainnet networks.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>ERC20</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_balance</code></td>
+    <td width="768">Retrieves the token balance for a specified address and ERC-20 contract.</td>
+</tr>
+<tr>
+    <td width="200"><code>transfer</code></td>
+    <td width="768">Transfers a specified amount of ERC-20 tokens to a destination address.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>ERC721</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_balance</code></td>
+    <td width="768">Retrieves the NFT balance for a specified address and ERC-721 contract.</td>
+</tr>
+<tr>
+    <td width="200"><code>mint</code></td>
+    <td width="768">Creates a new NFT token and assigns it to a specified destination address.</td>
+</tr>
+<tr>
+    <td width="200"><code>transfer</code></td>
+    <td width="768">Transfers ownership of a specific NFT token to a destination address.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Farcaster</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>account_details</code></td>
+    <td width="768">Fetches profile information and metadata for the authenticated Farcaster account.</td>
+</tr>
+<tr>
+    <td width="200"><code>post_cast</code></td>
+    <td width="768">Creates a new cast (message) on Farcaster with up to 280 characters.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Morpho</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>deposit</code></td>
+    <td width="768">Deposits a specified amount of assets into a designated Morpho Vault.</td>
+</tr>
+<tr>
+    <td width="200"><code>withdraw</code></td>
+    <td width="768">Withdraws a specified amount of assets from a designated Morpho Vault.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Pyth</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>fetch_price</code></td>
+    <td width="768">Retrieves current price data from a specified Pyth price feed.</td>
+</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>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Twitter</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>account_details</code></td>
+    <td width="768">Fetches profile information and metadata for the authenticated Twitter account.</td>
+</tr>
+<tr>
+    <td width="200"><code>account_mentions</code></td>
+    <td width="768">Retrieves recent mentions and interactions for the authenticated account.</td>
+</tr>
+<tr>
+    <td width="200"><code>post_tweet</code></td>
+    <td width="768">Creates a new tweet on the authenticated Twitter account.</td>
+</tr>
+<tr>
+    <td width="200"><code>post_tweet_reply</code></td>
+    <td width="768">Creates a reply to an existing tweet using the tweet's unique identifier.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>Wallet</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_wallet_details</code></td>
+    <td width="768">Retrieves wallet address, network info, balances, and provider details.</td>
+</tr>
+<tr>
+    <td width="200"><code>native_transfer</code></td>
+    <td width="768">Transfers native blockchain tokens (e.g., ETH) to a destination address.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>WETH</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>wrap_eth</code></td>
+    <td width="768">Converts native ETH to Wrapped ETH (WETH) on Base Sepolia or Base Mainnet.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>WOW</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>buy_token</code></td>
+    <td width="768">Purchases WOW tokens from a contract using ETH based on bonding curve pricing.</td>
+</tr>
+<tr>
+    <td width="200"><code>create_token</code></td>
+    <td width="768">Creates a new WOW memecoin with bonding curve functionality via Zora factory.</td>
+</tr>
+<tr>
+    <td width="200"><code>sell_token</code></td>
+    <td width="768">Sells WOW tokens back to the contract for ETH based on bonding curve pricing.</td>
+</tr>
+</table>
+</details>
+
 ## Creating an Action Provider
 
 Action providers are used to define the actions that an agent can take. They are defined as a class that extends the `ActionProvider` abstract class.
@@ -127,6 +313,21 @@ class MyActionProvider extends ActionProvider<WalletProvider> {
 
 Actions are defined as instance methods on the action provider class with the `@CreateAction` decorator. Actions can use a wallet provider or not and always return a Promise that resolves to a string.
 
+#### Required Typescript Compiler Options
+
+Creating actions with the `@CreateAction` decorator requires the following compilerOptions to be included in your project's `tsconfig.json`.
+
+```json
+{
+    "compilerOptions": {
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true
+    }
+} 
+```
+
+#### Steps to create an action
+
 1. Define the action schema. Action schemas are defined using the `zod` library.
 
 ```typescript
@@ -197,13 +398,14 @@ const agentKit = new AgentKit({
 });
 ```
 
-## Wallet Providers
+## EVM Wallet Providers
 
 Wallet providers give an agent access to a wallet. AgentKit currently supports the following wallet providers:
 
 EVM:
-- [CdpWalletProvider](./src/wallet-providers/cdpWalletProvider.ts)
-- [ViemWalletProvider](./src/wallet-providers/viemWalletProvider.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)
 
 ### CdpWalletProvider
 
@@ -277,6 +479,27 @@ const walletProvider = await CdpWalletProvider.configureWithWallet({
 });
 ```
 
+#### Configuring CdpWalletProvider gas parameters
+
+The `CdpWalletProvider` also exposes parameters for effecting the gas calculations.
+
+```typescript
+import { CdpWalletProvider } from "@coinbase/agentkit";
+
+const walletProvider = await CdpWalletProvider.configureWithWallet({
+    cdpWalletData: "WALLET DATA JSON STRING",
+    apiKeyName: "CDP API KEY NAME",
+    apiKeyPrivate: "CDP API KEY PRIVATE KEY",
+    gas: {
+        gasLimitMultiplier: 2.0,  // Adjusts gas limit estimation
+        feePerGasMultiplier: 2.0, // Adjusts max fee per gas
+    }
+});
+```
+
+**Note**: Gas parameters only impact the `walletProvider.sendTransaction` behavior. Actions that do not rely on direct transaction calls, such as `deploy_token`, `deploy_contract`, and `native_transfer`, remain unaffected.
+
+
 ### ViemWalletProvider
 
 The `ViemWalletProvider` is a wallet provider that uses the [Viem library](https://viem.sh/docs/getting-started). It is useful for interacting with any EVM-compatible chain.
@@ -301,6 +524,116 @@ const client = createWalletClient({
 const walletProvider = new ViemWalletProvider(client);
 ```
 
+#### Configuring ViemWalletProvider gas parameters
+
+The `ViemWalletProvider` also exposes parameters for effecting the gas calculations.
+
+```typescript
+import { ViemWalletProvider } from "@coinbase/agentkit";
+import { privateKeyToAccount } from "viem/accounts";
+import { baseSepolia } from "viem/chains";
+import { http } from "viem/transports";
+import { createWalletClient } from "viem";
+
+const account = privateKeyToAccount(
+  "0x4c0883a69102937d6231471b5dbb6208ffd70c02a813d7f2da1c54f2e3be9f38",
+);
+
+const client = createWalletClient({
+  account,
+  chain: baseSepolia,
+  transport: http(),
+});
+
+const walletProvider = new ViemWalletProvider(client, {
+    gasLimitMultiplier: 2.0,  // Adjusts gas limit estimation
+    feePerGasMultiplier: 2.0, // Adjusts max fee per gas
+});
+```
+
+### PrivyWalletProvider
+
+The `PrivyWalletProvider` is a wallet provider that uses [Privy Server Wallets](https://docs.privy.io/guide/server-wallets/). This implementation extends the `ViemWalletProvider`.
+
+```typescript
+import { PrivyWalletProvider } from "@coinbase/agentkit";
+
+// Configure Wallet Provider
+const config = {
+    appId: "PRIVY_APP_ID",
+    appSecret: "PRIVY_APP_SECRET",
+    chainId: "84532", // base-sepolia
+    walletId: "PRIVY_WALLET_ID", // optional, otherwise a new wallet will be created
+    authorizationPrivateKey: PRIVY_WALLET_AUTHORIZATION_PRIVATE_KEY, // optional, required if your account is using authorization keys
+    authorizationKeyId: PRIVY_WALLET_AUTHORIZATION_KEY_ID, // optional, only required to create a new wallet if walletId is not provided
+};
+
+const walletProvider = await PrivyWalletProvider.configureWithWallet(config);
+```
+
+#### Authorization Keys
+
+Privy offers the option to use authorization keys to secure your server wallets.
+
+You can manage authorization keys from your [Privy dashboard](https://dashboard.privy.io/account) or programmatically [using the API](https://docs.privy.io/guide/server-wallets/authorization/signatures).
+
+When using authorization keys, you must provide the `authorizationPrivateKey` and `authorizationKeyId` parameters to the `configureWithWallet` method if you are creating a new wallet. Please note that when creating a key, if you enable "Create and modify wallets", you will be required to use that key when creating new wallets via the PrivyWalletProvider.
+
+#### Exporting Privy Wallet information
+
+The `PrivyWalletProvider` can export wallet information by calling the `exportWallet` method. 
+
+```typescript
+const walletData = await walletProvider.exportWallet();
+
+// walletData will be in the following format:
+{
+    walletId: string;
+    authorizationKey: string | undefined;
+    chainId: string | undefined;
+}
+```
+
+## SVM Wallet Providers
+
+SVM:
+- [SolanaKeypairWalletProvider](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers/solanaKeypairWalletProvider.ts)
+
+### SolanaKeypairWalletProvider
+
+The `SolanaKeypairWalletProvider` is a wallet provider that uses the API [Solana web3.js](https://solana-labs.github.io/solana-web3.js/).
+
+#### Solana Network Configuration
+
+The `SolanaKeypairWalletProvider` can be configured to use a specific network by passing the `networkId` parameter to the `fromNetwork` method. The `networkId` is the ID of the Solana network you want to use. Valid values are `solana-mainnet`, `solana-devnet` and `solana-testnet`.
+
+The default RPC endpoints for each network are as follows:
+- `solana-mainnet`: `https://api.mainnet-beta.solana.com`
+- `solana-devnet`: `https://api.devnet.solana.com`
+- `solana-testnet`: `https://api.testnet.solana.com`
+
+```typescript
+import { SOLANA_NETWORK_ID, SolanaKeypairWalletProvider } from "@coinbase/agentkit";
+
+// Configure Solana Keypair Wallet Provider
+const privateKey = process.env.SOLANA_PRIVATE_KEY;
+const network = process.env.NETWORK_ID as SOLANA_NETWORK_ID;
+const walletProvider = await SolanaKeypairWalletProvider.fromNetwork(network, privateKey);
+```
+
+#### RPC URL Configuration
+
+The `SolanaKeypairWalletProvider` can be configured to use a specific RPC url by passing the `rpcUrl` parameter to the `fromRpcUrl` method. The `rpcUrl` will determine the network you are using.
+
+```typescript
+import { SOLANA_NETWORK_ID, SolanaKeypairWalletProvider } from "@coinbase/agentkit";
+
+// Configure Solana Keypair Wallet Provider
+const privateKey = process.env.SOLANA_PRIVATE_KEY;
+const rpcUrl = process.env.SOLANA_RPC_URL;
+const walletProvider = await SolanaKeypairWalletProvider.fromRpcUrl(network, privateKey);
+```
+
 ## Contributing
 
 See [CONTRIBUTING.md](../../CONTRIBUTING.md) for more information.

package/dist/action-providers/alchemy/alchemyTokenPricesActionProvider.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { ActionProvider } from "../actionProvider";
+import { AlchemyTokenPricesBySymbolSchema, AlchemyTokenPricesByAddressSchema } from "./schemas";
+/**
+ * Configuration options for the AlchemyTokenPricesActionProvider.
+ */
+export interface AlchemyTokenPricesActionProviderConfig {
+    /**
+     * Alchemy API Key
+     */
+    apiKey?: string;
+}
+/**
+ * AlchemyTokenPricesActionProvider is an action provider for fetching token prices via the Alchemy Prices API.
+ * This provider enables querying current and historical token prices using symbols or addresses.
+ *
+ */
+export declare class AlchemyTokenPricesActionProvider extends ActionProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    /**
+     * Creates a new instance of AlchemyTokenPricesActionProvider
+     *
+     * @param config - Configuration options including the API key
+     */
+    constructor(config?: AlchemyTokenPricesActionProviderConfig);
+    /**
+     * Fetch current token prices for one or more token symbols.
+     *
+     * @param args - The arguments containing an array of token symbols.
+     * @returns A JSON string with the token prices or an error message.
+     */
+    tokenPricesBySymbol(args: z.infer<typeof AlchemyTokenPricesBySymbolSchema>): Promise<string>;
+    /**
+     * Fetch current token prices for one or more tokens identified by network and address pairs.
+     *
+     * @param args - The arguments containing an array of token network/address pairs.
+     * @returns A JSON string with the token prices or an error message.
+     */
+    tokenPricesByAddress(args: z.infer<typeof AlchemyTokenPricesByAddressSchema>): Promise<string>;
+    /**
+     * Checks if the Alchemy Prices action provider supports the given network.
+     * Since the API works with multiple networks, this always returns true.
+     *
+     * @returns Always returns true.
+     */
+    supportsNetwork(): boolean;
+}
+/**
+ * Factory function to create a new AlchemyTokenPricesActionProvider instance.
+ *
+ * @param config - The configuration options for the provider.
+ * @returns A new instance of AlchemyTokenPricesActionProvider.
+ */
+export declare const alchemyTokenPricesActionProvider: (config?: AlchemyTokenPricesActionProviderConfig) => AlchemyTokenPricesActionProvider;

package/dist/action-providers/alchemy/alchemyTokenPricesActionProvider.js

@@ -0,0 +1,173 @@
+"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.alchemyTokenPricesActionProvider = exports.AlchemyTokenPricesActionProvider = void 0;
+const zod_1 = require("zod");
+const actionProvider_1 = require("../actionProvider");
+const actionDecorator_1 = require("../actionDecorator");
+const schemas_1 = require("./schemas");
+/**
+ * AlchemyTokenPricesActionProvider is an action provider for fetching token prices via the Alchemy Prices API.
+ * This provider enables querying current and historical token prices using symbols or addresses.
+ *
+ */
+class AlchemyTokenPricesActionProvider extends actionProvider_1.ActionProvider {
+    /**
+     * Creates a new instance of AlchemyTokenPricesActionProvider
+     *
+     * @param config - Configuration options including the API key
+     */
+    constructor(config = {}) {
+        super("alchemyTokenPrices", []);
+        config.apiKey || (config.apiKey = process.env.ALCHEMY_API_KEY);
+        if (!config.apiKey) {
+            throw new Error("ALCHEMY_API_KEY is not configured.");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = "https://api.g.alchemy.com/prices/v1";
+    }
+    /**
+     * Fetch current token prices for one or more token symbols.
+     *
+     * @param args - The arguments containing an array of token symbols.
+     * @returns A JSON string with the token prices or an error message.
+     */
+    async tokenPricesBySymbol(args) {
+        try {
+            // Build query parameters: for each symbol add a separate query parameter
+            const params = new URLSearchParams();
+            for (const symbol of args.symbols) {
+                params.append("symbols", symbol);
+            }
+            const url = `${this.baseUrl}/${this.apiKey}/tokens/by-symbol?${params.toString()}`;
+            const response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    Accept: "application/json",
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            return `Successfully fetched token prices by symbol:\n${JSON.stringify(data, null, 2)}`;
+        }
+        catch (error) {
+            return `Error fetching token prices by symbol: ${error}`;
+        }
+    }
+    /**
+     * Fetch current token prices for one or more tokens identified by network and address pairs.
+     *
+     * @param args - The arguments containing an array of token network/address pairs.
+     * @returns A JSON string with the token prices or an error message.
+     */
+    async tokenPricesByAddress(args) {
+        try {
+            const url = `${this.baseUrl}/${this.apiKey}/tokens/by-address`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(args),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            return `Successfully fetched token prices by address:\n${JSON.stringify(data, null, 2)}`;
+        }
+        catch (error) {
+            return `Error fetching token prices by address: ${error}`;
+        }
+    }
+    /**
+     * Checks if the Alchemy Prices action provider supports the given network.
+     * Since the API works with multiple networks, this always returns true.
+     *
+     * @returns Always returns true.
+     */
+    supportsNetwork() {
+        return true;
+    }
+}
+exports.AlchemyTokenPricesActionProvider = AlchemyTokenPricesActionProvider;
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "token_prices_by_symbol",
+        description: `
+This tool will fetch current prices for one or more tokens using their symbols via the Alchemy Prices API.
+
+A successful response will return a JSON payload similar to:
+{
+  "data": [
+    {
+      "symbol": "ETH",
+      "prices": [
+        {
+          "currency": "usd",
+          "value": "2873.490923459",
+          "lastUpdatedAt": "2025-02-03T23:46:40Z"
+        }
+      ]
+    }
+  ]
+}
+
+A failure response will return an error message with details.
+    `,
+        schema: schemas_1.AlchemyTokenPricesBySymbolSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], AlchemyTokenPricesActionProvider.prototype, "tokenPricesBySymbol", null);
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "token_prices_by_address",
+        description: `
+This tool will fetch current prices for tokens using network and address pairs via the Alchemy Prices API.
+
+A successful response will return a JSON payload similar to:
+{
+  "data": [
+    {
+      "network": "eth-mainnet",
+      "address": "0xYourTokenAddress",
+      "prices": [
+        {
+          "currency": "usd",
+          "value": "1234.56",
+          "lastUpdatedAt": "2025-02-03T23:46:40Z"
+        }
+      ]
+    }
+  ]
+}
+
+A failure response will return an error message with details.
+    `,
+        schema: schemas_1.AlchemyTokenPricesByAddressSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], AlchemyTokenPricesActionProvider.prototype, "tokenPricesByAddress", null);
+/**
+ * Factory function to create a new AlchemyTokenPricesActionProvider instance.
+ *
+ * @param config - The configuration options for the provider.
+ * @returns A new instance of AlchemyTokenPricesActionProvider.
+ */
+const alchemyTokenPricesActionProvider = (config) => new AlchemyTokenPricesActionProvider(config);
+exports.alchemyTokenPricesActionProvider = alchemyTokenPricesActionProvider;

package/dist/action-providers/alchemy/alchemyTokenPricesActionProvider.test.d.ts

@@ -0,0 +1 @@
+export {};