Live at: demos-oracle.com
The Demos Network Oracle (DNO) is a watch-only network intelligence service for the Demos blockchain testnet. It monitors public validator nodes, tracks network agreement, detects incidents, publishes attested health data on-chain via SuperColony, and serves a public API.
Built by XM33, independently of the Demos team.
- Watch-only. The Oracle observes the network; it does not validate, vote, or participate in consensus.
- Public-first. Canonical truth comes from public validator nodes. Fleet-internal data is reference-only.
- Observation ≠ endorsement. Being monitored by the Oracle is not a signal of approval.
- Explainability. Every categorical signal comes with a paired reason string.
| Endpoint | Description |
|---|---|
| / | Homepage — live status, agreement, incidents |
| /organism | Canonical JSON state (primary machine-readable endpoint) |
| /health | Network health snapshot |
| /methodology | How the Oracle computes what it publishes |
| /agent | Agent/consumer integration guide |
| /sources | Data provenance and monitoring sources |
| /community | Community node onboarding (reference surface) |
| /submit | Submit a community node for observation |
The Oracle publishes seven canonical fields via /organism:
| Field | Type | Paired reason |
|---|---|---|
status |
operable / partial / degraded / unknown | status_reason |
trend |
improving / stable / worsening | — |
risk |
low / elevated / high | risk_factors |
data_quality |
sufficient / partial / insufficient | — |
confidence |
clear / provisional | confidence_reason |
agreement |
strong / split / unknown | agreement_reason |
active_incidents |
integer | (incident list) |
Status = operability of the network right now. Risk = resilience under near-term stress.
curl -s https://demos-oracle.com/organism | jq '{status, risk, agreement, summary}'curl -s https://demos-oracle.com/organism | jq -r '.status'curl -s https://demos-oracle.com/health | jq- Single-file Node/Bun service:
src/agent.mjs(~3,500 lines) - Runtime: Bun
- Monitoring interval: 20 seconds
- Publishing interval: 20 minutes
- On-chain attestation: via SuperColony every ~1–6 hours
Not currently a supported use case — the Oracle is operated as a singular public service. If you want to run a modified instance for research or auditing, see /methodology and the source in src/agent.mjs.
Bugs, data inconsistencies, or security issues: see SECURITY.md.
MIT — see LICENSE.
Attribution. This repository and the Oracle service are built and maintained by XM33, independent of the Demos team. Inclusion of a node in the Oracle's monitoring set does not imply endorsement by Demos or XM33.