Skip to content

Commit

Permalink
mostly small language edits
Browse files Browse the repository at this point in the history
  • Loading branch information
brentstone committed Aug 7, 2024
1 parent 5e4f879 commit e787b44
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 9 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,5 @@ Setting up a decentralized Namada network requires coordination between two dist
This process is also called the **genesis ceremony** or the **pre-genesis process**.

The purpose of this process is to establish the initial (genesis) state of the network -- including initial account balances, an initial validator set and an initial stake distribution -- through social consensus.
This is done by generating *pre-genesis transactions* which define established accounts, validator accounts and/or bonds. See the [pre-genesis participants](./genesis-flow/participants.mdx#pre-genesis-network-participants)
This is done by generating *pre-genesis transactions* that define established accounts, validator accounts, and bonds. See the [pre-genesis participants](./genesis-flow/participants.mdx#pre-genesis-network-participants)
section for more details on generating pre-genesis transactions.
Original file line number Diff line number Diff line change
Expand Up @@ -26,14 +26,14 @@ Conventionally, the network coordinator hosts a git repository that allows the p

### Allocating pre-genesis NAM balances

Once the participants have [submitted their keys and addresses](./participants.mdx#submitting-keys-and-addresses) the network coordinator must allocate balances to these addresses/public keys. The coordinator will often have prior identity information associated with desired balances, which they will then associate with the public keys and addresses in order to set the correct balances in `balances.toml`. The coordinator must also ensure that the total pre-genesis NAM balances allocated to the pre-genesis network participants is equal to the total NAM supply.
Once the participants have [submitted their keys and addresses](./participants.mdx#submitting-keys-and-addresses), the network coordinator must allocate balances to these addresses/public keys. The coordinator will often have prior identity information associated with desired balances, which they will then associate with the public keys and addresses in order to set the correct balances in `balances.toml`. The coordinator must also ensure that the total pre-genesis NAM balances allocated to the pre-genesis network participants is equal to the total NAM supply.

After this is completed, the network coordinator will publish the `balances.toml` file that contains the pre-genesis NAM balances allocated to the pre-genesis network participants. The `balances.toml` file should be published in the same location as the pre-genesis public keys were submitted.
After this is completed, the network coordinator will publish the `balances.toml` file that contains the pre-genesis NAM balances allocated to the pre-genesis network participants. The `balances.toml` file should be published at the same location to which the pre-genesis public keys were submitted.


### Collecting pre-genesis transactions

Once the participants have [submitted their keys and addresses](./participants.mdx#submitting-keys-and-addresses) the network coordinator must collect the signed pre-genesis transactions from the pre-genesis network participants.
Once the participants have [submitted their keys and addresses](./participants.mdx#submitting-keys-and-addresses), the network coordinator must collect the signed pre-genesis transactions from the pre-genesis network participants.

The network coordinator then aggregates these transaction files into one file and saves it as the `transactions.toml` file to be used in the generation of the genesis block.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ import { Callout } from 'nextra-theme-docs'
import { Steps } from 'nextra-theme-docs'

# Pre-genesis participants
This section contains details on the pre-genesis process and instructions on how participants can generate, sign and submit each available type of pre-genesis
This section contains details on the pre-genesis process and instructions on how participants can generate, sign, and submit each available type of pre-genesis
transaction.

## Genesis state
Expand All @@ -14,7 +14,7 @@ Initial token allocations are given in the chain's `balances.toml` file, and the
derived as a result of applying the pre-genesis transactions given in the chain's `transactions.toml` file.

To produce an initial validator set in a decentralized manner, network participants (i.e. users and operators) are given the opportunity to generate and submit a
pre-genesis transaction in which they initialize their validators and/or bond stake to another genesis validator.
pre-genesis transaction in which they can initialize their validators and/or bond stake to a genesis validator.

Prospective pre-genesis transactions are then collected in a single location (typically a GitHub repo) where they can be reviewed by the
[network coordinator](./coordinator.mdx) and selected for inclusion in the genesis block. The finalized set of pre-genesis transactions are
Expand Down Expand Up @@ -205,11 +205,11 @@ The `--net-address` specifies the network address of the validator node given by
The `--alias` flag is the moniker name of the validator account in your wallet.
The `--commission-rate` and `--max-commision-rate` flags are the commission rate and the maximum permitted commission rate change of the validator account per epoch. See the validator docsfor more info.
The `--commission-rate` and `--max-commision-rate` flags are the commission rate and the maximum permitted commission rate change of the validator account per epoch. See the [validator docs](../../../operators/validators/validator-setup.mdx#initialize-a-new-validator-account) for more info.
The `--email` flag is the email address of the validator account. This is used for the validator account to receive notifications from the network coordinator and other participants.
The optional flags `--name`, `--discord-handle`, `--avatar`, `--website` and `--description` configure additional optional on-chain metadata which identify your validator.
The optional flags `--name`, `--discord-handle`, `--avatar`, `--website` and `--description` configure additional optional on-chain metadata that identify your validator.
The `--address` flag is the `tnam...` address of the established account that was generated in the previous section.
Expand Down Expand Up @@ -252,7 +252,7 @@ namadac utils genesis-bond \
### Signing transactions
In the case of init-validator and bond transactions, after generating your pre-genesis transaction (but before submitting it for inclusion in the genesis block) you must
For validator initialization and bonding transactions, after generating your pre-genesis transaction (but before submitting it for inclusion in the genesis block), you must
sign it with the relevant private key. You can do this using the `sign-genesis-txs` command.
The command will check for the necessary private key in the [pre-genesis wallet](#pre-genesis-wallet). If you are signing an init-validator
Expand Down

0 comments on commit e787b44

Please sign in to comment.