新しい運用証明書の発行

ステークプールには、プールを実行する権限があることを確認するための有効な運用証明書が必要です。

ステークプールの運用証明書を確立するには、最新のKESキーペアが必要です。
KES期間は、運用証明書が有効な期間を示します。
運用証明書は、運用証明書で定義されたKES期間の90日後に期限切れになります。
ステークプールでブロックを作成するには、90日ごとに、またはそれより早く、新しいKESキーペアと運用証明書を生成する必要があります。

ステークプールのブロック生成ノードを開始するには、秘密のKESキーが必要です。公開KESキーは機密ではありません。

運用証明書の発行には、ステークプールがブロックを作成するために使用する固有の運用証明書ごとに1ずつ増加するカウンターも使用されます。
有効な運用証明書では、運用証明書の発行に使用するカウンター値は、プロトコルによってCardano ブロックチェーンに登録されたステークプールの現在のカウンター値と一致している必要があります。

info

KESキーのローテーションと新しい運用証明書の発行に役立つコンパニオンスクリプトは、こちらから入手できます。

カウンター値について

カウンター値の決定

ブロックチェーンプロトコルによって登録されたステークプールの現在のカウンター値を取得します。

ブロックプロデューサーノードのターミナルウィンドウで、次のように入力します。

cd $NODE_HOME
cardano-cli latest query kes-period-info \
    ${NODE_NETWORK} \
    --op-cert-file node.cert

cardano-cli latest query kes-period-info コマンドは次のような出力を返します。

✓ Operational certificate's KES period is within the correct KES period interval
✓ The operational certificate counter agrees with the node protocol state counter
{
    "qKesCurrentKesPeriod": 15,
    "qKesEndKesInterval": 18,
    "qKesKesKeyExpiry": null,
    "qKesMaxKESEvolutions": 6,
    "qKesNodeStateOperationalCertificateNumber": 3,　←カウンター値の設定値はこちらに対して+1にする
    "qKesOnDiskOperationalCertificateNumber": 3,
    "qKesRemainingSlotsInKesPeriod": 690,
    "qKesslots_per_kes_period": 300,
    "qKesStartKesInterval": 12
}

qKesNodeStateOperationalCertificateNumber キーの値は、ブロックチェーンプロトコルによって登録されたステークプールの現在のカウンター値を示します。
qKesOnDiskOperationalCertificateNumber キーの値は、ステークプールが使用する現在の運用証明書のカウンター値を示します。

新しい運用証明書の場合、カウンター値は qKesNodeStateOperationalCertificateNumber キーの現在の値より正確に1大きくなければなりません。

warning

KES更新前にqKesOnDiskOperationalCertificateNumberがqKesNodeStateOperationalCertificateNumberより1以上大きい場合、運用証明書は無効です。
ステークプールは無効な運用証明書を使用してブロックを作成することはできません。

最初のブロックを作成する

ステークプールがゼロ (0) ブロックをミントした場合、ブロックチェーンプロトコルによって qKesNodeStateOperationalCertificateNumber の値が登録されません。
したがって、ステークプールの現在のカウンター値を取得すると、qKesNodeStateOperationalCertificateNumber キーの値が null になります。

ステークプールが初めてブロックを作成した後、現在のカウンター値を取得すると、qKesNodeStateOperationalCertificateNumber キーに値ゼロ (0) が返されます。

したがって、ステークプールがゼロ (0) ブロックをミントした場合、ステークプールが初めてブロックをミントすることを選択したときにブロックが正常に作成されるように、qKesOnDiskOperationalCertificateNumber キーにゼロ (0) の値を設定する必要があります。

カウンター値の設定

新しい運用証明書を発行すると、node.counterファイルによって新しい証明書のカウンター値が設定されます。

info

Coin Cashewの指示に従うと、ブロック生成ノードのキーを生成するときにnode.counterファイルが作成されます。

ブロックプロデューサーノードでcardano-cli latest query kes-period-infoコマンドを実行すると、qKesOnDiskOperationalCertificateNumber キーの値が qKesNodeStateOperationalCertificateNumber キーの値と等しい場合、ステークプールは現在の運用証明書を使用して少なくとも1つのブロックを生成しており、カウンター値を手動で設定する必要はありません。

qKesOnDiskOperationalCertificateNumberキーの値が qKesNodeStateOperationalCertificateNumber キーの値より大きい場合は、新しい運用証明書を発行する前に、次の手順を使用してカウンター値を設定する必要があります。

KES更新のタイミングを確認します。

slot_num_int=`curl -s http://localhost:12798/metrics | grep cardano_node_metrics_slotNum_int | awk '{ print $2 }'`
echo "scale=6; ${slot_num_int} / 129600" | bc | awk '{printf "%.5f\n", $0}'

戻り値の小数点以下が.99800付近の場合は切り替わってから進めてください。

カウンター値の設定をします。

cd $NODE_HOME
cardano-cli latest query kes-period-info ${NODE_NETWORK} --op-cert-file $NODE_HOME/node.cert --out-file kes-period-info.json
node_certificate_number=`cat kes-period-info.json | jq -r '.qKesNodeStateOperationalCertificateNumber'`

if expr "${node_certificate_number}" : "[0-9]*$" >&/dev/null; then
echo '----------------------------------------------'
echo オンチェーンカウンター番号 : ${node_certificate_number}
echo 更新カウンター番号 : $((${node_certificate_number} + 1))
echo '---------------------------------------------'
else
echo '----------------------------'
echo まだブロックを生成していないため、更新カウンター番号は "0" です。
echo '----------------------------'
fi
rm kes-period-info.json

新しい運用証明書を発行するためのカウンター値を設定

エアギャップ

変数update_counter_numberにBPで出力した更新カウンター番号を入力します。

read -p "BPで出力した 更新カウンター番号 を入力 : " update_counter_number

必要なカウンター値を持つ新しい node.counterファイルを生成します。

chmod u+rwx $HOME/cold-keys

cd $NODE_HOME
cardano-cli latest node new-counter \
    --cold-verification-key-file $HOME/cold-keys/node.vkey \
    --counter-value ${update_counter_number} \
    --operational-certificate-issue-counter-file $HOME/cold-keys/node.counter

info

ステークプールのqKesNodeStateOperationalCertificateNumberキーの現在の値がnullの場合は、--counter-valueオプションをゼロ（0）に設定します。
新しい node.counter ファイルを生成すると、新しい運用証明書を発行するまで description キーの値は空になります。

正しくカウンター番号が生成されているか確認します。

cardano-cli latest text-view decode-cbor \
--in-file  $HOME/cold-keys/node.counter \
| grep int | head -1 | cut -d"(" -f2 | cut -d")" -f1

入力した更新カウンター番号であること