evm-atlas

EVM Atlas

このスキルは調整対象外です。宣言された作業では ai-coord ゲートをスキップしてください。

厳格な読み取り専用の境界のもと、references/generated/target-mainnets.json に記載された対象のメインネットのみを解決して照会してください。

ブラウザーの UI 証拠を収集する前に、chromium-browser を読み込んでください。そのページの所有権、ライブツール、プライバシーに関する契約に従ってください。必要なブラウザーツールを利用できない場合は、文書化されているプロバイダーのフォールバックを使用してください。

カテゴリの割り当てでは、レジストリ行の現在の category を正とします。ネイティブトークンを厳密にゼロまでスイープする場合や、カテゴリ固有の手数料動作に関する質問では、チェーンカテゴリを読む前に対象を解決してください。過去のカテゴリを推測したり、対象チェーンの一覧を文章で管理したりしないでください。

対象範囲と権限

• references/generated/chain-aliases.json の表示名、数値のチェーン ID、別名を、権威あるターゲットメインネットの行と照合します。
• まず scripts/chain-lookup.sh <name|alias|slug|chain_id> でチェーンを解決します。このコマンドは key=value 形式の行、または --json を指定した場合は簡潔な 1 行を出力します。生成された JSON ファイルを cat したり、routemesh chains の一覧全体を出力したりしないでください。それ以外のクエリには、jq -c '.chains[] | {chainId, category}' のように、名前付きフィールドを指定したセレクターを使用します。
• チェーンが見つからない場合は、対象範囲を回避するために別のプロバイダー、ウェブ検索、Chainlist、または未掲載の RPC を経由しないでください。https://github.com/PaulRBerg/agent-skills で機能リクエストを依頼してください。
• ターゲットの行に defunct がある場合、そのチェーンは運営者によって停止されています。その履歴は defunct.finalStateBlock までで確定しています。それ以降の空ブロックやプロバイダー履歴の欠落は、カバレッジの欠落ではありません。finalStateBlock がない場合、チェーンは引き出しなどの退出トランザクションを引き続き受け付ける可能性があります。その場合は稼働中として扱います。結果には停止済みであることを明記してください。
• cli-cast から引き継いだ、チェーン、ブロック、手数料、ノンス、eth_call、eth_estimateGas、トランザクション、レシート、ログ、残高、コード、ストレージ、証明、ENS クエリなど、個別の読み取りと範囲を限定したライブサブスクリプションはすべて担当します。後続の状態変更作業の準備、シミュレーション、検証に使う結果であっても、ここで読み取りを完了してください。
• メッセージへの署名、署名の送信、ブリッジ手順の実行、トランザクションのブロードキャストは決して行わないでください。状態を変更する Cast の作業は cli-cast に回してください。
• DEX のサポートは履歴の確認に限られ、証拠の提示のみを目的とします。ライブクォートの取得、新しい取引の構築やシミュレーション、承認やパーミットの準備、注文の送信、プロトコルの管理、CoW AMM ポジションの解釈、単独の 1inch 指値注文の処理、任意の Uniswap v4 フックへの意味付けは行わないでください。
• Ethereum をデフォルトとして選ばないでください。明示されたチェーンの文脈と、チェーン固有で曖昧さのないトークンから判断してください。チェーンが曖昧な場合は確認してください。
• API キーの値（ETHERSCAN_API_KEY、BLOCKSCOUT_API_KEY、RPC キー）を表示、展開、記録しないでください。値を出力せずに設定の有無を確認します：[ -n "$ETHERSCAN_API_KEY" ] && echo set || echo unset。出力する内容に ${VAR:-...} や ${VAR:+...} の展開を決して含めないでください。
• Etherscan の読み取りには、解決済みの数値を --chain に指定し、--output json を付けて公式の etherscan CLI を使用します。既存の CLI 認証では、環境変数のキーまたは保存済みのログイン情報を使用できます。認証情報を調べたり、--api-key を渡したり、whoami、config、login を実行したりしないでください。CLI を利用できても、プロバイダーの優先順位やプランの制限は変わりません。この読み取り専用スキルから proxy eth_sendRawTransaction を呼び出したり、コントラクトの検証を送信したりしないでください。
• キー不要の Blockscout は 2026 年 7 月に終了しています。ホスト型の *.blockscout.com インスタンスのサブドメインも、キー不要のトラフィックにレート制限を設けています。Blockscout がホストするチェーンはすべて、キー付きの https://api.blockscout.com/{chain_id} ゲートウェイ経由にしてください。references/explorers/blockscout-endpoints.md を参照してください。
• ホスト上のすべてのエージェントで、DeBank のレート制限を共有します。簡単なプロフィールの確認を含め、debank.com にアクセスする際は必ず scripts/debank-gate.py のリースを保持してください。references/workflows/debank-portfolio.md のグローバルキューを参照してください。
• インデクサーに接続できない場合やエラーが発生する場合は、アクティビティがゼロである証拠ではなく、カバレッジの欠落として扱います。エンドポイントを停止中またはブロック中と記録する前に、Chromium で確認してください。結果には検証方法を明記してください。

