Skip to content

adr-005-genesis-parameters.md

Latest commit

 

History

History
188 lines (133 loc) · 14.5 KB

adr-005-genesis-parameters.md

File metadata and controls

188 lines (133 loc) · 14.5 KB

ADR 005: Genesis parameters

Status

Category Status
Authors Alexandr Kolesov, Ankur Banerjee, Alex Tweeddale
ADR Stage ACCEPTED
Implementation Status Implemented
Start Date 2021-09-15
Last Updated 2022-12-08

Summary

The aim of this document is to define the genesis parameters that will be used in cheqd network testnet and mainnet.

Cosmos v0.44.3 parameters are described.

Context

Genesis consists of Tendermint consensus engine parameters and Cosmos app-specific parameters.

Tendermint consensus parameters

Tendermint requires genesis parameters to be defined for basic consensus conditions on any Cosmos network.

Block parameters

Parameter Description Mainnet Testnet
max_bytes This sets the maximum size of total bytes that can be committed in a single block. This should be larger than max_bytes for evidence. 200,000 (~200 KB) 200,000 (~200 KB)
max_gas This sets the maximum gas that can be used in any single block. 200,000 (~200 KB) 200,000 (~200 KB)
time_iota_ms Unused. This has been deprecated and will be removed in a future version of Cosmos SDK. 1,000 (1 second) 1,000 (1 second)

Evidence parameters

Parameter Description Mainnet Testnet
max_age_num_blocks Maximum age of evidence, in blocks. The basic formula for calculating this is: MaxAgeDuration / {average block time}. 12,100 25,920
max_age_duration Maximum age of evidence, in time. It should correspond with an app's "unbonding period". 1,209,600,000,000,000 (expressed in nanoseconds, ~2 weeks) 59,200,000,000,000 (expressed in nanoseconds, ~72 hours)
max_bytes This sets the maximum size of total evidence in bytes that can be committed in a single block and should fall comfortably under max_bytes for a block. 50,000 (~ 50 KB) 5,000 (~ 5 KB)

Validator key parameters

Parameter Description Mainnet Testnet
pub_key_types Types of public keys supported for validators on the network. Ed25519 Ed25519

Cosmos SDK module parameters

Cosmos application is divided into a list of modules. Each module has parameters that help to adjust the module's behaviour.

auth module

Parameter Description Mainnet Testnet
max_memo_characters Maximum number of characters in the memo field 512 512
tx_sig_limit Max number of signatures 7 7
tx_size_cost_per_byte Gas cost of transaction byte 10 10
sig_verify_cost_ed25519 Cost of ed25519 signature verification 590 590
sig_verify_cost_secp256k1 Cost of secp256k1 signature verification 1,000 1,000

bank module

Parameter Description Mainnet Testnet
default_send_enabled The default send enabled value allows send transfers for all coin denominations True True

cheqd module (DID module)

Parameter Description Mainnet Testnet
create_did The specified transaction fee for creating a Decentralized Identifier (DID) on the cheqd network 50,000,000,000 ncheq (50 CHEQ) 50,000,000,000 ncheq (50 CHEQ)
update_did The specified transaction fee for updating an existing Decentralized Identifier (DID) on the cheqd network 25,000,000,000 ncheq (25 CHEQ) 25,000,000,000 ncheq (25 CHEQ)
deactivate_did The specified transaction fee for deactivating an existing Decentralized Identifier (DID) on the cheqd network 10,000,000,000 ncheq (10 CHEQ) 10,000,000,000 ncheq (10 CHEQ)
burn_factor The percentage of the transaction fee for create_did, update_did or deactivate_did that is burnt, i.e., destroyed from the cheqd network 50% 50%

crisis module

Parameter Description Mainnet Testnet
constant_fee The fee is used to verify the invariant(s) 10,000,000,000,000 ncheq (10,000 CHEQ) 10,000,000,000,000 ncheq (10,000 CHEQ)

distribution module

Parameter Description Mainnet Testnet
community_tax The percent of rewards that goes to the community fund pool 0.02 (2%) 0.02 (2%)
base_proposer_reward Base reward that proposer of a block receives 0.01 (1%) 0.01 (1%)
bonus_proposer_reward Bonus reward that proposer gets for proposing block. This depends on the number of pre-commits included to the block 0.04 (4%) 0.04 (4%)
withdraw_addr_enabled Whether withdrawal address can be changed or not. By default, it's the delegator's address. True True

gov module

Parameter Description Mainnet Testnet
deposit_params
min_deposit The minimum deposit for a proposal to enter the voting period. [{ "denom": "ncheq", "amount": "8,000,000,000,000" }] (8,000 cheq) [{ "denom": "ncheq", "amount": "8,000,000,000,000" }] (8,000 cheq)
max_deposit_period The maximum period for Atom holders to deposit on a proposal. Initial value: 2 months. 604,800s (1 week) 172,800s (48 hours)
voting_params
voting_period The defined period for an on-ledger vote from start to finish. 259,200s (3 days) 86.40s (1.2 minutes)
tally_params
quorum Minimum percentage of total stake needed to vote for a result to be considered valid. 0.334 (33.4%) 0.334 (33.4%)
threshold Minimum proportion of Yes votes for proposal to pass. 0.5 (50%) 0.5 (50%)
veto_threshold The minimum value of veto votes to total votes ratio for proposal to be vetoed. Default value: 1/3. 0.334 (33.4%) 0.334 (33.4%)

