SIPO は 11 月 20 日から 21 日にかけて、運営する Cardano のリレーをすべて「Genesis モード」に切り替え、あわせて cardano-node を 11.1.3 に上げました。ブロック生成ノードは、ノードの版だけを上げ、同期の方式は従来のままにしています。切り替えのあいだも、ブロックの生成は止めていません。
きっかけは、Cardano Foundation が 11 月に SPO 向けのメールで、Genesis モードへの切り替えをあらためて呼びかけたことです。メールは、今ある bootstrap ノードは次のハードフォークのあとには使えなくなると考えておくよう求めています。単なる設定の変更ではなく、ノードがネットワークに加わるときの「最初の手がかり」を、少数の決まったノードからネットワーク全体へ移す変化です。SIPO が実際に切り替えて分かったことを、これから切り替える SPO の方に向けてまとめます。
Genesis モードは「同期の出発点」を変える
ノードを新しく立ち上げたり、データを作り直したりするとき、ノードはチェーンの最初から追いつく必要があります。このとき、偽のチェーンをつかまされないことが大切です。
これまでの方式(Praos モード)では、その出発点として、IOG や Cardano Foundation などが運営する少数の「bootstrap ノード」を信頼して同期していました。Genesis モード(Ouroboros Genesis)は、この特定のノードへの信頼をなくし、チェーンに登録された大きなステークプール群の一覧(peer snapshot)を手がかりに、多くのプールと照らし合わせながら追いつく仕組みです。
ここが本筋です。bootstrap ノードがなくなると、Praos モードのままのノードは、最初から同期し直すときの出発点を失います。ふだんの運用はすぐには止まりませんが、データの作り直しや新しい台の構築のときに困ることになります。
公式の設定は切り替わり、ツールの既定はまだ旧方式
切り替えの前に、各所の「既定」がどうなっているかを一次ソースで確かめました。11 月 21 日時点で、次のように分かれています。
- 公式に配布されている mainnet の設定(book.play.dev.cardano.org)は、すでに Genesis モードが既定です。topology にも peer snapshot の指定が入っています
- その配布元(iohk-nix)にも、mainnet の既定を Genesis モードに変える変更が入っています
- cardano-node の最新の正式リリース 11.1.3 に同梱の mainnet の設定は、まだ Praos モードです。Genesis モードが既定なのは、試験版(プレリリース)の 11.2.1 の設定からです
- SPO のあいだで広く使われている構築ツール Guild Operators の mainnet の設定は、master も alpha も Praos モードのままです
- Cardano の開発者ポータルのトポロジーの解説は、今も Praos モードを推奨とし、Genesis モードを試験的な機能として扱っています
つまり、公式の配布物を取り込んでいるノードは自然に Genesis モードへ移りますが、ツールで構築したノードは、自分で切り替えない限り旧方式のままです。どちらで動いているかは、ノードの設定ファイル(config.json)の ConsensusMode の 1 行で確かめられます。
期限は「次のハードフォーク用のノードを入れるとき」
では、いつまでに切り替えればよいのでしょうか。cardano-node 10.6.0 のリリースノートは、Genesis モードを mainnet では「任意」としたうえで、SPO に対し、ブロックを作らないリレーの少なくとも 1 台を Genesis モードで動かすことを推奨しています。さらに、Genesis モードが mainnet の既定になったら peer snapshot の指定が必須になり、指定がないとノードが起動しなくなると予告しています。
実務上の期限は、次のハードフォーク(Dijkstra)に対応したノードへ上げるときだと SIPO は読んでいます。その版の同梱の設定は Genesis モードを前提にしていて、準備のないリレーは起動できなくなるおそれがあるためです。SIPO が確かめた範囲では、ハードフォークの日付はまだ発表されていません。日付が決まってから慌てないよう、余裕のあるうちに切り替えました。
SIPO が切り替えたもの、変えなかったもの
SIPO は、リレーとブロック生成ノードで扱いを分けました。
- リレー: Genesis モードに切り替えました。最初の 1 台を切り替えて 1 日ほど様子を見てから、残りの台に進めています
- ブロック生成ノード: 同期の方式は変えていません。ブロック生成ノードは、ふつう自前のリレーだけにつながり、bootstrap ノードを使わないので、bootstrap ノードがなくなっても影響を受けません。公式の推奨も「ブロックを作らないリレー」が対象です
- ノードの版: リレーもブロック生成ノードも 11.1.3 に上げました。11.1.3 は、11.1.2 で誤って変わってしまった IPv4 アドレスの読み方を元に戻す修正です。切り替えと同じ機会にまとめました
ブロック生成ノードを止めるときは、次にブロックを作る予定を確かめ、十分に間が空いている時間を選んでいます。切り替えの前後で、ブロックの生成は続いていました。
これから切り替える SPO の方へ
開発者ポータルの解説と SIPO の作業から、押さえておきたい点をまとめます。
- 設定の変更は 2 か所です。config.json の
ConsensusModeをGenesisModeにし、topology にpeerSnapshotFileで peer snapshot のファイルを指定します - peer snapshot は、同期を終えたノードで
cardano-cliのquery ledger-peer-snapshotを使って作れます。公式の配布物をそのまま使うこともできます - topology に残した bootstrap ノードの記載は、Genesis モードでは使われません。起動時に警告が 1 行出るだけなので、消さずに残しておくと、元に戻すときが楽です
- 11.1.3 では、peer snapshot が見つからなくても警告が出るだけで起動します。失敗に気づきにくいので、起動の記録で Genesis モードになったこと、snapshot を読み込んだことを確かめてください
- ノードは、自分の台帳が snapshot より新しくなると、そのファイルを使わなくなります。ふだんの運用には要りませんが、開発者ポータルは定期的に作り直すよう勧めています
- 切り替えのための再起動では、ノードを正しく停止させてから起動します。止め方を省くと、次の起動でデータの検証に長い時間がかかることがあります
Genesis モードへの切り替えは、ひとつひとつの手順は小さな作業です。ただ、ツールの既定が追いついていない今は、SPO が自分で気づいて動かない限り、旧方式のノードが静かに残り続けます。分散した運営者がそれぞれの手で移ることが、ネットワーク全体を特定のノードに頼らない形へ近づけます。
次に確かめる一点は、cardano-node の次の正式リリースです。IntersectMBO の cardano-node のリリースのページで、11.2 系以降が mainnet 向けの正式版になった時点が、旧方式のリレーにとっての本当の期限になります。
ことば
- Ouroboros Genesis(Genesis モード)— 特定のノードを信頼しなくても、チェーンの最初から安全に追いつけるようにする Cardano の仕組み。Praos の上に、同期のときの判断の仕方を足したものです。
- bootstrap ノード — Praos モードのノードが、同期の出発点として信頼してつなぐ少数のノード。IOG や Cardano Foundation などが運営していて、次のハードフォーク後は使えなくなる見込みです。
- peer snapshot — ある時点でチェーンに登録されている、大きなステークプール群の一覧。Genesis モードのノードは、これを手がかりにつなぐ相手を選びます。
一次ソース / 関連リンク
Cardano の公式 mainnet 設定(config.json)(book.play.dev.cardano.org)
Cardano の公式 mainnet 設定(topology.json)(book.play.dev.cardano.org)
GitHub
GitHub

developers.cardano.org
