T4 · RPC とは何か

現実の問題

ローカルで正常だった DApp が、公開から三日目におかしくなります。

• ページを開くと残高が 0 で、何度か更新すると正しくなるユーザーがいます。
• 取引履歴が数件抜け、翌日には戻るユーザーがいます。
• 自分で試すと正常です。

ログには大量の 429、その下にはタイムアウト、さらに五分前より小さいブロック高が返った記録があります。

ここで気づきます。**自分のコードは、一度もチェーンそのものに触れていません。**触れたのは HTTP エンドポイントです。自分で書かず、配置せず、監視せず、障害時にもログを見られないサービスです。

その奥には誰がいるのでしょう。なぜデータを返せるのでしょう。いつ返さなくなるのでしょう。誤ったデータを返したら、どう気づけるでしょう。

思考実験

読み取り専用のデータベースレプリカからデータを得る帳票システムを作るとします。このレプリカには五つの特徴があります。

1. **速度制限があります。**一定の毎秒クエリ数を超えると拒否され、クエリの「重さ」も違います。一行の取得と一千万行の走査では、消費枠が数百倍違います。
2. **遅れることがあります。**主データベースへの書き込み後、同期完了時刻は保証されません。二度目の問い合わせが別のマシンへ振り分けられ、最初より古い結果になることもあります。
3. 履歴がないことがあります。ディスク節約のため最近のデータしか保持せず、古いデータには空の結果ではなく意味の分からないエラーを返します。
4. **偽のデータを返せます。**それを防ぐ仕組みはありません。受け取った JSON 自体から正しさを判断できません。
5. **自分の管理下にありません。**停止すれば待つしかありません。

自分に問いかけてください。この五つを前提に、信頼できる帳票システムを作れますか？

作れます。ただし構成で五つを明示的に扱います。速度制限にはバックオフとキュー、遅延には単調性の検証、履歴不足には境界の把握、偽データには相互検証、管理外の障害には代替ソースが必要です。

この五つが、この章の全内容です。

「読み取り専用レプリカ」を「RPC エンドポイント」に置き換えても、すべて成り立ちます。違いは一つだけです。データベースは少なくとも自社のものですが、このエンドポイントは違います。

あなたが決める

公開間近の製品に使う RPC の構成を選びます。

結果を観察する

四つの選択肢の違いを、五つの軸にまとめます。

五つのうち、お金で解決できないのは「信頼」だけです。

ほかの四つは取捨選択です。利用枠やアーカイブに払うか、自前運用に人を使うかです。ただし「この JSON が本物とどう分かるか」は、いくら払っても同じです。自分で検証しなければ分かりません。

RPC を理解する最も重要な一文です。**第三者 RPC を使うことは、返されたデータを信頼することです。**製品の分散性の上限は、接続した時点でそのエンドポイントに制約されます。

モデルを作る

一回の呼び出しが実際に通る経路：

製品の上限を決める三つの軸：

一、速度制限。毎秒のリクエスト数ではなく、計算量の枠として理解します。残高一件の読み取りと百万ブロック分のログ走査では消費量が数百倍違う場合があります。使用量の曲線はユーザー数よりも呼ぶメソッドで決まります。

最初の最適化は、ログ範囲を狭め、バッチをまとめ、不変データをキャッシュすることです。T15 でキャッシュ層を扱います。

**二、データの深さ。**ノードは三種あります。最近の状態だけを保存するもの（大多数）、全ブロックを保存するが状態を刈り込むもの、各過去ブロック高の完全な状態を保持するアーカイブノードです。

古い高さの残高やストレージを最初の二種に聞くと、空ではなくエラーになります。このエラーは通常「履歴がない」とは見えません。初めて見る人はパラメータを間違えたと思いがちです。

**三、一貫性。**同時刻でも二つのインスタンスの最新高は違い得て、チェーン先端は再編成されます。つまり次の二点があります。

• 同じ論理リクエストを二度送ると、二度目が古い状態を読むことがあります。
• 「最新」として読んだデータが、数秒後には存在しないことがあります。

対処は毎回「最新」を使わず、明確なブロックタグを使うことです。

**実務上の規則は、二度実行して同じ結果が必要な処理では latest ではなく高さを固定することです。**特に索引器が該当します。latest を使う索引器は再実行できず、障害の再現もできません。

自社ラッパーに必要な機能：

最後の二つが「複数バックエンド」と「高可用性」を分けます。最初の四つだけなら負荷分散、最後の二つが加われば信頼しないことを扱っています。

何と呼ぶか

実践

for i in $(seq 1 10); do
  curl -s -o /dev/null -w '%{time_total}\n' -X POST <エンドポイント A> \
    -H 'content-type: application/json' \
    -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
done

curl -s -X POST <エンドポイント A> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance",
       "params":["<活動中の任意アドレス>","0x<かなり古いブロック高>"]}'

curl -s -X POST <エンドポイント A> \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getLogs","params":[{
        "fromBlock":"0x...","toBlock":"0x...",
        "address":"<活動中のトークンコントラクトのアドレス>"}]}'

AI Lab

第一段階：
RPC Provider ラッパーを書いてください。
複数のバックエンド、タイムアウト、指数バックオフ付きリトライ、
メソッド別ルーティング（アーカイブ用は指定先）、サーキットブレーカーが必要です。
指定した言語を使い、指定していない第三者ライブラリは使わないでください。

第二段階：
このラッパーを再実行可能な索引器に使うと仮定します。
上の実装が「正常に見えるが一貫しない」結果を返す条件を一つずつ指摘し、
それぞれの修正案を示してください。

実例

変数を一つ変える

持ち帰る問い

章末チェック