mint module

Parameter Description Mainnet Testnet
mint_denom Name of the cheq smallest denomination ncheq ncheq
inflation_rate_change Maximum inflation rate change per year. In Cosmos Hub they use 1.0. Formula: inflationRateChangePerYear = (1 - BondedRatio / GoalBonded) * MaxInflationRateChange 0.045 (4.5%) 0.045 (4.5%)
inflation_max Inflation aims to this value if bonded_ratio < bonded_goal 0.04 (4%) 0.04 (4%)
inflation_min Inflation aims to this value if bonded_ratio > bonded_goal 0.01 (1%) 0.01 (1%)
goal_bonded Percentage of bonded tokens at which inflation rate will neither increase nor decrease 0.60 (60%) 0.60 (60%)
blocks_per_year Number of blocks generated per year 3,155,760 (1 block every ~10 seconds) 3,155,760 (1 block every ~10 seconds)

resource module

Parameter Description Mainnet Testnet
image The specified transaction fee for creating an image as a DID-Linked Resource on the cheqd network 10,000,000,000 ncheq (10 CHEQ) 10,000,000,000 ncheq (10 CHEQ)
json The specified transaction fee for creating a JSON file as a DID-Linked Resource on the cheqd network 2,500,000,000 ncheq (2.5 CHEQ) 2,500,000,000 ncheq (2.5 CHEQ)
default The specified transaction fee for creating any other type of DID-Linked Resource on the cheqd network, other than images or JSON files 5,000,000,000 ncheq (5 CHEQ) 5,000,000,000 ncheq (5 CHEQ)
burn_factor The percentage of the transaction fee for image, json or default DID-Linked Resources that are burnt, i.e., destroyed from the cheqd network 50% 50%

slashing module

Parameter Description Mainnet Testnet
signed_blocks_window Number of blocks a validator can miss signing before it is slashed. 25,920 (expressed in blocks, equates to 259,200 seconds or ~3 days) 17,280 (expressed in blocks, equates to 172,800 seconds or ~2 days)
min_signed_per_window This percentage of blocks must be signed within the window. 0.50 (50%) 0.50 (50%)
downtime_jail_duration The minimal time validator have to stay in jail 600s (~10 minutes) 600s (~10 minutes)
slash_fraction_double_sign Slashed amount as a percentage for a double sign infraction 0.05 (5%) 0.05 (5%)
slash_fraction_downtime Slashed amount as a percentage for downtime 0.01 (1%) 0.01 (1%)

staking module

Parameter Description Mainnet Testnet
unbonding_time A delegator must wait this time after unbonding before tokens become available 1,210,000s (~2 weeks) 259,200s (~3 days)
max_validators The maximum number of validators in the network 125 125
max_entries Max amount of unbound/redelegation operations in progress per account 7 7
historical_entries Amount of unbound/redelegate entries to store 10,000 10,000
bond_denom Denomination used in staking ncheq ncheq

ibc module

Parameter Description Mainnet Testnet
max_expected_time_per_block Maximum expected time per block, used to enforce block delay. This parameter should reflect the largest amount of time that the chain might reasonably take to produce the next block under normal operating conditions. A safe choice is 3-5x the expected time per block. 30,000,000,000 (expressed in nanoseconds, ~ 30 seconds) 30,000,000,000 (expressed in nanoseconds, ~ 30 seconds)
allowed_clients Defines the list of allowed client state types. We allow connections from other chains using the Tendermint client, and with light clients using the Solo Machine client. [ "06-solomachine", "07-tendermint" ] [ "06-solomachine", "07-tendermint" ]

ibc-transfer module

Parameter Description Mainnet Testnet
send_enabled Enables or disables all cross-chain token transfers from this chain true true
receive_enabled Enables or disables all cross-chain token transfers to this chain true true

Decision

The parameters above were agreed separate the cheqd mainnet and testnet parameters. We have bolded the testnet parameters that differ from mainnet.

Consequences

Backward Compatibility

  • The token denomination has been changed to make the smallest denomination 10^-9 CHEQ (= 1 ncheq) instead of 1 CHEQ. This is a breaking change from the earliest versions of the cheqd testnet that which required issuing new tokens to be transferred and issued to testnet node operators.

Positive

  • Inflation allows fees to be collected from block rewards in addition to transaction fees.
  • In production/mainnet, parameters can only be changed via a majority vote without veto defeat according to the cheqd network governance principles. This allows for more democratic governance frameworks to be created for a self-sovereign identity network.

Negative

  • Existing node operators will need to re-establish staking with new staking denomination and staking parameters.

Neutral

  • Unbonding period, and deposit period have all been reduced to 2 weeks to balance the speed at which decisions can be reached vs giving enough time to validators to participate.

References