Certコマンドラインガイド

Bursaは、ステークプール運用、ステーク委任、Conway時代のガバナンス用の証明書を作成するために使用できます。

Bursaを使用して証明書を作成

これらのBursaコマンドは、各種Cardano証明書を生成するために使用できます。

証明書の種類:
op-cert	- ブロック生成用の運用証明書
pool-registration	- プール登録証明書
pool-retirement	- プール引退証明書
stake-registration	- ステークアドレスの登録
stake-deregistration	- ステークアドレスの登録解除
stake-delegation	- プールへのステーク委任
drep-registration	- DRep登録 (Conway)
drep-deregistration	- DRep登録解除 (Conway)
vote-delegation	- 投票委任 (Conway)
committee-hot-auth	- 委員会ホットキー認証 (Conway)
committee-cold-resign	- 委員会コールドキー辞任 (Conway)

ステークプール運用のための証明書を作成

op-certコマンドは、KESキーをプールコールドキーに紐付ける運用証明書(別名node.cert)を生成するために使用できます。ステークプールはKESキーをローテーションする際に新しいnode.certを作成する必要があります。そのため、SPOはBursaを使用して、新しいkes.vkey、コールドキー、KES期間で新しいnode.certを作成できます。

🔁 --outを指定すると、Bursaはnode.certにcardano-cli互換のJSONテキストエンベロープを書き込みます。

{
    "type": "NodeOperationalCertificate",
    "description": "Operational Certificate",
    "cborHex": "<hex>"
}

16進数のcborHexは、次の正規の2要素CBOR構造を表します。

[[kes_vkey, counter, kes_period, signature], cold_vkey]

外側の配列は、4要素の証明書タプルと32バイトのcold_vkeyを2要素として持ちます。Bursaは指定された32バイトのシードまたは64バイトのEd25519秘密鍵からこのコールド検証鍵を導出し、検証とラウンドトリップのために含めます。

必要な入力:
--kes-vkey KES検証鍵ファイル (bech32またはhex形式)
--cold-skey プールコールド署名鍵ファイル (bech32またはhex形式)
--counter 証明書のシーケンス番号 (新しい証明書ごとにインクリメントする必要があります)
--kes-period 証明書作成時のKES期間

✅ カウンタの値は、新しい運用証明書を作成するたびに、古いKESキーでブロックをミントした場合に限り、インクリメントする必要があります。KES期間は、現在のスロットをKES期間あたりのスロット数で割ったものです (通常はメインネットで129600スロット = 約36時間)。

node.certを作成するには、次のコマンドを実行できます。

⚠️ KESおよびコールドキーへのパスを調整してください。また、以下のカウンタとKES期間も調整してください。

./bursa cert op-cert --kes-vkey /path/kes.vkey --cold-skey /path/cold.skey --counter 0 --kes-period 200 --out node.cert

プール登録証明書を生成

プール登録証明書は、新しいステークプールを登録するか、Cardanoブロックチェーン上の既存の登録を更新します。

必要な入力:

--cold-vkey プールコールド検証鍵ファイル

--vrf-vkey VRF検証鍵ファイル

--pledge プレッジ額(lovelace)

--cost エポックごとの固定コスト(lovelace)

--margin プールマージン（0.0以上1.0以下の有限値）負の値、1.0を超える値、NaN、正または負の無限大は無効です。Bursa はプール登録証明書を生成する前に、これらの無効な値を拒否します。

--reward-account 報酬アカウントアドレス (bech32ステークアドレス)

オプションの入力:

--metadata-url プールメタデータURL

--metadata-hash プールメタデータハッシュ (hex)

--owner-stake-vkey プール所有者のステーク検証鍵ファイル (繰り返し指定可)

--relay-address リレーIPアドレスとポート (IPv4:portまたは[IPv6]:port) (繰り返し指定可)

--relay-host オプションのポートを付けたリレーホスト名 (name[:port]) (繰り返し指定可)

