Comment on page

Types of Proposals

Type of proposals (schema of a proposal)
For the section that allows validators to submit network proposals the following types of forms must be created.
Proposal of type "text"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"text" (fixed value)
Y
value
T_DICT
​
Y
value.text
​https://github.com/icon-project/governance2#T_STR​
Text value
Y
​
{
  "name": "text",
  "value": {
    "text": "This is a text proposal"
  }
}
​
Proposal of type "revision"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"revision" (fixed value)
Y
value
T_DICT
​
Y
value.revision
​https://github.com/icon-project/governance2#T_INT​
Revision code
Y
​
{
  "name": "revision",
  "value": {
    "revision": "0x11"
  }
}
​
Proposal of type "maliciousScore"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"maliciousScore" (fixed value)
Y
value
T_DICT
​
Y
value.address
​https://github.com/icon-project/governance2#T_ADDR_SCORE​
SCORE address
Y
value.type
​https://github.com/icon-project/governance2#T_INT​
0x0: Freeze, 0x1: Unfreeze
Y
​
{
  "name": "maliciousScore",
  "value": {
    "address": "cx7cc546bf908018b5602b66fa65ff5fdacef45fe0",
    "type": "0x0"
  }
}
​
Proposal of type "prepDisqualification"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"prepDisqualification" (fixed value)
Y
value
T_DICT
​
Y
value.address
​https://github.com/icon-project/governance2#T_ADDR_EOA​
EOA address of main/sub P-Rep
Y
​
{
  "name": "prepDisqualification",
  "value": {
    "address": "hx7cc546bf908018b5602b66fa65ff5fdacef45fe0"
  }
}
​
Proposal of type "stepPrice"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"stepPrice" (fixed value)
Y
value
T_DICT
​
Y
value.stepPrice
​https://github.com/icon-project/governance2#T_INT​
An integer of the step price in loop
Y
​
{
  "name": "stepPrice",
  "value": {
    "stepPrice": "0x2e90edd00"
  }
}
​
Proposal of type "stepCosts"
​
name
​https://github.com/icon-project/governance2#T_STR​
"stepCosts" (fixed value)
Required field?
value
T_DICT
​
Y
value.costs
​https://github.com/icon-project/governance2#T_DICT​
Step costs to set as a dict. All fields are optional but at least one field should be specified.
Y
value.costs.schema
T_INT
Schema version (currently fixed at 1)
N
value.costs.default
T_INT
Default cost charged each time transaction is executed
N
value.costs.contractCall
T_INT
Cost to call the smart contract function
N
value.costs.contractCreate
T_INT
Cost to call the smart contract code generation function
N
value.costs.contractUpdate
T_INT
Cost to call the smart contract code update function
N
value.costs.contractSet
T_INT
Cost to store the generated/updated smart contract code per byte
N
value.costs.get
T_INT
Cost to get values from the state database per byte
N
value.costs.getBase
T_INT
Default cost charged each time get is called
N
value.costs.set
T_INT
Cost to set values newly in the state database per byte
N
value.costs.setBase
T_INT
Default cost charged each time set is called
N
value.costs.delete
T_INT
Cost to delete values in the state database per byte
N
value.costs.deleteBase
T_INT
Default cost charged each time delete is called
N
value.costs.input
T_INT
Cost charged for input data included in transaction per byte
N
value.costs.log
T_INT
Cost to emit event logs per byte
N
value.costs.logBase
T_INT
Default cost charged each time log is called
N
value.costs.apiCall
T_INT
Cost charged for heavy API calls (e.g. hash functions)
N
​
{
  "name": "stepCosts",
  "value": {
    "costs": {"default": "0x186a0", "set": "0x140"}
  }
}
​
Proposal of type "rewardFund"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"rewardFund" (fixed value)
Y
value
T_DICT
​
Y
value.iglobal
​https://github.com/icon-project/governance2#T_INT​
The total amount of monthly reward fund in loop
Y
​
{
    "name": "rewardFund",
    "value": {
        "iglobal": "0x27b46536c66c8e3000000"
    }
}
​
Proposal of type "rewardFundsAllocation"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"rewardFundsAllocation" (fixed value)
Y
value
T_DICT
​
Y
value.rewardFunds
​https://github.com/icon-project/governance2#T_DICT​
Reward fund values information to set. All values are required.
Y
value.rewardFunds.iprep
T_INT
The percentage allocated to the P-Rep from the monthly reward fund
Y
value.rewardFunds.icps
T_INT
The percentage allocated to the CPS from the monthly reward fund
Y
value.rewardFunds.irelay
T_INT
The percentage allocated to the BTP relay from the monthly reward fund
Y
value.rewardFunds.ivoter
T_INT
The percentage allocated to the Voter from the monthly reward fund
Y
​
{
  "name": "rewardFundsAllocation",
  "value": {
    "rewardFunds": {
      "iprep": "0x10",
      "icps": "0xa",
      "irelay": "0xa",
      "ivoter": "0x40"
    }
  }
}
​
Proposal of type "networkScoreDesignation"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"networkScoreDesignation" (fixed value)
Y
value
T_DICT
​
Y
value.networkScores
T_LIST[T_DICT]
network SCORE values to set. If the address is an empty string, deallocate network SCORE.
Y
value.networkScores.role
​https://github.com/icon-project/governance2#T_STR​
"cps" or "relay"
Y
value.networkScores.address
​https://github.com/icon-project/governance2#T_ADDR_SCORE​
network SCORE address
Y
​
{
  "name": "networkScoreDesignation",
  "value": {
    "networkScores": [
      {
        "role": "cps",
        "address": "cx7cc546bf908018b5602b66fa65ff5fdacef45fe0"
      }
    ]
  }
}
​
Proposal of type "networkScoreUpdate"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"networkScoreUpdate" (fixed value)
Y
value
T_DICT
​
Y
value.address
​https://github.com/icon-project/governance2#T_ADDR_SCORE​
network SCORE address to update
Y
value.content
​https://github.com/icon-project/governance2#T_BIN_DATA​
SCORE code in hexadecimal string
Y
value.params
​https://github.com/icon-project/governance2#T_LIST​
Parameters passed to score on update
N
​
{
  "name": "networkScoreUpdate",
  "value": {
    "address": "cx7cc546bf908018b5602b66fa65ff5fdacef45fe0",
    "content": "0x504b0304107082bc2bf352a000000280...00000504b03041400080808000000210000000",
    "params": ["0x10", "Hello"]
  }
}
​
Proposal of type "accumulatedValidationFailureSlashingRate"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"accumulatedValidationFailureSlashingRate" (fixed value)
Y
value
T_DICT
​
Y
value.slashingRate
​https://github.com/icon-project/governance2#T_INT​
slashing rate [0 ~ 100]
Y
​
{
  "name": "accumulatedValidationFailureSlashingRate",
  "value": {
    "slashingRate": "0x5"
  }
}
​
Proposal of type "missedNetworkProposalVoteSlashingRate"
​
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"missedNetworkProposalVoteSlashingRate" (fixed value)
Y
value
T_DICT
​
Y
value.slashingRate
​https://github.com/icon-project/governance2#T_INT​
slashing rate [0 ~ 100]
Y
​
{
  "name": "missedNetworkProposalVoteSlashingRate",
  "value": {
    "slashingRate": "0x5"
  }
}
​
Proposal of type "call"
Key
Value Type
Description
Required field?
name
​https://github.com/icon-project/governance2#T_STR​
"customCall" (fixed value)
Y
value
T_DICT
​
Y
value.to
​https://github.com/icon-project/governance2#T_ADDRESS_SCORE​
SCORE address
Y
value.method
​https://github.com/icon-project/governance2#T_STR​
method name
Y
value.params
​https://github.com/icon-project/governance2#T_LIST​
parameters
?
value.params.type
​https://github.com/icon-project/governance2#T_STR​
type of parameter
?
value.params.value
​https://github.com/icon-project/governance2#T_STR​
value
?
value.params.fields
T_DICT[T_STR]
empty if parameter type is not struct or []struct. It has the keys of the struct as keys, and the types of values as values.
?
​
{
  "name": "call",
  "value": {
    "to": "cx0000000000000000000000000000000000000000",
    "method": "someMethod",
    "params": [
      {
        "type": "str",
        "value": "Alice"
      },
      {
        "type": "struct",
        "value": {
          "nickName": "Bob",
          "address": "hxb6b5791be0b5ef67063b3c10b840fb81514db2fd"
        },
        "fields": {
          "nickName": "str",
          "address": "Address"
        }
      }
    ]
  }
}
Resources:
​https://github.com/icon-project/governance2​

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"text" (fixed value)	Y
value	T_DICT		Y
value.text	https://github.com/icon-project/governance2#T_STR	Text value	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"revision" (fixed value)	Y
value	T_DICT		Y
value.revision	https://github.com/icon-project/governance2#T_INT	Revision code	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"maliciousScore" (fixed value)	Y
value	T_DICT		Y
value.address	https://github.com/icon-project/governance2#T_ADDR_SCORE	SCORE address	Y
value.type	https://github.com/icon-project/governance2#T_INT	0x0: Freeze, 0x1: Unfreeze	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"prepDisqualification" (fixed value)	Y
value	T_DICT		Y
value.address	https://github.com/icon-project/governance2#T_ADDR_EOA	EOA address of main/sub P-Rep	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"stepPrice" (fixed value)	Y
value	T_DICT		Y
value.stepPrice	https://github.com/icon-project/governance2#T_INT	An integer of the step price in loop	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"rewardFund" (fixed value)	Y
value	T_DICT		Y
value.iglobal	https://github.com/icon-project/governance2#T_INT	The total amount of monthly reward fund in loop	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"rewardFundsAllocation" (fixed value)	Y
value	T_DICT		Y
value.rewardFunds	https://github.com/icon-project/governance2#T_DICT	Reward fund values information to set. All values are required.	Y
value.rewardFunds.iprep	T_INT	The percentage allocated to the P-Rep from the monthly reward fund	Y
value.rewardFunds.icps	T_INT	The percentage allocated to the CPS from the monthly reward fund	Y
value.rewardFunds.irelay	T_INT	The percentage allocated to the BTP relay from the monthly reward fund	Y
value.rewardFunds.ivoter	T_INT	The percentage allocated to the Voter from the monthly reward fund	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"networkScoreDesignation" (fixed value)	Y
value	T_DICT		Y
value.networkScores	T_LIST[T_DICT]	network SCORE values to set. If the address is an empty string, deallocate network SCORE.	Y
value.networkScores.role	https://github.com/icon-project/governance2#T_STR	"cps" or "relay"	Y
value.networkScores.address	https://github.com/icon-project/governance2#T_ADDR_SCORE	network SCORE address	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"networkScoreUpdate" (fixed value)	Y
value	T_DICT		Y
value.address	https://github.com/icon-project/governance2#T_ADDR_SCORE	network SCORE address to update	Y
value.content	https://github.com/icon-project/governance2#T_BIN_DATA	SCORE code in hexadecimal string	Y
value.params	https://github.com/icon-project/governance2#T_LIST	Parameters passed to score on update	N

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"accumulatedValidationFailureSlashingRate" (fixed value)	Y
value	T_DICT		Y
value.slashingRate	https://github.com/icon-project/governance2#T_INT	slashing rate [0 ~ 100]	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"missedNetworkProposalVoteSlashingRate" (fixed value)	Y
value	T_DICT		Y
value.slashingRate	https://github.com/icon-project/governance2#T_INT	slashing rate [0 ~ 100]	Y

