Build and run oracles on Quantova, the post-quantum Layer 1. An oracle brings external data on-chain — market prices, fees, supply metrics, DEX feeds — so contracts can act on it. This repository shows how oracles work on Quantova and gives you runnable patterns to build and operate your own.
Everything here is built on the Quantova q_ JSON-RPC surface and the post-quantum account
model. The hard rule that runs through all of it: read and publish on finality, not on
inclusion. Quantova finality is deterministic (~3s) and does not reorg, which is exactly the
property a reliable data feed needs.
- Website: https://quantova.org
- Developer documentation: https://quantova.org/static/pdfjs/web/viewer.html?file=/static/pdf/Gitbook-Quantova-Developer-Documentation.pdf#nameddest=cover&page=1&pagemode=bookmarks
- JSON-RPC reference: see
developer-contentand the node guide inconsensus-specs - Testnet:
wss://testnet.quantova.io· faucet at https://quantova.org
Note on endpoints. The hosted RPC endpoints (
testnet.quantova.io,mainnet.quantova.io) are the canonical URLs from the Quantova developer documentation, but the public testnet may be offline at times. If a request doesn't connect, run a local node and point the examples at it instead —http://127.0.0.1:9933(HTTP) /ws://127.0.0.1:9944(WS). See running an oracle node.
An oracle is two halves:
- Off-chain feeder — a process you run that gathers data (from exchanges, DEX pools, or the chain itself), then signs and submits it to an on-chain contract with a post-quantum key.
- On-chain consumer — a QVM contract that stores the latest value and exposes it to other contracts, with freshness and authenticity checks.
data source ──► feeder (your node/service) ──► sign (PQ key) ──► q_sendRawTransaction
│
QVM oracle contract ◄─────────┘
│
consumer contracts read the value
Quantova-specific points that shape every oracle here:
- Finality, not inclusion. A receipt means included; a feed must treat a value as settled only after finality. Read source chain state from a finalized height too.
- Post-quantum signing. Feeder authorization uses Dilithium/Falcon/SPHINCS+ — on-chain
signature checks go through the post-quantum precompiles, never an
ecrecoverpath. - Run your own archive node. Production feeders should not depend on public RPC. See running an oracle node.
| # | Guide | What you build |
|---|---|---|
| 00 | Oracle Basics | The feeder + consumer model, finality, and trust assumptions. |
| 01 | Reading Chain Data (RPC) | The q_ methods every oracle uses, with examples. |
| 02 | Market Price Aggregator | A multi-exchange spot-price feed with median aggregation. |
| 03 | Fee & Gas Oracle | A network fee/gas feed from q_feeHistory and friends. |
| 04 | Supply Metrics Oracle | Circulating vs. total supply for QTOV and QRC20 assets. |
| 05 | DEX Price Feed Oracle | On-chain spot prices read directly from DEX pool reserves. |
| 06 | Running an Oracle Node | Hosting a feeder on your own archive node, reliably. |
| 07 | Publishing On-Chain | The QVM oracle contract: storing, signing, and freshness checks. |
| 08 | Post-Quantum DEX Price Aggregator | A GET-only engine that ranks every DEX in the ecosystem to find the best price feed per pair. |
| File | What it shows |
|---|---|
examples/rpc-client.js |
A minimal q_ JSON-RPC client used across the guides. |
examples/price-feeder.js |
A working price feeder: aggregate, then submit on finality. |
examples/OracleConsumer.sol |
A QVM consumer contract with freshness and authenticity checks. |
examples/dex-price-aggregator.js |
A post-quantum DEX price aggregator: GET-only reads across venues, ranks the best price feed per pair. |
Read the latest finalized block height with the q_ API:
curl -s https://testnet.quantova.io \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"q_blockNumber","params":[]}'From there, Reading Chain Data shows the rest of the surface a feeder needs.
| Repository | Purpose |
|---|---|
| developer-content | Developer documentation, including the full JSON-RPC reference. |
| consensus-specs | Consensus model and the node/RPC guide. |
| dev-base-template | Starter template for building on Quantova. |
© 2026 Quantova Inc. See LICENSE.md. These materials are for development reference and are not financial, investment, or security advice; oracle design carries real risk and is your responsibility to audit.