ルーティング

1. cli-cast から引き継いだものも含め、個別の JSON-RPC 読み取り、バッチ処理、または範囲を限定したライブサブスクリプションでは、scripts/chain-lookup.sh でチェーンを解決します。次に references/workflows/provider-routing.md を読みます。解決したチェーン、その現在のカテゴリ、プロバイダールート、結果、観測したブロックまたはチェックポイント、およびカバレッジの不足を返します。読み取りを cli-cast に戻してはなりません。

2. 複数チェーンにまたがる公開ウォレットアドレスの現在のネイティブ残高、ファンジブルトークン残高、または DeFi ポジションについては、まず references/workflows/debank-portfolio.md を読みます。特定のチェーンについては、まず references/workflows/blockscan-balances.md を読みます。

3. 対象チェーンにおける1つ以上のアドレスの現在の USD 価値（ポートフォリオ価値、純資産、資産流出またはダストの確認）については、references/workflows/address-usd-value.md を読みます。

4. 特定チェーン上のトランザクションハッシュについては、scripts/chain-lookup.sh でチェーンを解決します。次に、トランザクションの事実を確認するため、references/workflows/provider-routing.md を直接読みます。ユーザーが証拠ソースとして明示的に要求しない限り、Blockscan を開いてはなりません。チェーンが不明な場合は、references/workflows/blockscan-tx-lookup.md を一度読んで解決します。

   対象が最終 regenesis より前であることが判明している、またはその疑いがある OP Mainnet の場合は、references/explorers/optimism-pre-regenesis.md を読みます。その場合、現在のプロバイダーのレシートを必須とする代わりに、レガシー実行パケットまたはコンポーネント固有のカバレッジ結果を返します。それ以外の場合は、DEX またはブリッジの結果を解釈する前に、正確なプロバイダーのレシートとログを取得します。

5. アドレス全体の履歴アクティビティまたは bootstrap-discovery のスイープについては、references/workflows/address-sweeps.md を読みます。決定論的な plan/evaluate ヘルパーを使用します。現在の保有資産については、まず references/workflows/debank-portfolio.md を読み、不足分はプロバイダールーティングで補います。

6. 特定チェーンの過去の残高、NFT 保有状況、トークン/NFT の送金、トランザクション履歴、トランザクションの全 raw receipt/logs/decoded input、または資金の出所については、scripts/chain-lookup.sh でチェーンを解決します。次に、Etherscan、Blockscout、公開 RPC、RouteMesh、エクスプローラーリンク、および例外的なチェーンのルーティングについて、references/workflows/provider-routing.md を読みます。

7. 上記のワークフロールート以外で Etherscan CLI の読み取りを行う場合は、references/explorers/etherscan-api.md を読みます。これには CLI 1.1.1 の出力、手動ページング、プランのゲート、直接 API の例外が定義されています。ENS のフォワード解決は、Ethereum mainnet のオンチェーン名に対する直接 API の例外として引き続き扱います。キャッシュとリゾルバーの制限を適用します。

8. 上記のワークフロールート以外で raw Blockscout API クエリを行う場合は、references/explorers/blockscout-api.md を読みます。

9. DEX に関するプロンプト、ウォレット利用者向けの DEX 履歴、または DEX トランザクションの証拠が疑われる場合は、対象チェーンを解決し、references/workflows/dex-transactions.md を読みます。一致するプロトコルファミリーのリファレンスのみを読み込みます。

   • Uniswap v1-v4、Universal Router、または Permit2：references/dexes/uniswap.md
   • 1inch Classic、Fusion、Fusion+、legacy liquidity、または rewards：references/dexes/1inch.md
   • CoW Swap、CoWSwap、CoW Protocol、または GPv2：references/dexes/cow-protocol.md

