Skip to content

Latest commit

 

History

History
94 lines (63 loc) · 3.24 KB

020_keys_and_addresses.md

File metadata and controls

94 lines (63 loc) · 3.24 KB

Creating keys and addresses

UPDATED FOR TAG: 1.14.2

We need to create two sets of keys and addresses: One set to control our funds (make and receive payments) and one set to control our stake (to participate in the protocol delegating our stake)

Let's produce our cryptographic keys first, as we will need them to later create our addresses:

Payment key pair

  1. First we need to generate our payment key pair:

     cardano-cli shelley address key-gen \
     --verification-key-file payment.vkey \
     --signing-key-file payment.skey

    This will create two files (here named payment.vkey and payment.skey), one containing the public verification key, one the private signing key.

    The files are in plain-text format and human readable:

     cat payment.vkey

 > type: VerificationKeyShelley
 > title: Free form text
 > cbor-hex:
 >  18af58...

    The first line describes the file type and should not be changed. The second line is a free form text that we could change if we so wished. The key itself is the cbor-encoded byte-string in the fourth line.

Stake key pair

  1. Now let us create our stake key pair :

     cardano-cli shelley stake-address key-gen \
 --verification-key-file stake.vkey \
 --signing-key-file stake.skey

It's content look like this:

cat stake.vkey

type: StakingVerificationKeyShelley
title: Free form text
cbor-hex:
18b958203e...

Payment address

  1. We then use payment.vkey and stake.vkey to create our payment address:

     cardano-cli shelley address build \
 --payment-verification-key-file payment.vkey \
 --stake-verification-key-file stake.vkey \
 --out-file payment.addr \
 --testnet-magic 42

This created the file payment.addr that is already associated with our stake keys:

cat payment.addr
> 00ec78e3d3916636101f6d9539c451f248ba200f38f2c33129f7ef36d66853603e872296956a4d86

  1. To query your address (see the utxo's at that address), you first need to set environment variable CARDANO_NODE_SOCKET_PATH to the socket-path specified in your node configuration. In this example we will use the block-producing node created in the previous steps:

     export CARDANO_NODE_SOCKET_PATH=~/cardano-node/relay/db/node.socket

    and make sure that your node is running. Then use

    cardano-cli shelley query utxo \
--address $(cat payment.addr) \
--testnet-magic 42

    you should see something like this:

                           TxHash                                 TxIx        Lovelace

    (The --testnet-magic 42 is specific to the Shelley Testnet, for mainnet we would use --mainnet instead.)

Stake address

  1. Finally, we can create our stake address. This address CAN'T receive payments but will receive the rewards from participating in the protocol. We will save this address in the file stake.addr

     cardano-cli shelley stake-address build \
 --stake-verification-key-file stake.vkey \
 --out-file stake.addr \
 --testnet-magic 42

This created the file stake.addr, let's check its content:

cat stake.addr
> 5821e0872296956a4d86ee9654060734e83dddc56016fb2ecc7cbb435ee8e3c1053d9d