Skip to main content

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:

  1. Retrieve the stake pool ID.
  2. Query the stakes delegated the pool.
  3. 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_HOME
    cardano-cli conway stake-pool id \
    --cold-verification-key-file node.vkey \
    --output-format hex \
    --out-file stakepoolid-hex.txt
    cat 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_HOME
    cardano-cli conway stake-pool id \
    --cold-verification-key-file node.vkey \
    --output-format bech32 \
    --out-file stakepoolid-bech32.txt
    cat 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
Note

Cardano CLI commands throughout the How to Set Up a Cardano Stake Pool guide may use the ‑‑mainnet option. If you are working in a Testnet environment, then remember to replace each instance of the ‑‑mainnet option with ‑‑testnet‑magic <MagicNumber> where <MagicNumber> is the network magic number for the Testnet that you use.

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.