Data Dictionary

Oura follows a Cardano chain and outputs events. Each event contains data about itself and about the context in which it occurred.

A consumer aggregating a sequence of multiple events will notice redundant / duplicated data. For example, the "block number" value will appear repeated in the context of every event of the same block. This behavior is intended, making each event a self-contained record is an architectural decision. We favor "consumption ergonomics" over "data normalization".

Available Events

The following list represent the already implemented events. These data structures are represented as an enum at the code level.

RollBack Event

Data on chain rollback(The result of the local node switching to the consensus chains).

NameDataTypeDescription
block_slotu64Slot of the rolled back block.
block_hashStringHash of the rolled back block.



Block Event

Data on an issued block.

NameDataTypeDescription
body_sizeusizeSize of the block.
issuer_vkeyStringBlock issuer Public verification key.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.



Transaction Event

Data on a transaction.

NameDataTypeDescription
feeu64Transaction fees in lovelace.
ttlOption<u64>Transaction time to live.
validity_interval_startOption<u64>Start of transaction validity interval
network_idOption<u32>Network ID.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



TxInput Event

Data on a transaction input.

NameDataTypeDescription
tx_idStringTransaction ID.
indexu64Index of input in transaction inputs.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.
input_idxOption<usize>Input ID.



TxOutput Event

Data on a transaction output (UTXO).

NameDataTypeDescription
addressStringAddress of UTXO.
amountu64Amount of lovelace in UTXO.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.
output_idxOption<usize>Output ID.



OutputAsset Event

Data on a non-ADA asset in a UTXO.

NameDataTypeDescription
policyStringMinting policy of asset.
assetStringAsset ID.
amountu64Amount of asset.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.
output_idxOption<usize>Output ID.



Metadata Event

NameDataTypeDescription
keyString....
subkeyOption<String>....
valueOption<String>....

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



Mint Event

Data on the minting of a non-ADA asset.

NameDataTypeDescription
policyStringMinting policy of asset.
assetStringAsset ID.
quantityi64Quantity of asset minted.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



Collateral Event

Data on collateral inputs.

NameDataTypeDescription
tx_idStringTransaction ID.
indexu64Index of transaction input in inputs.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



PlutusScriptRef Event

NameDataTypeDescription
dataString....

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



StakeRegistration Event

Data on stake registration event.

NameDataTypeDescription
credentialStakeCredentialStaking credentials.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



StakeDeregistration Event

Data on stake deregistration event.

NameDataTypeDescription
credentialStakeCredentialStaking credentials.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



StakeDelegation Event

Data on stake delegation event.

NameDataTypeDescription
credentialStakeCredentialStake credentials.
pool_hashStringHash of stake pool ID.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



PoolRegistration Event

Data on the stake registration event.

NameDataTypeDescription
operatorStringStake pool operator ID.
vrf_keyhashStringKehash of node VRF operational key.
pledgeu64Stake pool pledge (lovelace).
costu64Operational costs per epoch (lovelace).
marginf64Operator margin.
reward_accountStringAccount to receive stake pool rewards.
pool_ownersVec<String>Stake pool owners.
relaysVec<String>....
pool_metadataOption<String>....

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



PoolRetirement Event

Data on stake pool retirement event.

NameDataTypeDescription
poolStringPool ID.
epochu64Current epoch.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



GenesisKeyDelegation Event

Data on genesis key delegation.

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Current slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.



MoveInstantaneousRewardsCert Event

NameDataTypeDescription
from_reservesbool....
from_treasurybool....
to_stake_credentialsOption<BTreeMap<StakeCredential, i64>>....
to_other_potOption<u64>....

Context

NameDataTypeDescription
block_numberOption<u64>Height of block from genesis.
slotOption<u64>Blockchain slot.
tx_idxOption<usize>Transaction Index.
tx_hashOption<String>Transaction hash.