Skip to main content
Version: pre-release (v0.78)

chain_events.proto

path vega/chain_events.proto

package vega


Messages

BuiltinAssetDeposit

Deposit for a Vega built-in asset

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
party_idstringVega party ID i.e. public key.
amountstringAmount 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

NameTypeDescription
depositBuiltinAssetDepositBuilt-in asset deposit.
withdrawalBuiltinAssetWithdrawalBuilt-in asset withdrawal.

BuiltinAssetWithdrawal

Withdrawal for a Vega built-in asset

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
party_idstringVega network party ID i.e. public key.
amountstringThe 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

NameTypeDescription
vega_asset_idstringVega network internal asset ID.

ERC20AssetLimitsUpdated

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
source_ethereum_addressstringEthereum wallet that initiated the deposit.
lifetime_limitsstringUpdated lifetime limits.
withdraw_thresholdstringUpdated withdrawal threshold.

ERC20AssetList

Asset allow-listing for an ERC20 token

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
asset_sourcestringEthereum address of the asset.

ERC20Deposit

Asset deposit for an ERC20 token

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
source_ethereum_addressstringEthereum wallet that initiated the deposit.
target_party_idstringVega party ID i.e. public key that is the target of the deposit.
amountstringAmount to be deposited.

ERC20Event

Event related to an ERC20 token

NameTypeDescription
indexuint64Index of the log in the transaction.
blockuint64Block in which the transaction was added.
chain_idstringID of the source chain for this event.
asset_listERC20AssetListList an ERC20 asset.
asset_delistERC20AssetDelistDe-list an ERC20 asset.
depositERC20DepositDeposit ERC20 asset.
withdrawalERC20WithdrawalWithdraw ERC20 asset.
asset_limits_updatedERC20AssetLimitsUpdatedUpdate an ERC20 asset.
bridge_stoppedboolBridge operations has been stopped.
bridge_resumedboolBridge operations has been resumed.

ERC20Heartbeat

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

NameTypeDescription
contract_addressstringContract address that is being listened to
block_heightuint64Last Ethereum block height that was checked for events
block_timeuint64Ethereum block time in Unix seconds.
source_chain_idstringSource chain for this chain event.

ERC20MultiSigEvent

Event related to the ERC20 MultiSig

NameTypeDescription
indexuint64Index of the log in the transaction
blockuint64Block in which the transaction was added
chain_idstringID of the source chain for this event.
signer_addedERC20SignerAddedAdd a signer to the erc20 bridge
signer_removedERC20SignerRemovedRemove a signer from the erc20 bridge
threshold_setERC20ThresholdSetThreshold set

ERC20SignerAdded

New signer added to the ERC20 bridge

NameTypeDescription
new_signerstringEthereum address of the new signer
noncestringNonce created by the Vega network used for this new signer
block_timeint64Time 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

NameTypeDescription
old_signerstringEthereum address of the old signer
noncestringNonce created by the Vega network used for this old signer
block_timeint64Time 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

NameTypeDescription
new_thresholduint32New threshold value to set
noncestringNonce created by the Vega network
block_timeint64Time 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

NameTypeDescription
vega_asset_idstringVega network internal asset ID.
target_ethereum_addressstringTarget Ethereum wallet address.
reference_noncestringReference nonce used for the transaction.

EthContractCallEvent

Result of calling an arbitrary Ethereum contract method

NameTypeDescription
spec_idstringID of the data source spec that triggered this contract call.
block_heightuint64Ethereum block height.
block_timeuint64Ethereum block time in Unix seconds.
resultbytesResult of contract call, packed according to the ABI stored in the associated data source spec.
erroroptional stringError message if the call failed.
source_chain_idoptional uint64Source chain for this chain event.
heartbeatboolIf true the event does not correspond to a contract call and is only a notification to core of the last checked block height.

StakeDeposited

NameTypeDescription
ethereum_addressstringEthereum Address of the user depositing stake (hex encode with 0x prefix)
vega_public_keystringHex encoded public key of the party receiving the stake deposit.
amountstringAmount deposited as an unsigned base 10 integer scaled to the asset's decimal places.
block_timeint64Time at which the block was produced. Will be used to inform the core at what time the stake started to be available.

StakeRemoved

NameTypeDescription
ethereum_addressstringEthereum address of the user removing stake. This should be hex encoded with 0x prefix.
vega_public_keystringHex encoded public key of the party from which to remove stake.
amountstringAmount removed as a base 10 unsigned integer scaled to the asset's decimal places.
block_timeint64The time at which the block was produced will be used to inform the core at what time the stake was made unavailable.

StakeTotalSupply

NameTypeDescription
token_addressstringAddress of the staking asset
total_supplystringTotal 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.

NameTypeDescription
indexuint64Index of the log in the transaction.
blockuint64Block in which the transaction was added.
stake_depositedStakeDeposited
stake_removedStakeRemoved
total_supplyStakeTotalSupply