Verifying Stake Pool Registration
The Cardano protocol only elects stake pools registered on the blockchain ledger to produce blocks. To verify that the stake pool you operate is registered, complete the following tasks:
- Retrieve the stake pool ID.
- Query the stakes delegated the pool.
- Search for the stake pool using a blockchain explorer.
Retrieving the Stake Pool ID
You can represent the unique ID for a stake pool using a hexadecimal or Bech32 format. The following examples illustrate each format:
# Hexadecimal format example
de060bd1b1ae27f3d7f11a918b2a6734192c2b8500ed38c8da6cc4b1
# Bech32 format example
pool1mcrqh5d34cnl84l3r2gck2n8xsvjc2u9qrkn3jx6dnztzhr6aaa
The Bech32 format is designed for better error detection and user experience.
To compute and display the unique ID for the stake pool that you operate using hexadecimal format:
- Using a terminal window on the block-producing node in your stake pool configuration, type:cd $NODE_HOMEcardano-cli conway stake-pool id \--cold-verification-key-file node.vkey \--output-format hex \--out-file stakepoolid-hex.txtcat stakepoolid-hex.txt
To compute and display the unique ID for the stake pool that you operate using Bech32 format:
- Using a terminal window on the block-producing node in your stake pool configuration, type:cd $NODE_HOMEcardano-cli conway stake-pool id \--cold-verification-key-file node.vkey \--output-format bech32 \--out-file stakepoolid-bech32.txtcat stakepoolid-bech32.txt
Querying Stakes
Using the stake pool ID, you can query the Cardano blockchain to display the stakes delegated to a pool.
Note | Cardano CLI commands throughout the How to Set Up a Cardano Stake Pool guide may use the |
To display the stakes delegated to the pool that you operate:
- Using a terminal window on the block-producing node in your stake pool configuration, type the following command where
<StakePoolID>is the stake pool ID using hexadecimal or Bech32 format:cardano-cli conway query stake-snapshot \--stake-pool-id <StakePoolID> \--mainnet
If the stake snapshot query returns results, then the stake pool is registered. For example:
{
"pools": {
"de060bd1b1ae27f3d7f11a918b2a6734192c2b8500ed38c8da6cc4b1": {
"stakeGo": 0,
"stakeMark": 0,
"stakeSet": 0
}
},
"total": {
"stakeGo": 1000766854112746,
"stakeMark": 987996914983585,
"stakeSet": 1001114042650656
}
}
The JSON output displays the following keys in alphabetical order, with all values in Lovelace:
- stakeGo—Total stakes in the previous epoch
- stakeSet—Total stakes in the current epoch
- stakeMark—Total stakes currently delegated for the next epoch
Searching For a Stake Pool
Using the stake pool ID, you can also search for the stake pool that you operate using a blockchain explorer. If a blockchain explorer displays details related to a stake pool, then the pool is registered on the Cardano network.
