Welcome to the Blockstack blockchain 1.0 testnet. This is NOT the Stacks 2.0 testnet! This is the *legacy* testnet!
To get started, first install the Blockstack CLI.
Basic Usage
Here's how you can get started with registering names and subdomains:
$ blockstack-cli -t make_keychain
$ blockstack-cli -t price BLOCKSTACK_ID
$ blockstack-cli -t register hello_world.id2 YOUR_OWNER_KEY YOUR_PAYMENT_KEY GAIA_READ_URL
$ blockstack-cli -t register_subdomain hello_world.personal.id2 YOUR_OWNER_KEY GAIA_READ_URL SUBDOMAIN_REGISTRAR_URL
$ blockstack-cli -t balance YOUR_ADDRESS
$ blockstack-cli -t get_confirmations YOUR_TXID
You can find values for GAIA_READ_URL
and SUBDOMAIN_REGISTRAR_URL
in the Services panel.
Sending and Receiving Stacks Tokens
You can send and receive Stacks with the following commands:
$ blockstack-cli -t send_tokens TOKEN_ADDRESS "STACKS" AMOUNT_MICROSTACKS PAYMENT_KEY [MEMO]
Note that the second argument must be "STACKS"
. You can optionally supply a memo string to be attached to the transaction.
Note also that TOKEN_ADDRESS
must be a Stacks address.
You can use blockstack-cli convert_address ADDRESS
to convert between Bitcoin and Stacks addresses.
You can use blockstack-cli get_address PRIVATE_KEY
to get both the Bitcoin and Stacks addresses for a private key.
$ blockstack-cli -t send_btc ADDRESS AMOUNT_SATOSHIS PAYMENT_KEY
Making a Namespace
If you want to create a namespace, use the following commands:
$ blockstack-cli -t price_namespace NAMESPACE_ID
$ blockstack-cli -t namespace_preorder NAMESPACE_ID REVEAL_ADDRESS PAYMENT_KEY
$ blockstack-cli -t namespace_reveal NAMESPACE_ID REVEAL_ADDRESS VERSION LIFETIME COEFFICIENT BASE PRICE_BUCKETS NONALPHA_DISCOUNT NO_VOWEL_DISCOUNT PAYMENT_KEY
$ blockstack-cli -t namespace_ready NAMESPACE_ID REVEAL_KEY
Example:
$ export PAYMENT_KEY="... your payment key goes here ..."
$ export REVEAL_KEY="... your reveal key goes here ..."
$ export REVEAL_ADDR="$(blockstack-cli -t get_address "$REVEAL_KEY")"
$ blockstack-cli -t namespace_preorder id2 "$REVEAL_ADDRESS" "$PAYMENT_KEY"
$ blockstack-cli -t namespace_reveal id2 "$REVEAL_ADDRESS" 3 52595 250 4 "6,5,4,3,2,1,0,0,0,0,0,0,0,0,0,0" 10 10 "$PAYMENT_KEY"
$ blockstack-cli -t namespace_ready id2 "$REVEAL_KEY"
Tips, Tricks and Resources
NOTE: This server reboots every 24 hours.