transaction.proto
path vega/commands/v1/transaction.proto
package vega.commands.v1
Messages
InputData
Input data for a transaction containing a network command for the Vega network to execute. Once populated the protobuf message should be marshalled into a byte array and included in a transaction message.
| Name | Type | Description |
|---|---|---|
nonce | uint64 | Arbitrary number used to provide uniqueness to the signature of two otherwise identical input data, preventing replay attacks. Must be set to a different value for all new transactions sent by a party. It is advised to generate this number randomly. |
block_height | uint64 | Block height which has been used to calculate the transaction proof-of-work. |
order_submission | OrderSubmission | Command to submit an order. |
order_cancellation | OrderCancellation | Command to cancel an order. |
order_amendment | OrderAmendment | Command to amend an order. |
withdraw_submission | WithdrawSubmission | Command to submit a withdrawal. |
proposal_submission | ProposalSubmission | Command to submit a governance proposal. |
vote_submission | VoteSubmission | Command to submit a vote on a governance proposal. |
liquidity_provision_submission | LiquidityProvisionSubmission | Command to submit a liquidity commitment. |
delegate_submission | DelegateSubmission | Command to delegate tokens to a validator. |
undelegate_submission | UndelegateSubmission | Command to remove tokens delegated to a validator. |
liquidity_provision_cancellation | LiquidityProvisionCancellation | Command to cancel a liquidity commitment. |
liquidity_provision_amendment | LiquidityProvisionAmendment | Command to amend a liquidity commitment. |
transfer | Transfer | Command to submit a transfer. |
cancel_transfer | CancelTransfer | Command to cancel a recurring transfer. |
announce_node | AnnounceNode | Command used by a node operator to announce its node as a pending validator. |
batch_market_instructions | BatchMarketInstructions | Command to submit a batch of order instructions. |
stop_orders_submission | StopOrdersSubmission | Command to submit a pair of stop orders. |
stop_orders_cancellation | StopOrdersCancellation | Command to cancel stop orders. |
create_referral_set | CreateReferralSet | Command to create a referral set. |
update_referral_set | UpdateReferralSet | Command to update a referral set. |
apply_referral_code | ApplyReferralCode | Command to apply a referral code. |
node_vote | NodeVote | Validator command sent automatically to vote on that validity of an external resource. |
node_signature | NodeSignature | Validator command sent automatically to provide signatures for the Ethereum bridge. |
chain_event | ChainEvent | Validator command sent automatically to notify the Vega chain of an off-chain event. |
key_rotate_submission | KeyRotateSubmission | Validator command sent manually by a node operator to rotate their node's Vega keys. |
state_variable_proposal | StateVariableProposal | Validator command sent automatically to reach consensus on floating point values. |
validator_heartbeat | ValidatorHeartbeat | Validator command sent automatically to signal regular participation in the network. |
ethereum_key_rotate_submission | EthereumKeyRotateSubmission | Validator command sent manually by a node operator to rotate their node's Ethereum keys. |
protocol_upgrade_proposal | ProtocolUpgradeProposal | Validator command sent manually to propose a protocol upgrade. |
issue_signatures | IssueSignatures | Command to request signatures to amend the multisig-control contract. |
oracle_data_submission | OracleDataSubmission | Command to submit external oracle data. |
ProofOfWork
Components needed for the network to verify proof-of-work.
| Name | Type | Description |
|---|---|---|
tid | string | Unique transaction identifier used to seed the proof-of-work hash. |
nonce | uint64 | Number which, combined with the transaction identifier, will produce a hash with the required number of leading zeros to be accepted by the network. |
Transaction
Transaction containing a command that can be sent to instruct the network to execute an action. A transaction contains a byte string representation of the input data which must then be signed, with the signature added to the transaction.
| Name | Type | Description |
|---|---|---|
input_data | bytes | Protobuf message of type `InputData` marshalled into bytes. If the transaction version is V3 or higher then this bytes string must be prepended with `chain_id_as_byes + \0`. |
signature | Signature | Signature of the input data field, signed by the sender of this transaction. |
address | string | Hex-encoded address of the sender. Not supported yet. |
pub_key | string | Hex-encoded public key of the sender. |
version | TxVersion | Version of the transaction. |
pow | ProofOfWork | Proof-of-work containing the random transaction ID used by the client and the nonce. |
Enums
TxVersion
Transaction versions to maintain backwards compatibility of transaction formats.
| Name | Number | Description |
|---|---|---|
TX_VERSION_UNSPECIFIED | 0 | Transaction version is unspecified. |
TX_VERSION_V2 | 2 | Transaction requires the addition of a proof-of-work calculation. |
TX_VERSION_V3 | 3 | Transaction input data contains a prepended chain ID to prevent use of a single transaction across multiple networks. |