@enclave-e3/contracts 0.1.3 → 0.1.5

package/artifacts/build-info/{solc-0_8_27-9aea5e3f6e25811e781e96c22e8edaf1eb1a01c5.json → solc-0_8_27-97c5c59c2349d6c07bd9b7583fed40a5ace84d56.json}

@@ -1,6 +1,6 @@
 {
   "_format": "hh3-sol-build-info-1",
-  "id": "solc-0_8_27-9aea5e3f6e25811e781e96c22e8edaf1eb1a01c5",
+  "id": "solc-0_8_27-97c5c59c2349d6c07bd9b7583fed40a5ace84d56",
   "solcVersion": "0.8.27",
   "solcLongVersion": "0.8.27+commit.40a35a09",
   "userSourceNameMap": {
@@ -93,7 +93,7 @@
         "content": "// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\npragma solidity >=0.8.27;\n\nimport { IInputValidator } from \"./IInputValidator.sol\";\n\ninterface IE3Program {\n    /// @notice This function should be called by the Enclave contract to validate the computation parameters.\n    /// @param e3Id ID of the E3.\n    /// @param seed Seed for the computation.\n    /// @param e3ProgramParams ABI encoded computation parameters.\n    /// @param computeProviderParams ABI encoded compute provider parameters.\n    /// @return encryptionSchemeId ID of the encryption scheme to be used for the computation.\n    /// @return inputValidator The input validator to be used for the computation.\n    function validate(\n        uint256 e3Id,\n        uint256 seed,\n        bytes calldata e3ProgramParams,\n        bytes calldata computeProviderParams\n    )\n        external\n        returns (bytes32 encryptionSchemeId, IInputValidator inputValidator);\n\n    /// @notice This function should be called by the Enclave contract to verify the decrypted output of an E3.\n    /// @param e3Id ID of the E3.\n    /// @param ciphertextOutputHash The keccak256 hash of output data to be verified.\n    /// @param proof ABI encoded data to verify the ciphertextOutputHash.\n    /// @return success Whether the output data is valid.\n    function verify(\n        uint256 e3Id,\n        bytes32 ciphertextOutputHash,\n        bytes memory proof\n    ) external returns (bool success);\n}\n"
       },
       "project/contracts/interfaces/IEnclave.sol": {
-        "content": "// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\npragma solidity >=0.8.27;\n\nimport { E3, IE3Program } from \"./IE3.sol\";\n\ninterface IEnclave {\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                         Events                         //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This event MUST be emitted when an Encrypted Execution Environment (E3) is successfully requested.\n    /// @param e3Id ID of the E3.\n    /// @param e3 Details of the E3.\n    /// @param filter Address of the pool of nodes from which the Cipher Node committee was selected.\n    /// @param e3Program Address of the Computation module selected.\n    event E3Requested(\n        uint256 e3Id,\n        E3 e3,\n        address filter,\n        IE3Program indexed e3Program\n    );\n\n    /// @notice This event MUST be emitted when an Encrypted Execution Environment (E3) is successfully activated.\n    /// @param e3Id ID of the E3.\n    /// @param expiration Timestamp when committee duties expire.\n    /// @param committeePublicKey Public key of the committee.\n    event E3Activated(\n        uint256 e3Id,\n        uint256 expiration,\n        bytes committeePublicKey\n    );\n\n    /// @notice This event MUST be emitted when an input to an Encrypted Execution Environment (E3) is\n    /// successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param data ABI encoded input data.\n    event InputPublished(\n        uint256 indexed e3Id,\n        bytes data,\n        uint256 inputHash,\n        uint256 index\n    );\n\n    /// @notice This event MUST be emitted when the plaintext output of an Encrypted Execution Environment (E3)\n    /// is successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param plaintextOutput ABI encoded plaintext output.\n    event PlaintextOutputPublished(uint256 indexed e3Id, bytes plaintextOutput);\n\n    /// @notice This event MUST be emitted when the ciphertext output of an Encrypted Execution Environment (E3)\n    /// is successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param ciphertextOutput ABI encoded ciphertext output.\n    event CiphertextOutputPublished(\n        uint256 indexed e3Id,\n        bytes ciphertextOutput\n    );\n\n    /// @notice This event MUST be emitted any time the `maxDuration` is set.\n    /// @param maxDuration The maximum duration of a computation in seconds.\n    event MaxDurationSet(uint256 maxDuration);\n\n    /// @notice This event MUST be emitted any time the CiphernodeRegistry is set.\n    /// @param ciphernodeRegistry The address of the CiphernodeRegistry contract.\n    event CiphernodeRegistrySet(address ciphernodeRegistry);\n\n    /// @notice The event MUST be emitted any time an encryption scheme is enabled.\n    /// @param encryptionSchemeId The ID of the encryption scheme that was enabled.\n    event EncryptionSchemeEnabled(bytes32 encryptionSchemeId);\n\n    /// @notice This event MUST be emitted any time an encryption scheme is disabled.\n    /// @param encryptionSchemeId The ID of the encryption scheme that was disabled.\n    event EncryptionSchemeDisabled(bytes32 encryptionSchemeId);\n\n    /// @notice This event MUST be emitted any time a E3 Program is enabled.\n    /// @param e3Program The address of the E3 Program.\n    event E3ProgramEnabled(IE3Program e3Program);\n\n    /// @notice This event MUST be emitted any time a E3 Program is disabled.\n    /// @param e3Program The address of the E3 Program.\n    event E3ProgramDisabled(IE3Program e3Program);\n\n    /// @notice Emitted when the allowed E3 encryption scheme parameters are configured.\n    /// @param e3ProgramParams Array of encoded encryption scheme parameters (e.g, for BFV)\n    event AllowedE3ProgramsParamsSet(bytes[] e3ProgramParams);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                  Structs                               //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This struct contains the parameters to submit a request to Enclave.\n    /// @param filter The address of the pool of nodes from which to select the committee.\n    /// @param threshold The M/N threshold for the committee.\n    /// @param startWindow The start window for the computation.\n    /// @param duration The duration of the computation in seconds.\n    /// @param e3Program The address of the E3 Program.\n    /// @param e3ProgramParams The ABI encoded computation parameters.\n    struct E3RequestParams {\n        address filter;\n        uint32[2] threshold;\n        uint256[2] startWindow;\n        uint256 duration;\n        IE3Program e3Program;\n        bytes e3ProgramParams;\n        bytes computeProviderParams;\n    }\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                  Core Entrypoints                      //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to request a computation within an Encrypted Execution Environment (E3).\n    /// @dev This function MUST emit the E3Requested event.\n    /// @param requestParams The parameters for the E3 request.\n    /// @return e3Id ID of the E3.\n    /// @return e3 The E3 struct.\n    function request(\n        E3RequestParams memory requestParams\n    ) external payable returns (uint256 e3Id, E3 memory e3);\n\n    /// @notice This function should be called to activate an Encrypted Execution Environment (E3) once it has been\n    /// initialized and is ready for input.\n    /// @dev This function MUST emit the E3Activated event.\n    /// @dev This function MUST revert if the given E3 has not yet been requested.\n    /// @dev This function MUST revert if the selected node committee has not yet published a public key.\n    /// @param e3Id ID of the E3.\n    /// @param publicKey Public key of the committee.\n    /// @return success True if the E3 was successfully activated.\n    function activate(\n        uint256 e3Id,\n        bytes memory publicKey\n    ) external returns (bool success);\n\n    /// @notice This function should be called to publish input data for Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the E3 is not yet activated.\n    /// @dev This function MUST emit the InputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param data ABI encoded input data to publish.\n    /// @return success True if the input was successfully published.\n    function publishInput(\n        uint256 e3Id,\n        bytes calldata data\n    ) external returns (bool success);\n\n    /// @notice This function should be called to publish output data for an Encrypted Execution Environment (E3).\n    /// @dev This function MUST emit the CiphertextOutputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param ciphertextOutput ABI encoded output data to verify.\n    /// @param proof ABI encoded data to verify the ciphertextOutput.\n    /// @return success True if the output was successfully published.\n    function publishCiphertextOutput(\n        uint256 e3Id,\n        bytes memory ciphertextOutput,\n        bytes memory proof\n    ) external returns (bool success);\n\n    /// @notice This function publishes the plaintext output of an Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the output has not been published.\n    /// @dev This function MUST emit the PlaintextOutputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param plaintextOutput ABI encoded plaintext output.\n    /// @param proof ABI encoded data to verify the plaintextOutput.\n    function publishPlaintextOutput(\n        uint256 e3Id,\n        bytes memory plaintextOutput,\n        bytes memory proof\n    ) external returns (bool success);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                   Set Functions                        //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to set the maximum duration of requested computations.\n    /// @param _maxDuration The maximum duration of a computation in seconds.\n    /// @return success True if the max duration was successfully set.\n    function setMaxDuration(\n        uint256 _maxDuration\n    ) external returns (bool success);\n\n    /// @notice This function should be called to enable an E3 Program.\n    /// @param e3Program The address of the E3 Program.\n    /// @return success True if the E3 Program was successfully enabled.\n    function enableE3Program(\n        IE3Program e3Program\n    ) external returns (bool success);\n\n    /// @notice This function should be called to disable an E3 Program.\n    /// @param e3Program The address of the E3 Program.\n    /// @return success True if the E3 Program was successfully disabled.\n    function disableE3Program(\n        IE3Program e3Program\n    ) external returns (bool success);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                   Get Functions                        //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to retrieve the details of an Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the E3 does not exist.\n    /// @param e3Id ID of the E3.\n    /// @return e3 The struct representing the requested E3.\n    function getE3(uint256 e3Id) external view returns (E3 memory e3);\n\n    /// @notice This function returns root of the input merkle tree for a given E3.\n    /// @dev This function MUST revert if the E3 does not exist.\n    /// @param e3Id ID of the E3.\n    /// @return root The root of the input merkle tree.\n    function getInputRoot(uint256 e3Id) external view returns (uint256 root);\n}\n"
+        "content": "// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\npragma solidity >=0.8.27;\n\nimport { E3, IE3Program } from \"./IE3.sol\";\n\ninterface IEnclave {\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                         Events                         //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This event MUST be emitted when an Encrypted Execution Environment (E3) is successfully requested.\n    /// @param e3Id ID of the E3.\n    /// @param e3 Details of the E3.\n    /// @param filter Address of the pool of nodes from which the Cipher Node committee was selected.\n    /// @param e3Program Address of the Computation module selected.\n    event E3Requested(\n        uint256 e3Id,\n        E3 e3,\n        address filter,\n        IE3Program indexed e3Program\n    );\n\n    /// @notice This event MUST be emitted when an Encrypted Execution Environment (E3) is successfully activated.\n    /// @param e3Id ID of the E3.\n    /// @param expiration Timestamp when committee duties expire.\n    /// @param committeePublicKey Public key of the committee.\n    event E3Activated(\n        uint256 e3Id,\n        uint256 expiration,\n        bytes committeePublicKey\n    );\n\n    /// @notice This event MUST be emitted when an input to an Encrypted Execution Environment (E3) is\n    /// successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param data ABI encoded input data.\n    event InputPublished(\n        uint256 indexed e3Id,\n        bytes data,\n        uint256 inputHash,\n        uint256 index\n    );\n\n    /// @notice This event MUST be emitted when the plaintext output of an Encrypted Execution Environment (E3)\n    /// is successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param plaintextOutput ABI encoded plaintext output.\n    event PlaintextOutputPublished(uint256 indexed e3Id, bytes plaintextOutput);\n\n    /// @notice This event MUST be emitted when the ciphertext output of an Encrypted Execution Environment (E3)\n    /// is successfully published.\n    /// @param e3Id ID of the E3.\n    /// @param ciphertextOutput ABI encoded ciphertext output.\n    event CiphertextOutputPublished(\n        uint256 indexed e3Id,\n        bytes ciphertextOutput\n    );\n\n    /// @notice This event MUST be emitted any time the `maxDuration` is set.\n    /// @param maxDuration The maximum duration of a computation in seconds.\n    event MaxDurationSet(uint256 maxDuration);\n\n    /// @notice This event MUST be emitted any time the CiphernodeRegistry is set.\n    /// @param ciphernodeRegistry The address of the CiphernodeRegistry contract.\n    event CiphernodeRegistrySet(address ciphernodeRegistry);\n\n    /// @notice The event MUST be emitted any time an encryption scheme is enabled.\n    /// @param encryptionSchemeId The ID of the encryption scheme that was enabled.\n    event EncryptionSchemeEnabled(bytes32 encryptionSchemeId);\n\n    /// @notice This event MUST be emitted any time an encryption scheme is disabled.\n    /// @param encryptionSchemeId The ID of the encryption scheme that was disabled.\n    event EncryptionSchemeDisabled(bytes32 encryptionSchemeId);\n\n    /// @notice This event MUST be emitted any time a E3 Program is enabled.\n    /// @param e3Program The address of the E3 Program.\n    event E3ProgramEnabled(IE3Program e3Program);\n\n    /// @notice This event MUST be emitted any time a E3 Program is disabled.\n    /// @param e3Program The address of the E3 Program.\n    event E3ProgramDisabled(IE3Program e3Program);\n\n    /// @notice Emitted when the allowed E3 encryption scheme parameters are configured.\n    /// @param e3ProgramParams Array of encoded encryption scheme parameters (e.g, for BFV)\n    event AllowedE3ProgramsParamsSet(bytes[] e3ProgramParams);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                  Structs                               //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This struct contains the parameters to submit a request to Enclave.\n    /// @param filter The address of the pool of nodes from which to select the committee.\n    /// @param threshold The M/N threshold for the committee.\n    /// @param startWindow The start window for the computation.\n    /// @param duration The duration of the computation in seconds.\n    /// @param e3Program The address of the E3 Program.\n    /// @param e3ProgramParams The ABI encoded computation parameters.\n    struct E3RequestParams {\n        address filter;\n        uint32[2] threshold;\n        uint256[2] startWindow;\n        uint256 duration;\n        IE3Program e3Program;\n        bytes e3ProgramParams;\n        bytes computeProviderParams;\n    }\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                  Core Entrypoints                      //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to request a computation within an Encrypted Execution Environment (E3).\n    /// @dev This function MUST emit the E3Requested event.\n    /// @param requestParams The parameters for the E3 request.\n    /// @return e3Id ID of the E3.\n    /// @return e3 The E3 struct.\n    function request(\n        E3RequestParams memory requestParams\n    ) external payable returns (uint256 e3Id, E3 memory e3);\n\n    /// @notice This function should be called to activate an Encrypted Execution Environment (E3) once it has been\n    /// initialized and is ready for input.\n    /// @dev This function MUST emit the E3Activated event.\n    /// @dev This function MUST revert if the given E3 has not yet been requested.\n    /// @dev This function MUST revert if the selected node committee has not yet published a public key.\n    /// @param e3Id ID of the E3.\n    /// @param publicKey Public key of the committee.\n    /// @return success True if the E3 was successfully activated.\n    function activate(\n        uint256 e3Id,\n        bytes calldata publicKey\n    ) external returns (bool success);\n\n    /// @notice This function should be called to publish input data for Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the E3 is not yet activated.\n    /// @dev This function MUST emit the InputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param data ABI encoded input data to publish.\n    /// @return success True if the input was successfully published.\n    function publishInput(\n        uint256 e3Id,\n        bytes calldata data\n    ) external returns (bool success);\n\n    /// @notice This function should be called to publish output data for an Encrypted Execution Environment (E3).\n    /// @dev This function MUST emit the CiphertextOutputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param ciphertextOutput ABI encoded output data to verify.\n    /// @param proof ABI encoded data to verify the ciphertextOutput.\n    /// @return success True if the output was successfully published.\n    function publishCiphertextOutput(\n        uint256 e3Id,\n        bytes calldata ciphertextOutput,\n        bytes calldata proof\n    ) external returns (bool success);\n\n    /// @notice This function publishes the plaintext output of an Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the output has not been published.\n    /// @dev This function MUST emit the PlaintextOutputPublished event.\n    /// @param e3Id ID of the E3.\n    /// @param plaintextOutput ABI encoded plaintext output.\n    /// @param proof ABI encoded data to verify the plaintextOutput.\n    function publishPlaintextOutput(\n        uint256 e3Id,\n        bytes calldata plaintextOutput,\n        bytes calldata proof\n    ) external returns (bool success);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                   Set Functions                        //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to set the maximum duration of requested computations.\n    /// @param _maxDuration The maximum duration of a computation in seconds.\n    /// @return success True if the max duration was successfully set.\n    function setMaxDuration(\n        uint256 _maxDuration\n    ) external returns (bool success);\n\n    /// @notice This function should be called to enable an E3 Program.\n    /// @param e3Program The address of the E3 Program.\n    /// @return success True if the E3 Program was successfully enabled.\n    function enableE3Program(\n        IE3Program e3Program\n    ) external returns (bool success);\n\n    /// @notice This function should be called to disable an E3 Program.\n    /// @param e3Program The address of the E3 Program.\n    /// @return success True if the E3 Program was successfully disabled.\n    function disableE3Program(\n        IE3Program e3Program\n    ) external returns (bool success);\n\n    ////////////////////////////////////////////////////////////\n    //                                                        //\n    //                   Get Functions                        //\n    //                                                        //\n    ////////////////////////////////////////////////////////////\n\n    /// @notice This function should be called to retrieve the details of an Encrypted Execution Environment (E3).\n    /// @dev This function MUST revert if the E3 does not exist.\n    /// @param e3Id ID of the E3.\n    /// @return e3 The struct representing the requested E3.\n    function getE3(uint256 e3Id) external view returns (E3 memory e3);\n\n    /// @notice This function returns root of the input merkle tree for a given E3.\n    /// @dev This function MUST revert if the E3 does not exist.\n    /// @param e3Id ID of the E3.\n    /// @return root The root of the input merkle tree.\n    function getInputRoot(uint256 e3Id) external view returns (uint256 root);\n}\n"
       },
       "project/contracts/interfaces/IInputValidator.sol": {
         "content": "// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\npragma solidity >=0.8.27;\n\ninterface IInputValidator {\n    /// @notice This function should be called by the Enclave contract to validate the\n    /// input of a computation.\n    /// @param sender The account that is submitting the input.\n    /// @param data The input to be verified.\n    /// @return input The decoded, policy-approved application payload.\n    function validate(\n        address sender,\n        bytes memory data\n    ) external returns (bytes memory input);\n}\n"