plugin-nodeflare
v0.1.0
Published
ElizaOS plugin for NodeFlare — read on-chain data & agent-intelligence (balances, portfolio, token approvals, tx simulation, wallet reports, token safety) across 23 EVM chains, including young chains (Robinhood, Plasma, Ink, Zircuit) the big indexers skip
Maintainers
Readme
plugin-nodeflare
Read on-chain data and agent-intelligence across 23 EVM chains from your ElizaOS agent — including young chains (Robinhood, Plasma, Ink, Zircuit) the big indexers skip. Powered by NodeFlare.
Read-only. No wallet, no private key. Works out of the box on the free public tier; add an API key
for higher limits and heavy methods. Complements @elizaos/plugin-evm
(which signs & sends) — this plugin is the read/intelligence side.
Why
Most data providers cover the same dozen big chains and stop. NodeFlare runs its own nodes on 23 EVM chains and exposes higher-level agent-intelligence on top of raw RPC: know a wallet, screen a token, check approvals, pre-flight a transaction — in one call, over chains other tools leave as empty shells.
Install
npm install plugin-nodeflare
# or: elizaos plugins add plugin-nodeflareAdd it to your character/agent:
import { nodeflarePlugin } from "plugin-nodeflare";
export const character = {
name: "MyAgent",
plugins: [nodeflarePlugin],
// ...
};Configuration
Zero-config on the public tier. For higher rate limits and heavy methods (token discovery, deep token-safety, full approval scans), set an API key — get one free at nodeflare.app/sign-up:
NODEFLARE_API_KEY=nf_live_...The plugin reads it from runtime.getSetting("NODEFLARE_API_KEY") or the environment.
Actions (14)
Agent-intelligence
| Action | Does |
|---|---|
| NODEFLARE_WALLET_REPORT | Know any wallet: balances + USD total + approvals, in one call |
| NODEFLARE_TOKEN_SAFETY | Screen an ERC-20: ownership, risk signals, honeypot/rug score |
| NODEFLARE_BALANCES | Native + ERC-20 balances across chains (optional token discovery) |
| NODEFLARE_PORTFOLIO | USD portfolio value + per-chain breakdown |
| NODEFLARE_ALLOWANCES | Active token approvals / revoke-risk (flags unlimited) |
| NODEFLARE_SIMULATE_TX | Pre-flight a tx: revert reason, gas, asset changes |
RPC reads
| Action | Does |
|---|---|
| NODEFLARE_LIST_CHAINS | The 23 supported chains + IDs |
| NODEFLARE_BLOCK_NUMBER | Latest block on a chain |
| NODEFLARE_GAS_PRICE | Current gas price (gwei) |
| NODEFLARE_GET_TRANSACTION | Look up a tx by hash |
| NODEFLARE_NATIVE_BALANCE | Native-token balance of an address |
| NODEFLARE_ERC20_BALANCE | ERC-20 balance for a holder |
| NODEFLARE_TOKEN_METADATA | Name / symbol / decimals / supply |
| NODEFLARE_RPC_QUERY | Any read-only JSON-RPC method (send/sign are rejected) |
Example prompts
- "Give me a report on wallet
0xd8dA…." - "Is
0x…on Base a honeypot?" - "What approvals has
0x…granted — any unlimited?" - "Discover every token
0x…holds on Robinhood Chain." - "Simulate calling
0x…with data0x…on Base — will it revert?" - "What's the latest block on Sonic?"
Supported chains (23)
Ethereum · Base · BNB Chain · Arbitrum One · Optimism · HyperEVM · Avalanche · Unichain · Sonic · Polygon · Linea · Mantle · Zircuit · Robinhood · XLayer · Soneium · Arbitrum Nova · BOB · Ink · Cronos · Mode · Sei · Plasma
Address a chain by slug, name, or numeric chain ID.
Safety
Every action is read-only — nothing signs or broadcasts. NODEFLARE_SIMULATE_TX only simulates;
NODEFLARE_RPC_QUERY rejects eth_sendRawTransaction / eth_sign* / personal_*. The plugin never
holds keys and only takes public on-chain identifiers as input.
Links
- Docs: nodeflare.app/agents
- Free API key: nodeflare.app/sign-up
- Also available as an MCP server and a Coinbase AgentKit provider
License
MIT
