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:

• Make a keychain with:

  $ blockstack-cli -t make_keychain

• Use the Faucet below to fund your payment address with some Stacks
• Get the price of a name with:

  $ blockstack-cli -t price BLOCKSTACK_ID

• Register a name with:

  $ blockstack-cli -t register hello_world.id2 YOUR_OWNER_KEY YOUR_PAYMENT_KEY GAIA_READ_URL

• Register a subdomain with:

  $ blockstack-cli -t register_subdomain hello_world.personal.id2 YOUR_OWNER_KEY GAIA_READ_URL SUBDOMAIN_REGISTRAR_URL

• Check your balance with:

  $ blockstack-cli -t balance YOUR_ADDRESS

• Check a transaction's confirmations with:

  $ 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:

• Send Stacks tokens with:

  $ 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.

• Send Bitcoin with:

  $ blockstack-cli -t send_btc ADDRESS AMOUNT_SATOSHIS PAYMENT_KEY

Making a Namespace

If you want to create a namespace, use the following commands:

• Get the price of the namespace with:

  $ blockstack-cli -t price_namespace NAMESPACE_ID

• Preorder the namespace with:

  $ blockstack-cli -t namespace_preorder NAMESPACE_ID REVEAL_ADDRESS PAYMENT_KEY

• Reveal the namespace with:

  $ blockstack-cli -t namespace_reveal NAMESPACE_ID REVEAL_ADDRESS VERSION LIFETIME COEFFICIENT BASE PRICE_BUCKETS NONALPHA_DISCOUNT NO_VOWEL_DISCOUNT PAYMENT_KEY

• Launch the namespace with:

  $ 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

• Testnet blocks are generated once every 60 seconds. Your transactions may take that long to confirm.
• Names take up to 10 blocks to register.
• Subdomains take up to 10 blocks to register.
• If you want to run your own subdomain registrar, register a name and read the instructions here.
• If you want to run your own Gaia hub, see here.
• A detailed, step-by-step guide can be found in this helpful testnet tutorial video

NOTE: This server reboots every 24 hours.