--relay-multi-host マルチホスト名 (DNS SRV、繰り返し指定可)

--owner-stake-vkeyを1つも指定しない場合、--reward-accountのステークキーを既定のプール所有者として使用します。報酬アカウントがステークキーアドレスでない場合は、--owner-stake-vkeyを明示的に指定する必要があります。所有者ファイルは、StakeVerificationKeyShelley_ed25519型のステーク検証キーエンベロープである必要があります。

リレーは、アドレス、ホスト、マルチホストの順に証明書へ書き込みます。

出力形式はcardano-cli証明書と互換性があります。

⚠️ 以下のパスを調整してください。

./bursa cert pool-registration \
    --cold-vkey /path/cold.vkey --vrf-vkey /path/vrf.vkey \
    --pledge 1000000000 --cost 340000000 --margin 0.01 \
    --reward-account stake1... \
    --owner-stake-vkey /path/owner.vkey \
    --relay-address 203.0.113.10:3001 \
    --relay-host relay.example.com:3001 \
    --relay-multi-host pool.example.com \
    --metadata-url "https://example.com/pool.json" \
    --metadata-hash "abc123..." --out pool-reg.cert

所有者とリレーを指定する例:

./bursa cert pool-registration \
    --cold-vkey /path/cold.vkey --vrf-vkey /path/vrf.vkey \
    --pledge 500000000 --cost 340000000 --margin 0.05 \
    --reward-account stake1... --owner-stake-vkey /path/owner.vkey \
    --relay-address 203.0.113.10:3001 --out pool-reg.cert

プール引退証明書を生成

プール引退証明書は、ステークプールが指定されたエポック境界で引退することを示します。

必要な入力:

--cold-vkey プールコールド検証鍵ファイル

--epoch 引退エポック

出力形式はcardano-cli証明書と互換性があります。

⚠️ コールドキーへのパスを調整してください。

./bursa cert pool-retirement --cold-vkey /path/cold.vkey \
    --epoch 300 --out pool-retire.cert

ステークアドレス登録証明書を作成

この証明書はステークアドレスをオンチェーンで登録します。これは、ステークキーが委任や報酬の引き出しに使用される前に必要です。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

オプションの入力:

--deposit <lovelace> デポジット額。--depositフラグを省略するとShelley形式(タイプ0)を出力し、指定すると指定した額を含むConway形式(タイプ7)を出力します。値に0を指定した場合もConway形式を選択します。

⚠️ 以下のパスを調整してください。

./bursa cert stake-registration \
    --stake-vkey /path/stake.vkey --out stake-reg.cert

--depositフラグを指定する場合:

./bursa cert stake-registration \
    --stake-vkey /path/stake.vkey --deposit 2000000 --out stake-reg.cert

ステークアドレス登録解除証明書を作成

この証明書はステークアドレスの登録を解除し、デポジットを返却し、オンチェーン登録からステークキーを削除します。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

オプションの入力:

--deposit-refund <lovelace> デポジット返金額。--deposit-refundフラグを省略するとShelley形式(タイプ1)を出力し、指定すると指定した額を含むConway形式(タイプ8)を出力します。値に0を指定した場合もConway形式を選択します。

⚠️ 以下のパスを調整してください。

 ./bursa cert stake-deregistration \
    --stake-vkey /path/stake.vkey --out stake-dereg.cert

--deposit-refundフラグを指定する場合:

 ./bursa cert stake-deregistration \
    --stake-vkey /path/stake.vkey --deposit-refund 2000000 \
    --out stake-dereg.cert

ステーク委任証明書を作成

この証明書は、プールID(bech32またはhex形式)で識別される特定のステークプールにステークキーからステークを委任します。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

⚠️ 以下のパスを調整してください。

./bursa cert stake-delegation \
    --stake-vkey /path/stake.vkey \
    --pool-id pool1... \
    --out stake-deleg.cert

DRep登録証明書を作成 (Conway)

