4.4 KiB

Raw Blame History

layout	description	permalink
smart	Blockstack CLI Wallet Quickstart	/:collection/:path.html

Send/Receive Stacks on Testnet

This quickstart guide will show you how to setup a Stacks wallet using the Blockstack JavaScript CLI and use it to send/receive Stacks tokens on Testnet. This wallet is intended for developer experimentation with Testnet only, do not use this wallet to store your tokens.

Prerequisites

You will need to have npm installed.

Installation

To install the Blockstack CLI, run the following command in terminal.

npm install -g https://github.com/blockstack/cli-blockstack#feature/stacks-2.0-tx

Creating a Wallet

First, we are going to generate a new wallet for Testnet. To generate a wallet use the make_keychain command with the -t option for Testnet.

$ blockstack-cli make_keychain -t

{
  "mnemonic": "private unhappy random runway boil scissors remove harvest fatigue inherit inquiry still before mountain pet tail mad accuse second milk client rebuild salt chase",
  "keyInfo": {
    "privateKey": "381314da39a45f43f45ffd33b5d8767d1a38db0da71fea50ed9508e048765cf301",
    "address": "ST1BG7MHW2R524WMF7X8PGG3V45ZN040EB9EW0GQJ",
    "index": 0
  }
}

The mnemonic is your 24 word seed phrase which you should back up securely if you want access to this wallet again in the future. Once lost, it cannot be recovered.

The Stacks address associated with this wallet is: ST1BG7MHW2R524WMF7X8PGG3V45ZN040EB9EW0GQJ

Note that this is a Testnet address for use with Testnet only. You will use this address to receive tokens from the Testnet faucet or other people.

The private key is what you will need to send tokens later.

Getting Tokens

To receive Testnet Stacks tokens, visit the Testnet stacks token faucet. Enter the Stacks address you generated above into the address field on the faucet page and click "Get STX".

Once the faucet transaction has been broadcasted, you will need to wait for the balance to be reflected in your account.

Checking Balance

Once you’ve requested Testnet Stacks tokens from the faucet, you can check the balance of your account using the following command.

$ blockstack-cli balance ST1BG7MHW2R524WMF7X8PGG3V45ZN040EB9EW0GQJ -H "http://neon.blockstack.org:20443"

{
  "balance": "1000",
  "nonce": 0
}

Using the -H option, we specify a connection to the testnet node at http://neon.blockstack.org:20443

Verify that your account has tokens before continuing to the next step to send tokens.

Sending Tokens

In order to send tokens, we will need the 5 parameters below.

Recipient Address - The Stacks address of the recipient

Amount - The number of Stacks to send denoted in microstacks (1 STX = 1000000 microstacks)

Fee Rate - The transaction fee rate for this transaction. You can safely set a fee rate of 1 for Testnet.

Nonce - The nonce is a number that needs to be incremented monotonically for each transaction from the account. This ensures transactions are not duplicated. You can get the latest valid nonce for each account using the balance command.

Private Key - This is the private key corresponding to your account that was generated when you created the wallet earlier using the CLI.

Once we have the parameters, we can use the send_tokens command:

$ blockstack-cli send_tokens ST1WZ69T99RHQMQX3D91ZH2R37GV5NK8KDS5D5VDZ 1000 200 0 381314da39a45f43f45ffd33b5d8767d1a38db0da71fea50ed9508e048765cf301 -t -T "http://neon.blockstack.org:20443/v2/transactions"

d32de0d66b4a07e0d7eeca320c37a10111c8c703315e79e17df76de6950c622c

With this command we’re sending 1000 microstacks to the Stacks address ST1WZ69T99RHQMQX3D91ZH2R37GV5NK8KDS5D5VDZ.

We set the fee rate to 200 microstacks.

The nonce is set to 0 for this transaction, since it will be the first transaction we send from this account.

Finally, the last parameter is the private key from earlier. 381314da39a45f43f45ffd33b5d8767d1a38db0da71fea50ed9508e048765cf301

Once again, we’re using the -t option to indicate that this is a Testnet transaction, so it should be broadcasted to Testnet.

Using the -T option, we specify that we want to broadcast to the testnet node at http://neon.blockstack.org:20443/v2/transactions

If valid, your transaction will now be broadcasted to the network and you will see the transaction ID displayed on the screen.

4.4 KiB Raw Blame History