KIP-91: Hire Green for Optimistic Oracle and V2 reviews
Summary
The DAO requests that the Cooperative hire Green as a full-time senior smart contract developer, on the Cooperative’s standard senior compensation terms. The role’s two initial responsibilities are:
-
Responsibility A — Kleros Optimistic Oracle: specify, implement, launch, and maintain a Kleros-native Optimistic Oracle built on Court V2, timed with the Kleros V2 launch, and coordinate the migration of the V2 apps onto it. Structured in two gated milestones, followed by ongoing development and maintenance.
-
Responsibility B — Kleros V2 review: continuous independent review and testing of the Kleros V2 contracts throughout the term.
As with any full-time role, more responsibilities may be added over time as needs arise. Progress is reported publicly each month either way.
Motivation
A. Optimistic oracle
Kleros currently relies on Reality.eth, a third-party contract maintained by one person as a side project, for optimistic resolution. This dependency has several problems:
-
The frontend is barely maintained, and question data depends on the subgraph: some data, like question creation timestamps, is not stored in the contract and can only be read through an indexer. When the subgraph fails, Kleros V1 evidence display breaks — and Kleros V2 data mappings will break the same way unless they also go through a subgraph. A native oracle exposes this data directly to disputes and data mappings.
-
Reality.eth’s evidence and dispute formats are not Kleros formats. Every integration needs proxy and adapter contracts, which have been a recurring source of bugs and complexity.
-
Reality.eth has no cross-chain support. Cross-chain is the most time-consuming part of the dependency: for each new chain, Kleros has to build, deploy, and operate its own proxies. In other words, the dependency gives no help exactly where the work is heaviest, so it offers little advantage over self-owned infrastructure. Kleros is also building its own bridge, Vea. It makes more sense to build an oracle that uses Vea directly than to keep maintaining Reality.eth proxies next to it.
-
Reality.eth includes a bond-doubling escalation mechanism. Kleros Court already provides appeals, so integrations carry this complexity without using it.
On top of that, most Kleros arbitrables (Curate, Proof of Humanity, Escrow) implement the same optimistic pattern internally — post, bond, challenge, escalate. The logic is duplicated at every layer: each application’s contracts, subgraphs, and frontends carry their own copy of the same flow, and each copy has to be developed, audited, indexed, and maintained separately. Kleros V2 already moved appeal handling out of arbitrables into a shared component; a shared optimistic oracle does the same for optimistic submission.
B. V2 review capacity
V2 development was recently postponed indefinitely after vulnerabilities and design disagreements. Adding developers does not speed things up, but adding reviewers makes it less likely that vulnerabilities slip through, and every vulnerability found late means more delay.
Specification
Request
The Cooperative hires Green as a full-time senior smart contract developer. The role starts with Responsibilities A and B below; as with other team members, more can be added over time by agreement with the Cooperative.
Responsibility A — Kleros Optimistic Oracle
The oracle uses Court V2 as its arbitrator, not Court V1. I will coordinate this development and the migration of all V2 apps onto the oracle.
Milestone 1: Specification (4 weeks)
A written specification covering:
-
Contract interfaces: home oracle, chain connector, arbitrable integration.
-
Ruling semantics, including whether and how partial or proportional rulings are supported — keeping the core protocol minimal while extensible.
-
The Vea integration model, produced in collaboration with the Vea team, documenting which interfaces are stable and which are in flux.
-
A migration path for each existing arbitrable: retire-and-redeploy, adapter, or stay on Reality.eth.
-
An inventory of what gets simpler: which contract, subgraph, and frontend components in existing arbitrables can be retired or simplified once they adopt the shared oracle.
-
Frontend and indexing data requirements, defined alongside the contracts.
Gate: technical review by Cooperative reviewers. The Cooperative owns the specification regardless of outcome.
Milestone 2: Implementation (12 weeks)
Home oracle contracts integrated with Kleros V2 Court; a first chain connector via Vea (Arbitrum as initial target); a reference frontend covering the full loop (post question, propose answer, challenge, view dispute in Court); developer documentation as described under Agent readiness below.
Gate: testnet deployment and demonstration. Acceptance test: integrating with the Kleros Oracle must take fewer steps and less custom code than the equivalent Reality.eth integration.
Timing and termination
Milestone durations count only the weeks spent on oracle work. Weeks spent on V2 review (Responsibility B) or other work assigned by the Cooperative push the active milestone’s deadline back by the same amount; the split is recorded in the monthly reports.
If a milestone misses its adjusted deadline or fails its gate review, the role is terminated.
Post-launch development and maintenance
After Milestone 2, work continues for the rest of the term without milestone gates:
-
Production launch, once Kleros V2 launches (and the audit and Vea are ready). Frontend, UX, and integration work continue in the meantime, so the oracle is ready to launch alongside V2.
-
Notification and backend services, exposed both through the oracle frontend and as part of the documented API.
-
Frontend and developer-experience iteration based on integrator feedback.
-
Coordinating the step-by-step migration of all V2 apps (contracts and frontends) onto the shared oracle, retiring the duplicated optimistic logic and the Reality.eth adapter layer.
-
Ongoing maintenance: adapting to Vea and V2 changes, fixes, and operational support.
Dependencies: multichain support depends on Vea being ready. Work targets whatever Vea and V2 standards are current at each stage.
Agent readiness
The oracle is designed to be directly usable by AI agents, both as integrators and as participants (posting questions, proposing answers, monitoring and challenging).
Responsibility B — Kleros V2 review
Independent review and testing of the Kleros V2 contracts throughout the term — an extra set of eyes alongside the existing V2 developers. This runs in parallel with Responsibility A for the whole role and has no milestone gates. Findings go into the monthly reports.
Other Responsibilities
When there is capacity left beyond Responsibilities A and B, work defaults to the core of the protocol:
-
Development and maintenance of a secure Arbitrator that uses PNK.
-
Notifications and user experience for jurors.
-
Documentation and ease of integration — off-chain, on-chain, and across chains.
-
Wrappers and abstractions that serve the above.
This is a default, not a limit: other responsibilities can be agreed with the Cooperative, as stated in the Request.
Compensation
Standard Cooperative terms for a senior developer: total compensation in the $90k–$120k annual range, including the Cooperative’s usual vested component.
Reporting
The hire is made on the DAO’s recommendation, so the role answers to both the Cooperative and the DAO. Concretely:
-
Monthly public progress reports on the forum: shipped work, V2 review findings, time split between Responsibilities A and B (and anything added later), and blockers.
-
Each milestone gate decision (pass/fail, with the reasons) is published.
-
Reporting continues for as long as the role exists, including for responsibilities added after this proposal.
Rationale
Why a full-time role and not a fixed-scope contract. Much of the work is ongoing rather than one-off:
-
An oracle in production needs maintenance: keeping notification and backend services running, fixing bugs, and adapting to Vea and V2 as they change. Reality.eth’s problems come from being maintained as a side project; the replacement should not repeat that support model.
-
Integration quality comes from iterating after the first release: improving user experience, developer experience, and documentation.
-
The V2 apps migrate to the shared interface step by step, as each application’s situation allows — I will coordinate that across teams.
-
V2 review only works if it is continuous through the development cycle.
Consolidation. One audited optimistic component replaces the per-arbitrable implementations and the Reality.eth adapter layer across contracts, subgraphs, and frontends. That means less to audit and maintain — and the effort now spent re-implementing the same flow in every application goes to user experience, developer experience, and the applications themselves instead.
Why pair the two responsibilities. Both need the same profile (Solidity, deep knowledge of the Kleros contracts), and the oracle plugs directly into the V2 Court, so oracle work and V2 review feed each other.
The deadline-extension rule in Timing and termination keeps the milestone commitments real while letting review take priority when needed.
Candidate
Green, the author of this proposal — 3 years at the Kleros Cooperative as a full-stack developer. Independent deliveries for Kleros: PGTCR.sol and the Vea validator (Rust).
Vote
-
For: The DAO requests the Cooperative to make this hire.
-
Against: No request is made.