95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
|
# Testnet Setup
|
||
|
|
|
||
|
|
**Note:** This document is incomplete and may not be up-to-date with the
|
||
|
|
state of the code.
|
||
|
|
|
||
|
|
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 couple of genesis transactions to be incorporated into
|
||
|
|
the genesis file, this will create two keys with the password
|
||
|
|
`1234567890`:
|
||
|
|
|
||
|
|
```
|
||
|
|
gaiad init gen-tx --name=foo --home=$HOME/.gaiad1
|
||
|
|
gaiad init gen-tx --name=bar --home=$HOME/.gaiad2
|
||
|
|
gaiacli keys list
|
||
|
|
```
|
||
|
|
|
||
|
|
**Note:** If you've already run these tests you may need to overwrite
|
||
|
|
keys using the `--owk` flag When you list the keys you should see two
|
||
|
|
addresses, we'll need these later so take note. Now let's actually
|
||
|
|
create the genesis files for both nodes:
|
||
|
|
|
||
|
|
```
|
||
|
|
cp -a ~/.gaiad2/config/gentx/. ~/.gaiad1/config/gentx/
|
||
|
|
cp -a ~/.gaiad1/config/gentx/. ~/.gaiad2/config/gentx/
|
||
|
|
gaiad init --gen-txs --home=$HOME/.gaiad1 --chain-id=test-chain
|
||
|
|
gaiad init --gen-txs --home=$HOME/.gaiad2 --chain-id=test-chain
|
||
|
|
```
|
||
|
|
|
||
|
|
**Note:** If you've already run these tests you may need to overwrite
|
||
|
|
genesis using the `-o` flag. What we just did is copy the genesis
|
||
|
|
transactions between each of the nodes so there is a common genesis
|
||
|
|
transaction set; then we created both genesis files independently from
|
||
|
|
each home directory. Importantly both nodes have independently created
|
||
|
|
their `genesis.json` and `config.toml` files, which should be identical
|
||
|
|
between nodes.
|
||
|
|
|
||
|
|
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
|
||
|
|
```
|
||
|
|
|
||
|
|
Then, we try to transfer some `steak` to another account:
|
||
|
|
|
||
|
|
```
|
||
|
|
gaiacli account <FOO-ADDR>
|
||
|
|
gaiacli account <BAR-ADDR>
|
||
|
|
gaiacli send --amount=10steak --to=<BAR-ADDR> --name=foo --chain-id=test-chain
|
||
|
|
```
|
||
|
|
|
||
|
|
**Note:** We need to be careful with the `chain-id` and `sequence`
|
||
|
|
|
||
|
|
Check the balance & sequence with:
|
||
|
|
|
||
|
|
```
|
||
|
|
gaiacli account <BAR-ADDR>
|
||
|
|
```
|
||
|
|
|
||
|
|
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 --chain-id=<chain-id> --name=test
|
||
|
|
```
|
||
|
|
|
||
|
|
That's it!
|
||
|
|
|
||
|
|
**Note:** TODO demonstrate edit-candidacy **Note:** TODO demonstrate
|
||
|
|
delegation **Note:** TODO demonstrate unbond of delegation **Note:**
|
||
|
|
TODO demonstrate unbond candidate
|