Reference
What it does
The oracle module brings external data — token prices, reference exchange rates — into chain state where economic logic can use it. Feeds are submitted, validated, and stored so that modules pricing marketplace services or evaluating policy have a consensus-visible data source.
Oracle design constrains manipulation: submissions are permissioned and validated rather than free-for-all, because a corrupted price feed corrupts everything priced by it.
Why it exists: A marketplace that prices real-world compute in a volatile token needs a trustworthy bridge to external prices. Doing that bridging in a dedicated, auditable module keeps a sensitive dependency contained and governable.
State
Primary objects
| Concept | Definition |
|---|---|
Feed | A stream of externally-sourced values validated into chain state. |
Oracle risk | The exposure created when on-chain logic depends on off-chain data quality. |
Messages
Messages & queries
Message and query surfaces are documented at implementation level in the module docs ↗ and the source ↗. The objects above are the state those messages create and transition.
Connections
Module interactions
-
x/settlementFiat-referenced pricing resolves through oracle rates. -
x/bmeSupply mechanics can reference oracle-reported market conditions. -
x/marketBid pricing strategies can anchor to oracle-published references.
Flows
Core flow
- Submit — Feeds are submitted. Permissioned sources publish token prices and reference rates on a schedule.
- Validate — Values are checked. Submissions pass validation before entering state — the guardrail against corrupted data.
- Store — Rates become state. Consensus-visible data that any module can reference deterministically.
- Price — Logic consumes. Settlement conversions, bid anchors, and policy inputs resolve through stored rates.
Questions
Asked about x/oracle
What is a feed?
A stream of externally-sourced values — token prices, reference exchange rates — validated into chain state on a schedule.
What is oracle risk?
The exposure created when on-chain logic depends on off-chain data quality. This module contains it by design: permissioned submissions, validation before storage, and a governable dependency surface.
Which modules read oracle data?
Settlement for fiat-referenced pricing, market participants anchoring bid strategies, and supply mechanics referencing market conditions.
Related