evm-atlas

EVM Atlas

This skill is coordination-exempt: skip the ai-coord gate for its declared work.

Resolve and query only the target mainnets in references/generated/target-mainnets.json, under a strict read-only boundary.

Before you collect browser UI evidence, load chromium-browser. Follow its page-ownership, live-tool, and privacy contract. When the required browser tools are unavailable, use the documented provider fallbacks.

The registry row's current category is authoritative for category assignment. For an exact-zero native sweep or a question about category-specific fee behavior, resolve the target before reading chain categories. Do not infer a historical category or maintain a prose roster of target chains.

Scope and Authority

• Match displayed names, numeric chain IDs, and aliases from references/generated/chain-aliases.json to the authoritative target-mainnet rows.
• Resolve a chain with scripts/chain-lookup.sh <name|alias|slug|chain_id> first. It prints key=value lines, or one compact row with --json. Never cat a generated JSON file or print the full routemesh chains list. For other queries, use a jq -c selector with named fields, such as jq -c '.chains[] | {chainId, category}'.
• If a chain is absent, do not route through another provider, web search, Chainlist, or an unlisted RPC to work around scope. Ask for a feature request at https://github.com/PaulRBerg/agent-skills.
• A target row with defunct identifies a chain its operator shut down. Its history is final through defunct.finalStateBlock. Later empty blocks or missing provider history are not coverage gaps. Without finalStateBlock, the chain may still accept exit transactions such as withdrawals. In that case, treat it as live. State the shutdown in the result.
• Own every discrete read and bounded live subscription handed off by cli-cast, including chain, block, fee, nonce, eth_call, eth_estimateGas, transaction, receipt, log, balance, code, storage, proof, and ENS queries. Complete the read here even when its result will prepare, simulate, or verify later state-changing work.
• Never sign messages, submit signatures, execute bridge steps, or broadcast transactions. Route state-changing Cast work to cli-cast.
• DEX support is historical and evidence-only. Do not discover live quotes, construct or simulate new trades, prepare approvals or permits, submit orders, administer protocols, interpret CoW AMM positions, handle standalone 1inch limit orders, or assign semantics to arbitrary Uniswap v4 hooks.
• Do not default to Ethereum. Infer from explicit chain context and unambiguous chain-specific tokens. If the chain is ambiguous, ask.
• Never echo, interpolate, or log API-key values (ETHERSCAN_API_KEY, BLOCKSCOUT_API_KEY, RPC keys). Check presence without printing values: [ -n "$ETHERSCAN_API_KEY" ] && echo set || echo unset. Never put ${VAR:-...} or ${VAR:+...} expansions in printed output.
• For Etherscan reads, use the official etherscan CLI with the resolved numeric --chain and --output json. Existing CLI authentication can use an environment key or saved login. Do not inspect credentials, pass --api-key, or run whoami, config, or login. CLI availability does not change provider priority or plan gates. Never call proxy eth_sendRawTransaction or submit contract verification through this read-only skill.
• Keyless Blockscout is sunset (July 2026). Hosted *.blockscout.com instance subdomains also rate-limit keyless traffic. Route every Blockscout-hosted chain through the keyed https://api.blockscout.com/{chain_id} gateway. See references/explorers/blockscout-endpoints.md.
• Every agent on the host shares DeBank's rate limit. Hold a scripts/debank-gate.py lease for any debank.com access, including a quick profile look. See the Global Queue in references/workflows/debank-portfolio.md.
• An unreachable or erroring indexer is a coverage gap, never evidence of zero activity. Confirm in Chromium before you record an endpoint as down or blocked. State the verification method in results.