chain_events.proto

path vega/chain_events.proto

package vega

---

Messages

BuiltinAssetDeposit

Deposit for a Vega built-in asset

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
party_id	string	Vega party ID i.e. public key.
amount	string	Amount to be deposited. This field is an unsigned integer scaled to the asset's decimal places.

BuiltinAssetEvent

Event related to a Vega built-in asset

Name	Type	Description
deposit	BuiltinAssetDeposit	Built-in asset deposit.
withdrawal	BuiltinAssetWithdrawal	Built-in asset withdrawal.

BuiltinAssetWithdrawal

Withdrawal for a Vega built-in asset

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
party_id	string	Vega network party ID i.e. public key.
amount	string	The amount to be withdrawn. This field is an unsigned integer scaled to the asset's decimal places.

ERC20AssetDelist

Asset deny-listing for an ERC20 token

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.

ERC20AssetLimitsUpdated

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
source_ethereum_address	string	Ethereum wallet that initiated the deposit.
lifetime_limits	string	Updated lifetime limits.
withdraw_threshold	string	Updated withdrawal threshold.

ERC20AssetList

Asset allow-listing for an ERC20 token

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
asset_source	string	Ethereum address of the asset.

ERC20Deposit

Asset deposit for an ERC20 token

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
source_ethereum_address	string	Ethereum wallet that initiated the deposit.
target_party_id	string	Vega party ID i.e. public key that is the target of the deposit.
amount	string	Amount to be deposited.

ERC20Event

Event related to an ERC20 token

Name	Type	Description
index	uint64	Index of the log in the transaction.
block	uint64	Block in which the transaction was added.
chain_id	string	ID of the source chain for this event.
asset_list	ERC20AssetList	List an ERC20 asset.
asset_delist	ERC20AssetDelist	De-list an ERC20 asset.
deposit	ERC20Deposit	Deposit ERC20 asset.
withdrawal	ERC20Withdrawal	Withdraw ERC20 asset.
asset_limits_updated	ERC20AssetLimitsUpdated	Update an ERC20 asset.
bridge_stopped	bool	Bridge operations has been stopped.
bridge_resumed	bool	Bridge operations has been resumed.

ERC20Heartbeat

Heartbeat represents that the ERC20 bridge is being watched even though no events happened.

Name	Type	Description
contract_address	string	Contract address that is being listened to
block_height	uint64	Last Ethereum block height that was checked for events
block_time	uint64	Ethereum block time in Unix seconds.
source_chain_id	string	Source chain for this chain event.

ERC20MultiSigEvent

Event related to the ERC20 MultiSig

Name	Type	Description
index	uint64	Index of the log in the transaction
block	uint64	Block in which the transaction was added
chain_id	string	ID of the source chain for this event.
signer_added	ERC20SignerAdded	Add a signer to the erc20 bridge
signer_removed	ERC20SignerRemoved	Remove a signer from the erc20 bridge
threshold_set	ERC20ThresholdSet	Threshold set

ERC20SignerAdded

New signer added to the ERC20 bridge

Name	Type	Description
new_signer	string	Ethereum address of the new signer
nonce	string	Nonce created by the Vega network used for this new signer
block_time	int64	Time at which the block was produced will be used to inform the core at what time the stake was made unavailable.

ERC20SignerRemoved

Signer removed from the ERC20 bridge

Name	Type	Description
old_signer	string	Ethereum address of the old signer
nonce	string	Nonce created by the Vega network used for this old signer
block_time	int64	Time at which the block was produced. Will be used to inform the core at what time the stake was made unavailable.

ERC20ThresholdSet

Threshold has been updated on the multisig control

Name	Type	Description
new_threshold	uint32	New threshold value to set
nonce	string	Nonce created by the Vega network
block_time	int64	Time at which the block was produced. Will be used to inform the core at what time the stake was made unavailable.

ERC20Withdrawal

Asset withdrawal for an ERC20 token

Name	Type	Description
vega_asset_id	string	Vega network internal asset ID.
target_ethereum_address	string	Target Ethereum wallet address.
reference_nonce	string	Reference nonce used for the transaction.

EthContractCallEvent

Result of calling an arbitrary Ethereum contract method

Name	Type	Description
spec_id	string	ID of the data source spec that triggered this contract call.
block_height	uint64	Ethereum block height.
block_time	uint64	Ethereum block time in Unix seconds.
result	bytes	Result of contract call, packed according to the ABI stored in the associated data source spec.
error	optional string	Error message if the call failed.
source_chain_id	optional uint64	Source chain for this chain event.
heartbeat	bool	If true the event does not correspond to a contract call and is only a notification to core of the last checked block height.

StakeDeposited

Name	Type	Description
ethereum_address	string	Ethereum Address of the user depositing stake (hex encode with 0x prefix)
vega_public_key	string	Hex encoded public key of the party receiving the stake deposit.
amount	string	Amount deposited as an unsigned base 10 integer scaled to the asset's decimal places.
block_time	int64	Time at which the block was produced. Will be used to inform the core at what time the stake started to be available.

StakeRemoved

Name	Type	Description
ethereum_address	string	Ethereum address of the user removing stake. This should be hex encoded with 0x prefix.
vega_public_key	string	Hex encoded public key of the party from which to remove stake.
amount	string	Amount removed as a base 10 unsigned integer scaled to the asset's decimal places.
block_time	int64	The time at which the block was produced will be used to inform the core at what time the stake was made unavailable.

StakeTotalSupply

Name	Type	Description
token_address	string	Address of the staking asset
total_supply	string	Total supply observed for the token as an unsigned based 10 integer scaled to the asset's decimal places.

StakingEvent

Event related to staking on the Vega network.

Name	Type	Description
index	uint64	Index of the log in the transaction.
block	uint64	Block in which the transaction was added.
stake_deposited	StakeDeposited
stake_removed	StakeRemoved
total_supply	StakeTotalSupply

---