governance_vote
The vote method submits a new vote. If the node has the right to vote based on governance mode, the vote can be placed. If not, an error message will be returned and the vote will be ignored.
JSONRPC: governance_vote
Request
- application/json
Body
Array [
]
params
undefined[]
required
Name of the configuration setting to be changed. Key has the form of domain.field
Various types of value for each key.
Key | Description |
---|---|
"governance.governancemode" | STRING. One of the three governance modes. "none", "single", "ballot" |
"governance.governingnode" | ADDRESS. Designated governing node's address. It only works if the governance mode is "single" e.g.,"0xe733cb4d279da696f30d470f8c04decb54fcb0d2" |
"governance.unitprice" | NUMBER. Price of unit gas. e.g., 25000000000 |
"governance.addvalidator" | ADDRESS. Address of a new validator candidate. e.g., 0xe733cb4d279da696f30d470f8c04decb54fcb0d2 |
"governance.removevalidator" | ADDRESS. Address of a current validator which need to be removed. e.g., 0xe733cb4d279da696f30d470f8c04decb54fcb0d2 |
"governance.deriveshaimpl" | NUMBER. Policy to generate the transaction hash and receipt hash in a block header. See here for available options. e.g., 2 (DeriveShaConcat) |
"governance.govparamcontract" | ADDRESS. Address of the GovParam contract. e.g., 0xe733cb4d279da696f30d470f8c04decb54fcb0d2 |
"istanbul.epoch" | NUMBER. A period in which votes are gathered in blocks. When an epoch end, all votes which haven't been passed will be cleared. e.g., 86400 |
"istanbul.committeesize" | NUMBER. The number of validators in a committee.(sub in chain configuration) e.g., 7 |
"reward.mintingamount" | STRING. Amount of Peb minted when a block is generated. Double quotation marks are needed for a value. e.g., "9600000000000000000" |
"reward.ratio" | STRING. Distribution rate for a CN/KGF/KIR separated by "/". The sum of all values has to be 100. e.g., "50/40/10" meaning CN 50%, KGF 40%, KIR 10% |
"reward.kip82ratio" | STRING. Distribution ratio of the block proposer to stakers separated by "/". The sum of all values has to be "100". See KIP-82 for further details. e.g., "20/80" means that the proposer takes 20% while stakers take 80%. |
"reward.useginicoeff" | BOOL. Use the Gini coefficient or not. true, false |
"reward.deferredtxfee" | BOOL. The way of giving transaction fee to a proposer. If true, it means the tx fee will be summed up with block reward and distributed to the proposer, KIR and KGF. If not, all tx fee will be given to the proposer. true, false |
"reward.minimumstake" | STRING. Amount of Klay required to be a CN (Consensus Node). Double quotation marks are needed for a value. e.g., "5000000" |
"kip71.lowerboundbasefee" | NUMBER. The lowest possible base fee. See KIP-71 for further details. e.g., 25000000000 |
"kip71.upperboundbasefee" | NUMBER. The highest possible base fee. e.g., 750000000000 |
"kip71.gastarget" | NUMBER. The block gas that base fee wants to achieve. The base fee increases when parent block contains more than gas target, and decreases when parent block contains less than gas target. e.g., 30000000 |
"kip71.basefeedenominator" | NUMBER. Controls how fast base fee changes. e.g., 20 |
"kip71.maxblockgasusedforbasefee" | NUMBER. The maximum block gas perceived in base fee calculation. e.g., 60000000 |
Responses
- 200
Result of vote submission
- application/json
- Schema
- Example (from schema)
Schema
error
object
A Number that indicates the error type that occurred. This MUST be an integer.
code | message | description |
---|---|---|
-32700 | Parse error | invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. |
-32602 | Invalid params | Invalid method parameter(s). |
A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.
A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).
Result of vote submission
{
"jsonrpc": "2.0",
"id": 0,
"error": {
"code": -32700,
"message": "Parse error",
"data": "string"
},
"result": "Your vote was successfully placed."
}