Network Governance

The unichain network is a decentralized network and is governed by decentralized mechanisms. Network-related parameters such as transaction fees, block reward, network upgrade... must be agreed upon by the majority of network nodes before they take effect.

To change any network parameter, an active witness must create a proposal and broadcast it into the network. Other active witnesses will review the proposal and decide whether to approve it or not. If more than ⅔ witnesses approve of the proposal then the network parameter will be changed, otherwise it will be rejected or expired. All proposal actions (create, cancel, approve, reject) are the transactions on the blockchain network that can be publicly discovered by UniScan

Create a proposal

Only witnesses can create proposals. To create a proposal, Witnesses can use wallet cli or web interface provided by Uni Validator

By Wallet CLI

wallet> CreateProposal 34 2

The command to create a proposal: crewateProposal <proposal ID> <value> Where the can be found in the list below and is the new proposal value

To get all proposal, We use this command:

wallet> ListProposals
{
"proposals":[
{
"proposal_id":1,
"proposer_address":"US1xxmn45vcHMWyRoT969NBtLsPuLmVkMc",
"parameters":[
{
"key":34,
"value":2
}
],
"expiration_time":1632498600000,
"create_time":1632497874000,
"approvals":[
"US1xxmn45vcHMWyRoT969NBtLsPuLmVkMc",
"UYBEVyN2wxLDZGMQBFrVn2gGL7MSRtirPk",
"Uk28n4A28nfXhgYWnRr6mXDbTbAeCkEtJ7",
"Ujhe4Wb6DXAVVLt9ziT4mf9HC63izpJscv",
"USzHCLkaE1HxbZY9o7AKqTCLCsTuBa3yPB",
"Uh2R7ahQoE5YJDZiM3wc57JRoQmS4xD9Xk",
"UazSBZCDUCABgAkhZv8WDpqgUMV4LPLBCh"
],
"state":"APPROVED"
}
]
}

The restructured will look like this:

"proposal_id": <network proposal ID>,
"proposer_address": "proposal address",
"parameters": [
{
"key":<proposal ID>,
"value": <proposal value>
}
],
"expiration_time": expire time,
"create_time": creation time,
"approvals": [
List of witnesses that approved
],
"state": "APPROVED | CANCELED | REJECTED"

Approve or reject a proposal

Only witnesses can approve or reject a proposal. If using command line, witness can approve/reject a proposal by command: ApproveProposal <network proposal ID> <response>

Where the is the network proposal ID, It’s different from proposal ID. Wherever a witness broadcasts a proposal into the network, the network proposal ID will be created (It’s integer number and increased by time). The can be true or false. If true, the proposal is approved, otherwise It will be rejected by witnesses. Example:

    approveProposal 1 true

The proposal ID list

Title/Description	ID	Current value
proposal to modify the maintenance interval	0	6 hours
proposal to modify the cost to apply for witness	1	1000 UNW
proposal to modify account creation fee	2	0.01 UNW
proposal to modify the transaction fee (Ginza/byte)	3	1 Ginza
proposal to modify the token creation fee	4	500 UNW
proposal to modify the witness block generation reward	5	1 UNW
proposal to modify the witness standby allowance	6	7363 UNW
proposal to modify account creation in system contract	7	0 UNW
proposal to modify the maximum execution time of one transaction	13	50 ms
proposal to allow update account name (0 or 1)	14	0
proposal to allow delegate resource (0 or 1)	16	1
proposal to allow the initiation of multi-signature (0 or 1)	20	1
proposal to modify the account update permision fee	22	2 UNW
proposal to modify the multi-signature fee	23	0.25 UNW
proposal to modify the allowance for top 55 witnesses	31	1 UNW
proposal to update the network version	34	[2, 3, 4, 5 ...]
proposal to change the max time in future transfer UNW	35	50 years
proposal to change the max time in future transfer token	36	50 years
proposal to change the fee of native URC-20/URC-30 update operation	37	2 UNW
proposal to the max time of locking UNW (freeze UNW)	38	3 days
proposal to the min time of locking UNW (freeze UNW)	39	3 days