Creating a Wallet
To operate a stake pool, you need to create the following addresses for a wallet:
- Payment Address—Used to store, receive and send money
- Stake Address—Used to store and withdraw rewards, as well as to define the stake pool owner, rewards accounts and stake pool delegation
You can create a wallet for your stake pool using key pairs or a seed phrase. While creating a wallet using keys is simpler, using a seed phrase offers the convenience of accessing the rewards account holding the pledge for your stake pool using an online, Desktop or Mobile wallet.
Note | Pledge is the stake that you delegate to the pool that you operate, serving as a security measure and indicating your commitment to the Cardano ecosystem. |
If you create a wallet using a seed phrase, then you can generate the keys for the wallet. If you create a wallet using keys, then generating the seed phrase for the wallet is NOT possible.
For security, generate key pairs, addresses and the optional seed phrase using your air-gapped, offline computer.
Note | Cardano CLI commands throughout the How to Set Up a Cardano Stake Pool guide may use the |
Using Keys
To create a new wallet using a terminal window on your air-gapped, offline computer:
- To generate a new payment address key pair using the file names
payment.vkeyandpayment.skeytype:cd $NODE_HOMEcardano-cli conway address key-gen \--verification-key-file payment.vkey \--signing-key-file payment.skeyNote

You copied the Cardano CLI binary when Configuring an Air-gapped, Offline Computer.
- To generate a new stake address key pair using the file names
stake.vkeyandstake.skeytype:cardano-cli conway stake-address key-gen \--verification-key-file stake.vkey \--signing-key-file stake.skey - To generate a stake address using the file name
stake.addrtype:cardano-cli conway stake-address build \--stake-verification-key-file stake.vkey \--out-file stake.addr \--mainnet - To generate a payment address using the file name
payment.addrthat is associated with the stake address you created in step 3, type:cardano-cli conway address build \--payment-verification-key-file payment.vkey \--stake-verification-key-file stake.vkey \--out-file payment.addr \--mainnet - Carefully back up the files containing the payment address and stake address as well as the corresponding public verification and secret keys using a secure and comprehensive backup strategy.
- Using removable media, copy the
stake.vkey,stake.addrandpayment.addrfiles to the$NODE_HOMEfolder on your block-producing node.
Using a Seed Phrase
To create a new wallet using a seed phrase:
- Using a terminal window on the computer designated as the block-producing node in your stake pool configuration, type the following commands to download the latest release of Cardano Wallet:cd $NODE_HOMERELEASETAG=$(curl -s https://api.github.com/repos/cardano-foundation/cardano-wallet/releases/latest | jq -r .tag_name)wget https://github.com/cardano-foundation/cardano-wallet/releases/download/${RELEASETAG}/cardano-wallet-${RELEASETAG}-linux64.tar.gz
- Using removable media, copy the TAR.GZ archive that you downloaded in step 1 to the
$NODE_HOMEfolder on your air-gapped, offline computer, and then type the following command using a terminal window to extract the contents of the archive, where<ArchiveName>is the name of the file containing Cardano Wallet:tar -xvzf <ArchiveName> - To copy the
shelley-genesis.jsonfile for the environment that you use, type the following command where<ArchiveFolder>is the name of the folder where you extracted Cardano Wallet in step 2, and<EnvironmentName>is the name of the environment:cp ./<ArchiveFolder>/configs/<EnvironmentName>/shelley-genesis.json $NODE_HOME - To add Cardano Wallet as well as bundled Cardano CLI binaries to the PATH environment variable temporarily, and then generate a 24-word seed phrase, type:export PATH="$(pwd)/cardano-wallet-${RELEASETAG}-linux64:$PATH"cardano-wallet recovery-phrase generate --size 24 > seed-phrase.dat
- Using a text editor, create a new file named
$NODE_HOME/createWallet.sh, and then paste the following script into the file:#!/bin/bash## To run the createWallet.sh script, type the following command where <Index> is 0 or 1# indicating the payment key path for the wallet, <OutputFolder> is the location where# you want the script to save keys and addresses, and <SeedPhrase> is the 24-word seed# phrase that you want the script to use:## createWallet.sh <Index> <OutputFolder> <SeedPhrase>## For example, type:## ./createWallet.sh 0 wallet-keys $(cat seed-phrase.dat)## Keys used in Cardano transactions are five derivations away from the seed phrase,# using the derivation path 1852H/1815H/<x>H/<y>/<z> where:## - 1852 is the coin ID for ADA# - 1815 is an extra, unused path# - <x> is the wallet index number# - <y> is 0 or 1 indicating the payment key path for wallet <x>, or 2 indicating the# staking key path# - <z> is the key number## NOTE: An extended key may derive a hierarchy of other keys. Normal keys represent a# single, standalone key pair.## NOTE: An enterprise address is a payment address that cannot participate in staking.## For more details on Cardano Wallet, see https://cardano-foundation.github.io/cardano-wallet/## For more details on using the cardano-address binary, to access built-in help type:## cardano-address --help### Assign paths to required binaries to variables#CADDR=${CADDR:=$(which cardano-address)}[[ -z "$CADDR" ]] && { echo "cardano-address is not available. Exiting..." >&2 ; exit 1; }CCLI=${CCLI:=$(which cardano-cli)}[[ -z "$CCLI" ]] && { echo "cardano-cli is not available. Exiting..." >&2 ; exit 1; }BECH32=${BECH32:=$(which bech32)}[[ -z "$BECH32" ]] && { echo "bech32 is not available. Exiting..." >&2 ; exit 1; }## Parse arguments passed to the script## Only support 24-word seed phrases[[ "$#" -ne 26 ]] && {echo "usage: $(basename $0) Arguments passed to the script are incorrect. Only 24-word seed phrases are supported." >&2exit 1}IDX=$1shiftOUT_DIR="$1"[[ -e "$OUT_DIR" ]] && {echo "The folder $OUT_DIR already exists. Please delete the folder, and then run the createWallet.sh script again." >&2exit 1} || mkdir -p "$OUT_DIR" && pushd "$OUT_DIR" >/dev/nullshiftSEEDPHRASE="$*"## If the Shelley Genesis file exists, then query to retrieve required values#GEN_FILE=${GEN_FILE:="../shelley-genesis.json"}[[ ! -f "$GEN_FILE" ]] && { echo "Shelley genesis file is not available. Exiting..." >&2 ; exit 1; }NW_ID=$(jq '.networkMagic' -r "$GEN_FILE")MAGIC="--testnet-magic $NW_ID"case $NW_ID in1)NETWORK="preprod";;2)NETWORK="preview";;*)NETWORK="mainnet"MAGIC="--mainnet";;esac## Derive keys and addresses#echoecho "Generating wallet in the $NETWORK environment..."echo# Convert the seed phrase into the master keyecho "$SEEDPHRASE" | "$CADDR" key from-recovery-phrase Shelley > root.prv# Using the master key, derive the extended private stake address keycat root.prv | "$CADDR" key child 1852H/1815H/0H/2/0 > stake.xprv# Using the master key, derive the extended private payment address keycat root.prv | "$CADDR" key child 1852H/1815H/0H/$IDX/0 > payment.xprv# Using the extended private keys, derive the extended public keys# as well as the enterprise address and payment addresscat payment.xprv \| "$CADDR" key public --with-chain-code \| tee payment.xpub \| "$CADDR" address payment --network-tag $NETWORK \| tee enterprise.addr_candidate \| "$CADDR" address delegation $(cat stake.xprv | "$CADDR" key public --with-chain-code | tee stake.xpub) \| tee payment.addr_candidate \| "$CADDR" address inspectechoecho "Wallet generated using derivation path 1852H/1815H/0H/$IDX/0"echo# Using Cardano CLI, convert extended private keys to the corresponding Shelley-format secret signing key"$CCLI" conway key convert-cardano-address-key --shelley-payment-key --signing-key-file payment.xprv --out-file payment.skey"$CCLI" conway key convert-cardano-address-key --shelley-stake-key --signing-key-file stake.xprv --out-file stake.skey# Using secret signing keys, get extended public verification keys"$CCLI" conway key verification-key --signing-key-file payment.skey --verification-key-file payment.evkey"$CCLI" conway key verification-key --signing-key-file stake.skey --verification-key-file stake.evkey# Using extended public verification keys, get normal public verification keys"$CCLI" conway key non-extended-key --extended-verification-key-file payment.evkey --verification-key-file payment.vkey"$CCLI" conway key non-extended-key --extended-verification-key-file stake.evkey --verification-key-file stake.vkey# Using the stake address public verification key, generate the stake address"$CCLI" conway stake-address build --stake-verification-key-file stake.vkey $MAGIC --out-file stake.addr# Using the payment address public verification key, generate the enterprise address"$CCLI" conway address build --payment-verification-key-file payment.vkey $MAGIC --out-file enterprise.addr# Using the payment address and stake address public verification keys, generate the payment address# associated with the stake address"$CCLI" conway address build \--payment-verification-key-file payment.vkey \--stake-verification-key-file stake.vkey \$MAGIC \--out-file payment.addrecho "WARNING: If the address in the payment.addr file Cardano CLI generates does NOT match the address in the payment.addr_candidate file"echo " Cardano Wallet generates, then do NOT use the wallet:"echoecho " payment.addr: $(cat payment.addr)"echo "payment.addr_candidate: $(cat payment.addr_candidate)"echodiff -s payment.addr payment.addr_candidateechopopd > /dev/nullCredit

Thanks to Geld Tiger, den-is and ilap for preparing the original script.
- Save and close the
createWallet.shfile, and then type the following command to grant file permissions for executing the script:chmod +x createWallet.sh - To generate keys and addresses for your wallet, type:./createWallet.sh 0 wallet-keys $(cat seed-phrase.dat)
- To prevent overwriting your seed phrase, type the following command to remove Cardano Wallet binaries where
<ArchiveFolder>is the name of the folder where you extracted Cardano Wallet in step 2:rm -r $NODE_HOME/<ArchiveFolder> - To protect your seed phrase, type the following command to clear history:history -c && history -w
- Close the terminal window that you used to create your wallet, and then open a new terminal window if needed.
- Carefully back up the
$NODE_HOME/seed-phrase.datfile, as well as all files in the$NODE_HOME/wallet-keys/folder, using a secure and comprehensive backup strategy. - Using removable media, from the
$NODE_HOME/wallet-keys/folder copy thestake.vkey,stake.addrandpayment.addrfiles to the$NODE_HOMEfolder on the computer designated as the block-producing node in your stake pool configuration.
Funding Your Payment Address
Using a wallet, send funds that you want to pledge to your stake pool from another account you control to the new payment address.
To fund the new payment address:
- To display the new payment address, using a terminal window type:cat $NODE_HOME/payment.addr
- For a Mainnet payment address, use a wallet of your choice to send funds that you want to pledge to the address that displays in step 1
OR For a payment address in a Testnet environment, request funds using the Testnets Faucet.Challenge

Using Cardano CLI, create a transaction Sending Funds to the new payment address.
- Wait a few moments for the transaction to complete. To verify the transaction, type the following command using a terminal window on the block-producing node to display the list of Unspent Transaction Output (UTXOs) available for the new payment address, and then find the UTXO for the funds that you sent in step 2:cardano-cli conway query utxo \--address $(cat $NODE_HOME/payment.addr) \--mainnet
The UTXO query displays JSON output similar to the following—where the key is the transaction hash, followed by a hash (#) character, and then followed by the transaction index—displaying the value of the UTXO in Lovelace:
{
"4f26e87038f6657ea9429732685c43525685506816420dc5f0e50c692d3387e6#0": {
"address": "addr_test1qzkdq88knvkrycp40zv9mtdejqqjqwklvzcjmvlj8erjgx5q628ecngj4yjr4dmtfqwj76qcqrwclgwvn39hm4hcy9eqcsza02",
"datum": null,
"datumhash": null,
"inlineDatum": null,
"inlineDatumRaw": null,
"referenceScript": null,
"value": {
"lovelace": 9997654786
}
}
}
Note | Named after the English mathematician and writer Ada Lovelace, the currency symbol for ADA is ₳ and the sub-unit is the Lovelace. ₳1 is comprised of 1,000,000 Lovelace. |