Skip to content

Add NodeFlare action provider - #1366

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

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

Conversation

@nodeflareapp

@nodeflareapp nodeflareapp commented Jul 16, 2026 •

Copy link
Copy Markdown

Description

Adds a NodeFlare action provider that gives an agent read access to on-chain data across 17 EVM chains through NodeFlare's public RPC gateway — Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, and young chains like Robinhood Chain, 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

cb-heimdall commented Jul 16, 2026 •

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 0
1 if authored by an app that is not allowlisted and lacks verified human attribution 0
Sum 1

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jul 16, 2026
@nodeflareapp

Copy link
Copy Markdown
Author

Updated the chain list to the 17 chains NodeFlare serves today: Linea, Mantle, Arbitrum Nova, Cronos, Sei and Plasma are no longer served and were removed from the provider, README and changeset.

This branch has not been deployed

No deployments
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