Skip to main content

Governance Parameters

warning

DO NOT EDIT: this file was generated by make docs_update_gov_params_page

Access Control

// TODO_DOCUMENT(@bryanchriswhite) tl;dr, authz.

Updating governance parameter values

// TODO_DOCUMENT(@bryanchriswhite)

Updating this page

make docs_update_gov_params_page

Adding a new parameter

Please follow the instructions in this guide to add a new parameter.

Parameters

ModuleField TypeField NameComment
applicationuint64max_delegated_gatewaysmax_delegated_gateways defines the maximum number of gateways that a single application can delegate to. This is used to prevent performance issues in case the relay ring signature becomes too large.
applicationcosmos.base.v1beta1.Coinmin_stakemin_stake is the minimum stake in upokt that an application must have to remain staked.
gatewaycosmos.base.v1beta1.Coinmin_stakemin_stake is the minimum amount of uPOKT that a gateway must stake.
proofcosmos.base.v1beta1.Coinproof_missing_penaltyproof_missing_penalty is the number of tokens (uPOKT) which should be slashed from a supplier when a proof is required (either via proof_requirement_threshold or proof_missing_penalty) but is not provided. TODO_MAINNET: Consider renaming this to proof_missing_penalty_upokt.
prooffloatproof_request_probabilityproof_request_probability is the probability of a session requiring a proof if it's cost (i.e. compute unit consumption) is below the ProofRequirementThreshold.
proofcosmos.base.v1beta1.Coinproof_requirement_thresholdproof_requirement_threshold is the session cost (i.e. compute unit consumption) threshold which asserts that a session MUST have a corresponding proof when its cost is equal to or above the threshold. This is in contrast to the this requirement being determined probabilistically via ProofRequestProbability. TODO_MAINNET: Consider renaming this to proof_requirement_threshold_upokt.
proofcosmos.base.v1beta1.Coinproof_submission_feeproof_submission_fee is the number of tokens (uPOKT) which should be paid by the supplier operator when submitting a proof. This is needed to account for the cost of storing proofs on-chain and prevent spamming (i.e. sybil bloat attacks) the network with non-required proofs. TODO_MAINNET: Consider renaming this to proof_submission_fee_upokt.
servicecosmos.base.v1beta1.Coinadd_service_feeThe amount of uPOKT required to add a new service. This will be deducted from the signer's account balance, and transferred to the pocket network foundation.
shareduint64application_unbonding_period_sessionsapplication_unbonding_period_sessions is the number of sessions that an application must wait after unstaking before their staked assets are moved to their account balance. On-chain business logic requires, and ensures, that the corresponding block count of the application unbonding period will exceed the end of its corresponding proof window close height.
shareduint64claim_window_close_offset_blocksclaim_window_close_offset_blocks is the number of blocks after the claim window open height, at which the claim window closes.
shareduint64claim_window_open_offset_blocksclaim_window_open_offset_blocks is the number of blocks after the session grace period height, at which the claim window opens.
shareduint64compute_units_to_tokens_multiplierThe amount of upokt that a compute unit should translate to when settling a session. DEV_NOTE: This used to be under x/tokenomics but has been moved here to avoid cyclic dependencies.
shareduint64grace_period_end_offset_blocksgrace_period_end_offset_blocks is the number of blocks, after the session end height, during which the supplier can still service payable relays. Suppliers will need to recreate a claim for the previous session (if already created) to get paid for the additional relays.
shareduint64num_blocks_per_sessionnum_blocks_per_session is the number of blocks between the session start & end heights.
shareduint64proof_window_close_offset_blocksproof_window_close_offset_blocks is the number of blocks after the proof window open height, at which the proof window closes.
shareduint64proof_window_open_offset_blocksproof_window_open_offset_blocks is the number of blocks after the claim window close height, at which the proof window opens.
shareduint64supplier_unbonding_period_sessionssupplier_unbonding_period_sessions is the number of sessions that a supplier must wait after unstaking before their staked assets are moved to their account balance. On-chain business logic requires, and ensures, that the corresponding block count of the unbonding period will exceed the end of any active claim & proof lifecycles.
suppliercosmos.base.v1beta1.Coinmin_stakemin_stake is the minimum amount of uPOKT that a supplier must stake to be included in network sessions and remain staked.