194 lines
4.3 KiB
ReStructuredText
194 lines
4.3 KiB
ReStructuredText
Testnet Setup
|
|
=============
|
|
|
|
See the `installation guide <../sdk/install.html>`__ for details on installation.
|
|
|
|
Here is a quick example to get you off your feet:
|
|
|
|
First, generate a new key with a name, and save the address:
|
|
|
|
::
|
|
|
|
MYNAME=<your name>
|
|
gaiacli keys new $MYNAME
|
|
gaiacli keys list
|
|
MYADDR=<your newly generated address>
|
|
|
|
|
|
Now initialize a gaia chain:
|
|
|
|
::
|
|
|
|
gaiad init --home=$HOME/.gaiad1
|
|
|
|
you should see seed phrase for genesis account in the output & config & data folder in the home directory.
|
|
|
|
In the config folder, there will be the following files: ``config.toml``, ``genesis.json``, ``node_key.json``, and ``priv_validator.json``.
|
|
|
|
The genesis file should look like this:
|
|
|
|
::
|
|
|
|
{
|
|
"genesis_time": "0001-01-01T00:00:00Z",
|
|
"chain_id": "test-chain-0TRiTa",
|
|
"validators": [
|
|
{
|
|
"pub_key": {
|
|
"type": "AC26791624DE60",
|
|
"value": "<value>"
|
|
},
|
|
"power": 10,
|
|
"name": ""
|
|
}
|
|
],
|
|
"app_hash": "",
|
|
"app_state": {
|
|
"accounts": [
|
|
{
|
|
"address": "<ADDR>",
|
|
"coins": [
|
|
{
|
|
"denom": "steak",
|
|
"amount": 9007199254740992
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
|
|
**Note:** We need to change the denomination of token from default to ``steak`` in the genesis file.
|
|
|
|
Then, recover the genesis account with ``gaiacli``:
|
|
|
|
::
|
|
|
|
gaiacli keys add <name> --recover
|
|
|
|
By now, you have set up the first node. This is great!
|
|
|
|
We can add a second node on our local machine by initiating a node in a new directory, and copying in the ``genesis.json``:
|
|
|
|
::
|
|
|
|
gaiad init --home=$HOME/.gaiad2
|
|
|
|
and replace the ``genesis.json`` and ``config.toml`` files:
|
|
|
|
::
|
|
|
|
cp $HOME/.gaiad/config/genesis.json $HOME/.gaiad2/config
|
|
cp $HOME/.gaiad/config/config.toml $HOME/.gaiad2/config
|
|
|
|
then, get the node id of first node:
|
|
|
|
::
|
|
|
|
gaiad show_node_id --home=$HOME/.gaiad1
|
|
|
|
We need to also modify $HOME/.gaiad2/config.toml to set new seeds and ports. It should look like:
|
|
|
|
::
|
|
|
|
proxy_app = "tcp://127.0.0.1:46668"
|
|
moniker = "anonymous"
|
|
fast_sync = true
|
|
db_backend = "leveldb"
|
|
log_level = "state:info,*:error"
|
|
|
|
[rpc]
|
|
laddr = "tcp://0.0.0.0:46667"
|
|
|
|
[p2p]
|
|
laddr = "tcp://0.0.0.0:46666"
|
|
persistent_peers = "<node1-ID>@0.0.0.0:46656"
|
|
|
|
|
|
Great, now that we've initialized the chains, we can start both nodes in the background:
|
|
|
|
::
|
|
|
|
gaiad start --home=$HOME/.gaiad1 &> gaia1.log &
|
|
NODE1_PID=$!
|
|
gaia start --home=$HOME/.gaiad2 &> gaia2.log &
|
|
NODE2_PID=$!
|
|
|
|
Note that we save the PID so we can later kill the processes. You can peak at your logs with ``tail gaia1.log``, or follow them for a bit with ``tail -f gaia1.log``.
|
|
|
|
Nice. We can also lookup the validator set:
|
|
|
|
::
|
|
|
|
gaiacli validatorset
|
|
|
|
There is only **one** validator now. Let's add another one!
|
|
|
|
First, we need to create a new account:
|
|
|
|
::
|
|
|
|
gaiacli keys new <NAME>
|
|
|
|
Check that we now have two accounts:
|
|
|
|
::
|
|
|
|
gaiacli keys list
|
|
|
|
Then, we try to transfer some ``steak`` to another account:
|
|
|
|
::
|
|
|
|
gaiacli send --amount=1000steak --to=$MYADDR2 --name=$NAME --chain-id=<CHAIN-ID> --node=tcp://localhost:46657 --sequence=0
|
|
|
|
**Note:** We need to be careful with the ``chain-id`` and ``sequence``
|
|
|
|
Check the balance & sequence with:
|
|
|
|
::
|
|
|
|
gaiacli account $MYADDR
|
|
|
|
We can see the balance of ``$MYADDR2`` is 1000 now.
|
|
|
|
Finally, let's bond the validator in ``$HOME/gaiad2``. Get the pubkey first:
|
|
|
|
::
|
|
|
|
cat $HOME/.gaiad2/config/priv_validator.json | jq .pub_key.value
|
|
|
|
Go to `this website <http://tomeko.net/online_tools/base64.php?lang=en>`__ to change pubkey from base64 to Hex.
|
|
|
|
Ok, now we can bond some coins to that pubkey:
|
|
|
|
::
|
|
|
|
gaiacli bond --stake=1steak --validator=<validator-pubkey-hex> --sequence=0 --chain-id=<chain-id> --name=test
|
|
|
|
Nice. We can see there are now two validators:
|
|
|
|
::
|
|
|
|
gaiacli validatorset
|
|
|
|
Check the balance of ``$MYADDR2`` to see the difference: it has 1 less ``steak``!
|
|
|
|
::
|
|
|
|
gaiacli account $MYADDR2
|
|
|
|
To confirm for certain the new validator is active, check tendermint:
|
|
|
|
::
|
|
|
|
curl localhost:46657/validators
|
|
|
|
Finally, to relinquish all your power, unbond some coins. You should see your VotingPower reduce and your account balance increase.
|
|
|
|
::
|
|
|
|
gaiacli unbond --sequence=# --chain-id=<chain-id> --name=test
|
|
|
|
That's it!
|