{"id":23107820,"url":"https://github.com/kleros/cross-chain-arbitration-proxy","last_synced_at":"2026-04-29T10:33:44.716Z","repository":{"id":56654769,"uuid":"301510927","full_name":"kleros/cross-chain-arbitration-proxy","owner":"kleros","description":"Smart contract infrastructure to allow arbitrable dapps on other chains to use Kleros on Ethereum as arbitrator.","archived":false,"fork":false,"pushed_at":"2021-01-07T21:01:32.000Z","size":685,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-08T12:02:52.354Z","etag":null,"topics":["arbitrable","cross-chain-applications","ethereum","ethereum-contract","kleros","smart-contracts","xdai"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kleros.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-05T18:59:32.000Z","updated_at":"2022-06-30T16:19:56.000Z","dependencies_parsed_at":"2022-08-15T22:40:43.916Z","dependency_job_id":null,"html_url":"https://github.com/kleros/cross-chain-arbitration-proxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kleros/cross-chain-arbitration-proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleros%2Fcross-chain-arbitration-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleros%2Fcross-chain-arbitration-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleros%2Fcross-chain-arbitration-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleros%2Fcross-chain-arbitration-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kleros","download_url":"https://codeload.github.com/kleros/cross-chain-arbitration-proxy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleros%2Fcross-chain-arbitration-proxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32421901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arbitrable","cross-chain-applications","ethereum","ethereum-contract","kleros","smart-contracts","xdai"],"created_at":"2024-12-17T01:16:14.210Z","updated_at":"2026-04-29T10:33:44.702Z","avatar_url":"https://github.com/kleros.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kleros Cross-Chain Arbitration for xDAI\n\nSmart contract infrastructure to allow arbitrable dapps on xDAI to use Kleros on Ethereum as arbitrator.\n\n## Architectural Overview\n\n```\n\n                                              +----------------+\n                       +---------------------\u003e+  Cross  Chain  |\n                       v                      |   Arbitrable   |\n            +----------+----------+           +----------------+\n            |   Home Arbitration  |\n            |        Proxy        |\n            +----------+----------+\n                       ^\n  xDAI                 |\n+----------------------|---------------------------------------------+\n                       v\n           +-----------+-------------------------------+\n           |  xDAI/Ethereum AMB    +----------------+  |\n           |                       |     Oracle     |  |\n           |                       +----------------+  |\n           |  +----------------+   +----------------+  |\n           |  |     Oracle     |   |     Oracle     |  |\n           |  +----------------+   +----------------+  |\n           +-----------+-------------------------------+\n                       ^\n+----------------------|---------------------------------------------+\n  Ethereum             |\n                       v\n            +----------+----------+\n            | Foreign Arbitration |\n            |        Proxy        |\n            +----------+----------+\n                       ^                      +------------+\n                       +---------------------\u003e+   Kleros   |\n                                              +------------+\n```\n\n## Glossary\n\n-   **Home Proxy**: proxy on xDAI/Sokol.\n-   **Foreign Proxy**: proxy on Ethereum Mainnet/Goerli.\n-   **Plaintiff**: the dispute requester, interested in changing the current arbitrable outcome.\n-   **Defendant**: the user interested in keeping the current arbitrable outcome.\n\n## Disclaimers\n\n-   Users willing to request a dispute **SHOULD** watch the arbitrable contract on the Home Network to know when requesting dispute is possible.\n-   However, if there is a time limit for when the dispute can be requested, the Arbitration Proxies **CANNOT** guarantee the dispute request will be notified in time. This is due to the asynchronous nature of cross-chain communication.\n-   Once the dispute is created, its lifecycle will happen entirely on Ethereum.\n\n## High-Level Algorithm\n\n### Handshaking\n\n1. Arbitrable contracts **MUST** register themselves in the _Home Proxy_ before any dispute can be created.\n    1. Contracts **CAN** register the dispute params (namely `metaEvidence`, and `arbitratorExtraData`) at a contract level or on a per-item basis or a mix of both.\n1. The _Home Proxy_ **MUST** forward the params to the _Foreign Proxy_.\n\nAt this point users **CAN** request a dispute for that given arbitrable item.\n\n### Dispute Request\n\n1. In order to request a dispute, the _plaintiff_ **MUST** pay for the current arbitration cost beforehand.\n1. The dispute request **MUST** be relayed to the _Home Proxy_.\n1. The _Home Proxy_ **MUST** check if the _Arbitrable_ contract accepts the dispute.\n    1. The arbitrable contract **CAN** accept or reject the request according to its own rules.\n    1. If the dispute request is accepted, the information **MUST** be relayed to the _foreign proxy_, which will proceed to create the dispute.\n        1. The _home proxy_ **MUST** inform the arbitrable contract of the dispute request.\n        1. The _foreign proxy_ **MUST** now wait for the _defendant_ to pay for the arbitration cost up to `feeDepositTimeout` seconds.\n            1. If the _defendant_ pays the due amount in time, then the dispute **SHOULD** be created.\n                1. If the dispute could be created\n                    1. Then the _foreign proxy_ **MUST** relay that information to the _home proxy_.\n                    1. Once the final ruling is recived, it **MUST** be relayed to the _home proxy_.\n                        1. The _home proxy_ **MUST** rule over the arbitrable item.\n                1. Otherwise, if the dispute creation fails\n                    1. Then the _foreign proxy_ **MUST** relay that information to the _home proxy_.\n                        1. The _home proxy_ **MUST** inform the arbitrable contract that the dispute could not be created.\n            1. Otherwise, the _plaintiff_ **MUST** be considered the winner\n                1. The _foreign proxy_ **MUST** forward the ruling to the _home proxy_.\n                1. The _home proxy_ **MUST** rule over the arbitrable item.\n    1. Otherwise, the rejection **MUST** also be relayed to the _foreign proxy_.\n        1. The _plaintiff_ **MUST** be reimbursed of any deposited fees.\n        1. The arbitration request process **CAN** be restarted.\n\n## State Charts\n\n### Home Proxy\n\n```\n(I) Means the initial state.\n[condition] Means a guard condition.\n\n     Receive Request     +----------+\n   +--------------------\u003e+ Rejected |\n   |   [Rejected]        +-----+----+\n   |                           |\n   |                           |\n   |                           | Relay Rejected\n+-(I)--+                       |\n| None +\u003c----------------------+\n+--+---+                       |\n   |                           |\n   |                           | Receive Dispute Failed\n   |                           |\n   | Receive Request     +-----+----+                     +--(F)--+\n   +--------------------\u003e+ Accepted +--------------------\u003e+ Ruled |\n      [Accepted]         +----------+   Receive Ruling    +-------+\n```\n\n### Foreign Proxy\n\n```\n(I) Means the initial state.\n(F) Means a final state.\n[condition] Means a guard condition.\n\n                                                                               [Defendant did not pay]\n                                                                                      |\n+-(I)--+   Request Dispute   +-----------+                  +----------------+        |        +--(F)--+\n| None +--------------------\u003e+ Requested +-----------------\u003e+ DepositPending +----------------\u003e+ Ruled |\n+------+    [Registered]     +-----+-----+    [Accepted]    +-------+--------+                 +---+---+\n    A                              |                                |                              ^\n    |                              |                                |                              |\n    |                              | [Rejected]                     | [Defendant Paid]             |\n    |                              |                                |                              | Rule\n    |                              |                                |                              |\n    |                              |                                |          +---------+         |\n    +------------------------------+--------------------------------+---------\u003e+ Ongoing +---------+\n                                                              |           |    +---------+\n                                                              |           |\n                                           [Create Dispute Failed]      [Create Dispute Created]\n```\n\n## Available Proxies\n\n### Binary Arbitration\n\nUsed by arbitrable contracts which expect a binary ruling for dispute.\n\n#### Deployed Addresses\n\n**Home Proxy:**\n\n-   Sokol: `\u003cnone\u003e`\n-   xDai: `\u003cnone\u003e`\n\n**Foreign Proxy:**\n\n-   Goerli: `\u003cnone\u003e`\n-   Mainnet: `\u003cnone\u003e`\n\n## Contributing\n\n### Install Dependencies\n\n```bash\nyarn install\n```\n\n### Run Tests\n\n```bash\nyarn test\n```\n\n### Compile the Contracts\n\n```bash\nyarn build\n```\n\n### Run Linter on Files\n\n```bash\nyarn lint\n```\n\n### Fix Linter Issues on Files\n\n```bash\nyarn fix\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleros%2Fcross-chain-arbitration-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkleros%2Fcross-chain-arbitration-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleros%2Fcross-chain-arbitration-proxy/lists"}