失敗したトランザクションのデバッグワークフロー (cast)

言語ルール

• ユーザーが使用している言語と常に同じ言語で応答してください。 ユーザーが中国語で質問した場合は中国語で、英語で質問した場合は英語で応答してください。

ステップ 1: トランザクションレシートの取得 — 成功/失敗の判断

source .env
cast receipt <tx_hash> --rpc-url $RPC_URL

注目フィールド:

ステップ 2: トランザクション詳細の取得 — gas limit と input の取得

cast tx <tx_hash> --rpc-url $RPC_URL

注目フィールド:

ステップ 3: 失敗タイプの判断 — gasUsed vs gas limit

ステップ 4: 関数セレクターのデコード — どの関数が呼び出されたかを確認

# input の最初の 4 バイトから関数シグネチャを検索
cast 4byte 0xb51a038a
# 出力例: unstake(uint256,address[],uint256[])

ステップ 5: 完全な calldata のデコード — 呼び出しパラメーターの復元

# ステップ 4 で得られた関数シグネチャを使用してデコード
cast calldata-decode "unstake(uint256,address[],uint256[])" <完全なinput_data>

デコードされたパラメーターは以下に使用できます:

• 入力パラメーターに誤りがないか分析する
• トランザクションの再試行に直接使用する

ステップ 6: Revert Reason の取得（OOG 以外のシナリオ）

# 方法 A: cast call シミュレーション（失敗したブロック番号を指定し、トランザクションが存在するブロックを使用）
cast call <to> <input_data> \
  --from <from> \
  --block-number <block_number> \
  --rpc-url $RPC_URL

# 方法 B: cast run でトランザクションをリプレイ（アーカイブノードが必要）
cast run <tx_hash> --rpc-url <archive_rpc_url>

# 方法 C: オンラインツール（予備）
# Tenderly や Blocksec Phalcon などのトランザクション分析プラットフォームを使用

ステップ 7: オンチェーン状態のクエリ — トランザクション失敗後のデータがロールバックされたことを確認

# public 変数/マッピングをクエリ
cast call <contract> "orderLocations(uint256)(address,uint256,bool)" <id> --rpc-url $RPC_URL

# struct フィールドをクエリ（ABI の順序で戻り値を指定）
cast call <contract> "userStakeRecord(address,uint256)(uint40,uint160,bool,uint8,uint256)" <user> <index> --rpc-url $RPC_URL

失敗したトランザクションの状態変更は完全にロールバックされます。データが元の状態にあることを確認する必要があります。

ステップ 8: 成功したトランザクションと失敗したトランザクションの比較 — 差異の特定

成功したトランザクションと失敗したトランザクションを並べて比較します:

ステップ 9: トランザクションの再試行

source .env

# gas limit を指定しない（ノードに自動見積もりさせる、推奨）
cast send <contract> "functionName(uint256,address[],uint256[])" <arg1> "[<addr1>,<addr2>]" "[<amt1>,<amt2>]" \
  --account <KEYSTORE_NAME> \
  --rpc-url $RPC_URL \
  --legacy

# 高い gas limit を指定する（消費範囲が既知のシナリオに適用）
cast send <contract> "functionName(uint256)" <arg1> \
  --account <KEYSTORE_NAME> \
  --rpc-url $RPC_URL \
  --gas-limit 2000000 \
  --legacy

セキュリティに関する注意事項

完全なサンプルプロセス

source .env

# 1. レシートを確認
cast receipt 0x4ca1...414f --rpc-url $RPC_URL

# 2. トランザクション詳細を確認
cast tx 0x4ca1...414f --rpc-url $RPC_URL

# 3. gas=1000000, gasUsed=999472, status=0 → OOG であることを発見

# 4. 関数セレクターをデコード
cast 4byte 0xb51a038a
# → unstake(uint256,address[],uint256[])

# 5. 完全なパラメーターをデコード
cast calldata-decode "unstake(uint256,address[],uint256[])" 0xb51a038a...

# 6. シミュレーションで通過することを確認
cast call <contract> "unstake(uint256,address[],uint256[])" 35 "[addr1,addr2]" "[amt1,amt2]" \
  --from <from> --rpc-url $RPC_URL

# 7. オンチェーン状態をクエリして、注文がまだ処理されていないことを確認
cast call <contract> "orderLocations(uint256)(address,uint256,bool)" 35 --rpc-url $RPC_URL

# 8. OOG であることを確認 → gas を制限せずに再試行
cast send <contract> "unstake(uint256,address[],uint256[])" 35 "[addr1,addr2]" "[amt1,amt2]" \
  --account <KEYSTORE_NAME> --rpc-url $RPC_URL --legacy

# 9. 成功を確認
cast receipt <new_tx_hash> --rpc-url $RPC_URL