この証明書は、Delegated Representative (DRep) をオンチェーンで登録します。これにより、DRepは投票委任を受け取り、ガバナンスアクションに参加できるようになります。

lovelaceでのデポジット額が必要です。DRepメタデータ用に、オプションでアンカーURLとハッシュを提供できます。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

アンカーメタデータ付きDRep登録の例

⚠️ 以下のパスを調整してください。

./bursa cert drep-registration \
    --drep-vkey /path/drep.vkey \
    --deposit 500000000 \
    --anchor-url https://example.com/drep.json \
    --anchor-hash abc123... \
    --out drep-reg.cert

DRep登録解除証明書を作成 (Conway)

この証明書はオンチェーンガバナンスからDRepを登録解除し、デポジット返金額を返却します。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

⚠️ 以下のパスを調整してください。

./bursa cert drep-deregistration \
    --drep-vkey /path/drep.vkey \
    --deposit-refund 500000000 \
    --out drep-dereg.cert

投票委任証明書を作成 (Conway)

この証明書は、ステークキーから投票権をDRepに、または特別な投票オプション(常時棄権または常時不信任)に委任します。

委任先は1つだけ指定する必要があります:
--drep-vkey-hash	キーハッシュ(hex)でDRepに委任
--drep-id	ID (bech32またはhex) でDRepに委任
--always-abstain	常に投票を棄権する
--always-no-confidence	常に不信任に投票する

出力形式はcardano-cli互換のJSONテキストエンベロープです。

⚠️ 以下のパスを調整してください。

特定のDRepに委任

  ./bursa cert vote-delegation \
    --stake-vkey /path/stake.vkey \
    --drep-id drep1... \
    --out vote-deleg.cert

常時棄権

  ./bursa cert vote-delegation \
    --stake-vkey /path/stake.vkey \
    --always-abstain \
    --out vote-deleg.cert

委員会ホットキー認証証明書を作成 (Conway)

この証明書は、ガバナンス投票のために、委員会コールドキーに代わって行動するホットキーを承認します。コールドキーはオフラインのまま保持され、ホットキーがガバナンスに参加します。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

⚠️ 以下のパスを調整してください。

./bursa cert committee-hot-auth \
    --cold-vkey /path/cc-cold.vkey \
    --hot-vkey /path/cc-hot.vkey \
    --out cc-hot-auth.cert

委員会コールドキー辞任証明書を作成 (Conway)

この証明書は、コールドキーによって委員会メンバーを辞任させます。理由書を参照するために、オプションでアンカーURLとハッシュを提供できます。

出力形式はcardano-cli互換のJSONテキストエンベロープです。

⚠️ 以下のパスを調整してください。

アンカーなしで辞任

  ./bursa cert committee-cold-resign \
    --cold-vkey /path/cc-cold.vkey \
    --out cc-resign.cert

アンカー理由書付きで辞任

  ./bursa cert committee-cold-resign \
    --cold-vkey /path/cc-cold.vkey \
    --anchor-url https://example.com/resign.json \
    --anchor-hash abc123... \
    --out cc-resign.cert

その他のBursaコマンドを探索

Bursaコマンドカテゴリ

wallet - Cardanoウォレットの管理に必要なウォレットおよびファイルを生成するコマンド

api    - APIを実行するコマンド

kes-agent    - KESエージェントを実行するコマンド

cert - 各種Cardano証明書を生成するコマンド

hash     - Cardanoで使用される暗号ハッシュを生成するコマンド

script    - マルチシグネチャ操作用のコマンド

address - Cardanoアドレスを操作するコマンド

key    - ニーモニックから個別の鍵を導出するコマンド

tx - オフライントランザクション操作

sign - CIP-8/CIP-30メッセージの署名と検証

signer - リモート署名サービス

Docs authored by Doc Holiday

ページを編集

最終更新日: 2026/11/04

前へ
コマンドラインガイド次へ
Hashコマンドラインガイド