Yamale docs ← back to the site

x/validatorgov

Restricts the validator set to candidates that governance has admitted, enforced before a create-validator transaction is accepted.

Transactions

MsgApplyValidator

/blockchain.validatorgov.v1.MsgApplyValidator

Signed by the creator field.

ApplyValidator defines the ApplyValidator RPC.

Field Type Description
creator string
moniker string
description string

MsgApproveValidator

/blockchain.validatorgov.v1.MsgApproveValidator

Signed by the authority field.

ApproveValidator defines the ApproveValidator RPC. It is authority-gated (the x/gov module account) and approves or rejects a pending validator application submitted via ApplyValidator.

Field Type Description
authority string authority is the address that controls the module (defaults to x/gov unless overwritten).
candidate string
approve bool

MsgUpdateParams

/blockchain.validatorgov.v1.MsgUpdateParams

Signed by the authority field.

UpdateParams defines a (governance) operation for updating the module parameters. The authority defaults to the x/gov module account.

Field Type Description
authority string authority is the address that controls the module (defaults to x/gov unless overwritten).
params Params NOTE: All parameters must be supplied.

Queries

GetApprovedValidator

GET /yamale/blockchain/validatorgov/v1/approved_validator/{candidate}

ListApprovedValidator Queries a list of ApprovedValidator items.

Request:

Field Type Description
candidate string

Response:

Field Type Description
approved_validator ApprovedValidator

GetValidatorApplication

GET /yamale/blockchain/validatorgov/v1/validator_application/{candidate}

ListValidatorApplication Queries a list of ValidatorApplication items.

Request:

Field Type Description
candidate string

Response:

Field Type Description
validator_application ValidatorApplication

ListApprovedValidator

GET /yamale/blockchain/validatorgov/v1/approved_validator

ListApprovedValidator defines the ListApprovedValidator RPC.

Request:

Field Type Description
pagination PageRequest

Response:

Field Type Description
approved_validator repeated ApprovedValidator
pagination PageResponse

ListValidatorApplication

GET /yamale/blockchain/validatorgov/v1/validator_application

ListValidatorApplication defines the ListValidatorApplication RPC.

Request:

Field Type Description
pagination PageRequest

Response:

Field Type Description
validator_application repeated ValidatorApplication
pagination PageResponse

Params

GET /yamale/blockchain/validatorgov/v1/params

Parameters queries the parameters of the module.

Response:

Field Type Description
params Params params holds all the parameters of this module.

State

ApprovedValidator

ApprovedValidator defines the ApprovedValidator message.

Field Type Description
candidate string
approved string

ValidatorApplication

ValidatorApplication defines the ValidatorApplication message.

Field Type Description
candidate string
status string

Errors

Every way a transaction to this module can be rejected.

Code Name Message
1100 ErrInvalidSigner expected gov account as only signer for proposal message
1101 ErrApplicationNotFound validator application not found
1102 ErrApplicationNotPending validator application is not pending