T1 · Blockchain データとは何か

現実の問題

プロダクト担当から、あるアドレスが USDC を受け取ったら、利用者へ通知するという要件が来ました。

五分でできそうですが、文書を開くと最初の問いで迷います。「受け取った」をどこで読み取るべきでしょうか。

• 数秒ごとに残高を調べ、増えたら通知する？
• USDC コントラクトの Transfer イベントを監視する？
• 各ブロックの取引を取得し、一件ずつ解析する？
• 第三者の API を使う？

すべて demo は作れても、実際の動作は異なります。通知の欠落、重複、再編後に存在しない送金の通知などが起こります。

選択を誤る代償は性能ではなく正確性です。選ぶ前に、実際に保存されているものを理解します。

思考実験

チェーンを一つではなく、二つのものとして考えます。

一つ目は、追記しかできない流水台帳です。

一定間隔でブロックができ、取引が順番に入ります。後から変更も割込みもできません。台帳は行動だけを記録し、誰が何を呼び、どんな引数で、手数料はいくらかを示します。

二つ目は、流水台帳から導いた現在の状態表です。

各アカウントの残高や、コントラクトの各保存スロットの値です。表を直接書き込むのではなく、最初のブロックからすべての取引を順に実行した結果です。

では、一取引はどの状態を変えたのでしょうか。

流水台帳には直接は書かれていません。コントラクト A の transfer を、アドレス B と量 100 で呼んだと記録するだけです。何スロットが変わり、他のコントラクトが呼ばれたかは、実際に実行する必要があります。

そこで三つ目のログがあります。実行中にコントラクトが、B から C へ 100 を送ったと自ら知らせ、その声を取引レシートに残して外部へ伝えます。

あなたが決める

通知の要件に戻り、どれを選びますか。

結果を観察する

四つの選択肢は、オンチェーンデータを読んでいるつもりでも、実際には一層の投影を読んでいることを示します。

許容できる欠落で選びます。残高表示は状態、資金照合はトレース、通知と索引は Event が適します。

最も正確な層ではなく、要件に合う層を選びます。

モデルを作る

チェーンのデータを層に分けます。

Block                       ブロック：取引の容器
 ├─ header                  ヘッダー：親ハッシュ、高さ、時刻、状態ルート
 └─ transactions[]          本体：順序付きの取引
      └─ Transaction        取引：from、to、value、data、nonce、gas
           └─ Receipt       取引レシート：実行後に生成
                ├─ status   成功か失敗か
                ├─ gasUsed  実際の消費
                └─ logs[]   コントラクトのイベント
                     └─ Log  topics（索引可能）+ data（内容）

State                       状態：すべての取引の実行結果
 ├─ account balance         残高
 ├─ contract code           コントラクトのコード
 └─ contract storage        保存スロット

四つを覚えると、遠回りを減らせます。

1. Receipt は実行後に存在します。 ブロックに入っても成功とは限らず、status を確認します。送信を成功とするのはよくある bug です（T14）。
2. topics は索引可能で、data は違います。 アドレスと topics で効率的に絞れますが、通常のデータ項目ではできません。
3. State は現在だけです。 過去の高さにはアーカイブノードが必要で、費用の落とし穴になります（T4）。
4. Event は状態ではありません。 実際と異なるイベントも出せ、攻撃に使われたこともあります。状態を確認するには状態を読みます。

何と呼ぶか

実践

curl -s -X POST <あなたの-RPC-アドレス> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

curl -s -X POST <あなたの-RPC-アドレス> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["latest",true]}'

curl -s -X POST <あなたの-RPC-アドレス> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":["<取引ハッシュ>"]}'

curl -s -X POST <あなたの-RPC-アドレス> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getLogs","params":[{
        "fromBlock":"0x...","toBlock":"0x...",
        "address":"<トークンのコントラクトアドレス>",
        "topics":["<Transfer イベント署名のハッシュ>"]}]}'

AI Lab

第一段階：
Blockchain の State と Event の違いと、不一致が起こる理由を説明してください。

第二段階：
Transfer の監視だけでは誤った結論になる具体的な状況を三つ示してください。
各状況で、欠けるもの、結果、正しい方法を説明してください。

実例

変数を一つ変える

持ち帰る問い

章末チェック