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).
| Name | DataType | Description |
|---|---|---|
| block_slot | u64 | Slot of the rolled back block. |
| block_hash | String | Hash of the rolled back block. |
Block Event
Data on an issued block.
| Name | DataType | Description |
|---|---|---|
| body_size | usize | Size of the block. |
| issuer_vkey | String | Block issuer Public verification key. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
Transaction Event
Data on a transaction.
| Name | DataType | Description |
|---|---|---|
| fee | u64 | Transaction fees in lovelace. |
| ttl | Option<u64> | Transaction time to live. |
| validity_interval_start | Option<u64> | Start of transaction validity interval |
| network_id | Option<u32> | Network ID. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
TxInput Event
Data on a transaction input.
| Name | DataType | Description |
|---|---|---|
| tx_id | String | Transaction ID. |
| index | u64 | Index of input in transaction inputs. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
| input_idx | Option<usize> | Input ID. |
TxOutput Event
Data on a transaction output (UTXO).
| Name | DataType | Description |
|---|---|---|
| address | String | Address of UTXO. |
| amount | u64 | Amount of lovelace in UTXO. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
| output_idx | Option<usize> | Output ID. |
OutputAsset Event
Data on a non-ADA asset in a UTXO.
| Name | DataType | Description |
|---|---|---|
| policy | String | Minting policy of asset. |
| asset | String | Asset ID. |
| amount | u64 | Amount of asset. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
| output_idx | Option<usize> | Output ID. |
Metadata Event
| Name | DataType | Description |
|---|---|---|
| key | String | .... |
| subkey | Option<String> | .... |
| value | Option<String> | .... |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
Mint Event
Data on the minting of a non-ADA asset.
| Name | DataType | Description |
|---|---|---|
| policy | String | Minting policy of asset. |
| asset | String | Asset ID. |
| quantity | i64 | Quantity of asset minted. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
Collateral Event
Data on collateral inputs.
| Name | DataType | Description |
|---|---|---|
| tx_id | String | Transaction ID. |
| index | u64 | Index of transaction input in inputs. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
PlutusScriptRef Event
| Name | DataType | Description |
|---|---|---|
| data | String | .... |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
StakeRegistration Event
Data on stake registration event.
| Name | DataType | Description |
|---|---|---|
| credential | StakeCredential | Staking credentials. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
StakeDeregistration Event
Data on stake deregistration event.
| Name | DataType | Description |
|---|---|---|
| credential | StakeCredential | Staking credentials. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
StakeDelegation Event
Data on stake delegation event.
| Name | DataType | Description |
|---|---|---|
| credential | StakeCredential | Stake credentials. |
| pool_hash | String | Hash of stake pool ID. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
PoolRegistration Event
Data on the stake registration event.
| Name | DataType | Description |
|---|---|---|
| operator | String | Stake pool operator ID. |
| vrf_keyhash | String | Kehash of node VRF operational key. |
| pledge | u64 | Stake pool pledge (lovelace). |
| cost | u64 | Operational costs per epoch (lovelace). |
| margin | f64 | Operator margin. |
| reward_account | String | Account to receive stake pool rewards. |
| pool_owners | Vec<String> | Stake pool owners. |
| relays | Vec<String> | .... |
| pool_metadata | Option<String> | .... |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
PoolRetirement Event
Data on stake pool retirement event.
| Name | DataType | Description |
|---|---|---|
| pool | String | Pool ID. |
| epoch | u64 | Current epoch. |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
GenesisKeyDelegation Event
Data on genesis key delegation.
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Current slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |
MoveInstantaneousRewardsCert Event
| Name | DataType | Description |
|---|---|---|
| from_reserves | bool | .... |
| from_treasury | bool | .... |
| to_stake_credentials | Option<BTreeMap<StakeCredential, i64>> | .... |
| to_other_pot | Option<u64> | .... |
Context
| Name | DataType | Description |
|---|---|---|
| block_number | Option<u64> | Height of block from genesis. |
| slot | Option<u64> | Blockchain slot. |
| tx_idx | Option<usize> | Transaction Index. |
| tx_hash | Option<String> | Transaction hash. |