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 (ParseCbor Filter)

When the filter ParseCbor is enabled, the events will use the UTxORPC data structures.

Available Events (Legacy V1 Filter)

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	Option<String>	Block hash. 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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.

---

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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
output_idx	Option<usize>	Output ID.

---

Metadata Event

Name	DataType	Description
label	String	Metada label.
map_json (*)	Option<JsonValue>	Json map.
array_json (*)	Option<JsonValue>	Json array.
int_scalar (*)	Option<i128	Number.
text_scalar (*)	Option<String>	Text.
bytes_hex (*)	Option<String>	Bytes.

(*) Only one of these options will be used.

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

VkeyWitness Event

Name	DataType	Description
vkey_hex	String
signature_hex	String

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.

---

NativeWitness Event

Name	DataType	Description
policy_id	String
script_json	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

PlutusWitness Event

Name	DataType	Description
script_hash	String
script_hex	String

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

PlutusRedeemer Event

Name	DataType	Description
purpose	String
ex_units_mem	u32
ex_units_steps	u64
input_idx	u32
plutus_data	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

PlutusDatum Event

Name	DataType	Description
datum_hash	String
plutus_data	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

CIP25Asset Event

Name	DataType	Description
version	String	version
policy	String
asset	String
name	Option<String>
image	Option<String>
media_type	Option<String>
description	Option<String>
raw_json	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

CIP15Asset Event

Name	DataType	Description
voting_key	String
stake_pub	String
reward_address	String
nonce	i64
raw_json	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.

---

NativeScript Event

Name	DataType	Description
policy_id	String
script	JsonValue

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.

---

PlutusScript Event

Name	DataType	Description
hash	String	…
data	String	…

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
certificate_idx	Option<usize>

---

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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
certificate_idx	Option<usize>

---

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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
certificate_idx	Option<usize>

---

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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
certificate_idx	Option<usize>

---

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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.
certificate_idx	Option<usize>

---

GenesisKeyDelegation Event

Data on genesis key delegation.

Context

Name	DataType	Description
block_number	Option<u64>	Height of block from genesis.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Current slot.
timestamp	Option<u64>	Timestamp.
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.
block_hash	Option<String>	Block hash.
slot	Option<u64>	Blockchain slot.
timestamp	Option<u64>	Timestamp.
tx_idx	Option<usize>	Transaction Index.
tx_hash	Option<String>	Transaction hash.