Ethereum読み取り専用アクセス

Foundryのcastコマンドを使用してウォレットなしでEthereumブロックチェーンの状態を読み取る方法。ブロック情報、コントラクト状態、イベントログ、ENS解決の実装ガイドです。

セットアップ

Foundryインストール

# Foundryインストール
curl -L https://foundry.paradigm.xyz | bash
foundryup

# 動作確認
cast --version

RPC設定

# 環境変数設定（~/.bashrc または ~/.zshrc）
export ETH_RPC_URL="https://eth-mainnet.alchemyapi.io/v2/YOUR-API-KEY"
export POLYGON_RPC_URL="https://polygon-mainnet.g.alchemy.com/v2/YOUR-API-KEY"
export ARB_RPC_URL="https://arb-mainnet.g.alchemy.com/v2/YOUR-API-KEY"

# 無料RPCの使用（レート制限あり）
export ETH_RPC_URL="https://rpc.ankr.com/eth"
export POLYGON_RPC_URL="https://rpc.ankr.com/polygon"

# 設定確認
cast client --rpc-url $ETH_RPC_URL

ブロック情報取得

基本的なブロック検査

#!/bin/bash
# block-inspector.sh

# 最新ブロック番号取得
get_latest_block() {
    echo "最新ブロック番号:"
    cast block-number --rpc-url $ETH_RPC_URL
}

# ブロック基本情報
inspect_block() {
    local block_number="$1"
    
    echo "=== ブロック $block_number 基本情報 ==="
    cast block "$block_number" --rpc-url $ETH_RPC_URL
}

# トランザクション込みの詳細ブロック情報
inspect_block_full() {
    local block_number="$1"
    
    echo "=== ブロック $block_number 詳細情報（トランザクション含む）==="
    cast block "$block_number" --full --rpc-url $ETH_RPC_URL
}

# ブロック統計
block_stats() {
    local block_number="$1"
    
    echo "=== ブロック $block_number 統計 ==="
    
    # トランザクション数
    local tx_count="$(cast block "$block_number" --rpc-url $ETH_RPC_URL | jq -r '.transactions | length')"
    echo "トランザクション数: $tx_count"
    
    # ガス使用量
    local gas_used="$(cast block "$block_number" --rpc-url $ETH_RPC_URL | jq -r '.gasUsed')"
    echo "ガス使用量: $gas_used"
    
    # タイムスタンプ
    local timestamp="$(cast block "$block_number" --rpc-url $ETH_RPC_URL | jq -r '.timestamp')"
    echo "ブロック時刻: $(date -d @$((timestamp)) +'%Y-%m-%d %H:%M:%S')"
}

# 使用例
get_latest_block
inspect_block "latest"
block_stats "latest"

ブロック範囲分析

# block-range-analyzer.sh

analyze_block_range() {
    local start_block="$1"
    local end_block="$2"
    
    echo "=== ブロック範囲分析: $start_block - $end_block ==="
    
    local total_tx=0
    local total_gas=0
    
    for ((block=$start_block; block<=$end_block; block++)); do
        echo "ブロック $block を処理中..."
        
        local block_data="$(cast block "$block" --rpc-url $ETH_RPC_URL)"
        local tx_count="$(echo "$block_data" | jq -r '.transactions | length')"
        local gas_used="$(echo "$block_data" | jq -r '.gasUsed')"
        
        total_tx=$((total_tx + tx_count))
        total_gas=$((total_gas + gas_used))
        
        echo "  TX: $tx_count, Gas: $gas_used"
    done
    
    echo ""
    echo "=== サマリー ==="
    echo "総トランザクション数: $total_tx"
    echo "総ガス使用量: $total_gas"
    echo "平均TX/ブロック: $((total_tx / (end_block - start_block + 1)))"
}

# 使用例
analyze_block_range 19000000 19000010

コントラクト状態読み取り

基本的なコントラクト呼び出し

#!/bin/bash
# contract-reader.sh