Skip to main content

Governance Params

Governance Parameters

DO NOT EDIT

This file was auto-generated by the script at tools/scripts/docusaurus/generate_docs_params.go

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 NameField TypeComment
applicationmax_delegated_gatewaysuint64max_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.
applicationmin_stakecosmos.base.v1beta1.Coinmin_stake is the minimum stake in upokt that an application must have to remain staked.
gatewaymin_stakecosmos.base.v1beta1.Coinmin_stake is the minimum amount of uPOKT that a gateway must stake.
migrationallow_morse_account_import_overwriteboolallow_morse_account_import_overwrite is a feature flag which is used to enable/disable the re-importing of Morse claimable accounts by the authority. Such a re-import will: - Ignore (i.e. leave) ALL claimed destination Shannon accounts/actors - Delete ALL existing onchain MorseClaimableAccounts - Import the new set of MorseClaimableAccounts from the provided MsgImportMorseClaimableAccounts This is useful for testing purposes, but should be disabled in production.
migrationmorse_account_claiming_enabledboolmorse_account_claiming_enabled is a feature flag which is used to enable/disable the processing of Morse account/actor claim messages (i.e. MsgClaimMorseAccount, MorseClaimApplication, and MorseClaimSupplier).
migrationwaive_morse_claim_gas_feesboolwaive_morse_claim_gas_fees is a feature flag used to enable/disable the waiving of gas fees for txs that: - Contain exactly one secp256k1 signer - Contain at least one Morse account/actor claim messages - Do not contain any other messages other than Morse account/actor claim messages
proofproof_missing_penaltycosmos.base.v1beta1.Coinproof_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_MIGRATION: Consider renaming this to proof_missing_penalty_upokt.
proofproof_request_probabilitydoubleproof_request_probability is the probability of a session requiring a proof if it's cost (i.e. compute unit consumption) is below the ProofRequirementThreshold.
proofproof_requirement_thresholdcosmos.base.v1beta1.Coinproof_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_MIGRATION: Consider renaming this to proof_requirement_threshold_upokt.
proofproof_submission_feecosmos.base.v1beta1.Coinproof_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 onchain and prevent spamming (i.e. sybil bloat attacks) the network with non-required proofs. TODO_MAINNET_MIGRATION: Consider renaming this to proof_submission_fee_upokt.
serviceadd_service_feecosmos.base.v1beta1.CoinThe 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.
servicetarget_num_relaysuint64target_num_relays is the target for the EMA of the number of relays per session. Per service, onchain relay mining difficulty will be adjusted to maintain this target.
sessionnum_suppliers_per_sessionuint64num_suppliers_per_session is the maximum number of suppliers per session (application:supplier pair for a given session number).
sharedapplication_unbonding_period_sessionsuint64application_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. Onchain 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.
sharedclaim_window_close_offset_blocksuint64claim_window_close_offset_blocks is the number of blocks after the claim window open height, at which the claim window closes.
sharedclaim_window_open_offset_blocksuint64claim_window_open_offset_blocks is the number of blocks after the session grace period height, at which the claim window opens.
sharedcompute_unit_cost_granularityuint64compute_unit_cost_granularity is the fraction of the base unit (uPOKT) used to represent the smallest price of a single compute unit. compute_unit_cost_granularity defines the smallest fraction of uPOKT that can represent the cost of a single compute unit. It acts as a denominator in the formula: compute_unit_cost_in_uPOKT = compute_units_to_tokens_multiplier / compute_unit_cost_granularity This enables high-precision pricing of compute units using integer math. For example: +-------------------------------+---------------------------------------------+
sharedcompute_units_to_tokens_multiplieruint64The amount of tokens that a compute unit should translate to when settling a session. It is denominated in fractional uPOKT (1/compute_unit_cost_granularity) DEV_NOTE: This used to be under x/tokenomics but has been moved here to avoid cyclic dependencies.
sharedgateway_unbonding_period_sessionsuint64gateway_unbonding_period_sessions is the number of sessions that a gateway must wait after unstaking before their staked assets are moved to its account balance.
sharedgrace_period_end_offset_blocksuint64grace_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.
sharednum_blocks_per_sessionuint64num_blocks_per_session is the number of blocks between the session start & end heights.
sharedproof_window_close_offset_blocksuint64proof_window_close_offset_blocks is the number of blocks after the proof window open height, at which the proof window closes.
sharedproof_window_open_offset_blocksuint64proof_window_open_offset_blocks is the number of blocks after the claim window close height, at which the proof window opens.
sharedsupplier_unbonding_period_sessionsuint64supplier_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. Onchain business logic requires, and ensures, that the corresponding block count of the unbonding period will exceed the end of any active claim & proof lifecycles.
suppliermin_stakecosmos.base.v1beta1.Coinmin_stake is the minimum amount of uPOKT that a supplier must stake to be included in network sessions and remain staked.
supplierstaking_feecosmos.base.v1beta1.Coinstaking_fee is the fee charged by the protocol for staking a supplier.
tokenomicsdao_reward_addressstringdao_reward_address is the address to which mint_allocation_dao percentage of the minted tokens are at the end of claim settlement.
tokenomicsglobal_inflation_per_claimdoubleglobal_inflation_per_claim is the percentage of a claim's claimable uPOKT amount which will be minted on settlement.
tokenomicsmint_allocation_percentagesMintAllocationPercentagesmint_allocation_percentages represents the distribution of newly minted tokens, at the end of claim settlement, as a result of the Global Mint TLM.