KIRA | Docs
/
SEKAI | Documentation & CLI
/
Network Properties
Search
Duplicate
Try Notion
Network Properties
Concept
KIRA Network utilizes a unique set of on-chain variables known as Network Properties to help control and regulate various behaviors and characteristics of the SEKAI application on a network-wide basis. These parameters serve as the operational gears of the system, allowing for the adjustment of pivotal features such as KEX inflation rate, the minimum transaction fee for any on-chain message to ensure global transaction spam protection, or even the required minimum percentage of governance members necessary to vote on a proposal, making it valid. Such versatility is particularly beneficial, considering the ever-evolving needs of the community and the potential alterations in the network's operational dynamics. Any changes to these network properties require consensus from the network's governance, ensuring that any alterations align with the wishes of the majority of network participants.
Parameters
All network properties and their respective default values (which can also be found here)
1
min_tx_fee
int ukex
100
Minimum transaction fee that must be sent in order to submit any on-chain message. Global transaction spam protection measure.
2
max_tx_fee
int ukex
1000000
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.
3
vote_quorum
int %
33
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.
4
minimum_proposal_end_time
int second
300
Minimum time that proposals must be active and default time for all proposals to remain pending. Duration time of individual proposal can be modified by governance as explained here.
5
proposal_enactment_time
int second
300
Minimum time for the proposals to take effect after they passed
6
min_proposal_end_blocks
int block
2
Minimum number of blocks during which the proposals MUST remain active. This is used to prevent edge cases where minimum_proposal_end_time is set to value shorter than a single block time, thus making it impossible to vote in time.
7
min_proposal_enactment_blocks
int block
1
Minimum number of blocks that must pass after proposal passed for the proposal to take effect.
8
enable_foreign_fee_payments
boolean
true
Allow transaction fee payments with tokens other than KEX
9
mischance_rank_decrease_amount
int
10
When it's certain that validator is offline and failed to participate in a block production, decrease its global rank by the specified value.
10
max_mischance
int
110
How many consecutive blocks must the validator miss for the network to change validator status to inactive
11
mischance_confidence
int
10
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
12
inactive_rank_decrease_percent
int
50
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.
13
poor_network_max_bank_send
int ukex
1000000
When poor network conditions occur, sets the maximum value that can be transferred between accounts.
14
min_validators
int
1
Minimum number of consensus nodes that must be active for the network to be considered healthy. If number of validators falls below this value then poor network conditions occur.
15
unjail_max_time
int second
600
Maximum amount of time before which a jailed node can request to be unjailed before becoming permanently jailed.(tombstoned).
16
enable_token_whitelist
boolean
false
Enables whitelist of tokens transferable on the network
17
enable_token_blacklist
boolean
true
Enable blacklist of tokens transferable on the network
18
min_identity_approval_tip
int ukex
200
Minimum tip amount that must be sent along 🚧Identity Registrar record verification request
19
unique_identity_keys
string
moniker,username
Key values that must remain unique in the 🚧Identity Registrar
20
ubi-hard-cap
int
6000000
Maximum amount of additional KEX that can be created per year by the UBI module
21
validators_fee_share
int
0.5
0 - 0.5
Percentage cut a block proposer takes from the block’s transaction fees rewards.
22
inflation_rate
int
0.18
0 - 0.5
KEX inflation percentage
23
inflation_period
int
31557600
2629800 - 31557600
Period of time in seconds over which current KEX supply is inflated by inflation_rate
24
unstaking_period
int
2629800
604800 - 31557600
Undelegation cooling period (in seconds)
25
max_delegators
int
1000
Maximum number of delegators allowed per staking pool above which min_delegation_pushout can be triggered.
26
min_delegation_pushout
int
10
The minimum stake multiplier amount a user need to provide to push out the weakest delegator of a staking pool who reach its max_delegators capacity
27
slashing_period
int
3600
0 - unstaking_period
The time window in in seconds in which a collusion of double-signing event must occur in order for a slashing proposal to be automatically rised
28
max_jailed_percentage
int
25
<13\small< \dfrac{1}{3} of active nodes
The percentage threshold of consensus nodes that must double-sign within the time window slashing_period in order for a slashing proposal to be automatically rised.
29
max_slashing_percentage
int
1
0 - 1
Maximum percentage of slashing that can be applied by governance to a jailed consensus node.
30
min_custody_reward
int
31
max_custody_buffer_size
int
32
max_custody_tx_size
int
CLI syntax & examples
Governance
To modify these properties the following permissions are required to vote on and create properties modification proposal : 12 & 13.
Table
Filter
Sort
Subcommand Path
CLI
DESCRIPTION
PERMISSIONS (VOTE/CREATION/SUDO)
proposal-set-plan
Proposes a software upgrade to the Kira Network
28
29
proposal-cancel-plan
Proposes to cancel a previously proposed software upgrade
28
29
UpsertTokenAlias
Proposes to upsert a new token alias in the network
🟢
14
🟢
15
UpsertTokenRates
Proposes to upsert new token rates for a specific token pair
🟢
18
🟢
19
TokensWhiteBlackChange
Proposes to change the whitelisted and blacklisted tokens on the network
🟢
24
🟢
25
UnjailValidator
Proposes to unjail a validator that has been jailed
🟢
20
🟢
21
proposal-reset-whole-validator-rank
Proposes to reset the ranking of all validators
26
27
SlashValidator
Proposes to slash a validator for malicious behavior
🟢
57
🟢
58
UpdateSpendingPoolProposal
Proposes to update the spending pool with new funds
âš«
N/A
SpendingPoolDistributionProposal
Proposes to distribute funds from the spending pool to a specific address
âš«
N/A
SpendingPoolWithdrawProposal
Proposes to withdraw funds from the spending pool
âš«
N/A
proposal-upsert-ubi
Proposes to upsert a Universal Basic Income (UBI) for the network
53
54
proposal-remove-ubi
Proposes to remove the UBI from the network
55
56
proposal-reset-whole-councilor-rank
Proposes to reset the ranking of all councilors
62
63
proposal-jail-councilor
Proposes to jail councilors for violating the network's rules
64
65
AssignPermission
Proposes to assign a permission to a specific account
whitelist-permission
Proposes to whitelist an account's permission
4
5
blacklist-permission
Proposes to blacklist an account's permission
33
34
remove-whitelisted-permission
Proposes to remove a whitelisted permission from an account
35
36
remove-blacklisted-permission
Proposes to remove a blacklisted permission from an account
37
38
assign-role role
Proposes to assign a role to a specific account
47
48
unassign-role role
Proposes to unassign a role from a specific account
49
50
create
Proposes to create a new role with specific permissions
22
23
remove
Proposes to remove a role from the network
51
52
blacklist-permission
Proposes to blacklist a role's permission
41
42
remove-whitelisted-permission
Proposes to remove a whitelisted permission from a role
43
44
whitelist-permission
Proposes to whitelist a role's permission
39
40
remove-blacklisted-permission
Proposes to remove a blacklisted permission from a role
45
46
set-network-property
Proposes to set a specific network property
12
13
UpsertDataRegistry
Proposes to upsert data to the network's data registry
🟢
10
🟢
11
SetPoorNetworkMessages
Proposes to set poor network messages
16
17
set-proposal-durations-proposal
Proposes to set the voting_end_time of specific proposal types
31
32
CreateBasket
Proposes to create a new basket
🟢
59
🟢
60
EditBasket
Proposes to edit an existing basket
BasketWithdrawSurplus
Proposes to withdraw surplus funds from a basket
CollectiveSendDonation
Proposes to send a donation to a specific address
CollectiveUpdate
Proposes to update a collective account
CollectiveRemove
Proposes to remove a collective account
JoinDapp
Proposes to join a Dapp
TransitionDapp
Proposes to transition a Dapp to a new state
UpsertDapp
Proposes to upsert a new Dapp in the network
Transactions
N/A
Queries
sekaid query customgov
network-properties
Query Network Properties
List all network properties and corresponding values using the network-properties command.
Bash
Copy
sekaid query customgov network-properties $FLAGS_QR | jq
​
Table