Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add default params to the spec #2416

Merged
merged 12 commits into from
Sep 4, 2023
1 change: 1 addition & 0 deletions specs/src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,4 @@
- [paramfilter](https://github.com/celestiaorg/celestia-app/blob/main/x/paramfilter/README.md)
- [upgrade](https://github.com/celestiaorg/celestia-app/blob/main/x/upgrade/README.md)
- [tokenfilter](https://github.com/celestiaorg/celestia-app/blob/main/x/tokenfilter/README.md)
- [Mainnet Parameters](./specs/params.md)
7 changes: 7 additions & 0 deletions specs/src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,10 @@
- [Data Square Layout](./specs/data_square_layout.md)
- [Resource Pricing](./specs/resource_pricing.md)
- [State Machine Modules](./specs/state_machine_modules.md)
- [blob](https://github.com/celestiaorg/celestia-app/blob/main/x/blob/README.md)
- [qgb](https://github.com/celestiaorg/celestia-app/blob/main/x/qgb/README.md)
- [mint](https://github.com/celestiaorg/celestia-app/blob/main/x/mint/README.md)
- [paramfilter](https://github.com/celestiaorg/celestia-app/blob/main/x/paramfilter/README.md)
- [upgrade](https://github.com/celestiaorg/celestia-app/blob/main/x/upgrade/README.md)
- [tokenfilter](https://github.com/celestiaorg/celestia-app/blob/main/x/tokenfilter/README.md)
- [Mainnet Parameters](./specs/params.md)
50 changes: 50 additions & 0 deletions specs/src/specs/params.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# Celestia Governance Params

These are the parameters for mainnet. Note that not all of these parameters are
changable via governance. This list also includes parameter that require a
hardfork to change due to being manually hardcoded in the application or they
are blocked by the `x/paramfilter` module.

## Parameters

| Module.Parameter | Default | Summary | Changeable via Governance |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| --- | --- | --- | --- |
| auth.MaxMemoCharacters | 256 | Largest allowed size for a memo. | True |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| auth.TxSigLimit | 7 | Max number of signatures allowed in a multisig transaction. | True |
| auth.TxSizeCostPerByte | 10 | Gas used per transaction byte. | True |
| auth.SigVerifyCostED25519 | 590 | Gas used to verify ED25519 signature. | True |
evan-forbes marked this conversation as resolved.
Show resolved Hide resolved
| auth.SigVerifyCostSecp256k1 | 1000 | Gas used to verify secp256k1 signature. | True |
| bank.SendEnabled | true | Allow transfers. | False |
| blob.GasPerBlobByte | 8 | Gas used per blob byte. | True |
| MaxBlockBytes | 100MB | Hardcoded value in tendermint for the protobuf encoded block. | False |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
evan-forbes marked this conversation as resolved.
Show resolved Hide resolved
| MaxSquareSize | 128 | Hardcoded value in the applications that requires a hardfork to change. | False |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| blob.GovMaxSquareSize | 64 | Governance parameter for the square size. If larger than MaxSquareSize, MaxSquareSize is used. | True |
| consensus.block.MaxBytes | 1.8MB | Governance parameter for the maximum size of the block. | True |
| consensus.block.MaxGas | -1 / ∞ | Maximum gas allowed per block (-1 is infinite). | True |
evan-forbes marked this conversation as resolved.
Show resolved Hide resolved
| consensus.block.TimeIotaMs | 1000 | Minimum time added to the time in the header each block. | False |
| consensus.evidence.MaxAgeNumBlocks | 100000 | The maximum number of blocks before evidence is considered invalid. This value will stop CometBFT from pruning block data. | True |
| consensus.evidence.MaxAgeDuration | 172800000000000 | The maximum age of evidence before it is considered invalid. This value should be identical to the unbonding period. | True |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| consensus.evidence.MaxBytes | 1MB | Maximum size in bytes used by evidence in a given block. | True |
| consensus.validator.PubKeyTypes | Ed25519 | The type of public key used by validators. | False |
| consensus.Version.AppVersion | 1 | Determines protocol rules used for a given height. Incremented by the application upon an upgrade. | False |
| distribution.communitytax | 0.02 | Percentage of the inflation sent to the community pool. | True |
| distribution.WithdrawAddrEnabled | true | Enables delegators to withdraw funds to a different address. | True |
| distribution.BaseProposerReward | 0 | Reward for proposing a block. | True |
| distribution.BonusProposerReward | 0 | Extra reward for proposers based on the voting power included in the commit. | True |
| gov.DepositParams.MinDeposit | | Minimum deposit for a proposal to enter voting period. | True |
| gov.DepositParams.MaxDepositPeriod | | Maximum period for token holders to deposit on a proposal. | True |
| gov.VotingParams.VotingPeriod | | Duration of the voting period. | True |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| gov.TallyParams.Quorum | 33.4 | Minimum percentage of total stake needed to vote for a result to be considered valid. | True |
| gov.TallyParams.Threshold | 50.0 | Minimum proportion of Yes votes for proposal to pass. | True |
| gov.TallyParams.VetoThreshold | 33.4 | Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. | True |
| slashing.SignedBlocksWindow | 5000 | The range of blocks used to count for downtime. | True |
| slashing.MinSignedPerWindow | 5 | Minumum signatures in the block. | True |
rootulp marked this conversation as resolved.
Show resolved Hide resolved
| slashing.DowntimeJailDuration | 10 mins | Duration of time a validator must stay jailed. | True |
| slashing.SlashFractionDoubleSign | 1/20 | Percentage slashed after a validator is jailed for downtime. | True |
| slashing.SlashFractionDowntime | 1/100 | Percentage slashed after a validator is jailed for downtime. | True |
liamsi marked this conversation as resolved.
Show resolved Hide resolved
| staking.UnbondingTime | 21 days | Duration of time for unbonding. | False |
| staking.MaxValidators | 100 | Maximum number of validators. | False |
| staking.MaxEntries | 7 | Maximum number of entries in the redelegation queue. | True |
| staking.HistoricalEntries | 10000 | Number of historical entries to persist in store. | True |
| staking.BondDenom | utia | Bondable coin denomination. | False |
| staking.MinCommissionRate | 0.05 (5%) | Minimum commission rate used by all validators. | True |
Loading