Dingo v0.94.1 設定リファレンス
このページは Dingo v0.94.1 の設定を対象とします。説明、既定値、環境変数、コマンドラインフラグ、プロバイダー設定、デプロイ構成を含む完全なフィールドリファレンスは、リリースに対応する dingo.yaml.example ファイルにあります。同じファイルは Dingo v0.94.1 のソースにも含まれます。
サンプルでは設定値がすべてコメントアウトされています。Dingo の組み込みの既定値を使用するには、そのままにしてください。既定値を変更する項目だけコメントを解除します。利用可能なフィールドや動作は変わる場合があるため、リリースに対応するサンプルを確認せずに別の Dingo リリースの設定ファイルをコピーしないでください。
設定の優先順位
Section titled “設定の優先順位”設定の優先順位は、コマンドライン、環境変数、YAML ファイル、組み込みの既定値の順です。CLI フラグと環境変数の名前は、サンプルの各フィールドとともに記載されています。主要な実行時の選択については、ノード設定とストレージモードを参照してください。
Cardano ノード設定
Section titled “Cardano ノード設定”Cardano ノード設定ファイル(YAML または JSON)に記載する項目です。Dingo 固有の CLI フラグや環境変数ではありません。
| 設定 | Cardano ノード設定キー | CLI フラグ | 環境変数 | 既定値、検証、動作 |
|---|---|---|---|---|
| トランザクション送信ロジックのバージョン | TxSubmissionLogicVersion | — | — | 省略すると TxSubmissionLogicV1 を使用します。Dingo は TxSubmissionLogicV1 の従来のピア単位の着信トランザクション送信戦略を実装しています。Dingo は TxSubmissionLogicV2 と不明な値を設定の読み込み時に拒否します。 |
| エンドーサーブロックの最小オファー先行スロット数 | LeiosMinOfferLead | — | — | Cardano ノード設定ファイルのキーです。エンドーサーブロックをピアにオファーするには、ノードの immutable tip より何スロット先行している必要があるかを指定します。省略すると既定値は 3600 スロットです。 |
Dingo は、Cardano ノード設定に従来のフラット形式と cardano-node の Version 2 エンベロープ形式の両方を受け付けます。Version 2 形式では、トップレベルに整数の Version: 2 を置き、Configuration の下に設定を配置します。
{ "Version": 2, "Configuration": { "Protocol": { "ByronGenesisFile": "byron-genesis.json", "ShelleyGenesisFile": "shelley-genesis.json", "ShelleyGenesisHash": "<hash>" }, "Testing": { "DijkstraGenesisFile": "dijkstra-genesis.json", "DijkstraGenesisHash": "<hash>" }, "Consensus": { "ConsensusMode": "GenesisMode" }, "Network": { "PeerSharing": false, "DeadlineTargetNumberOfRootPeers": 7, "DeadlineTargetNumberOfKnownPeers": 80, "DeadlineTargetNumberOfEstablishedPeers": 30, "DeadlineTargetNumberOfActivePeers": 15 } }}Dingo は各セクションの設定を既存の Cardano ノード設定フィールドに反映します。Protocol はジェネシスファイル、ハッシュ、チェックポイントなどのプロトコル設定、Testing はテスト用ジェネシス設定とハードフォークのエポック設定、Consensus はコンセンサスモード、Network はピア共有とピア数の目標を指定します。Version 2 のネットワーク設定では、次のキーを既存のキーに対応付けます。
DeadlineTargetNumberOfRootPeers→TargetNumberOfRootPeersDeadlineTargetNumberOfKnownPeers→TargetNumberOfKnownPeersDeadlineTargetNumberOfEstablishedPeers→TargetNumberOfEstablishedPeersDeadlineTargetNumberOfActivePeers→TargetNumberOfActivePeers
Version 2 のエンベロープには、整数値の Version: 2 とオブジェクトの Configuration が必要です。Protocol、Testing、Consensus、Network を指定する場合、それぞれをオブジェクトにします。Dingo は Version または Configuration の欠落や形式不正、未対応のバージョン、対応セクションのオブジェクト以外の値を拒否します。Dingo はルート、Configuration、セクション内の重複キーを拒否し、別のキーで同じ設定フィールドを指定する衝突も拒否します。従来のフラット形式は引き続き使用できます。エンベロープでも、表に示す TxSubmissionLogicVersion の検証を適用します。
| 分野 | 主な設定 | 用途 |
|---|---|---|
| ネットワークとパス | network, networkMagic, cardanoConfig, topology, databasePath, socketPath, socketMode | Cardano ネットワークを選択し、ノード、トポロジー、データの各ファイルの場所を指定します。 |
| リスナーと診断 | bindAddr, privateBindAddr, relayPort, privatePort, metricsBindAddr, metricsAuthToken, metricsPort, healthPort, debugPort, debugBindAddr, debugMutexProfileFraction, debugBlockProfileRate, tracing, tracingEndpoint, tracingServiceName, tracingSampleRatio, tracingAlwaysSamplePools, localStateQueryViewMaxLifetime | ノードとプライベートリスナー、メトリクス、ヘルスプローブ、プロファイリング、トレーシング、LocalStateQuery スナップショットの有効期間を設定します。 |
| ログと TLS | logging, tlsCertFilePath, tlsKeyFilePath, api.tls | ログ出力を選択し、対応する API または Bark リスナーを保護します。 |
| ストレージと API | storageMode, plugins.storage, plugins.mempool, plugins.api, corsAllowedOrigins | 保存する履歴、ストレージプロバイダー、トランザクションの順序、アプリケーション API を選択します。 |
| コンセンサスとプラグインの選択 | plugins.consensus | ノードで使用するコンセンサスプロバイダーを選択します。 |
| ブートストラップと同期 | mithril, mithril.downloadMaxBytes, mithril.server, mithril.server.aggregator, genesisBootstrap, genesisBootstrap.corroborationPeers, genesisBootstrap.controlGroups, genesisBootstrap.chainSyncJumping, intersectTip, immutableDbPath, chainsync, validateHistorical, strictUtxoValidation | スナップショットまたはジェネシスからのブートストラップ、同期、過去のデータの検証を設定します。 |
| ピア管理 | targetNumberOfKnownPeers, targetNumberOfEstablishedPeers, targetNumberOfActivePeers, targetNumberOfRootPeers, activePeersTopologyQuota, activePeersGossipQuota, activePeersLedgerQuota, inboundWarmTarget, inboundHotQuota, inboundMinTenure, inboundHotScoreThreshold, inboundPruneAfter, inboundDuplexOnlyForHot, inboundCooldown | ピア数の目標、取得元ごとの割り当て、着信ピアのポリシーを設定します。 |
| ブロック生成と台帳ルール | blockProducer, shelley*, forge*, validateForgedBlock, minPoolMargin, pledgeLeverage*, fullPotRewards*, delegatorInactivity*, ledgerApplyRowBatchingEnabled, ledgerPrefetchAheadEnabled, ledgerValidateAheadEnabled | ブロック生成鍵、安全性のしきい値、オプションの台帳動作を設定します。 |
| アーカイブとデータベースのライフサイクル | bark*, historyExpiry, databaseLifecycle | アーカイブデータの配信や取得、ローカル履歴の期限切れ、スナップショットの管理を設定します。 |
| 任意のインデックスと診断 | midnight, midnight.authTokenPolicyId, midnight.authTokenAssetName, tokenRegistry, tokenRegistry.manifestUrl, tokenRegistry.trustedManifestKey, tokenRegistry.allowRollback, koiosParity, cache, skipRewardLiveStakeBackfillCheck | 任意のインデックス作成、認証付きレジストリ更新、パリティ診断、キャッシュ、起動時検証を設定します。 |
コンセンサスプロバイダー
Section titled “コンセンサスプロバイダー”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| コンセンサスプロバイダー | plugins.consensus.provider | --consensus | DINGO_PLUGINS_CONSENSUS_PROVIDER | 既定値は praos です。ヘッダー検証、チェーン比較、リーダースケジューリングに使用するコンセンサスプロバイダーを選択します。tachys は Babbage または Conway から始まる対応ネットワーク構成で使用できます。Dingo は genesisBootstrap、Mithril ブートストラップ、Leios モード、Dijkstra の開始または移行設定、Shelley ジェネシス設定の欠落、Shelley から Babbage までのハードフォークエポックのいずれかの非ゼロ値、activeSlotsCoeff の 1/1 以外の値を拒否します。 |
Dingo は、選択したプロバイダーのデータベース識別子をデータディレクトリに記録します。保存された識別子が選択したプロバイダーと異なる場合は起動を拒否します。Praos が既定のプロバイダーです。既存の Praos データベースとの互換性を保つため、識別子のない空でないデータベースは、選択した識別子が praos/v1 の場合に受け入れられ、検証が成功すると Dingo はその識別子を記録します。それ以外の識別子を選択した場合、識別子のない空でないデータベースは拒否されます。Praos の識別子を持つデータベースで tachys を選択した場合も起動を拒否します。空のデータベースは、チェーンデータをインポートする前に、選択したプロバイダーの識別子を記録して使用できます。
メモリプール容量
Section titled “メモリプール容量”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| メモリプール容量 | plugins.mempool.config.capacity | — | — | バイト単位で指定します。設定を省略すると、標準モードまたは Praos では 1 MiB、runMode: leios またはネットワークが Musashi(名前または network magic)の場合は 25 MiB です。この既定値は serve の Musashi にも適用します。明示した値はこれらの既定値に優先します。 |
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| 台帳行の一括処理 | ledgerApplyRowBatchingEnabled | --ledger-apply-row-batching-enabled | DINGO_LEDGER_APPLY_ROW_BATCHING_ENABLED | false(無効)。core ストレージモードでは、対象となる未検証のブロック差分に複数行の一括処理を適用します。serve と dingo load にこの設定を渡します。API モードは既に一括処理を使用します。コンセンサスには影響しません。 |
| 台帳の先行読み取り | ledgerPrefetchAheadEnabled | --ledger-prefetch-ahead-enabled | DINGO_LEDGER_PREFETCH_AHEAD_ENABLED | true(有効)。検証済みブロックでは、現在のブロックの適用中に、読み取り専用トランザクションから次のブロックの入力 UTxO を先行読み取りします。無効にすると先行検証も無効になります。コンセンサスには影響しません。 |
| 台帳の先行検証 | ledgerValidateAheadEnabled | --ledger-validate-ahead-enabled | DINGO_LEDGER_VALIDATE_AHEAD_ENABLED | true(有効)。検証済みブロックのウィットネス署名を、ブロック適用で使用する前に検証します。ledgerPrefetchAheadEnabled が必要であり、先行読み取りを無効にすると先行検証も無効になります。コンセンサスには影響しません。 |
| Blockfetch の低水位開始 | blockfetchLowWatermarkEnabled | --blockfetch-low-watermark-enabled | DINGO_BLOCKFETCH_LOW_WATERMARK_ENABLED | false(無効)。ヘッダーがピアの先端から遠いときに有効にすると、4 つのヘッダー範囲がキューに入るのを待たず、1 つが入った時点で blockfetch を開始します。ヘッダーキューの容量は変わらず、コンセンサスにも影響しません。 |
メトリクスリスナー
Section titled “メトリクスリスナー”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| メトリクスのバインドアドレス | metricsBindAddr | --metrics-bind-addr | DINGO_METRICS_BIND_ADDR | 127.0.0.1。bindAddr とは独立しており、既定ではループバックです。スクレーパーがコンテナまたはホストの外で動作する場合は、ワイルドカードまたはリモートから到達できるアドレスを明示的に設定します。 |
| メトリクスの認証トークン | metricsAuthToken | — | DINGO_METRICS_AUTH_TOKEN | 既定では空です。プロセス引数が他のユーザーに見える可能性があるため、CLI フラグはありません。Dingo は設定値を認証に使用せず、効果を持ちません。 |
| メトリクスポート | metricsPort | --metrics-port | — | 既定値は 12798 です。0 にすると Prometheus リスナーが無効になります。 |
ノードと Mithril のメトリクスエンドポイントは認証なしでアクセスできます。
pprof サンプリング
Section titled “pprof サンプリング”debugPort が 0 以外の場合に、次の設定で pprof のミューテックスプロファイルとブロックプロファイルのサンプリングを有効にします。debugPort が 0 の場合、サンプリング値を設定しても適用しません。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| ミューテックスプロファイルのサンプリング割合 | debugMutexProfileFraction | --debug-mutex-profile-fraction | DINGO_DEBUG_MUTEX_PROFILE_FRACTION | 0(無効)。競合するミューテックスイベントを平均して 1 件に 1/N の割合でサンプリングします。 |
| ブロックプロファイルのサンプリングレート | debugBlockProfileRate | --debug-block-profile-rate | DINGO_DEBUG_BLOCK_PROFILE_RATE | 0(無効)。ブロックに費やしたナノ秒数 N ごとに 1 件をサンプリングします。1 はすべてのイベントを記録します。 |
トレーシング
Section titled “トレーシング”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| トレースコレクターのエンドポイント | tracingEndpoint | --tracing-endpoint | DINGO_TRACING_ENDPOINT | 既定では空です。OTLP HTTP コレクターの URL を設定するとトレーシングが有効になります。空の場合は tracing 設定で有効化を制御し、標準の OTEL_EXPORTER_OTLP_* 環境変数で送信先を選択します。 |
| トレースのサービス名 | tracingServiceName | --tracing-service-name | DINGO_TRACING_SERVICE_NAME | 明示した tracingServiceName を優先し、未設定時は OTEL_SERVICE_NAME、それも未設定時は dingo を使用します。エクスポートするテレメトリーのサービス名を設定します。 |
| トレースのサンプリング率 | tracingSampleRatio | --tracing-sample-ratio | DINGO_TRACING_SAMPLE_RATIO | 既定値は 1 です。0 以上 1 以下に設定します。範囲外の値は設定検証で拒否されます。 |
| 常時サンプリングするステークプール | tracingAlwaysSamplePools | --tracing-always-sample-pools | DINGO_TRACING_ALWAYS_SAMPLE_POOLS | 既定値は空のリストです。ステークプール ID を Bech32 または 56 文字の 16 進数鍵ハッシュで指定します。大文字の Bech32 も使用できます。Dingo は指定したプールのブロックを tracingSampleRatio に関係なくサンプリングします。 |
| OpenTelemetry サービス名 | — | — | OTEL_SERVICE_NAME | OpenTelemetry の標準サービス名環境変数です。tracingServiceName を設定しない場合に参照します。 |
| OpenTelemetry リソース属性 | — | — | OTEL_RESOURCE_ATTRIBUTES | Dingo はリソース属性を、エクスポートするトレース、ログ、メトリクスに適用します。解析できない属性は警告として報告し、ノードを起動します。 |
| OpenTelemetry ログエクスポーター | — | — | OTEL_LOGS_EXPORTER | 未設定または none の場合、OTLP ログエクスポートを無効にします。Dingo は無効なエクスポーター設定を警告し、標準出力ログを維持してノードを起動します。 |
| OpenTelemetry メトリクスエクスポーター | — | — | OTEL_METRICS_EXPORTER | 未設定または none の場合、OTLP メトリクスエクスポートを無効にします。Dingo は無効なエクスポーター設定を警告し、ノードを起動します。OTLP エクスポートの設定は Prometheus の /metrics エンドポイントに影響しません。 |
Unix ソケットの権限
Section titled “Unix ソケットの権限”管理対象のパス名 Unix ソケットは、プロセスの umask に関係なく既定で所有者だけがアクセスできる 0600 で作成します。値は 8 進数の Unix パーミッションモードで指定し、Unix では他のユーザーによる書き込みを許可する値を拒否します。Unix のソケットの親ディレクトリは現在のユーザーまたは root が所有している必要があります。グループまたは他のユーザーが書き込める親ディレクトリは、sticky bit を設定している場合に限り許可します。sticky bit のない書き込み可能な親ディレクトリは拒否します。拒否された場合は chmod +t で sticky bit を設定するか、グループまたは他のユーザーの書き込み権限を削除します。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| ノード間クライアントソケットのモード | socketMode | --socket-mode | CARDANO_SOCKET_MODE | 0600。8 進数で指定します。グループ共有が必要な場合は、要件に合うモードを明示します。 |
| DMQ ソケットのモード | dmq.socketMode | --dmq-socket-mode | DINGO_DMQ_SOCKET_MODE | 0600。8 進数で指定します。 |
DMQ の設定
Section titled “DMQ の設定”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値 | 検証と動作 |
|---|---|---|---|---|---|
| 有効化 | dmq.enabled | --dmq-enabled | DINGO_DMQ_ENABLED | false | 真偽値です。false はこの設定を無効にします。 |
| トピック | dmq.topic | --dmq-topic | DINGO_DMQ_TOPIC | mithril | 有効な場合、値は mithril である必要があります。それ以外は無効です。 |
| ネットワークマジック | dmq.networkMagic | --dmq-network-magic | DINGO_DMQ_NETWORK_MAGIC | 未設定の場合、トピックと Cardano ネットワークから導出します。 | 省略すると、トピックと Cardano ネットワークから値を導出します。明示した値は導出した値に優先します。ネットワークにそのトピックの既定値がない場合に設定してください。 |
| ソケットパス | dmq.socketPath | --dmq-socket-path | DINGO_DMQ_SOCKET_PATH | dingo-dmq.socket | 有効な場合、空ではなく、Cardano の socketPath とは異なる値が必要です。 |
| メッセージの TTL | dmq.messageTtl | --dmq-message-ttl | DINGO_DMQ_MESSAGE_TTL | 1800 秒 | 有効な場合、9223372036 秒以下の正の値が必要です。 |
| メモリプールの最大サイズ | dmq.maxMempoolSize | --dmq-max-mempool-size | DINGO_DMQ_MAX_MEMPOOL_SIZE | 128 MB | 有効な場合、8796093022207 MB 以下の正の値が必要です。 |
| N2N ピアポート | dmq.n2nPort | --dmq-n2n-port | DINGO_DMQ_N2N_PORT | 0 | 0 は N2N ポートを無効にします。0 以外の値を設定し、かつ dmq.maxPeers が 0 以外の場合、DMQ のノード間リスナーとピア管理を有効にします。 |
| IPv4 ピアリスナーのアドレス | dmq.listenAddress | --dmq-listen-address | DINGO_DMQ_LISTEN_ADDRESS | 0.0.0.0 | dmq.n2nPort が 0 以外で、このフィールドを設定する場合は、IPv4 リテラルが必要です。 |
| IPv6 ピアリスナーのアドレス | dmq.listenIpv6Address | --dmq-listen-ipv6-address | DINGO_DMQ_LISTEN_IPV6_ADDRESS | :: | dmq.n2nPort が 0 以外で、このフィールドを設定する場合は、IPv6 リテラルが必要です。 |
| DMQ ピアトポロジーファイル | dmq.topologyFile | --dmq-topology-file | DINGO_DMQ_TOPOLOGY_FILE | 未設定 | 設定する場合、パスには .. による移動を含めず、既存の通常ファイルを指定します。DMQ ソケットを開く前に読み込み、検証します。 |
| DMQ ピアの最小数 | dmq.minPeers | --dmq-min-peers | DINGO_DMQ_MIN_PEERS | 3 | dmq.minPeers <= dmq.maxPeers が必要です。これは接続を確立する発信ピアの最小数であり、着信接続はこの数を満たすものとして数えません。0 は必要な発信ピア数を 0 にします。 |
| DMQ ピアの最大数 | dmq.maxPeers | --dmq-max-peers | DINGO_DMQ_MAX_PEERS | 10 | dmq.minPeers <= dmq.maxPeers が必要です。発信接続と着信接続を合わせた最大接続数を指定します。着信接続用の枠は、dmq.minPeers とローカルルートの合計 valency の大きい方を発信接続用に予約した残りから導出します。minPeers も 0 の場合、0 はピアを許可しません。 |
DMQ の起動時に、これら 6 つのピア設定を検証します。dmq.n2nPort: 0 の場合はリスナーアドレスの検証を省略します。0 以外の場合、各リスナーアドレスは対応する IP バージョンである必要があります。DMQ スタックは maxPeers から、minPeers とローカルルートの合計 valency の大きい方を発信接続用に予約し、残りを着信接続の上限として内部的に導出します。この上限は Dingo の YAML キー、CLI フラグ、環境変数として公開されていません。導出した枠を使い切ると、DMQ スタックはハンドシェイク前に着信接続を拒否します。設定したトポロジーファイルはピアマネージャーに接続先を提供し、ピアマネージャーはまず localRoots、次に publicRoots の順に発信接続を試みます。有効なトピックでは、トピックの DNS SRV プレフィックスを使って台帳から検出したリレーピアも接続を試みます。
dmq.topologyFile を設定した場合、DMQ ソケットを開く前に次のトポロジールールを適用します。
- ファイルは
10 MiB以下の JSON オブジェクトである必要があります。不正な JSON、JSON のnull、大文字と小文字だけが異なるオブジェクトキーは拒否されます。 localRootsまたはpublicRootsの各アクセスポイントには、空でないホストと1から65535のポートが必要です。ホストの前後の空白と IPv6 の角括弧は除去されます。- ルートには
valencyを使用します。省略した場合は別名としてhotValencyを使用でき、両方がある場合はvalencyが優先されます。warmValencyの既定値はvalencyであり、それ以上である必要があります。valency はアクセスポイント数を超えてもかまいません。 - 異なるホストとポートの組を 1 回ずつ数えます。ホスト名は大文字と小文字や末尾のドットを区別せず、名前解決せずに IP リテラルを正規化します。
bootstrapPeersまたはpeerSnapshotFileに値がある場合は警告し、両フィールドを無視します。useLedgerAfterSlotも無視します。
ファイルの読み込み後に異なるピアの数をログに記録し、ピアが 1 つもない場合は警告します。不正なトポロジーの場合、DMQ ソケットを開く前に起動に失敗します。
ImmutableDB の取得元
Section titled “ImmutableDB の取得元”immutableDbPath と dingo load の位置引数には、ローカルディレクトリまたはリモート URL を指定できます。リモート取得元には https:// が必要です。http:// はループバックホストでのみ使用でき、それ以外の HTTP は拒否されます。HTTPS では、最初の URL、すべてのリダイレクト、各接続時の DNS 解決について、プライベートまたは特殊用途の接続先を拒否します。リモートインポートでは環境の HTTP プロキシ設定を無視します。リモートのルートは tip.json と、番号付きの .chunk、.primary、.secondary の 3 ファイル組を提供します。不一致または不完全な公開チャンクデータは拒否されます。要求したチャンク範囲から、転送バイト数、キャッシュとステージング、空き領域の予約、並行処理の合計上限を導出します。上限を超えるか空き領域が不足すると、エラーを報告してインポートに失敗し、ステージングファイルを削除します。リモートインポートで、コピー済み immutable ブロックが台帳適用済みの先端を越えた後に信頼済み再実行または処理が失敗した場合、元のエラーを返す前に未適用ブロックをその先端まで巻き戻します。このため、ステージングの後処理だけが行われて未適用の immutable ブロックが台帳の先端より先に残ることはありません。ストレージバックエンドが巻き戻しを拒否した場合は、元のエラーと巻き戻しエラーの両方を返し、次のロード前にデータベースの復旧が必要になります。取得元、チャンク、整合性の要件はブートストラップとデータ保守ガイドを参照してください。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| 過去ブロックの検証 | validateHistorical | --validate-historical | CARDANO_VALIDATE_HISTORICAL | false にしても、信頼済みリプレイまたは Mithril 認証済み履歴以外のピア由来の過去ブロックでは、ブロックエンベロープと運用証明書カウンターの検証を省略しません。完全な過去トランザクション検証だけを無効にします。 |
| 台帳状態のインポート対応範囲 | — | — | — | 現在の台帳時代が Conway 以降の状態だけをインポートできます。Shelley から Babbage までの状態は ErrPreConwaySnapshotUnsupported を返し、状態を永続化する前に拒否します。 |
Genesis ブートストラップの裏付け確認
Section titled “Genesis ブートストラップの裏付け確認”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| 裏付け確認用ピア | genesisBootstrap.corroborationPeers | --genesis-bootstrap-corroboration-peers | DINGO_GENESIS_BOOTSTRAP_CORROBORATION_PEERS | 既定値は 0 です。裏付け確認ゲートは既定で無効です。必要な場合は、正の値を明示的に設定して有効にします。 |
| Genesis の control group | genesisBootstrap.controlGroups | — | — | ネットワーク固有の control group は暗黙には提供されません。固定の control group のセットが必要な場合は、このフィールドを明示的に設定します。 |
| Genesis ChainSync Jumping | genesisBootstrap.chainSyncJumping | --genesis-csj | DINGO_GENESIS_CSJ | true(有効)。Genesis のチェーン選択中に、識別された発信ホットピア 1 つがヘッダーをストリームし、他の発信ホットピアは MsgFindIntersect でそのチェーンを確認します。Genesis 選択が有効な場合に適用されます。 |
Musashi では、Cardano ノード設定の ConsensusMode: PraosMode が Genesis チェーン選択を無効にします。genesisBootstrap が有効で、交差ポイントなしに起点から起動した場合も同じです。この場合、Dingo は Genesis の密度、裏付け確認、patience による選択を適用せず、Cardano の設定に従います。
UTxO RPC プロバイダー
Section titled “UTxO RPC プロバイダー”別のホストまたはインターフェイスから UTxO RPC にアクセスするには、ホストを明示的に設定します。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| ホスト | plugins.api.utxorpc.config.host | — | — | 既定値は 127.0.0.1 です。リモートアクセスには、ホストを明示的に設定する必要があります。 |
Blockfrost プロバイダー
Section titled “Blockfrost プロバイダー”組み込みの Blockfrost プロバイダーは、既定でループバックで待ち受けます。読み取り専用 API リクエストには Blockfrost の変更操作の受け入れ制限は適用されません。Dingo は API リクエストに認証を要求しません。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| ホスト | plugins.api.blockfrost.config.host | — | — | 既定値は 127.0.0.1 です。明示的に空にするとルートの bindAddr を使用します。別のインターフェイスで公開するにはホストを設定します。 |
| 認証トークン | plugins.api.blockfrost.config.authToken | — | — | 既定では空です。設定しても従来互換のため受け付けますが、Dingo は認証に使用せず、効果を持ちません。トランザクションの送信と評価に必要ありません。 |
| 変更操作全体の同時実行数 | plugins.api.blockfrost.config.maxConcurrentMutations | — | — | 0(未設定も同じ)は無制限です。正の値を設定すると、プロバイダー全体のトランザクション送信と評価の同時実行数に上限を設けます。 |
| クライアントごとの変更操作の同時実行数 | plugins.api.blockfrost.config.maxConcurrentMutationsPerClient | — | — | 0(未設定も同じ)は無制限です。正の値を設定すると、1 つのリモートアドレスからの処理に上限を設けます。プロバイダー全体の上限が 0 でも、この上限だけを有効にできます。全体の上限が正の場合は、その値以下である必要があります。 |
変更操作には認証は必要ありません。Dingo は本文を読む前に、設定した変更操作の上限を適用します。設定した上限を使い切った場合だけ、本文を読まずに Retry-After: 1 を含む HTTP 429 を返します。上限を設定していない場合、変更操作の受け入れ制限はありません。
共有アウトバウンド HTTP ユーザーエージェント
Section titled “共有アウトバウンド HTTP ユーザーエージェント”共有アウトバウンド HTTP ユーザーエージェントは環境変数で設定します。YAML キーや CLI フラグはありません。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| 共有 HTTP ユーザーエージェント | — | — | DINGO_HTTP_USER_AGENT | 既定値は dingo/<version> (<GOOS>/<GOARCH>) です。環境変数に有効な値を設定すると、その値を使用します。無効な値は無視します。オフチェーンメタデータとトークンレジストリのコンポーネント固有の userAgent 設定が優先されます。 |
LocalStateQuery スナップショットの有効期間
Section titled “LocalStateQuery スナップショットの有効期間”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値 | 検証と動作 |
|---|---|---|---|---|---|
| 取得した台帳スナップショットの最大有効期間 | localStateQueryViewMaxLifetime | --local-state-query-view-max-lifetime | DINGO_LOCAL_STATE_QUERY_VIEW_MAX_LIFETIME | 5m | 5m などの正の期間文字列を指定します。不正な値、0、負の値は起動時または設定検証で拒否されます。有効期間を過ぎると、保持中のスナップショットを閉じます。次のクエリは取得済みのポイントで再度開き、そのスナップショットから回答します。先端を取得した場合は、取得時の先端を使用します。ロールバックまたは保持期間によるプルーニングで取得済みのポイントが削除された場合は、再度開けないため接続を閉じます。 |
Mithril の同期とバックエンド
Section titled “Mithril の同期とバックエンド”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| 自動管理の Mithril 同期 | mithril.enabled | --mithril-enabled | DINGO_MITHRIL_ENABLED | false(無効)。core ストレージでの serve では、認証済み Mithril v2 の先端から同期でき、自動管理の Mithril 同期が失敗すると Ouroboros 同期に切り替えます。手動の Mithril 同期コマンドはこの設定に関係なく使用できます。 |
| Mithril アーティファクトのバックエンド | mithril.backend | --mithril-backend | DINGO_MITHRIL_BACKEND | v2(空の場合も v2)。v1 と v1 CLI パスは拒否されます。v2 は増分 Cardano データベースアーティファクトを使用し、ブートストラップ時に検証済みの付属台帳状態と immutable ダイジェストを要求します。v2 アーティファクトの配置を正とします。 |
| Mithril の固定ダイジェスト | mithril.pinnedDigest | --mithril-pinned-digest | DINGO_MITHRIL_PINNED_DIGEST | 既定では空です。新規ブートストラップで設定する場合は、v2 Cardano データベースアーティファクトを識別する値が必要です。v1 スナップショットの固定値やダイジェストは拒否されます。 |
| ロード後の Mithril チャンククリーンアップ | mithril.cleanupAfterLoad | --mithril-cleanup-after-load | DINGO_MITHRIL_CLEANUP | true(有効)。Dingo はブロックを blob ストアに永続的にコミットした後、抽出済み ImmutableDB チャンクのうち、保持する再開アンカーより前のチャンクを削除します。同期が中断すると、Dingo は内部の mithril_immutable_retired_below マーカーを使い、削除済みチャンクを再取得せずに保持された境界から再開します。このマーカーは内部の再開専用で、設定変更には使用しません。 |
Mithril のダウンロード制限
Section titled “Mithril のダウンロード制限”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| Mithril オブジェクトごとの圧縮サイズ上限 | mithril.downloadMaxBytes | --mithril-download-max-bytes | DINGO_MITHRIL_DOWNLOAD_MAX_BYTES | 0 は組み込みのオブジェクト別圧縮サイズ上限を使用します。正の値を設定すると、すべてのダウンロードオブジェクトでその上限を使用します。負の値は起動時または設定検証で拒否されます。 |
mithril.downloadMaxBytes が 0 の場合、次の組み込み圧縮サイズ上限を使用します。
| Mithril オブジェクト | 組み込み上限 |
|---|---|
| v2 immutable アーカイブ | 1 GiB |
| v2 ダイジェスト一覧 | 256 MiB |
| v2 付属データ | 64 GiB |
Mithril アーティファクトサーバー
Section titled “Mithril アーティファクトサーバー”mithril.server は dingo mithril snapshot create と dingo mithril serve を制御します。スナップショットアーティファクトの読み取りは公開されます。アグリゲーターの署名者登録と登録締め切りは認証なしでアクセスできます。アーティファクトサーバーの TLS は任意です。スナップショットのダウンロード場所に現れる公開オリジンを mithril.server.publicBaseUrl に設定します。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| アーティファクトサーバーのポート | mithril.server.port | --mithril-server-port | DINGO_MITHRIL_SERVER_PORT | 8081。dingo mithril serve はこのポートとルートの bindAddr で待ち受けます。 |
| スナップショットの公開オリジン | mithril.server.publicBaseUrl | --mithril-server-public-base-url | DINGO_MITHRIL_SERVER_PUBLIC_BASE_URL | dingo mithril serve で必須です。認証情報、パス、クエリ、フラグメントを含まない絶対 HTTP または HTTPS オリジンを指定します。パスは空または / にできます。 |
| アーティファクトストア | mithril.server.artifactStore | --mithril-server-artifact-store | DINGO_MITHRIL_SERVER_ARTIFACT_STORE | 空です。ファイルシステムのディレクトリ、s3://bucket/prefix、gcs://bucket/prefix を指定します。後者 2 つには dingo_extra_plugins を有効にしたビルドが必要です。 |
| リダイレクト先の基底 URL | mithril.server.redirectBaseUrl | --mithril-server-redirect-base-url | DINGO_MITHRIL_SERVER_REDIRECT_BASE_URL | 空です。設定すると、アーカイブリクエストはオブジェクトをストリーム配信せず、この URL にオブジェクトキーを加えた場所へリダイレクトします。リモートオブジェクトが公開読み取り可能な場合のみ使用します。 |
| スナップショットの保持数 | mithril.server.keepSnapshots | --mithril-server-keep-snapshots | DINGO_MITHRIL_SERVER_KEEP_SNAPSHOTS | 0 は生成したすべてのスナップショットを保持します。正の値は、最新のスナップショットをその件数だけ保持します。 |
| 付属データの署名鍵 | mithril.server.ancillarySigningKeyFile | --mithril-server-ancillary-signing-key-file | DINGO_MITHRIL_SERVER_ANCILLARY_SIGNING_KEY_FILE | 空です。各付属マニフェストに署名する Ed25519 Mithril JSON hex 鍵を設定します。 |
| アーティファクトサーバーの TLS | mithril.server.tlsEnabled | --mithril-server-tls-enabled | DINGO_MITHRIL_SERVER_TLS_ENABLED | false。有効な場合は共有の tlsCertFilePath と tlsKeyFilePath を使用します。 |
| アグリゲーターのエンドポイント | mithril.server.aggregator.enabled | --mithril-aggregator-enabled | DINGO_MITHRIL_AGGREGATOR_ENABLED | false。署名者登録、署名収集、スナップショット認証を有効にします。 |
| 署名者の登録エポック | mithril.server.aggregator.epoch | --mithril-aggregator-epoch | DINGO_MITHRIL_AGGREGATOR_EPOCH | 0 では有効なエポックを選択しません。アグリゲーターを有効にする場合は 1 以上を設定します。ジェネシス証明書は前のエポックを使用します。 |
| STM 定足数 | mithril.server.aggregator.k | --mithril-aggregator-k | DINGO_MITHRIL_AGGREGATOR_K | 設定されるまでは 0 です。m 以下の正の定足数を指定します。 |
| STM 抽選数 | mithril.server.aggregator.m | --mithril-aggregator-m | DINGO_MITHRIL_AGGREGATOR_M | 設定されるまでは 0 です。アグリゲーターを有効にする場合は正の値を指定します。 |
| STM 当選確率 | mithril.server.aggregator.phiF | --mithril-aggregator-phi-f | DINGO_MITHRIL_AGGREGATOR_PHI_F | 設定されるまでは 0 です。0 より大きく 1 以下の値を指定します。 |
| アグリゲーターのジェネシス署名鍵 | mithril.server.aggregator.genesisSigningKeyFile | --mithril-aggregator-genesis-signing-key-file | DINGO_MITHRIL_AGGREGATOR_GENESIS_SIGNING_KEY_FILE | アグリゲーターを有効にする場合は必須です。Ed25519 Mithril JSON hex 鍵を指定します。 |
| アグリゲーターのオペレータートークン | mithril.server.aggregator.operatorTokenFile | --mithril-aggregator-operator-token-file | DINGO_MITHRIL_AGGREGATOR_OPERATOR_TOKEN_FILE | 既定では空です。アグリゲーターを有効にする場合も不要です。設定しても従来互換のため受け付けますが、Dingo は認証に使用せず、効果を持ちません。 |
SQLite メタデータストレージの検証
Section titled “SQLite メタデータストレージの検証”plugins.storage.metadata.provider が sqlite の場合、または省略して既定の sqlite が使用される場合、ルートの databasePath を空でない値に設定します。いずれの場合も databasePath が空なら起動を拒否します。
SQL メタデータの TLS
Section titled “SQL メタデータの TLS”プロバイダーが生成する PostgreSQL 接続は、既定で sslMode: verify-full を使用し、サーバー証明書とホスト名を検証します。プロバイダーが生成する MySQL 接続は、sslMode が未設定でホストがループバック以外の場合、tls=true を使用します。localhost、127.0.0.1、::1 は、このリモート TLS の自動既定値の対象外です。明示的な dsn がある場合はそれを優先し、プロバイダーが生成する既定値を適用しません。
MySQL のスナップショットと復元は、接続を機会的 TLS に弱めず、tls=skip-verify を拒否します。ライフサイクル操作で別の設定が必要な場合は、tls=false、tls=true、tls=preferred など、対応するモードを明示してください。
Midnight 認証トークンの設定
Section titled “Midnight 認証トークンの設定”登録の認可で特定のポリシーとアセットを使用する場合は、midnight の下に Midnight 認証トークンのフィールドを設定します。
| 設定 | YAML キー | 既定値 | 検証と動作 |
|---|---|---|---|
| 認証トークンのポリシー ID | midnight.authTokenPolicyId | 空 | 56 文字ちょうどの 16 進数で、デコードすると 28 バイトになる値が必要です。 |
| 認証トークンのアセット名 | midnight.authTokenAssetName | 空 | 認証トークンの検証時に、設定されたポリシー ID とともに使用します。 |
両方のフィールドを設定するか、両方とも空にします。片方だけでは設定と起動時の検証に失敗します。設定した場合、認証トークンのポリシー ID とアセット名が、設定値と完全に一致する場合にのみ受け入れます。
Badger 値ログのガベージコレクション
Section titled “Badger 値ログのガベージコレクション”Badger プロバイダーでは、plugins.storage.blob.config の下にこれらの YAML キーを設定します。対応するトップレベルの CLI フラグや環境変数はありません。
plugins.storage.blob.config.valueThreshold の既定値は 1 MiB です。ただし、Core モードの sync と Mithril 同期では 1 KiB を使用します。明示した YAML 値は、0 も含め、どちらのモードの既定値にも優先します。
| 設定 | プロバイダーの YAML キー | 既定値 | 検証と動作 |
|---|---|---|---|
| ブロックキャッシュのサイズ | plugins.storage.blob.config.blockCacheSize | Core では 0、API では 256 MiB | バイト数を指定します。 |
| インデックスキャッシュのサイズ | plugins.storage.blob.config.indexCacheSize | Core と API の両方で 0 | バイト数を指定します。 |
| 圧縮 | plugins.storage.blob.config.compression | Core では false、API では true | ディスク上の Badger ストレージで圧縮を有効にする場合、blockCacheSize に正の値を設定します。blockCacheSize: 0 のまま圧縮を有効にすると、Dingo は設定の読み込みに失敗します。圧縮を無効にする場合、キャッシュサイズ 0 は有効です。 |
| Memtable のサイズ | plugins.storage.blob.config.memTableSize | ストレージモードが core で実行モードが sync の場合のみ 512 MiB。それ以外のモードの組み合わせで、この設定を省略または 0 にした場合は 128 MiB。 | バイト数を指定します。明示した値は組み込みの既定値に優先します。トップレベルの CLI フラグや環境変数はありません。 |
| 値ログ GC の間隔 | plugins.storage.blob.config.gcInterval | 5m | 0 の間隔は既定値 5m を選択します。負の間隔は拒否されます。 |
| 値ログ GC の破棄率 | plugins.storage.blob.config.gcDiscardRatio | 0.5 | 0 より大きく 1 より小さい値が必要です。 |
Badger プロバイダーで plugins.storage.blob.config.gc を true に設定しても、一括インポートモードの load と sync では値ログ GC は無効のままです。
データベーススナップショットの停止時間上限
Section titled “データベーススナップショットの停止時間上限”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値 | 検証と対象範囲 |
|---|---|---|---|---|---|
| スナップショットのコミット停止時間上限 | databaseLifecycle.snapshotMaxCommitPause | --db-snapshot-max-commit-pause | DINGO_DB_LIFECYCLE_SNAPSHOT_MAX_COMMIT_PAUSE | 30s。0s は上限なし。 | 0 以上の期間を指定します。負の値は設定検証で拒否されます。正の値は、手動のオフライン、ライブ、自動エポック境界スナップショットのすべてで、コミットバリア取得後の処理時間を制限します。上限を超えるとスナップショットをキャンセルし、部分的な出力を削除し、ErrCommitPauseExceeded をラップしたエラーを返します。 |
データベーススナップショットの保存先
Section titled “データベーススナップショットの保存先”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| ローカルスナップショットディレクトリ | databaseLifecycle.snapshotDir | --db-snapshot-dir | — | 既定値は空です。自動スナップショットと Bark からのスナップショットを保存するローカルファイルシステムのディレクトリを指定します。snapshotEnabled を有効にする場合と、Bark の DatabaseService をマウントする場合に必要です。Unix では保存先をプロセスユーザーまたは root の所有に限定し、ディレクトリを 0700、スナップショットファイルを 0600 にします。Windows では保護された所有者だけの ACL を使用します。ディレクトリの所有権または書き込み権限が要件を満たさない場合、起動を拒否します。 |
データベーススナップショットの信頼鍵
Section titled “データベーススナップショットの信頼鍵”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| スナップショット信頼鍵ファイル | databaseLifecycle.snapshotTrustKeyFile | --db-snapshot-trust-key-file | DINGO_DB_LIFECYCLE_SNAPSHOT_TRUST_KEY_FILE | 既定では空です。指定するファイルは 16 バイト以上 1024 バイト以下の通常ファイルで、シンボリックリンクではない必要があります。クラウドスナップショットミラーリングを有効にする場合、Dingo は受け入れ可能な信頼鍵を必要とします。 |
Unix では、ファイルは現在のユーザーの所有で、グループや他のユーザーに権限を付与していない必要があります。Windows では、所有者は現在のユーザー、またはプロセスが所属する BUILTIN\Administrators である必要があります。DACL に含められるのは、所有者、Administrators、SYSTEM、Creator Owner、Owner Rights のみです。Administrators が所有する場合は、制限されたローカル Administrator ACE も含められます。スナップショット認証時、および信頼鍵が必要なライフサイクル操作時に、不正なファイルを拒否します。従来のスナップショットに信頼鍵による認証がない場合、Dingo はミラーリング用の自動署名を行わず、スナップショットを拒否します。ミラーリングには、信頼鍵を使用してスナップショットを作成し直す必要があります。
信頼鍵を使用しないローカル復元では、Unix ではプライベートで信頼できるスナップショット場所が必要です。Windows では認証済みマニフェストが必要です。所有権、権限、ACL、パスを確認する運用手順については、ブートストラップとデータ保守ガイドを参照してください。
Bark のリモートライフサイクルサービス
Section titled “Bark のリモートライフサイクルサービス”Bark のリモートライフサイクルサービスは既定で無効です。有効にすると、Bark 経由で Stop、Restart、GetStatus を提供します。サービスをマウントした場合の既定のアドレスは 127.0.0.1 です。別のインターフェイスで公開するには barkHost を設定します。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と要件 |
|---|---|---|---|---|
| ライフサイクルサービスの有効化 | barkLifecycleEnabled | --bark-lifecycle-enabled | DINGO_BARK_LIFECYCLE_ENABLED | false。有効にするには、0 以外の barkPort が必要です。barkClientCaFilePath、tlsCertFilePath、tlsKeyFilePath、barkLifecycleOperatorCertificateFingerprints は不要です。サーバー TLS の証明書と鍵は任意で設定できます。 |
| ライフサイクルオペレーターの証明書 | barkLifecycleOperatorCertificateFingerprints | --bark-lifecycle-operator-certificate-fingerprints | DINGO_BARK_LIFECYCLE_OPERATOR_CERTIFICATE_FINGERPRINTS | 既定では空です。設定しても従来互換のため受け付けますが、Dingo は認証に使用せず、効果を持ちません。 |
| ブロックダウンロードのプライベートまたは特殊用途アドレス | barkBlockDownloadAllowPrivateAddresses | --bark-block-download-allow-private-addresses | DINGO_BARK_BLOCK_DOWNLOAD_ALLOW_PRIVATE_ADDRESSES | false。true にすると、Bark のブロックダウンロード先で、名前解決後のプライベートまたは特殊用途アドレスを許可します。オリジン許可リスト、HTTPS 要件、リダイレクト検証、プロキシ無効化は維持されます。ブロックダウンロードにのみ影響し、Bark RPC 通信には影響しません。 |
GetStatus、Stop、Restart は、認証情報やクライアント証明書なしの平文 HTTP リクエストを受け付けます。barkClientCaFilePath は従来の入力として受け付けますが、Dingo は認証に使用せず、効果を持ちません。DatabaseService のオペレーター認証情報は独立しており、ライフサイクルアクセスを認可しません。Restart は Unix で使用でき、それ以外では未対応操作のエラーを返します。
Bark アーカイブ検索の制限
Section titled “Bark アーカイブ検索の制限”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| アーカイブ検索全体の毎秒上限 | barkArchiveLookupsPerSecond | --bark-archive-lookups-per-second | DINGO_BARK_ARCHIVE_LOOKUPS_PER_SECOND | 0(未設定も同じ)は無制限です。正の値を設定すると、すべての匿名 ArchiveService 呼び出し元に適用する上限になります。Dingo は負の値を拒否します。 |
| 呼び出し元ごとのアーカイブ検索の毎秒上限 | barkArchiveCallerLookupsPerSecond | --bark-archive-caller-lookups-per-second | DINGO_BARK_ARCHIVE_CALLER_LOOKUPS_PER_SECOND | 0(未設定も同じ)は無制限です。正の値を設定すると、IPv4 アドレスまたは IPv6 /64 ごとの上限になります。Dingo は負の値を拒否します。 |
Dingo は各参照に基本検索コストを 1 件ずつ計上し、グローバル制限と呼び出し元ごとの制限の両方に適用します。高さを含む参照がバッチにある場合は、インデックスの上限を解決するための 1 回限りの追加料金 66 ルックアップ単位をバッチ単位で計上し、各高さ参照には、解決した上限に基づく二分探索の追加プローブ分を計上します。境界解決中の古い末尾の再試行や、探索中に古い内部インデックス項目をスキップする処理にも、実行前に追加予算を確保します。予算が不足すると、対応するアーカイブまたはクラウド検索を開始する前に、RESOURCE_EXHAUSTED で拒否します。高さ参照を含む大きなバッチは分割してください。
ファイルによる秘密情報とパリティ入力
Section titled “ファイルによる秘密情報とパリティ入力”ファイル入力は、値を直接指定する代わりに使用できます。CLI、環境変数、YAML、組み込みの既定値の優先順位は前述と同じです。同じ設定元で直接指定とファイル指定の両方を設定すると拒否されます。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| Dingo Koios パリティ API 鍵 | koiosParity.apiKey | 削除済み・無効: --koios-parity-api-key | DINGO_KOIOS_PARITY_API_KEY | 既定では空です。YAML とこの環境変数では、リテラルの API 鍵を引き続き使用できます。 |
| Dingo Koios パリティ API 鍵ファイル | koiosParity.apiKeyFile | --koios-parity-api-key-file | DINGO_KOIOS_PARITY_API_KEY_FILE | 既定では空です。CLI 入力にはこのファイル方式を使用します。ファイルを API 鍵の文字列として読み取ります。 |
| 汎用プラグイン設定フィールドのファイル | — | — | DINGO_PLUGINS_<CAPABILITY>_CONFIG_<FIELD>_FILE | DINGO_PLUGINS_<CAPABILITY>_CONFIG_<FIELD> の代わりに使用します。ファイルを通常の文字列として読み取り、YAML として解析しません。 |
koios-parity API 鍵ファイル | — | --api-key-file | KOIOS_API_KEY_FILE | --api-key または KOIOS_API_KEY の代わりに使用します。CLI フラグは環境変数より優先されます。 |
koios-parity メタデータ DSN ファイル | — | --metadata-dsn-file | — | --metadata-dsn の代わりに使用します。ファイルは接続文字列を通常のテキストで指定します。 |
node-parity from-genesis Koios API 鍵ファイル | — | --koios-api-key-file | — | --koios-api-key の代わりに使用します。Koios リクエストに使用する API 鍵をファイルで指定します。 |
node-parity from-genesis の境界キャプチャディレクトリ | — | --boundary-capture-dir | — | from-genesis の UTxO 比較で使用する、任意の境界キャプチャディレクトリを指定します。 |
node-parity from-genesis の /tx_info バッチサイズ | — | --koios-tx-info-batch-size | — | 既定値は 40 です。各 /tx_info リクエストに含めるトランザクションハッシュ数を 1 から 999 の範囲で指定します。公開ホストはリクエスト本文が 5120 バイトを超えると拒否するため、より大きな値はそれを受け入れるホストでのみ使用します。 |
node-parity from-genesis の /tx_info 同時実行数 | — | --koios-tx-info-concurrency | — | 既定値は 8 です。同時に処理する /tx_info リクエスト数を 1 から 64 の範囲で指定します。 |
--koios-tx-info-batch-size と --koios-tx-info-concurrency は Dingo ノード本体ではなく、node-parity from-genesis サブコマンドでのみ使用できます。これらに YAML キーや環境変数はありません。
ファイルから読み取る値は、次の要件を満たす必要があります。
- パスは通常ファイルを指定する必要があります。ディレクトリ、デバイス、その他の通常ファイル以外は拒否されます。
- ファイル内容は最大
64 KiBです。末尾のCRとLFを除去し、空または空白のみの内容を拒否します。 - 権限または ACL はプラットフォームのセキュリティポリシーを満たす必要があります。Unix ではファイルとパスのすべての祖先ディレクトリをプロセスユーザーまたは root が所有している必要があります。sticky bit のないディレクトリがグループまたは他のユーザーによって書き込み可能な場合は拒否します。sticky bit のあるディレクトリはこの書き込み条件の対象外ですが、所有者の確認は行います。ファイルは所有者とグループのアクセスを許可できますが、その他のユーザーには許可できません。Windows の ACL では所有者、Administrators、SYSTEM のみを許可できます。
- エラーでは値またはパスを示しますが、ファイル内容は含めません。
トークンレジストリのマニフェスト認証
Section titled “トークンレジストリのマニフェスト認証”トークンレジストリの同期では、公開アーカイブまたは署名付きミラーを使用できます。公開アーカイブを使用する場合は tokenRegistry.manifestUrl と tokenRegistry.trustedManifestKey の両方を空にします。署名付きミラーを使用する場合は両方を設定し、片方だけの設定は無効になります。
| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と動作 |
|---|---|---|---|---|
| 署名付きマニフェスト URL | tokenRegistry.manifestUrl | --token-registry-manifest-url | DINGO_TOKEN_REGISTRY_MANIFEST_URL | 既定では空です。公開アーカイブでは空のままにし、署名付きミラーでは trustedManifestKey とともに設定します。設定する場合は絶対 HTTPS URL を指定します。 |
| 信頼するマニフェスト鍵 | tokenRegistry.trustedManifestKey | --token-registry-trusted-manifest-key | DINGO_TOKEN_REGISTRY_TRUSTED_MANIFEST_KEY | 既定では空です。公開アーカイブでは空のままにし、署名付きミラーでは manifestUrl とともに設定します。設定する場合は 32 バイトの Ed25519 公開鍵を 16 進数で指定します。 |
| マニフェストのロールバックを許可 | tokenRegistry.allowRollback | --token-registry-allow-rollback | DINGO_TOKEN_REGISTRY_ALLOW_ROLLBACK | 既定値は false。署名付きミラーで公開者による意図的なロールバックを許可する場合のみ true にします。 |
tokenRegistry.sourceUrl を明示する場合、それも絶対 HTTPS URL である必要があります。公開アーカイブでは署名付きマニフェストなしでアーカイブを同期します。署名付きミラーでは、スナップショットの適用前に署名付きマニフェストを、設定したアーカイブ URL、正確な圧縮サイズ、BLAKE2b-256 ダイジェストに対して検証します。ロールバック検査に用いるシーケンス番号もマニフェストから取得します。
署名付きミラーでは、未認証、不一致、不完全なスナップショットを拒否します。allowRollback が true でない限り、小さいシーケンス番号も拒否し、同じシーケンス番号でダイジェストが変わる場合も拒否します。拒否されたスナップショットが最後に受け入れたものを置き換えることはありません。
トークンレジストリのヘッダー認証情報
Section titled “トークンレジストリのヘッダー認証情報”認証付きトークンレジストリミラーの認証情報には tokenRegistry.headerSecrets を使用します。YAML ではヘッダー名から秘密の値へのマップを指定します。
tokenRegistry: headerSecrets: Authorization: "Bearer <token>"環境変数は DINGO_TOKEN_REGISTRY_HEADER_SECRETS で、name:value の組をカンマで区切ります。最初のコロンで各組を分割するため、値は追加のコロンを含められますが、カンマは含められません。プロセス一覧で認証情報が見えるため、CLI フラグはありません。
Dingo は出力する設定とエラーからヘッダー値を秘匿します。ヘッダー認証情報を持つリクエストは、HTTPS の取得元 URL またはループバックの取得元を使用する必要があります。不正なヘッダー名や値、およびトランスポートやリクエストで使用する予約済みヘッダー名は拒否されます。リダイレクトでスキームまたはホストが変わる場合は、追従前に設定した認証情報を削除します。
ブロック生成
Section titled “ブロック生成”Dingo v0.94.0 は ForgePrimaryChainTipToleranceSlots と forgePrimaryChainTipToleranceSlots を YAML、CLI、環境変数でサポートしていません。別のフィールドに置き換えるのではなく、これらの設定を削除してください。
任意の forgeAppliedTipStalenessSlots は、YAML、CLI フラグ --forge-applied-tip-staleness-slots、環境変数 DINGO_FORGE_APPLIED_TIP_STALENESS_SLOTS で設定します。既定値の 0 は上限を無効にします。裏付け確認済みの上流ターゲットがある場合のみ評価し、ターゲットが不明な場合は無視します。
複数プールのブロック生成
Section titled “複数プールのブロック生成”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| 複数プールのブロック生成 | blockProducerPools | — | — | YAML 専用です。省略または空リストの場合、Dingo は既存のトップレベルの単一プール設定を使用します。1 つ以上のエントリを指定すると、Dingo は関連するトップレベルの shelley* 鍵と KES 設定を各エントリの設定で置き換えます。 |
各エントリには shelleyVrfKey、shelleyOperationalCertificate、および KES ソースを 1 つ指定します。KES ソースには、shelleyKesKey、shelleyKesAgentSocket、shelleyKesAgentAddress、shelleyKesAgentAddresses のいずれかを使用します。Dingo は shelleyKesAgentAddress と shelleyKesAgentAddresses の同時指定を拒否します。KES エージェントの追加設定には、shelleyKesAgentMode、shelleyKesAgentClientCertFile、shelleyKesAgentClientKeyFile、shelleyKesAgentServerSpkiSha256、shelleyKesAgentPlaintext、shelleyKesAgentProfile を使用できます。これらのネストしたキーには個別の CLI フラグや環境変数のバインディングがありません。
リストにエントリを指定する場合、Dingo は関連するトップレベルの shelleyVrfKey、shelleyKesKey、shelleyOperationalCertificate、shelleyKesAgentSocket、shelleyKesAgentMode、shelleyKesAgentAddress、shelleyKesAgentAddresses、shelleyKesAgentClientCertFile、shelleyKesAgentClientKeyFile、shelleyKesAgentServerSpkiSha256、shelleyKesAgentPlaintext、shelleyKesAgentProfile との混在を拒否します。Dingo は運用証明書のパスの重複を拒否します。複数のプールが同じリモート KES リスナーを使用する場合は、各プールに異なる shelleyKesAgentProfile を設定します。プロファイルが異なれば、Dingo はリモートアドレスの共有を拒否しません。トップレベルの shelleyKesAgentSignTimeout と shelleyKeyWatchInterval はすべてのプールに適用されます。
リモート KES エージェント
Section titled “リモート KES エージェント”| 設定 | YAML キー | CLI フラグ | 環境変数 | 既定値と検証 |
|---|---|---|---|---|
| リモート KES エージェントアドレス一覧 | shelleyKesAgentAddresses(トップレベルまたは blockProducerPools の各エントリ) | --shelley-kes-agent-addresses | SHELLEY_KES_AGENT_ADDRESSES | 既定値は空のリストです。順序付きの host:port リストを指定します。各要素には空でないホストと 1 から 65535 のポートが必要です。shelleyKesAgentAddress と同時には設定できず、ローカルの shelleyKesKey または shelleyKesAgentSocket とも併用できません。 |
| リモート KES エージェントプロファイル | shelleyKesAgentProfile(トップレベルまたは blockProducerPools の各エントリ) | --shelley-kes-agent-profile | SHELLEY_KES_AGENT_PROFILE | 既定値は空です。リモートアドレスなしでは設定できません。同じリモートリスナーを共有するプールはそれぞれこの値を設定し、異なるプロファイル名を使用します。CLI フラグと環境変数はトップレベル設定に適用します。 |
blockProducerPools の shelleyKesAgentAddresses と shelleyKesAgentProfile は YAML で各プールに設定します。リモートアドレスを 1 つだけ使用するプールでは、プロファイルを省略できます。
Shelley KES エージェントソケット
Section titled “Shelley KES エージェントソケット”--shelley-kes-agent-socket はファイルシステムのソケットパスと Linux の抽象ソケットアドレスに対応します。相対パスはクライアント構築時に一度解決し、再接続でもそのパスを再利用します。@ で始まる抽象アドレスは保持し、NUL 文字で始まるアドレスは構築時に拒否します。プラットフォームのソケット長制限も適用します。
Kupo プロバイダー
Section titled “Kupo プロバイダー”任意の Kupo プロバイダーは plugins.api.kupo の下に設定します。組み込みプロバイダーには provider: "builtin" を使用します。Kupo には storageMode: api が必要です。CLI では --kupo-provider でプロバイダーを選択します。plugins.api.kupo.config.port を 0 にすると Kupo リスナーを無効にします。
サンプルには、リレー、API/データ、ブロックプロデューサー、アーカイブ、履歴期限切れ、開発用ノードの構成例もコメントとして含まれます。コンセンサス、ブロック生成、ネットワーク公開範囲を変更する設定を有効にする前に、各構成例の注意事項を確認してください。
Docs authored by Doc Holiday