diff --git a/README.md b/README.md index d23a1edc8..37b5c4101 100644 --- a/README.md +++ b/README.md @@ -20,12 +20,12 @@ breaking changes. **Note**: Requires [Go 1.11.5+](https://golang.org/dl/) -## Cosmos Hub Public Testnet +## Cosmos Hub Mainnet -To run a full-node in the latest public testnet of the Hub, first [install `gaia`](./docs/gaia/installation.md), then follow [the guide](./docs/gaia/join-testnet.md). +To run a full-node for the mainnet of the Cosmos Hub, first [install `gaia`](./docs/gaia/installation.md), then follow [the guide](./docs/gaia/join-mainnet.md). -For status updates and genesis files, see the -[testnets repo](https://github.com/cosmos/testnets). +For status updates and genesis file, see the +[launch repo](https://github.com/cosmos/launch). ## Quick Start diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index 669c2467e..e8ee111d6 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -26,7 +26,7 @@ module.exports = { sidebar: [ { title: "Overview", - collapsable: false, + collapsable: true, children: [ "/intro/", "/intro/sdk-app-architecture", @@ -35,11 +35,11 @@ module.exports = { }, { title: "Gaia", - collapsable: false, + collapsable: true, children: [ "/gaia/what-is-gaia", "/gaia/installation", - "/gaia/join-testnet", + "/gaia/join-mainnet", "/gaia/validators/validator-setup", "/gaia/validators/overview", "/gaia/validators/security", @@ -47,12 +47,13 @@ module.exports = { "/gaia/delegator-guide-cli", "/gaia/ledger", "/gaia/gaiacli", + "/gaia/join-testnet", "/gaia/deploy-testnet" ] }, { title: "Tutorial", - collapsable: false, + collapsable: true, children: [ "/tutorial/", "/tutorial/app-design", @@ -74,7 +75,7 @@ module.exports = { }, { title: "Clients", - collapsable: false, + collapsable: true, children: [ "/clients/", "/clients/cli", diff --git a/docs/README.md b/docs/README.md index 09c96f9eb..7b1632437 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,9 +11,10 @@ - [SDK API Reference](https://godoc.org/github.com/cosmos/cosmos-sdk): Godocs of the Cosmos SDK. - [REST API spec](https://cosmos.network/rpc/): List of endpoints to interact with a `gaia` full-node through REST. -## Cosmos Hub testnet +## Cosmos Hub -- [Join the public testnet](./gaia/join-testnet.md) of the Cosmos Hub. +- [Join the mainnet](./gaia/join-mainnet.md) of the Cosmos Hub. +- [Join the latest public testnet](./gaia/join-testnet.md) of the Cosmos Hub. - [Start your own `gaia` testnet](./gaia/deploy-testnet.md). ## Creating a new SDK project diff --git a/docs/gaia/README.md b/docs/gaia/README.md index 488ac960c..eaf21a823 100644 --- a/docs/gaia/README.md +++ b/docs/gaia/README.md @@ -2,12 +2,16 @@ Welcome to the `Gaia` docs. `Gaia` is the current name of the Cosmos SDK application for the Cosmos Hub. -## Join the Cosmos Hub public testnet +## Join the Cosmos Hub Mainnet - [Install the `gaia` application](./installation.md) -- [Set up a full node and join the current public testnet](./join-testnet.md) +- [Set up a full node and join the mainnet](./join-mainnet.md) - [Upgrade to a validator node](./validators/validator-setup.md) +## Join the Cosmos Hub Public Testnet + +- [Join the testnet](./join-testnet.md) + ## Setup your own `gaia` testnet - [Setup your own `gaia` testnet](./deploy-testnet.md) diff --git a/docs/gaia/delegator-guide-cli.md b/docs/gaia/delegator-guide-cli.md index 26ae01abc..a77914c1e 100644 --- a/docs/gaia/delegator-guide-cli.md +++ b/docs/gaia/delegator-guide-cli.md @@ -237,7 +237,7 @@ In order to query the state and send transactions, you need a way to access the This is the most secure option, but comes with relatively high resource requirements. In order to run your own full-node, you need good bandwidth and at least 1TB of disk space. -You will find the tutorial on how to install `gaiad` [here](https://cosmos.network/docs/gaia/installation.html), and the guide to run a full-node [here](https://cosmos.network/docs/gaia/join-testnet.html). +You will find the tutorial on how to install `gaiad` [here](https://cosmos.network/docs/gaia/installation.html), and the guide to run a full-node [here](https://cosmos.network/docs/gaia/join-mainnet.html). ### Connecting to a remote full-node @@ -286,7 +286,7 @@ gaiacli config trust-node false Finally, let us set the `chain-id` of the blockchain we want to interact with: ```bash -gaiacli config chain-id gos-6 +gaiacli config chain-id cosmoshub-1 ``` ## Querying the state @@ -299,7 +299,7 @@ gaiacli config chain-id gos-6 ```bash // query account balances and other account-related information -gaiacli query account +gaiacli query account // query the list of validators gaiacli query staking validators @@ -336,20 +336,28 @@ For each command, you can use the `-h` or `--help` flag to get more information. ## Sending Transactions +::: warning +On Cosmos Hub mainnet, the accepted denom is `uatom` (micro-Atom), where `1atom = 1,000,000uatom` +::: + ### A note on gas and fees Transactions on the Cosmos Hub network need to include a transaction fee in order to be processed. This fee pays for the gas required to run the transaction. The formula is the following: ``` -fees = gas * gasPrices +fees = ceil(gas * gasPrices) ``` -The `gas` is dependent on the transaction. Different transaction require different amount of `gas`. The `gas` amount for a transaction is calculated as it is being processed, but there is a way to estimate it beforehand by using the `auto` value for the `gas` flag. Of course, this only gives an estimate. You can adjust this estimate with the flag `--gas-adjustment` (default `1.0`) if you want to be sure you provide enough `gas` for the transaction. +The `gas` is dependent on the transaction. Different transaction require different amount of `gas`. The `gas` amount for a transaction is calculated as it is being processed, but there is a way to estimate it beforehand by using the `auto` value for the `gas` flag. Of course, this only gives an estimate. You can adjust this estimate with the flag `--gas-adjustment` (default `1.0`) if you want to be sure you provide enough `gas` for the transaction. For the remainder of this tutorial, we will use a `--gas-adjustment` of `1.5`. The `gasPrice` is the price of each unit of `gas`. Each validator sets a `min-gas-price` value, and will only include transactions that have a `gasPrice` greater than their `min-gas-price`. The transaction `fees` are the product of `gas` and `gasPrice`. As a user, you have to input 2 out of 3. The higher the `gasPrice`/`fees`, the higher the chance that your transaction will get included in a block. +::: tip +For mainnet, the recommended `gas-prices` is `0.025uatom`. +::: + ### Bonding Atoms and Withdrawing rewards ::: tip @@ -366,22 +374,22 @@ The transaction `fees` are the product of `gas` and `gasPrice`. As a user, you h ```bash // Bond a certain amount of Atoms to a given validator -// ex value for flags: =cosmosvaloper18thamkhnj9wz8pa4nhnp9rldprgant57pk2m8s, =10000stake, =0.001stake +// ex value for flags: =cosmosvaloper18thamkhnj9wz8pa4nhnp9rldprgant57pk2m8s, =10000000uatom, =0.025uatom -gaiacli tx staking delegate --from --gas auto --gas-prices +gaiacli tx staking delegate --from --gas auto --gas-adjustment 1.5 --gas-prices // Withdraw all rewards -// ex value for flag: =0.001stake +// ex value for flag: =0.025uatom -gaiacli tx distr withdraw-all-rewards --from --gas auto --gas-prices +gaiacli tx distr withdraw-all-rewards --from --gas auto --gas-adjustment 1.5 --gas-prices // Unbond a certain amount of Atoms from a given validator // You will have to wait 3 weeks before your Atoms are fully unbonded and transferrable -// ex value for flags: =cosmosvaloper18thamkhnj9wz8pa4nhnp9rldprgant57pk2m8s, =10000stake, =0.001stake +// ex value for flags: =cosmosvaloper18thamkhnj9wz8pa4nhnp9rldprgant57pk2m8s, =10000000uatom, =0.025uatom -gaiacli tx staking unbond --from --gas auto --gas-prices +gaiacli tx staking unbond --from --gas auto --gas-adjustment 1.5 --gas-prices ``` ::: warning @@ -434,21 +442,21 @@ At the end of the voting period, the proposal is accepted if there are more than ```bash // Submit a Proposal // =text/parameter_change/software_upgrade -// ex value for flag: =0.0001stake +// ex value for flag: =0.025uatom -gaiacli tx gov submit-proposal --title "Test Proposal" --description "My awesome proposal" --type --deposit=10stake --gas auto --gas-prices --from +gaiacli tx gov submit-proposal --title "Test Proposal" --description "My awesome proposal" --type --deposit=10000000uatom --gas auto --gas-adjustment 1.5 --gas-prices --from // Increase deposit of a proposal // Retrieve proposalID from $gaiacli query gov proposals --status deposit_period -// ex value for parameter: =1stake +// ex value for parameter: =10000000uatom -gaiacli tx gov deposit --gas auto --gas-prices --from +gaiacli tx gov deposit --gas auto --gas-adjustment 1.5 --gas-prices --from // Vote on a proposal // Retrieve proposalID from $gaiacli query gov proposals --status voting_period //