nodeflare-agentkit
v0.2.0
Published
Coinbase AgentKit action provider for NodeFlare — read on-chain data across 23 EVM chains (incl. young chains like Robinhood, Plasma, Ink) through one provider, addressed by chain name. No per-chain RPC setup.
Maintainers
Readme
nodeflare-agentkit
A Coinbase AgentKit action provider that gives your on-chain agent read access to 23 EVM chains through one provider — Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, and young chains like Robinhood Chain, Plasma, Ink, Zircuit, BOB and Soneium that no other agent toolkit covers out of the box.
Unlike a wallet-bound provider, every action takes an explicit chain argument (slug, name, or chain ID), so an agent queries any supported chain without configuring 23 separate RPCs. Backed by NodeFlare's own bare-metal nodes; the public read tier needs no API key.
Install
npm install nodeflare-agentkitRequires @coinbase/agentkit, viem and zod (peer deps). Your tsconfig.json needs experimentalDecorators and emitDecoratorMetadata (AgentKit already requires these).
Usage
import { AgentKit } from "@coinbase/agentkit";
import { getVercelAITools } from "@coinbase/agentkit-vercel-ai-sdk";
import { nodeflareActionProvider } from "nodeflare-agentkit";
const agentKit = await AgentKit.from({
walletProvider, // your existing EvmWalletProvider
actionProviders: [nodeflareActionProvider()],
});
const tools = getVercelAITools(agentKit);
// generateText({ model, tools, prompt: "What's the gas price on Base and Ink right now?" })LangChain: import { getLangChainTools } from "@coinbase/agentkit-langchain" → await getLangChainTools(agentKit).
Actions
| Action | Description |
|---|---|
| get_supported_chains | The 23 chains, with chain IDs and native currencies |
| get_block_number | Latest block on any chain |
| get_native_balance | Native-token balance of an address (ETH, BNB, POL, SEI…) |
| get_erc20_balance | ERC-20 balance for a holder, human-readable |
| get_token_metadata | ERC-20 name, symbol, decimals, total supply |
| get_gas_price | Current gas price in gwei |
| get_transaction | Look up a transaction by hash |
| get_multichain_balances | Native + ERC-20 balances for one address across many of the 23 chains in one call (incl. young chains) |
Every action's chain argument accepts a slug (base), a name (ethereum, bsc), or a numeric chain ID (8453).
Notes
- Read-only. This provider does not send transactions or touch the agent's wallet — it reads public chain data through NodeFlare's gateway.
- Free public tier. Heavy methods (
eth_getLogs, trace) aren't exposed here; for those, use the NodeFlare MCP server with a free API key, or x402 pay-per-call. - Docs: nodeflare.app/agents
MIT
