Cowrie Research

reality-eth-primary-sources-2026-05-07

2 min read

reality.eth primary sources — 2026-05-07

Classification takeaway

reality.eth is most usefully classified as a subjective oracle and optimistic-dispute primitive: a mechanism for turning contested offchain claims into onchain answers through escalating bonds, timeout windows, and arbitrator fallback rather than through a fixed publisher set.

Primary sources reviewed

  1. Project site — https://reality.eth.limo/

    • Official homepage for the project and dapp entrypoint.
    • Useful as the canonical root URL for the system.

  2. Documentation index — https://realitio.github.io/docs/html/

    • Describes reality.eth as a “crowd-sourced on-chain smart contract oracle system.”
    • Shows the main components of the public docs: dapp usage, contract usage, arbitrators, fees, whitepaper, contract internals, and audit material.

  3. Official whitepaper — https://realitio.github.io/docs/html/whitepaper.html

    • Defines the project goals around arbitrary questions, cheap typical resolution, rewarding correct answers, and making wrong answers costly.
    • Explains the core escalation-game design: answers require bonds, later answers must at least double earlier bonds, timeouts finalize routine cases, and arbitration handles exceptional disputes.
    • Documents important mechanism details like commit-reveal, question encoding/templates, low-gas correction paths, and fee sinks.

  4. Arbitrators documentation — https://realitio.github.io/docs/html/arbitrators.html

    • Says any contract address can be used as an arbitrator.
    • Lists different arbitration models including trusted third parties, jury pools, stakeholder voting, and coordination games.
    • Makes the dependency surface explicit: if the arbitrator is untrustworthy, the system cannot be relied on.

  5. Monorepo README — https://raw.githubusercontent.com/RealityETH/reality-eth-monorepo/master/README.md

    • Confirms the project ships a complete public stack: contracts, question/template library, dapp, docs, website, CLI tools, graph definitions, and template generator.
    • Shows reality.eth as maintained infrastructure, not just a paper mechanism.

  6. Subjectivocratic Oracle-enshrined Rollup design note — https://raw.githubusercontent.com/RealityETH/subjectivocracy/main/README.md

    • Extends the reality.eth escalation game into a broader governance framing where routine disputes are handled by reality.eth and exceptional cases can escalate into fork-or-governance style resolution.
    • Useful for comparing oracle truth resolution with governance escalation, bridge control, and fork-management authority.

Why it stays in the active corpus

  • Canonical example of an oracle primitive where truth is produced by a bond-and-arbitration game rather than by a fixed signer committee.
  • Strong comparison case for governance systems that depend on question wording, executor setup, arbitration choices, or optimistic dispute windows.
  • Helps connect oracle infrastructure to governance execution, especially when protocols turn offchain facts or outcomes into onchain actions through a small set of templated dispute pathways.

Graph View