feat: interfaces for the arbitrator, arbitrables and evidence v2

Author: jaybuidl

contracts/src/arbitration/IArbitrableV2.sol

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8;
+
+import "./IArbitratorV2.sol";
+
+/**
+ * @title IArbitrableV2
+ * Arbitrable interface.
+ * When developing arbitrable contracts, we need to:
+ * - Define the action taken when a ruling is received by the contract.
+ * - Allow dispute creation. For this a function must call arbitrator.createDispute{value: _fee}(_choices,_extraData);
+ */
+interface IArbitrableV2 {
+    /**
+     * @dev To be emitted when a dispute is created to link the correct meta-evidence to the disputeID.
+     * @param _arbitrator The arbitrator of the contract.
+     * @param _disputeID ID of the dispute in the Arbitrator contract.
+     * @param _externalDisputeID Unique identifier from the dispute creator that is linked to this dispute.
+     * @param _disputeContextUri IPFS path to dispute context, example: '/ipfs/Qmarwkf7C9RuzDEJNnarT3WZ7kem5bk8DZAzx78acJjMFH/disputecontext.json'
+     */
+    event Dispute(
+        IArbitrableV2 indexed _arbitrator,
+        uint256 indexed _disputeID,
+        uint256 _externalDisputeID,
+        string _disputeContextUri
+    );
+
+    /**
+     * @dev To be raised when a ruling is given.
+     * @param _arbitrator The arbitrator giving the ruling.
+     * @param _disputeID ID of the dispute in the Arbitrator contract.
+     * @param _ruling The ruling which was given.
+     */
+    event Ruling(IArbitratorV2 indexed _arbitrator, uint256 indexed _disputeID, uint256 _ruling);
+
+    /**
+     * @dev Give a ruling for a dispute. Must be called by the arbitrator.
+     * The purpose of this function is to ensure that the address calling it has the right to rule on the contract.
+     * @param _disputeID ID of the dispute in the Arbitrator contract.
+     * @param _ruling Ruling given by the arbitrator. Note that 0 is reserved for "Not able/wanting to make a decision".
+     */
+    function rule(uint256 _disputeID, uint256 _ruling) external;
+}

contracts/src/arbitration/IArbitratorV2.sol

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8;
+
+import "./IArbitrableV2.sol";
+
+/**
+ * @title Arbitrator
+ * Arbitrator interface that implements the new arbitration standard.
+ * Unlike the ERC-792 this standard doesn't have anything related to appeals, so each arbitrator can implement an appeal system that suits it the most.
+ * When developing arbitrator contracts we need to:
+ * - Define the functions for dispute creation (createDispute). Don't forget to store the arbitrated contract and the disputeID (which should be unique, may nbDisputes).
+ * - Define the functions for cost display (arbitrationCost).
+ * - Allow giving rulings. For this a function must call arbitrable.rule(disputeID, ruling).
+ */
+interface IArbitratorV2 {
+    /**
+     * @dev To be emitted when a dispute is created.
+     * @param _disputeID Identifier of the dispute.
+     * @param _arbitrable The contract which created the dispute.
+     */
+    event DisputeCreation(uint256 indexed _disputeID, IArbitrableV2 indexed _arbitrable);
+
+    /**
+     * @dev To be raised when a ruling is given.
+     * @param _arbitrable The arbitrable receiving the ruling.
+     * @param _disputeID Identifier of the dispute in the Arbitrator contract.
+     * @param _ruling The ruling which was given.
+     */
+    event Ruling(IArbitrableV2 indexed _arbitrable, uint256 indexed _disputeID, uint256 _ruling);
+
+    /**
+     * @dev Create a dispute. Must be called by the arbitrable contract.
+     * Must pay at least arbitrationCost(_extraData).
+     * @param _choices Amount of choices the arbitrator can make in this dispute.
+     * @param _extraData Can be used to give additional info on the dispute to be created.
+     * @return disputeID Identifier of the dispute created.
+     */
+    function createDispute(uint256 _choices, bytes calldata _extraData) external payable returns (uint256 disputeID);
+
+    /**
+     * @dev Compute the cost of arbitration. It is recommended not to increase it often, as it can be highly time and gas consuming for the arbitrated contracts to cope with fee augmentation.
+     * @param _extraData Can be used to give additional info on the dispute to be created.
+     * @return cost Required cost of arbitration.
+     */
+    function arbitrationCost(bytes calldata _extraData) external view returns (uint256 cost);
+
+    /**
+     *  @dev Return the current ruling of a dispute. This is useful for parties to know if they should appeal.
+     *  @param _disputeID ID of the dispute.
+     *  @return ruling The ruling which has been given or the one which will be given if there is no appeal.
+     */
+    function currentRuling(uint _disputeID) external view returns (uint ruling);
+}

contracts/src/evidence/IEvidenceV2.sol

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+import "../arbitration/IArbitratorV2.sol";
+
+/** @title IEvidence
+ *  ERC-1497: Evidence Standard
+ */
+interface IEvidenceV2 {
+    /**
+     * @dev To be raised when evidence is submitted. Should point to the resource (evidences are not to be stored on chain due to gas considerations).
+     * @param _arbitrator The arbitrator of the contract.
+     * @param _externalDisputeID Unique identifier from the dispute creator that is linked to this dispute.
+     * @param _party The address of the party submiting the evidence. Note that 0x0 refers to evidence not submitted by any party.
+     * @param _evidenceUri IPFS path to evidence, example: '/ipfs/Qmarwkf7C9RuzDEJNnarT3WZ7kem5bk8DZAzx78acJjMFH/evidence.json'
+     */
+    event Evidence(
+        IArbitratorV2 indexed _arbitrator,
+        uint256 indexed _externalDisputeID,
+        address indexed _party,
+        string _evidenceUri
+    );
+}