Register stake pool metadata

To register a stake pool metadata you need to:

  1. Create a JSON file for your stake pool metadata and store it in your node, for ejample:


"name": "TestPool",
"description": "The pool that tests all the pools",
"ticker": "TEST",
"homepage": "https://teststakepool.com"

This data needs to be hosted by the pool operator at a URL that they maintain (their personal website, a github raw gist file, etc, for example "https://gist.githubusercontent.com/testPool/.../testPool.json. The URL must be no more than 64 bytes long.

  1. Get the hash of your file:
cardano-cli shelley stake-pool metadata-hash --pool-metadata-file testPool.json
  1. Register or re-register the pool on-chain using the node CLI as described in the tutorials (Stake Pool Registration). Provide all the necessary metadata in the registration, including the relay information, the URL for the metadata file and metadata hash, as well as the cost parameters.
cardano-cli shelley stake-pool registration-certificate \
--cold-verification-key-file cold.vkey \
--vrf-verification-key-file vrf.vkey \
--pool-pledge <LOVELACE> \
--pool-cost <LOVELACE> \
--pool-margin <PERCENTAGE> \
--pool-reward-account-verification-key-file stake.vkey \
--pool-owner-stake-verification-key-file stake.vkey \
--testnet-magic 42 \
--pool-relay-port <PORT> \
--pool-relay-ipv4 <IP ADDRESS> \
--metadata-url http://testpool/pool1.json
--metadata-hash 6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af \
--out-file node.cert        

Build, sign and submit the transaction:

cardano-cli shelley transaction build-raw \
--tx-in TxId#TxIx \
--tx-out $(cat payment.addr)+<LOVELACE> \
--ttl <SLOT> \
--fee <LOVELACE> \
--out-file tx.raw \
--certificate-file node.cert \
--certificate-file delegation.cert             
cardano-cli shelley transaction sign \
--tx-body-file tx.raw \
--signing-key-file payment.skey \
--signing-key-file payment.skey \
--signing-key-file cold.skey \
--testnet-magic 42 \
--out-file tx.signed
cardano-cli shelley transaction submit \
--tx-file tx.signed \
--testnet-magic 42
  1. Obtain the pool id using the node CLI.
cardano-cli shelley stake-pool id --verification-key-file pool.vkey
> <poolid>

You can check whether the on-chain registration has succeeded by running:

cardano-cli shelley query ledger-state --testnet-magic 42 \
| jq '._delegationState._pstate._pParams.<poolid>'
  1. Temporary step until DB-sync is upgraded

Submit a PR to add your pool data to https://github.com/input-output-hk/cardano-ops/blob/master/topologies/ff-peers.nix You will need to provide your IP address/DNS host name and port.

   operator = “testPool”;
   poolId = “<poolid>”;
   metadataUrl = “https://gist.githubusercontent.com/testPool/.../testPool.json”
   meatadataHash = “6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af”;
   addr = “”;
   port = 3001

cardano-cli shelley transaction build-raw \

Last updated: June 20, 2020 00:00 UTC