Retiring a Stake Pool

Search…
We assume that we have a registered stake pool with cold keys cold.vkey and cold.skey, a payment address with sufficient funds (for the transaction fees) payment.addr and an associated payment signing key payment.skey.
To retire our pool we need to:
Create a deregistration certificate and
Submit the certificate to the blockchain with a transaction
The deregistration certificate contains the epoch in which we want to retire the pool.
This epoch must be after the current epoch and not later than eMax epochs in the future, where eMax is a protocol parameter.
So we first need to figure out the current epoch. The number of slots per epoch is recorded in the genesis file, and we can get it with
1
cat testnet-shelley-genesis.json | grep epoch
2
> "epochLength": 21600,
Copied!
So one epoch lasts for 21600 slots. We get the current slot by querying the tip:
1
export CARDANO_NODE_SOCKET_PATH=relay-db/node-socket
2
cardano-cli query tip --testnet-magic 1097911063
3
​
4
> Tip (SlotNo {unSlotNo = 856232}) ...
Copied!
This gives us
1
expr 856232 / 432000
2
> 39
Copied!
So we are currently in epoch 39.
We can look up eMax by querying the current protocol parameters:
1
cardano-cli query protocol-parameters \
2
--testnet-magic 1097911063 \
3
--out-file protocol.json
4
​
5
cat protocol.json | grep eMax
6
> "eMax": 100,
Copied!
This means the earliest epoch for retirement is 40 (one in the future), and the latest is 139 (current epoch plus eMax).
So for example, we can decide to retire in epoch 41.
Create deregistration certificate
WARNING This involves the cold keys. Take the necessary precautions to not to expose your cold keys to the internet.
Create the deregistration certificate and save it as pool.retirement:
1
cardano-cli stake-pool deregistration-certificate \
2
--cold-verification-key-file cold.vkey \
3
--epoch 41 \
4
--out-file pool.dereg
Copied!
Draft the transaction
1
cardano-cli transaction build-raw \
2
--tx-in <UTXO>#<TxIx> \
3
--tx-out $(cat payment.addr)+0 \
4
--ttl 0 \
5
--fee 0 \
6
--out-file tx.draft \
7
--certificate-file pool.retirement
Copied!
Calculate the fees:
1
cardano-cli transaction calculate-min-fee \
2
--tx-body-file tx.draft \
3
--tx-in-count 1 \
4
--tx-out-count 1 \
5
--witness-count 1 \
6
--byron-witness-count 0 \
7
--testnet-magic 1097911063 \
8
--protocol-params-file protocol.json
Copied!
For example:
171309
We query our address for a suitable UTxO to use as input:
1
cardano-cli query utxo \
2
--address $(cat payment.addr) \
3
--testnet-magic 1097911063
4
​
5
​
6
​
7
       TxHash             TxIx        Lovelace
8
------------------------------------------------
9
9db6cf...                    0      999999267766
Copied!
We calculate our change:
1
expr 999999267766 - 171309
2
> 999999096457
Copied!
Build, sign and submit the transaction:
Build the raw transaction:
1
cardano-cli transaction build-raw \
2
    --tx-in 9db6cf...#0 \
3
    --tx-out $(cat payment.addr)+999999096457 \
4
    --ttl 860000 \
5
    --fee 171309 \
6
    --out-file tx.raw \
7
    --certificate-file pool.retirement
Copied!
Sign it with both the payment signing key and the cold signing key (the first signature is necessary because we are spending funds from paymant.addr, the second because the certificate needs to be signed by the pool owner):
1
cardano-cli transaction sign \
2
    --tx-body-file tx.raw \
3
    --signing-key-file payment.skey \
4
    --signing-key-file cold.skey \
5
    --testnet-magic 1097911063 \
6
    --out-file tx.signed
Copied!
And submit to the blockchain:
1
cardano-cli transaction submit \
2
    --tx-file tx.signed \
3
    --testnet-magic 1097911063
Copied!
And we are done. The pool will retire at the end of epoch 40. If we change our mind, we can create and submit a new registration certificate before epoch 41, which will then overrule the deregistration certificate.
QUESTIONS AND FEEDBACK
If you have any questions and suggestions while taking the lessons please feel free to ask in the forum and we will respond as soon as possible.
Withdraw rewards
Next - STAKE POOL HANDBOOK
Monitoring the node
Last modified 1yr ago
Copy link
Contents
Create deregistration certificate
Draft the transaction
Calculate the fees:
Build, sign and submit the transaction: