Oracle upgrade
Status: Planning · Target: 15 January 2027 on testnet, then with Mainnet
The oracle decides the settlement rate of every contract. This upgrade makes those rates come from independent operators and sources, publishes the full FX catalogue on Stellar, and opens the feed to other Stellar projects.
Today (testnet)
| Operators | Run by BlockFinaX |
| Data | Live FX market data |
| Agreement | At least 2 submissions within 1%, no older than 15 minutes; the average is used |
| Pairs | The pairs that have pools (USD/NGN, USD/GHS), from a larger catalogue available for pricing |
Already built
| Improvement | What it means |
|---|---|
| Rounds per contract and end time | Each settlement round is tied to its contract and its end time. |
| Agreement on matching rates | A round settles on the largest group of rates that agree, so one outlying rate never holds it up. |
| Confirmed large moves | A large move in the market is accepted once a second reading confirms it. |
These reach testnet with the next release.
After the upgrade
| Change | What it means |
|---|---|
| Independent operators | Settlement rates come from several independent operators, which must agree before they count. |
| Full FX catalogue on Stellar | Every pair BlockFinaX carries is published, each with a status. Missing or stale rates are reported as such, never replaced with estimates. |
| Large moves double-checked | Devaluation-sized moves are confirmed before settlement. |
| Reusable feed | A documented Soroban interface and API for other Stellar projects: pair, rate, precision, timestamp and source, with an example consumer contract that handles stale or missing data. |
| Separate pricing and settlement data | Premium inputs and settlement observations are kept apart and every settlement observation is retained. |
| Official fixings | Each currency settles on its official fixing, at that fixing's publication time. |
| Market-standard calendar | Valuation dates follow each currency's business days, and a missing fixing is handled by the market's postponement and fallback rules. |
What stays the same
- European settlement: only the rate at or after expiry counts.
- The agreed rate must be for the contract's exact end time.
- Contracts settle from the oracle's agreed rate; a defined fallback applies only if no agreed rate arrives within a set period after the end time.
Evidence at completion
A catalogue report covering every FX pair, traceable observations, settlement failure tests, and the reference consumer contract.