Key	Value Type	Description	Required field?
name	https://github.com/icon-project/governance2#T_STR	"customCall" (fixed value)	Y
value	T_DICT		Y
value.to	https://github.com/icon-project/governance2#T_ADDRESS_SCORE	SCORE address	Y
value.method	https://github.com/icon-project/governance2#T_STR	method name	Y
value.params	https://github.com/icon-project/governance2#T_LIST	parameters	?
value.params.type	https://github.com/icon-project/governance2#T_STR	type of parameter	?
value.params.value	https://github.com/icon-project/governance2#T_STR	value	?
value.params.fields	T_DICT[T_STR]	empty if parameter type is not struct or []struct. It has the keys of the struct as keys, and the types of values as values.	?

Overview on Network Proposals

Registering and voting network proposals

Last modified 7mo ago

name	https://github.com/icon-project/governance2#T_STR	"stepCosts" (fixed value)	Required field?
value	T_DICT		Y
value.costs	https://github.com/icon-project/governance2#T_DICT	Step costs to set as a dict. All fields are optional but at least one field should be specified.	Y
value.costs.schema	T_INT	Schema version (currently fixed at 1)	N
value.costs.default	T_INT	Default cost charged each time transaction is executed	N
value.costs.contractCall	T_INT	Cost to call the smart contract function	N
value.costs.contractCreate	T_INT	Cost to call the smart contract code generation function	N
value.costs.contractUpdate	T_INT	Cost to call the smart contract code update function	N
value.costs.contractSet	T_INT	Cost to store the generated/updated smart contract code per byte	N
value.costs.get	T_INT	Cost to get values from the state database per byte	N
value.costs.getBase	T_INT	Default cost charged each time get is called	N
value.costs.set	T_INT	Cost to set values newly in the state database per byte	N
value.costs.setBase	T_INT	Default cost charged each time set is called	N
value.costs.delete	T_INT	Cost to delete values in the state database per byte	N
value.costs.deleteBase	T_INT	Default cost charged each time delete is called	N
value.costs.input	T_INT	Cost charged for input data included in transaction per byte	N
value.costs.log	T_INT	Cost to emit event logs per byte	N
value.costs.logBase	T_INT	Default cost charged each time log is called	N
value.costs.apiCall	T_INT	Cost charged for heavy API calls (e.g. hash functions)	N