diff --git a/3000/README.md b/3000/README.md new file mode 100644 index 00000000..cc2b79bd --- /dev/null +++ b/3000/README.md @@ -0,0 +1,65 @@ +# Testnet 3000 + +## Overview +Kava testnet-3000 will test the functionality of the Kava blockchain prior to deployment of mainnet. If no bugs are found, this version of [Kava](https://www.github.com/kava-labs/kava) will be the same as the version used on mainnet. If you are planning on running a validator on miannet it is **strongly** reccommended that you participate in testnet-3000. + +## Joining +To join testnet-3000 as a validator, you should submit both a **genesis transaction** and an **account addresss**. The genesis transaction will be for your validator and the account address will control vesting coins that can be delegated. Coins held by the account address will be in a new account type called a [Validator Vesting Account](https://github.com/Kava-Labs/kava/blob/master/x/validator-vesting/spec/01_concepts.md), which vests the coins over time based on weather or not your validator participates in consensus. For testnet-3000, coins will be released every ~12 hours if the validator has signed 90% or greater pre-commits. + + Since this is new functionality, we encourage participants to test regular account actions like delegating/undelegating coins, sending coins, and taking your validator offline. If you suspect you have found a bug, file an issue in the [Kava repo](https://www.github.com/kava-labs/kava/issues) or post it in the [riot chat](https://riot.im/app/#/room/#kava-validators:matrix.org) + +1. Install Kava + +**Requires Go 1.13** + +```sh +git clone https://github.com/kava-labs/kava +git checkout v0.3.0-rc1 +make install +kvd init --chain-id=kava-testnet-3000 +``` + +`kvd version --long` should output: + +```sh +name: kava +server_name: kvd +client_name: kvcli +version: 0.3.0-rc1 +commit: 247ccc288678da0d30b24a4589164eecbcd031ed +build_tags: netgo,ledger +go: go version go1.13 darwin/amd64 +``` + +2. Create a gentx for your validator + +```sh +kvcli keys add +kvd add-genesis-account $(kvcli keys show validator -a) 50000000ukava +kvd gentx --name --amount 50000000ukava +``` + +3. Create your account address and save it to a text file. + +```sh +kvcli keys add +kvcli keys show -a > .txt +``` + +4. Submit your gentx and account address as a PR. + +First, fork https://github.com/kava-labs/kava-testnets to your `$HOME` directory. + +```sh +cd $HOME/kava-testnets +# Make a directory for your gentx +mkdir ./3000/ +cp $HOME/.kvd/config/gentx/gentx-* $HOME/kava-testnets/3000/gentx//. +cp $HOME/kava/.txt $HOME/kava-testnets/3000/gentx//. +``` + +The structure of your PR should look like ![this](testnet-3000-dir-structure.png) + +Push the changes to github and submit a PR at the [kava-testnets](https://github.com/kava-labs/kava-testnets) repo. + +For general troubleshooting, please use the [riot chat](https://riot.im/app/#/room/#kava-validators:matrix.org). \ No newline at end of file diff --git a/3000/genesis-params.md b/3000/genesis-params.md index 076c8c61..f8a46503 100644 --- a/3000/genesis-params.md +++ b/3000/genesis-params.md @@ -27,11 +27,10 @@ These are the same as cosmos hub 3 and 2. hub 1 was slightly different. ### Bank -Start with txs disabled and use governance to enable them. -Note: faucet won't work. +Start with txs enabled "bank": { - "send_enabled": false + "send_enabled": true }, ### Genutil @@ -67,7 +66,7 @@ Disable community pool by setting tax to 0. "community_tax": "0.000000000000000000", "base_proposer_reward": "0.010000000000000000", "bonus_proposer_reward": "0.040000000000000000", - "withdraw_addr_enabled": false, + "withdraw_addr_enabled": true, "delegator_withdraw_infos": [], "previous_proposer": "", "outstanding_rewards": [], @@ -87,6 +86,7 @@ Mint has same parameters as hubs 1, 2, and 3 except ref: [https://github.com/cosmos/cosmos-sdk/issues/2846](https://github.com/cosmos/cosmos-sdk/issues/2846) `annual_provisions` is fine to start at zero, the setting here is just the initial value. It gets computed each block from the inflation percentage and the total supply. +```json "mint": { "minter": { "inflation": "0.070000000000000000", @@ -101,6 +101,7 @@ ref: [https://github.com/cosmos/cosmos-sdk/issues/2846](https://github.com/cosmo "blocks_per_year": "5057308" } }, +``` ### Auth diff --git a/3000/gentx/.gitkeep b/3000/gentx/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/3000/testnet-3000-dir-structure.png b/3000/testnet-3000-dir-structure.png new file mode 100644 index 00000000..596254e3 Binary files /dev/null and b/3000/testnet-3000-dir-structure.png differ