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を作成できます。

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

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

node.certの出力形式は、cardano-cliの運用証明書と互換性があります。

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

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

プール登録証明書を生成

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

出力形式は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... \
    --metadata-url "https://example.com/pool.json" \
    --metadata-hash "abc123..." --out pool-reg.cert

プール引退証明書を生成

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

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

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

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

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

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

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

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

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

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

 ./bursa cert stake-deregistration \
    --stake-vkey /path/stake.vkey --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コマンドを探索