Skip to content

Commit ac2111d

Browse files
marcosklerosgitbook-bot
authored andcommitted
GITBOOK-344: Created RoJ Page
1 parent 4749fd6 commit ac2111d

File tree

14 files changed

+871
-0
lines changed

14 files changed

+871
-0
lines changed

SUMMARY.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,19 @@
6969
* [Escrow React](integrations/types-of-integrations/1.-dispute-resolution-integration-plan/integration-tools/escrow-react-widget.md)
7070
* [Escrow SDK](integrations/types-of-integrations/1.-dispute-resolution-integration-plan/integration-tools/escrow-sdk.md)
7171
* [Centralized Arbitrator](integrations/types-of-integrations/1.-dispute-resolution-integration-plan/integration-tools/centralized-arbitrator.md)
72+
* [Recognition of Jurisdiction Integration](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/README.md)
73+
* [Smart contract integration with Kleros Court (Arbitrator)](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/smart-contract-integration.md)
74+
* [Use Cases](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/use-cases/README.md)
75+
* [DeFi Insurance](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/use-cases/defi-insurance.md)
76+
* [Gaming](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/use-cases/gaming.md)
77+
* [Channel partners](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/channel-partners/README.md)
78+
* [How to use Reality.eth + Kleros as an oracle](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/channel-partners/how-to-use-reality.eth-+-kleros-as-an-oracle.md)
79+
* [Safe Zodiac integration](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/channel-partners/zodiac-integration.md)
80+
* [Kleros Reality Module](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/channel-partners/kleros-reality-module.md)
81+
* [Integration Tools](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/integration-tools/README.md)
82+
* [Escrow React](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/integration-tools/escrow-react-widget.md)
83+
* [Escrow SDK](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/integration-tools/escrow-sdk.md)
84+
* [Centralized Arbitrator](integrations/types-of-integrations/1.-dispute-resolution-integration-plan-1/integration-tools/centralized-arbitrator.md)
7285
* [2. Curated-data integration plan](integrations/types-of-integrations/2.-curated-data-integration-plan/README.md)
7386
* [Retrieving information from Kleros Dapps](integrations/types-of-integrations/2.-curated-data-integration-plan/interacting-with-arbitrable-app.md)
7487
* [Policy writing guide](integrations/policy-writing-guide.md)
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
description: A guide on how to use Kleros as a standalone dispute resolution service.
3+
---
4+
5+
# Recognition of Jurisdiction Integration
6+
7+
## Introduction
8+
9+
If you're interested in using the [**Kleros Court**](../../../products/court/) for dispute resolution within your project/company with zero technical work, the Recognition of Jurisdiction Integration (RoJ) is a great alternative. This is especially useful for **Protocols or Companies that are:** 
10+
11+
* Operating on **chains other than Ethereum and Gnosis Chain** (where Kleros offers native support)**.** 
12+
* Interested in **testing out the workflow with Kleros** without investing in a technical integration
13+
* **Traditional companies** (web 2 or web 2.5) that do not interact with the blockchain
14+
15+
Completing the necessary documentation for a RoJ is a relatively short process, which shouldn't take more than a few weeks (or even a few days). \
16+
To begin with the 4 steps, it's recommended to have had a call with a member of the Business Development team beforehand. If you're interested in scheduling an initial call, please contact Marcos at marcos@kleros.io.
17+
18+
Integrating Kleros into your dispute decision process will always involve 3 main steps and they are outlined below. 
19+
20+
{% hint style="info" %}
21+
To help you keep track of your integration process, click [**here**](https://docs.google.com/document/d/1dn27idjPIfRInrPUmdvL2nYN0BQ6HRIu7yjVjDlRHFY/edit?usp=sharing) to make a copy of our RoJ integration plan!
22+
{% endhint %}
23+
24+
## Key integration steps for RoJ
25+
26+
Following these 4 steps in sequence will ensure that your integration is secure and runs smoothly for both you and your users.
27+
28+
### 1. Determine the conditions for submission and enforcement
29+
30+
A RoJ integration with Kleros implies that you have chosen to submit all or some of the disputes that may arise on your platform to Kleros Courts.
31+
32+
As with real-world courts, Kleros Court is only a dispute resolution system, and it is important to remember that our decentralized jury only takes care of the ruling on a dispute given certain facts/evidences and policy documents. **Enforcement of the ruling is out of scope for Kleros (in this type of integration), and needs to be carefully taken care of by your service/platform/dApp.** 
33+
34+
* **Submission criteria**: determining the circumstances under which disputes may be submitted to Kleros court.
35+
* Example: escalation is only allowed after a first round of dispute resolution has taken place within your platform, and the disputed amount does not exceed a certain value.
36+
* **Enforcement criteria**: what criteria need to be fulfilled for your platform/service to commit to enforcing a ruling from Kleros
37+
* Example: The partner (exchange, fintech company, etc.) makes a pledge to their customers to abide by the Kleros ruling. \
38+
And the user retains the right to pursue traditional legal actions if they are not satisfied with the decision made by Kleros.
39+
40+
### 2. Write a good 'Dispute Policy'
41+
42+
The dispute policy is a document that serves as the primary "law" for jurors, providing them with rules on resolving disputes. It operates similarly to legal statutes or laws in real-world cases, tailored specifically to your integration. Jurors base their decisions on three key sources:
43+
44+
* The dispute policy itself
45+
* The evidence presented by the parties
46+
* The policies of the Kleros courts.
47+
48+
Writing a good dispute policy is essential for ensuring fair and expeditious dispute resolution. 
49+
50+
{% hint style="info" %}
51+
You can find our Policy Writing Questionnaire in our "[RoJ Integration Plan](https://docs.google.com/document/d/1dn27idjPIfRInrPUmdvL2nYN0BQ6HRIu7yjVjDlRHFY/edit?usp=sharing)" (mentioned above). Based on your feedback, the Kleros team will provide a first draft, subject to an iterative and collaborative process to create the best dispute policy possible.
52+
{% endhint %}
53+
54+
### 3. Communicate all the above to your users
55+
56+
Once all the above are done, it is time to communicate the involvement of Kleros in the dispute resolution processes of your platform. This is essential for the smooth operations of your dispute resolution process and reduces any potential confusion when disputes eventually arise. This includes but is not limited to:
57+
58+
1. Ensuring that the dispute policy is publicly available and pinned using an immutable file storage system (e.g. [IPFS](https://ipfs.io/))
59+
2. Publishing and communicating the **escalation** and **enforcement** criteria.
60+
61+
{% hint style="info" %}
62+
Please reach out to us at marcos@kleros.io once you are done and we will advice you on the right court to use.
63+
{% endhint %}
64+
65+
Once all the above are done, you are ready to go live with Kleros! 
66+
67+
_For more information about this type of integrations with Kleros, you can visit our_ [_page on Notion: Web 2.0 companies._](https://www.notion.so/kleros/Web-2-0-companies-635bc6949764444dadf6f2ae94d307b9?pvs=4)
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
description: Ready-made integrations for various use cases
3+
---
4+
5+
# Channel partners
6+
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
description: When you want your app to get data from a subjective oracle
3+
---
4+
5+
# How to use Reality.eth + Kleros as an oracle
6+
7+
In use cases where a subjective oracle is required to give an answer on-chain about the occurrence of an event (e.g.: Prediction Markets, DAO Governance, etc...), your application might want to use the combination of [Reality.eth](https://reality.eth.link/) bond escalation mechanism with Kleros arbitration services to have a decentralized and fair source of truth.
8+
9+
[Learn more about this use case](https://kleros.gitbook.io/docs/products/oracle)
10+
11+
### Architecture
12+
13+
![High-level architecture overview of an app using Reality.eth + Kleros as an oracle](../../../../.gitbook/assets/untitled-diagram-2-.png)
14+
15+
* **Your app requiring a subjective oracle**
16+
17+
This is your smart contract that will only interact directly with Reality.eth contract.
18+
* **Reality.eth**
19+
20+
Bond escalation mechanism contract where anyone can submit a question with a required minimum bond to submit answers. It is possible to request arbitration by a 3rd party at any point after a first answer is submitted.
21+
22+
[Documentation](https://reality.eth.link/app/docs/html) - [Github](https://github.com/realitio/realitio-contracts/tree/master/truffle/contracts)
23+
* **Reality.eth < > Kleros Arbitrator proxy**
24+
25+
Contract acting as a proxy between Reality.eth and Kleros Court contract. It acts as a Reality.eth arbitrator by creating corresponding disputes in Kleros Courts and submitting the final ruling as an answer in the proper format. This contract is configured with a number of initial votes required and a specific sub-court where the dispute will be raised (ex: 5 initial votes by jurors in Blockchain > Technical court). You can use one already used by other apps or ask the cooperative Kleros team to deploy a new one fit for your needs.
26+
27+
[Github](https://github.com/kleros/realitio-arbitrator-with-appeals)
28+
* **Kleros**
29+
30+
[Kleros Court](https://kleros.gitbook.io/docs/products/court) contract that will adjudicate on the dispute by drawing jurors and publishing a final ruling about the case.
31+
32+
### Requirements
33+
34+
To use this service, you just need to ensure that:
35+
36+
* your smart contract is compatible with the Reality.eth contract interface (check their [documentation](https://reality.eth.link/app/docs/html/contracts.html) and [repo](https://github.com/realitio/realitio-contracts/tree/master/truffle/contracts))
37+
* If your contract is in development, Cooperative Kleros team can support you in making it compatible.
38+
* If your contract is already live, Cooperative Kleros team can support you in building a connector for it.
39+
* you submit the address of the Reality.eth<>Kleros arbitrator proxy you want to use as `arbitrator`when you ask a question. The arbitrator proxy will be set up with an initaial number of votes to be requested and a specific subcourt in whichcases will be raised. The Cooperative Kleros team can help select the right arbitrator for your use case or deploy a new one for you.
40+
41+
```typescript
42+
function askQuestion ( uint256 template_id, string question, address arbitrator, uint32 timeout, uint32 opening_ts, uint256 nonce ) external payable returns ( bytes32 );
43+
```
44+
45+
{% hint style="info" %}
46+
**Reality.eth <> Kleros Arbitrator Proxy deployments**
47+
48+
* (Current version) Mainnet: General Court - 0x728cba71a3723caab33ea416cb46e2cc9215a596
49+
* (Current version) Mainnet: Technical Court - 0xf72cfd1b34a91a64f9a98537fe63fbab7530adca
50+
* (Current version) Polygon: General Court - \
51+
0x5afa42b30955f137e10f89dfb5ef1542a186f90e
52+
* (Current version) Mumbai: General Court - \
53+
0xead0c9a4baeaf9b5221358539173602fa12b4b7d
54+
* (Current version) Kovan: Non-technical Court - 0xDEd12537dA82C1019b3CA1714A5d58B7c5c19A04
55+
56+
**Deprecated**
57+
58+
* (Old version without appeals) [Mainnet](https://etherscan.io/address/0xd47f72a2d1d0E91b0Ec5e5f5d02B2dc26d00A14D)
59+
* 500 votes in general Court
60+
* (Old version without appeals) [Kovan](https://kovan.etherscan.io/address/0xa6ead513d05347138184324392d8ceb24c116118)
61+
{% endhint %}
62+
63+
### Sequence Diagram
64+
65+
![](../../../../.gitbook/assets/kleros-reality.png)

0 commit comments

Comments
 (0)