ピアスナップショット設定

ピアスナップショット設定

このページでは、topology.json から cardano-node のピアスナップショットを読み込むための peerSnapshotFile と、起動時に適用される検証条件を説明します。

対応形式は、NodeToClientVersion が 23 の cardano-node の peer-snapshot.json です。

peerSnapshotFile の設定

topology.json の peerSnapshotFile に、cardano-node のピアスナップショットファイルを指定します。

{
  "peerSnapshotFile": "peer-snapshot.json"
}

相対パスは、topology.json があるディレクトリを基準に解決します。

スナップショットの検証条件

Dingoは、スナップショットからピアを読み込む前に、次の条件を検証します。

• NodeToClientVersion は 23 である必要があります。
• NetworkMagic には値を指定します。Dingoは、設定済みのネットワークマジックと一致しない値を受け付けません。
• Point.blockPointHash は、64文字の16進数で指定する必要があります。これは32バイトのハッシュに相当します。
• Point には Point.blockPointSlot を含めます。Dingo はその値に追加の制約を課しません。
• bigLedgerPools と allLedgerPools の一方だけに1件以上のプールを設定し、もう一方は空にします。allLedgerPools を使用できます。
• 選択した各プールの relays リストに、1件以上のリレーを設定します。

リレー接続先

各リレーには、次の条件を満たす address を指定します。port はリレーの種類に応じて設定します。

• address は空にできません。値には有効なDNSホスト名、または未指定ではないIPアドレスを指定します。
• DNSホスト名を使用するリレーでは、SRV解決のために port を省略するか、port を 0 に設定できます。Dingo はこれらを MultiHostName リレーとして保持します。
• IPアドレスを使用するリレーでは、0ではないTCPポートを 1 から 65535 の範囲で指定する必要があります。port: 0 は拒否されます。

Dingo は、設定済みのブートストラップピアをスナップショットのリレー接続先で置き換える前に、スナップショット全体を検証します。形式が不正であるか内容に矛盾がある場合は、リレー接続先を使用する前にノードの起動を停止し、スナップショットを黙って受け入れることはありません。

---

Docs authored by Doc Holiday