65 lines
1.8 KiB
ReStructuredText
65 lines
1.8 KiB
ReStructuredText
Public Testnets
|
|
===============
|
|
|
|
Here we'll cover the basics of joining a public testnet. These testnets
|
|
come and go with various names are we release new versions of tendermint
|
|
core. This tutorial covers joining the ``gaia-1`` testnet. To join
|
|
other testnets, choose different initialization files, described below.
|
|
|
|
Get Tokens
|
|
----------
|
|
|
|
If you haven't already `created a key <../key-management.html>`__,
|
|
do so now. Copy your key's address and enter it into
|
|
`this utility <http://www.cosmosvalidators.com/>`__ which will send you
|
|
some ``fermion`` testnet tokens.
|
|
|
|
Get Files
|
|
---------
|
|
|
|
Now, to sync with the testnet, we need the genesis file and seeds. The
|
|
easiest way to get them is to clone and navigate to the tendermint
|
|
testnet repo:
|
|
|
|
::
|
|
|
|
git clone https://github.com/tendermint/testnets ~/testnets
|
|
cd ~/testnets/gaia-1/gaia
|
|
|
|
NOTE: to join a different testnet, change the ``gaia-1/gaia`` filepath
|
|
to another directory with testnet inititalization files *and* an
|
|
active testnet.
|
|
|
|
Start Node
|
|
----------
|
|
|
|
Now we can start a new node:it may take awhile to sync with the
|
|
existing testnet.
|
|
|
|
::
|
|
|
|
gaia node start --home=$HOME/testnets/gaia-1/gaia
|
|
|
|
Once blocks slow down to about one per second, you're all caught up.
|
|
|
|
The ``gaia node start`` command will automaticaly generate a validator
|
|
private key found in ``~/testnets/gaia-1/gaia/priv_validator.json``.
|
|
|
|
Finally, let's initialize the gaia client to interact with the testnet:
|
|
|
|
::
|
|
|
|
gaia client init --chain-id=gaia-1 --node=tcp://localhost:46657
|
|
|
|
and check our balance:
|
|
|
|
::
|
|
|
|
gaia client query account $MYADDR
|
|
|
|
Where ``$MYADDR`` is the address originally generated by ``gaia keys new bob``.
|
|
|
|
You are now ready to declare candidacy or delegate some fermions. See the
|
|
`staking module overview <./staking-module.html>`__ for more information
|
|
on using the ``gaia client``.
|