validator_commands.proto

path vega/commands/v1/validator_commands.proto

package vega.commands.v1

---

Messages

AnnounceNode

Used to announce a node as a new pending validator

Name	Type	Description
vega_pub_key	string	Vega public key, required field.
ethereum_address	string	Ethereum public key, required field.
chain_pub_key	string	Public key for the blockchain, required field.
info_url	string	URL with more info on the node.
country	string	Country code (ISO 3166-1 alpha-2) for the location of the node.
id	string	Node ID of the validator, i.e. the node's public master key.
name	string	Name of the validator.
avatar_url	string	AvatarURL of the validator.
vega_pub_key_index	uint32	Vega public key derivation index.
from_epoch	uint64	Epoch from which the validator is expected to be ready to validate blocks.
ethereum_signature	Signature	Signature from the validator made using the ethereum wallet.
vega_signature	Signature	Signature from the validator made using the Vega wallet.
submitter_address	string	Ethereum public key to use as a submitter to allow automatic signature generation.

ChainEvent

Event forwarded to the Vega network to provide information on events happening on other networks

Name	Type	Description
tx_id	string	Transaction ID of the transaction in which the events happened, usually a hash.
nonce	uint64	Arbitrary one-time integer used to prevent replay attacks.
builtin	vega.BuiltinAssetEvent	Built-in asset event.
erc20	vega.ERC20Event	Ethereum ERC20 event.
staking_event	vega.StakingEvent	Ethereum Staking event.
erc20_multisig	vega.ERC20MultiSigEvent	Ethereum ERC20 multisig event.

EthereumKeyRotateSubmission

Transaction to allow a validator to rotate their ethereum keys

Name	Type	Description
target_block	uint64	Target block at which the key rotation will take effect on.
new_address	string	New address to rotate to.
current_address	string	Currently used public address.
submitter_address	string	Ethereum public key to use as a submitter to allow automatic signature generation.
ethereum_signature	Signature	Signature that can be verified using the new ethereum address.

KeyRotateSubmission

Transaction to allow a validator to rotate their Vega keys

Name	Type	Description
new_pub_key_index	uint32	New Vega public key derivation index.
target_block	uint64	Target block at which the key rotation will take effect on.
new_pub_key	string	New public key to rotate to.
current_pub_key_hash	string	Hash of currently used public key.

NodeSignature

Represents a signature from a validator, to be used by a foreign chain in order to recognise a decision taken by the Vega network

Name	Type	Description
id	string	ID of the resource being signed.
sig	bytes	The signature generated by the signer.
kind	NodeSignatureKind	Kind of resource being signed.

NodeVote

Used when a node votes for validating that a given resource exists or is valid, for example, an ERC20 deposit is valid and exists on ethereum.

Name	Type	Description
reference	string	Reference identifying the resource making the vote, required field.
type	NodeVote.Type	Type of NodeVote, also required.

ProtocolUpgradeProposal

Transaction for a validator to suggest a protocol upgrade

Name	Type	Description
upgrade_block_height	uint64	Block height at which to perform the upgrade.
vega_release_tag	string	Release tag for the Vega binary.

StateVariableProposal

Transaction for a validator to submit a floating point value

Name	Type	Description
proposal	vega.StateValueProposal	State value proposal details.

ValidatorHeartbeat

Message from a validator signalling they are still online and validating blocks or ready to validate blocks when they are still a pending validator

Name	Type	Description
node_id	string	Node ID of the validator emitting the heartbeat.
ethereum_signature	Signature	Signature from the validator made using the ethereum wallet.
vega_signature	Signature	Signature from the validator made using the vega wallet.
message	string	Message which has been signed.

---

Enums

NodeSignatureKind

Kind of signature created by a node, for example, allow-listing a new asset, withdrawal etc

Name	Number	Description
NODE_SIGNATURE_KIND_UNSPECIFIED	0	Represents an unspecified or missing value from the input
NODE_SIGNATURE_KIND_ASSET_NEW	1	Represents a signature for a new asset allow-listing
NODE_SIGNATURE_KIND_ASSET_WITHDRAWAL	2	Represents a signature for an asset withdrawal
NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_ADDED	3	Represents a signature for a new signer added to the erc20 multisig contract
NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_REMOVED	4	Represents a signature for a signer removed from the erc20 multisig contract
NODE_SIGNATURE_KIND_ASSET_UPDATE	5	Represents a signature for an asset update allow-listing

NodeVote.Type

Name	Number	Description
TYPE_UNSPECIFIED	0	Represents an unspecified or missing value from the input
TYPE_STAKE_DEPOSITED	1	Node vote for a new stake deposit
TYPE_STAKE_REMOVED	2	Node vote for a new stake removed event
TYPE_FUNDS_DEPOSITED	3	Node vote for a new collateral deposit
TYPE_SIGNER_ADDED	4	Node vote for a new signer added to the erc20 bridge
TYPE_SIGNER_REMOVED	5	Node vote for a signer removed from the erc20 bridge
TYPE_BRIDGE_STOPPED	6	Node vote for a bridge stopped event
TYPE_BRIDGE_RESUMED	7	Node vote for a bridge resumed event
TYPE_ASSET_LISTED	8	Node vote for a newly listed asset
TYPE_LIMITS_UPDATED	9	Node vote for an asset limits update
TYPE_STAKE_TOTAL_SUPPLY	10	Node vote to share the total supply of the staking token
TYPE_SIGNER_THRESHOLD_SET	11	Node vote to update the threshold of the signer set for the multisig contract
TYPE_GOVERNANCE_VALIDATE_ASSET	12	Node vote to validate a new assert governance proposal

---