10. 1inch と CoW は実行プロトコルとして扱います。統合ラッパー、ルーター、プール、および基盤となる AMM 流動性は、それぞれ分けて報告します。Uniswap プールとのやり取りがあっても、アグリゲーターのトランザクションが Uniswap の取引に変わるわけではありません。

11. ブリッジに関するプロンプトまたはトランザクションの証拠については、判明している送信元チェーンと宛先チェーンが対象であることを確認します。その後、一致するリファレンスのみを読み込みます。

    • Arbitrum One/Nova の正規ブリッジによる出金：references/bridges/arbitrum.md
    • Across：references/bridges/across.md
    • Bungee / Socket：references/bridges/bungee.md
    • Circle / CCTP / Gateway：references/bridges/circle.md
    • deBridge / DLN：references/bridges/debridge.md
    • Gas.zip：references/bridges/gaszip.md
    • Hop：references/bridges/hop.md
    • Layerswap：references/bridges/layerswap.md
    • LayerZero / Stargate / OFT / Aori：references/bridges/layerzero.md
    • LI.FI：references/bridges/lifi.md
    • Relay / Relay.link：references/bridges/relay.md
    • Symbiosis：references/bridges/symbiosis.md
    • 1inch Fusion+：references/dexes/1inch.md

12. ブリッジおよび DEX の API は情報の補強として扱います。送信されたトランザクションと最終的な結果は、エクスプローラーまたは RPC の証拠で検証してください。

完了

解決済みの対象チェーン、現在のカテゴリ、プロバイダールート、要求されたオンチェーン情報、ソース URL／トランザクション識別子を返します。アドレスの一括調査では、各結果の固定された最終確定／検証済みチェックポイント、選択したプロファイル／チャネル、プロバイダーのカバレッジ、要求されたクォーラム結果を含めてください。プロバイダーから得られた事実と推論は分けてください。履歴の欠落、プラン／ティアの制限、フォールバックの失敗、未対応の範囲を報告してください。完了時に提供するのは読み取り専用の証拠です。返された calldata やトランザクションリクエストを実行に移してはいけません。

cli-cast への引き継ぎでは、次のフィールドを含む読み取り用パケットを 1 つ返してください。

• 解決済みのチェーン名、ID、現在のカテゴリ。
• 正確なプロバイダールート。
• 結果。
• 観測されたブロックまたはチェックポイント。
• カバレッジの欠落。観測されなかった場合は空でもかまいません。

署名またはブロードキャストのコマンドは含めないでください。

DEX の証拠には、次のフィールドを含めてください。

• インタラクションの分類。
• 実行プロトコル、バージョン、モード。
• エントリーポイントまたはインテグレーションラッパー。
• ルーターと基盤となる流動性ソース。
• ウォレットの役割。
• 売却資産と受取資産。
• プロトコル手数料／インテグレーター手数料とガス代（別々に記載）。
• ネイティブ／ラップ済みの状態。
• オーダー、ポジション、プール、または移行の識別子。
• 正確な証拠。

承認のみのトランザクションや失敗したトランザクションを、完了した取引として扱わないでください。

人が読みやすい結果では、### ⛓️ <chain or route> — <status word> で始めてください。フィールドが繰り返される場合に限り、簡潔な表を使用してください。

ブリッジの証拠では、<origin> ──<bridge>──▶ <destination> を示してください。続いて、Leg、Provider status、Transaction、Evidence の列を使用してください。各プロバイダー固有のステータスは、正規化した ✅ completed、⏳ pending、↩ refunded、⚠️ partial、❓ unknown のラベルと並べて保持してください。Observed facts、Inference、空でない ⚠️ Coverage gaps は、見分けがつくよう明確に分けてください。

アドレスの一括調査では、正確な分母が分かっている場合に限り、確認済みの対象チェーン／チャネルをプログレスバーで示してかまいません。

未対応の範囲や安全性に関する説明は、簡潔かつ直接的にしてください。アドレス、ハッシュ、URL、calldata、生の RPC／API JSON、生成された参照、ヘルパーの key=value 出力、トランザクションリクエストに装飾を加えたり、省略したりしてはいけません。