Network Properties

Network properties are governance-curated, global, on-chain variables used to control various behaviours of the KIRA  blockchain application. Values of all network properties can be found here.

To modify network properties a PermCreateSetNetworkPropertyProposal (12) and PermVoteSetNetworkPropertyProposal (13) are required to vote on and create properties modification proposal.

NAME	DEFAULT	UNIT	DESCRIPTION
min_tx_fee	100	ukex	Minimum transaction fee that must be sent in order to submit any on-chain message. Global transaction spam protection measure.
max_tx_fee	1000000	ukex	Maximum transaction fee that can be sent along any transaction type. Prevents potential loss of funds while specifying wrong transaction fee amount by the user.
vote_quorum	33	percentage, %	Required, minimum percentage of governance members with permission to vote on a given proposal to make said proposal valid. If minimum quorum is not reached then passing said proposal is not possible.
minimum_proposal_end_time	300	second	Minimum time that proposal MUST be active and default time for all proposals to remain pending. To modify duration time of individual proposal a proposal dime amendment can be raised by the governance as defined here.
proposal_enactment_time	300	second	Minimum time for the proposals to take effect after they passed
min_proposal_end_blocks	2	block	Minimum number of blocks during which the proposals MUST remain active. This is used to prevent edge cases where MinimumProposalEndTime is set to value shorter than a single block time, thus making it impossible to vote in time.
min_proposal_enactment_blocks	1	block	Minimum number of blocks that must pass after proposal passed for the proposal to take effect.
enable_foreign_fee_payments	true	boolean	Allow transaction fee payments with tokens other then KEX
mischance_rank_decrease_amount	10	integer	When it's certain that validator is offline and failed to participate in a block production, decrease its global rank by the specified value.
max_mischance	110	integer	How many consecutive blocks must the validator miss for the network to change validator status to inactive
mischance_confidence	10	integer	How many consecutive blocks must the validator miss for the network to be certain that the node is offline and not participating in the block signing
inactive_rank_decrease_percent	50	percentage, %	By what percentage should the validator global rank decrease when the said validator node status changes to inactive due to not participating in signing new blocks.
min_validators	1	integer	Minimum number of validators that must be active for the network to be considered healthy. If number of validators falls below this value then poor network conditions occur.
poor_network_max_bank_send	1000000	ukex	When poor network conditions occur, what is the maximum value that can be transferred between accounts.
unjail_max_time	1209600	second	Maximum time governance has to unjail validator. If UnjailMaxTime passes then validator becomes permanently jailed (tombstoned).
enable_token_whitelist	false	boolean	Enables whitelist of tokens transferable on the network
enable_token_blacklist	true	boolean	Enable blacklist of tokens transferable on the network
min_identity_approval_tip	200	ukex	Minimum tip amount that must be sent along Identity Registrar record verification request
unique_identity_keys	moniker,username	string	Key values that must remain unique in the Identity Registrar

Commands Examples

Proposals Creation

# CLI
sekaid tx customgov proposal set-network-property "${KEY^^}" "$VALUE" \
 --title="Upserting Network Property '$KEY'" \
 --description="Assign value '$VALUE' to property '$KEY'" \
 --from=$ACCOUNT --chain-id=$NETWORK_NAME --keyring-backend=test  --fees=100ukex --yes --log_format=json --broadcast-mode=async --output=json
# KM
# e.g: upsertNetworkProperty <account> <property-name> <property-value>
setNetworkProperty validator "MIN_TX_FEE" 123

Bash

Query All Properties

# CLI
sekaid query customgov network-properties --output=json --home=$SEKAID_HOME
# INTERX
curl "<ip>:11000/api/kira/gov/network_properties" | jq
# KM
showNetworkProperties

# Example Output:
{"properties":{"min_tx_fee":"100","max_tx_fee":"1000000","vote_quorum":"33","default_proposal_end_time":"360","minimum_proposal_end_time":"300","proposal_enactment_time":"300","min_proposal_end_blocks":"2","min_proposal_enactment_blocks":"1","enable_foreign_fee_payments":true,"mischance_rank_decrease_amount":"1","max_mischance":"50","mischance_confidence":"25","inactive_rank_decrease_percent":"50","min_validators":"1","poor_network_max_bank_send":"1000000","jail_max_time":"1209600","enable_token_whitelist":false,"enable_token_blacklist":true,"min_identity_approval_tip":"200","unique_identity_keys":"moniker,username"}}

Bash