# Create Cardano Wallet {% hint style="success" %} This tutorial was successful with [**cardano-wallet-v2022-01-18-linux64.tar.gz**](https://github.com/input-output-hk/cardano-wallet/releases/download/v2022-01-18/cardano-wallet-v2022-01-18-linux64.tar.gz) **System:** Ubuntu 20.04.03 LTS\ **Shell:** bash\ **Cardano Node:** 1.33.0 (included in cardano-wallet-v2022-01-18) {% endhint %} {% hint style="info" %} Credits to [**ilap** ](https://gist.github.com/ilap/3fd57e39520c90f084d25b0ef2b96894)and for sure the great [**COINCASHEW**](https://www.coincashew.com/coins/overview-ada/guide-how-to-build-a-haskell-stakepool-node) crew. They have already finished almost 100%of the work and I only try to contribute at least a tiny bit. {% endhint %} {% hint style="danger" %} Most wallets use a recovery phrase / mnemonic seed length of **15 or 24** words. In this expample we will use **24** words. {% endhint %} {% hint style="success" %} **Benefits of mnemonic based wallets:** Track and control pool rewards from any wallet (Daedalus, YOROI or any other wallet) that support stakings. {% endhint %} {% hint style="info" %} **Good to know:** a mnemonic seed phrase is not a pure random number of 15 to 24 words. Words need to be select from a specific library - not all words from all languages are allowed. Indeed, only [specific english lowercase](https://github.com/input-output-hk/cardano-wallet/blob/master/specifications/mnemonic/english.txt) words are allowed. Anyway, will not select the words for our seed manually. We will use the `cardano-wallet` cli, which is part `Cardano Wallet` library. {% endhint %} ### 1. Download latest cardano-wallet release {% embed url="" %} Link to latest cardano-wallet release {% endembed %} ### 2. Lets create the wallet with all necessary keys and phrases ```bash # Uncompress the downloaded file in your home directory cd $HOME mkdir cardano-wallet ``` Now pls copy your downloaded `cardano-wallet-v20---linux64.tar.gz` file into the `cardano-wallet` folder and uncopress it. {% hint style="info" %} **\** in `cardano-wallet-v20---linux64.tar.gz might be different at the time you will create your wallet because their is a new release available!` {% endhint %} ``` cd $HOME/cardano-wallet tar -zxvf cardano-wallet-v20---linux64.tar.gz ``` In the next step we will already be able to generate our mnemonic seed phrase with `cardano-wallet` cli ```bash # Set PATH variable temporary (within the current shell session) # to use the cli cardano-wallet cd $HOME/cardano-wallet export PATH="$(pwd)/cardano-wallet-v20---linux64:$PATH" ``` Lets generate a **24** words long recovery phrase / mnemonic seed phrase by using the `cardano-address` cli ```bash # cardano-wallet is located in cardano-wallet-v20---linux64 cardano-wallet recovery-phrase generate --size 24 > mnemonic-phrase.dat ``` Lets have a look inside the *mnemonic-phrase.dat* file ```bash # you will see 24 words randomly choosen from the allowed nano mnemonic-phrase.dat # you will see a line of words separated by spaces: # word1 word2 word3 word4 ... word24 # about about century destroy ... diet ``` ### 3. Generate your private cardano wallet keys {% hint style="danger" %} These steps must be done on an **air-gapped** machine. That means the PC, notebook, raspberrypi what ever device you use to generate your wallet is **NOT** connected to the internet and will never be. You will store informations on this enveronment that will allow attackers to steel youf funds! {% endhint %} {% hint style="info" %} 1. Make shure to copy `mainnet-shelley-genesis.json` into your `$HOME/cardano-wallet` folder 2. Check if **`jq`** (JASON convert) is installed on your system. \ If not run: `sudo apt-get install jq`\ If you get the error: `E: Couldn't find package jq` you need to update your system and include the [**specific repositories**](https://stackoverflow.com/questions/33184780/install-jq-json-processor-on-ubuntu-10-04). 3. **TESTNET:** change `mainnet-shelley-genesis.json` to `testnet-shelley-genesis.json` in `extractPoolStakingKeys.sh` **(NOT TESTED)** {% endhint %} Create `extractPoolStakingKeys.sh` script. ```bash ### ### On air-gapped offline machine! ### cat > extractPoolStakingKeys.sh << HERE #!/bin/bash # original work from ilap https://gist.github.com/ilap/3fd57e39520c90f084d25b0ef2b96894 # UPDATE by den-is https://gist.github.com/den-is/0fb758b07cdb68abc968b3dea689fa9b CADDR=${CADDR:=$( which cardano-address )} [[ -z "$CADDR" ]] && { echo "cardano-address cannot be found, exiting..." >&2 ; exit 127; } CCLI=${CCLI:=$( which cardano-cli )} [[ -z "$CCLI" ]] && { echo "cardano-cli cannot be found, exiting..." >&2 ; exit 127; } BECH32=${BECH32:=$( which bech32 )} [[ -z "$BECH32" ]] && { echo "bech32 cannot be found, exiting..." >&2 ; exit 127; } # Only 24-word length mnemonic is supported only [[ "$#" -ne 26 ]] && { echo "usage: $(basename $0) <24-word length mnemonic>" >&2 exit 127 } GEN_FILE=${GEN_FILE:="$HOME/cardano-wallet/mainnet-shelley-genesis.json"} [[ ! -f "$GEN_FILE" ]] && { echo "genesis file does not exit, exiting..." >&2 ; exit 127; } IDX=$1 shift OUT_DIR="$1" [[ -e "$OUT_DIR" ]] && { echo "The \"$OUT_DIR\" is already exist delete and run again." >&2 exit 127 } || mkdir -p "$OUT_DIR" && pushd "$OUT_DIR" >/dev/null shift MNEMONIC="$*" # Generate the master key from mnemonics and derive the stake account keys # as extended private and public keys (xpub, xprv) echo "$MNEMONIC" |\ "$CADDR" key from-recovery-phrase Shelley > root.prv cat root.prv |\ "$CADDR" key child 1852H/1815H/0H/2/0 > stake.xprv cat root.prv |\ "$CADDR" key child 1852H/1815H/0H/$IDX/0 > payment.xprv # XPrv/XPub conversion to normal private and public key, keep in mind the # keypars are not a valind Ed25519 signing keypairs. NW=$(jq '.networkId' -r "$GEN_FILE") NW_ID=$(jq '.networkMagic' -r "$GEN_FILE") echo "Generating $NW wallet..." if [ "$NW" == "Testnet" ]; then NETWORK=0 MAGIC="--testnet-magic $NW_ID" CONV="bech32 | bech32 addr_test" else NETWORK=1 MAGIC="--mainnet" CONV="cat" fi cat payment.xprv |\ "$CADDR" key public --with-chain-code | tee payment.xpub |\ "$CADDR" address payment --network-tag $NETWORK |\ "$CADDR" address delegation $(cat stake.xprv | "$CADDR" key public --with-chain-code | tee stake.xpub) |\ tee base.addr_candidate |\ "$CADDR" address inspect echo echo "Generated from 1852H/1815H/0H/$IDX/0" if [ "$NW" == "Testnet" ]; then cat base.addr_candidate | bech32 | bech32 addr_test > base.addr_candidate_test mv base.addr_candidate_test base.addr_candidate fi cat base.addr_candidate echo # Convert cardano-addresses extended signing keys to corresponding Shelley-format keys. "$CCLI" key convert-cardano-address-key --shelley-payment-key --signing-key-file payment.xprv --out-file payment.skey "$CCLI" key convert-cardano-address-key --shelley-stake-key --signing-key-file stake.xprv --out-file stake.skey # Get verification keys from signing keys. "$CCLI" key verification-key --signing-key-file stake.skey --verification-key-file stake.evkey "$CCLI" key verification-key --signing-key-file payment.skey --verification-key-file payment.evkey # Get non-extended verification keys from extended verification keys. "$CCLI" key non-extended-key --extended-verification-key-file stake.evkey --verification-key-file stake.vkey "$CCLI" key non-extended-key --extended-verification-key-file payment.evkey --verification-key-file payment.vkey # Build stake and payment addresses "$CCLI" stake-address build --stake-verification-key-file stake.vkey $MAGIC --out-file stake.addr "$CCLI" address build --payment-verification-key-file payment.vkey $MAGIC --out-file payment.addr "$CCLI" address build \ --payment-verification-key-file payment.vkey \ --stake-verification-key-file stake.vkey \ $MAGIC \ --out-file base.addr echo "Important the base.addr and the base.addr_candidate must be the same" diff -s base.addr base.addr_candidate echo cat base.addr echo cat base.addr_candidate popd >/dev/null HERE ``` Now we need to add execution permisson to `extractPoolStakingKeys.sh` ```bash ### ### On air-gapped offline machine, ### chmod +x extractPoolStakingKeys.sh ``` Extract your keys. Update the command with your mnemonic phrase. ```bash ### ### On air-gapped offline machine, ### ./extractPoolStakingKeys.sh 0 extractedPoolKeys/ $(cat mnemonic-phrase.dat) ``` {% hint style="danger" %} **IMPORTANT:** Please check carefully if the **base.addr** and the **base.addr\_candidate** are identical! {% endhint %} Your new staking keys are in the folder `extractedPoolKeys/` Now move `payment/stake` key pair over to your `$HOME/key` folder ```bash ### ### On air-gapped offline machine, ### cd extractedPoolKeys/ cp stake.vkey stake.skey stake.addr payment.vkey payment.skey base.addr $HOME cd $HOME #Rename to base.addr file to payment.addr mv base.addr payment.addr ``` {% hint style="info" %} **payment.addr**, or also known as **base.addr** from this extraction script, will be the cardano address which holds your pool's pledge. {% endhint %} Finally close all your terminal windows and open new ones with zero history. ```bash ### ### On air-gapped offline machine, ### history -c && history -w ``` {% hint style="success" %} Congratulations! You have generated all your required keys to interact with the Cardano ecosystem. :thumbsup: {% endhint %} ### Fund your payment address Copy **payment.addr** to your **hot environment** (with internet connection and fully sycroniced node).\ Payment address can be funded from your Daedalus / Yoroi wallet.\ Run the following to find your payment address. ```bash cat payment.addr ``` {% hint style="warning" %} **RECOMMENDATION:** Only fund the minimum amount of ADA initally to your new payment.addr to test if everything works as expected. The minimum is 1 ADA. You should be able to: 1. Receive funds on your **payment.addr** 2. Sent funds from your **payment.addr** to any other wallet address\ You could try to send some ADA to: `addr1qyrytjmrf37r0cfas4pa9ss3v3tgqy0m7v4ljmkwtj4m33u4y6asl5ruap3hj6cqhyjn7guh9z4a3ya58xdh064zq8yq4n09fd` {% endhint %} After funding your account, check your payment address balance. {% hint style="danger" %} Before continuing, your nodes must be fully synchronized to the blockchain. Otherwise, you won't see your funds. {% endhint %} {% tabs %} {% tab title="MAINNET: Fully Syncronized Node " %} ```bash cardano-cli query utxo \ --address $(cat payment.addr) \ --mainnet ``` {% endtab %} {% tab title="TESTNET: Fully Syncronized Node " %} ``` cardano-cli query utxo \ --address $(cat payment.addr) \ --testnet-magic 1097911063 ``` {% endtab %} {% endtabs %} You should see output similar to this. This is your unspent transaction output (UXTO). ``` TxHash TxIx Lovelace ---------------------------------------------------------------------------------------- 100322a39d02c2ead.... 0 1000000 ``` {% hint style="info" %} **PLAN B to check the balance:** [**https://explorer.cardano.org/**](https://explorer.cardano.org/) [**https://cardanoscan.io**](https://cardanoscan.io) (TESTNET available)\ \ Simply put the output of `$(cat payment.addr)` into the search field. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://geldtiger.gitbook.io/geti-explainer/create-cardano-wallet.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.