evm-chains
EVM Chains
Targeted EVM chain dataset (chain name, chain ID, public RPCs, native currency symbol, default block explorer URL, RouteMesh support) and a router for reading on-chain data: resolve the chain, then dispatch balance, token, transfer, transaction, and first-funding queries to Etherscan (preferred) or Blockscout (fallback). For bridge transactions and cross-chain swaps, enrich explorer/RPC verification with Bungee status data only when the relevant chains are target chains.
Use this skill to resolve chain metadata before reading from an RPC, sending transactions, calling contracts, constructing chain-specific RPC URLs, or building explorer links to addresses, transactions, or blocks — and to query on-chain account data once the chain is resolved (see Querying On-Chain Data (Routing)). Also use it when the user mentions bridging, bridge tx, cross-chain swap, Bungee, or Socket, or when a transaction is inferred to be bridge-related.
Match chains by displayed name or numeric chain ID. ./references/target-mainnets.json is the skill's authoritative scope. If the requested chain is not listed there, do not use Etherscan, Blockscout, Bungee, RouteMesh, Chainlist, web search, or public RPCs to work around the scope. Ask the user to file a feature request in https://github.com/PaulRBerg/agent-skills.
Also normalize common code aliases from ./references/chain-aliases.json to their target mainnet rows.
Querying On-Chain Data (Routing)
To read account data — native balance, token holdings, ERC-20/721/1155 transfers, transaction history, or first-funding — resolve the chain, then dispatch to the right explorer API. Do not default to Ethereum; infer the chain from the prompt (explicit chain mention, chain-specific tokens like POL→137 / ARB→42161, target-chain aliases). If ambiguous, ask. If the resolved chain is not a target chain, ask for a feature request instead of querying.
- Resolve the chain — map the name or alias to a chain ID via
./references/target-mainnets.jsonand./references/chain-aliases.json. - Etherscan (preferred) — if the chain ID is listed in
./references/etherscan-chains.md, follow./references/etherscan-api.md(unified API V2, needs$ETHERSCAN_API_KEY). - Blockscout (fallback) — for target chains not served by Etherscan, or paid Etherscan chains on a free Etherscan plan, follow
./references/blockscout-api.md. - Neither — if the target chain is in neither registry, query the target chain's public RPC directly over JSON-RPC (
castfrom thecli-castskill, orcurl). If the chain is not a target chain, ask for a feature request instead of querying.