About

Welcome to the Blockstack blockchain 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.

Services
Blockchain Height:
loading...
Consensus Hash:
loading...
Gaia read URL:
loading...
Gaia write URL:
loading...
Transaction broadcaster:
loading...
Subdomain registrar:
loading...
Bitcoin JSON-RPC:
loading...
Bitcoin P2P:
loading...
Faucet

This will also send 5000000 satoshis to your address


Registered Names and Namespaces
Names
Namespaces
loading...
loading...
Blockstack Transactions from the Last Block
loading...
Testnet Peers
loading...