プール情報(pool.cert)の更新¶

概要

誓約、固定手数料、変動手数料、リレー情報、メタ情報を変更する場合に実施します。

注意

誓約・固定手数料・変動手数料の反映は提出エポック＋3エポック後からになります。
例）
320エポックに変更申請
321エポックで有効化
322エポックで待機
323エポックで反映

poolMetaData.jsonをGithubでホストしている場合はダウンロードする
短縮URLをご自身のものに修正してからコマンドを実行してください

メタデータ更新を含む場合誓約、手数料、リレー情報のみ更新の場合

poolMetaData.json

予めpoolMetaData.jsonを修正し、各ホストサーバーへアップロードする （poolMetaData.jsonをGithubでホストしている場合はGithub上で修正し、ダウンロードする）

ブロックプロデューサーノード

cd $NODE_HOME
wget -O poolMetaData.json https://git.io/****

poolMetaData.jsonのハッシュファイルを作成する

ブロックプロデューサーノード

cd $NODE_HOME
cardano-cli stake-pool metadata-hash --pool-metadata-file poolMetaData.json > poolMetaDataHash.txt

ファイル転送

BPのpoolMetaDataHash.txt をエアギャップマシンのcnodeディレクトリにコピーします。

graph LR
    A[BP] -->|poolMetaDataHash.txt| B[エアギャップ];

登録証明書トランザクションを作成する

複数のリレーノードを設定する場合は複数のリレーノードを構成する記述方法を参考にパラメーターを指定して下さい。

注意

以下は参考コードです。ご自身のプール設定値に変更してください
例）

固定費・・・340ADA
Margin・・・5%
誓約・・・1000ADA

エアギャップオフラインマシン

cd $NODE_HOME

chmod u+rwx $HOME/cold-keys
cardano-cli stake-pool registration-certificate \
    --cold-verification-key-file $HOME/cold-keys/node.vkey \
    --vrf-verification-key-file vrf.vkey \
    --pool-pledge 1000000000 \
    --pool-cost 340000000 \
    --pool-margin 0.05 \
    --pool-reward-account-verification-key-file stake.vkey \
    --pool-owner-stake-verification-key-file stake.vkey \
    $NODE_NETWORK \
    --pool-relay-ipv4 ***.***.***.*** \
    --pool-relay-port 6000 \
    --metadata-url https://xxx.xxx.xxx/poolMetaData.json \
    --metadata-hash $(cat poolMetaDataHash.txt) \
    --out-file pool.cert

ヒント

上記のコードを自プール用の設定に修正したら、次回も使用できるようテキストファイルとして保存しておいてください。

ステークプールに誓約します。

エアギャップオフラインマシン

cardano-cli stake-address delegation-certificate \
    --stake-verification-key-file stake.vkey \
    --cold-verification-key-file $HOME/cold-keys/node.vkey \
    --out-file deleg.cert

ファイル転送

エアギャップのpool.certとdeleg.certをブロックプロデューサーのcnodeディレクトリにコピーします。

graph LR
    A[エアギャップ] -->|pool.cert / deleg.cert| B[BP];

最新のスロット番号を取得します

ブロックプロデューサーノード

cd $NODE_HOME
currentSlot=$(cardano-cli query tip $NODE_NETWORK | jq -r '.slot')
echo Current Slot: $currentSlot

payment.addrの残高を出力します。

ブロックプロデューサーノード

cardano-cli query utxo \
    --address $(cat payment.addr) \
    $NODE_NETWORK > fullUtxo.out

tail -n +3 fullUtxo.out | sort -k3 -nr | sed -e '/lovelace + [0-9]/d' > balance.out

cat balance.out

UTXOを算出します

ブロックプロデューサーノード

tx_in=""
total_balance=0
while read -r utxo; do
    in_addr=$(awk '{ print $1 }' <<< "${utxo}")
    idx=$(awk '{ print $2 }' <<< "${utxo}")
    utxo_balance=$(awk '{ print $3 }' <<< "${utxo}")
    total_balance=$((${total_balance}+${utxo_balance}))
    echo TxHash: ${in_addr}#${idx}
    echo ADA: ${utxo_balance}
    tx_in="${tx_in} --tx-in ${in_addr}#${idx}"
done < balance.out
txcnt=$(cat balance.out | wc -l)
echo Total ADA balance: ${total_balance}
echo Number of UTXOs: ${txcnt}

build-rawトランザクションコマンドを実行します。

ブロックプロデューサーノード

cardano-cli transaction build-raw \
    ${tx_in} \
    --tx-out $(cat payment.addr)+${total_balance} \
    --invalid-hereafter $(( ${currentSlot} + 10000)) \
    --fee 0 \
    --certificate-file pool.cert \
    --certificate-file deleg.cert \
    --out-file tx.tmp

最低手数料を計算します。

ブロックプロデューサーノード

fee=$(cardano-cli transaction calculate-min-fee \
    --tx-body-file tx.tmp \
    --tx-in-count ${txcnt} \
    --tx-out-count 1 \
    $NODE_NETWORK \
    --witness-count 3 \
    --byron-witness-count 0 \
    --protocol-params-file params.json | awk '{ print $1 }')
echo fee: $fee

計算結果を出力します。

ブロックプロデューサーノード

txOut=$((${total_balance}-${fee}))
echo txOut: ${txOut}

トランザクションファイルを構築します。

ブロックプロデューサーノード

cardano-cli transaction build-raw \
    ${tx_in} \
    --tx-out $(cat payment.addr)+${txOut} \
    --invalid-hereafter $(( ${currentSlot} + 10000)) \
    --fee ${fee} \
    --certificate-file pool.cert \
    --certificate-file deleg.cert \
    --out-file tx.raw

ファイル転送

BPのtx.raw をエアギャップマシンのcnodeディレクトリにコピーします。

graph LR
    A[BP] -->|tx.raw| B[エアギャップ];

トランザクションに署名します。

エアギャップオフラインマシン

cd $NODE_HOME
cardano-cli transaction sign \
    --tx-body-file tx.raw \
    --signing-key-file payment.skey \
    --signing-key-file $HOME/cold-keys/node.skey \
    --signing-key-file stake.skey \
    $NODE_NETWORK \
    --out-file tx.signed
chmod a-rwx $HOME/cold-keys

ファイル転送

エアギャップのtx.signed をBPのcnodeディレクトリにコピーします。

graph LR
    A[エアギャップ] -->|tx.signed| B[BP];

トランザクションを送信します。

ブロックプロデューサーノード

cardano-cli transaction submit \
    --tx-file tx.signed \
    $NODE_NETWORK

Transacsion Successfully submittedと表示されれば成功