Skip to content

Add NodeFlare action provider#1366

Open
nodeflareapp wants to merge 12 commits into
coinbase:mainfrom
Nodeflare-app:add-nodeflare-action-provider
Open

Add NodeFlare action provider#1366
nodeflareapp wants to merge 12 commits into
coinbase:mainfrom
Nodeflare-app:add-nodeflare-action-provider

Conversation

@nodeflareapp

Copy link
Copy Markdown

Description

Adds a NodeFlare action provider that gives an agent read access to on-chain data across 23 EVM chains through NodeFlare's public RPC gateway — Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, and young chains like Robinhood Chain, Plasma, Ink, Zircuit, BOB and Soneium.

Unlike a wallet-bound provider, every action takes an explicit chain argument (slug, common name, or numeric chain ID), so an agent can query any supported chain without configuring a separate RPC per chain. All actions are read-only and keyless (free public tier), and the injected wallet provider is not used — supportsNetwork returns true.

Structure and conventions follow the existing alchemy action provider (schemas in schemas.ts, string-returning actions, Jest tests, README).

Actions

  • get_supported_chains — list the chains, with chain IDs and native currencies
  • get_block_number — latest block on a chain
  • get_native_balance — native gas-token balance of an address
  • 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

Multi-read actions batch their eth_calls into a single JSON-RPC request to stay within the public rate limit.

Tests

Added nodeflareActionProvider.test.ts (Jest, mocked fetch) covering supportsNetwork, chain resolution (name + numeric ID), a successful native-balance/gas read, and gateway-error handling.

Checklist

  • New action provider under src/action-providers/nodeflare/
  • Registered in src/action-providers/index.ts
  • Unit tests
  • README
  • Changeset

@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants