リリースノート - v0.91.0
v0.91.0
Section titled “v0.91.0”タイトル: トレーシング、可観測性、性能、運用を向上
バージョン: v0.91.0
リリース: v0.91.0
比較: v0.90.5…v0.91.0
Dingo v0.91.0では、ノード間トレーシング、運用上の可視性、ノード同等性の設定、データベース性能、コンテナビルド、プロトコル検証、ドキュメント品質を改善しました。
推奨ネットワーク互換性 ⚠️
Section titled “推奨ネットワーク互換性 ⚠️”| Network | Compatible |
|---|---|
| mainnet | ⛔ |
| preprod-testnet | ✅ |
| preview-testnet | ✅ |
| musashi | ✅ |
トレーシングと可観測性
Section titled “トレーシングと可観測性”- 追加: 各ブロックハッシュから共通のトレース識別子を導出するブロックトレーシングを追加し、従来のスパン名をステージベースの分類に置き換え、ステージ、トランザクション受付、キャッチアップ、Mithril、データベースのライフサイクルスパンをノード間で結び付け、ログを相関させました。任意のOTLPログおよびメトリクス出力には
OTEL_LOGS_EXPORTERとOTEL_METRICS_EXPORTERを使用し、OTEL_RESOURCE_ATTRIBUTESとOTEL_SERVICE_NAMEでサービスリソースを設定できます。SQLスパンはサンプリングされたトレースだけに記録し、DINGO_TRACING_ALWAYS_SAMPLE_POOLSで常時サンプリングするプールの許可リストを解析するトレーシングダッシュボードにも対応しました。 - 除外: オブザーバーに降格されたピアをLimit on Eagernessの候補から除外し、可観測性専用のピアがチェーン選択を制約しないようにしました。
API、ノード同等性、データベース性能
Section titled “API、ノード同等性、データベース性能”- 投影: SQLが対応する場合にBlockfrostのブロック出力と手数料の合計をSQLから直接取得し、トランザクション全体を読み込まずに十進値の正確性とフォールバック動作を維持しました。
- 設定:
--koios-tx-info-batch-sizeと--koios-tx-info-concurrencyでKoios/tx_infoのバッチ処理を設定できるようにしました。既定値はリクエストあたり40ハッシュ、同時リクエスト数8のままで、検証とリクエストスケジューリングも改善しました。 - 最適化: インデックスに適したスロット範囲選択でエポック出力合計を取得し、APIモードのクロージャアドレス行の延期とロールバックを一貫させ、識別子とキャンセルを維持しながらSQLiteの挿入結果処理のオーバーヘッドを削減しました。
- 再利用: SQLiteの正確なbigint合計でスクラッチ値を再利用し、64ビットの十進文字列を高速処理しながら、幅の広い十進値の正確な動作を維持しました。
- 維持: 取得したトランザクション挿入結果を使い、SQLiteのトランザクション識別子、競合処理、リプレイ動作、ロールバック、キャンセルを維持しました。
- 効率化: APIモードのLeiosクロージャアドレス行をフラッシュまでまとめ、SQLiteのUTxO挿入結果処理のオーバーヘッドを削減しながら修復動作を維持しました。
- 復旧: Genesisの認証済み配信を中断後に復旧し、必要なブロック配信を継続できるようにしました。
- 継続: 不変なチップでもLimit on Eagernessの進行を維持し、先端が変わらない状況でも候補選択を進められるようにしました。
- 再試行: 検証コンテキストが変わっても運用証明書の検証を再試行し、接続を維持できるようにしました。
- 訂正: 置き換えられたプールの退役処理とVRFキー検索を修正し、最新のプール状態を正しく扱えるようにしました。
- 既定値: Genesisの追加照合は0ピアで、照合ゲートは無効です。
genesisBootstrap.corroborationPeersに正の値を設定するとゲートが有効になります。 - 集約: キャッチアップ中のアイドル処理をまとめ、追いつくまでの待機処理を効率化しました。
- 公開: Blockfrostの
Retry-After応答ヘッダーをCORSで公開し、クライアントが再試行待ち時間を参照できるようにしました。 - 活用: 検証済みBlockfrostトランザクション数を再利用し、同じ情報の再取得を避けられるようにしました。
- 一括化: 検証済みブロックAPIのインデックス処理をまとめ、失敗時に変更を原子的にロールバックできるようにしました。
- 保存: 深いメタデータと非JSONメタデータを保持し、元のCBORを保ちながらJSONではnull値を使用できるようにしました。
- 限定: コンテナ値を持つマップキーをCBOR専用として扱い、JSONへ変換できない値の表現を明確にしました。
- 確定: 遅延ガバナンスの批准を境界に固定し、適切な境界で批准結果を確定できるようにしました。
- 統合: インポートした報酬クレジットを一度だけ折り込み、重複した残高加算を防止しました。
- 高速化: 委員会規模のBLS処理を最適化してキャッシュし、検証処理を効率化しました。
- 準備: 準備済みの同期状態を読み取り、同期処理で必要な状態を効率よく取得できるようにしました。
- 取消: Meshの残高読み取りでキャンセルと受付判定を適切に処理し、不要な読み取りを抑制できるようにしました。
- 安定化: 選出中のVRF値をメモ化し、同じ選出処理で一貫した結果を再利用できるようにしました。
プロトコル検証とビルド運用
Section titled “プロトコル検証とビルド運用”- 強化: MithrilのGenesis証明書検証で、アグリゲートキーとプロトコルパラメータハッシュを署名済みメッセージに結び付けました。
- 選択: canonical DijkstraNetには従来のBLS_SIG証明ドメインを使用し、その他のチェーンとプライベートチェーンにはBLS_POPを起動、リプレイ、検証で一貫して使用しました。
- 更新:
ca-certificatesとlibssl3の固定バージョンおよびDebianスナップショット日付を更新し、ビルドで必要なパッケージを解決できるようにしました。 - 切り替え: DockerのランタイムとAntithesisステージでライブDebianリポジトリと固定しないパッケージを使用し、フィンガープリント検証後に署名済みのライブ
pgdgリポジトリからPostgreSQLクライアント16をインストールするようにしました。 - 改善: プロキシの転送エラーが発生した場合に、CIとDockerのモジュール取得が
https://proxy.golang.orgからdirectへフォールバックするようにしました。 - 検証: Dijkstraから開始するネットワークでConwayの検証を実行し、ネットワーク移行時の検証結果を正しく扱えるようにしました。
- 予定: Dijkstraハードフォークの実行時刻をスケジュールに反映し、指定されたタイミングで移行できるようにしました。
- 修復: Dockerビルドで
gnupgを正しく取得できるようにし、コンテナイメージのビルドを復旧しました。
ドキュメント
Section titled “ドキュメント”- 整形: リポジトリのMarkdown本文を80列で折り返し、意味を変えずにレンダリング動作を修正しました。
Docs authored by Doc Holiday