Merge pull request #12 from flare-foundation/0.1.42

Update version to 0.1.42, add IMasterAccountController interface

Author: fassko

coston2/ContractRegistry.sol

@@ -43,6 +43,7 @@ import {IAssetManagerController} from "./IAssetManagerController.sol";
 import {IAssetManager} from "./IAssetManager.sol";
 import {IJsonApiVerification} from "./IJsonApiVerification.sol";
 import {IGenericRewardManager} from "./IGenericRewardManager.sol";
+import {IMasterAccountController} from "./IMasterAccountController.sol";
 // END AUTO GENERATED - DO NOT EDIT ABOVE THIS LINE
 
 // Library is intended to be used inline, so the strings are all memory allocated (instead of calldata)
@@ -525,5 +526,18 @@ library ContractRegistry {
             );
     }
 
+    function getMasterAccountController()
+        internal
+        view
+        returns (IMasterAccountController)
+    {
+        return
+            IMasterAccountController(
+                FLARE_CONTRACT_REGISTRY.getContractAddressByHash(
+                    keccak256(abi.encode("MasterAccountController"))
+                )
+            );
+    }
+
     // END AUTO GENERATED - DO NOT EDIT ABOVE THIS LINE
 }

flare/ContractRegistry.sol

@@ -42,6 +42,7 @@ import {IFdcRequestFeeConfigurations} from "./IFdcRequestFeeConfigurations.sol";
 import {IAssetManagerController} from "./IAssetManagerController.sol";
 import {IAssetManager} from "./IAssetManager.sol";
 import {IGenericRewardManager} from "./IGenericRewardManager.sol";
+import {IMasterAccountController} from "./IMasterAccountController.sol";
 // END AUTO GENERATED - DO NOT EDIT ABOVE THIS LINE
 
 // Library is intended to be used inline, so the strings are all memory allocated (instead of calldata)
@@ -516,5 +517,18 @@ library ContractRegistry {
             );
     }
 
+    function getMasterAccountController()
+        internal
+        view
+        returns (IMasterAccountController)
+    {
+        return
+            IMasterAccountController(
+                FLARE_CONTRACT_REGISTRY.getContractAddressByHash(
+                    keccak256(abi.encode("MasterAccountController"))
+                )
+            );
+    }
+
     // END AUTO GENERATED - DO NOT EDIT ABOVE THIS LINE
 }

flare/IAgentVaultsFacet.sol

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4 <0.9;
+
+/**
+ * @title IAgentVaultsFacet
+ * @notice Interface for the AgentVaultsFacet contract.
+ */
+interface IAgentVaultsFacet {
+    /**
+     * @notice Emitted when an agent vault is added.
+     * @param agentVaultId The agent vault ID.
+     * @param agentVaultAddress The agent vault address.
+     */
+    event AgentVaultAdded(
+        uint256 indexed agentVaultId,
+        address indexed agentVaultAddress
+    );
+
+    /**
+     * @notice Emitted when an agent vault is removed.
+     * @param agentVaultId The agent vault ID.
+     * @param agentVaultAddress The agent vault address.
+     */
+    event AgentVaultRemoved(
+        uint256 indexed agentVaultId,
+        address indexed agentVaultAddress
+    );
+
+    /**
+     * @notice Reverts if array lengths do not match.
+     */
+    error AgentsVaultsLengthsMismatch();
+
+    /**
+     * @notice Reverts if the agent vault ID is zero.
+     * @param index The index in the input array.
+     */
+    error AgentVaultIdZero(uint256 index);
+
+    /**
+     * @notice Reverts if the agent vault ID is already added.
+     * @param agentVaultId The agent vault ID.
+     */
+    error AgentVaultIdAlreadyAdded(uint256 agentVaultId);
+
+    /**
+     * @notice Reverts if the agent vault address is zero.
+     * @param index The index in the input array.
+     */
+    error AgentVaultAddressZero(uint256 index);
+
+    /**
+     * @notice Reverts if the agent vault address is already added.
+     * @param agentVaultAddress The agent vault address.
+     */
+    error AgentVaultAddressAlreadyAdded(address agentVaultAddress);
+
+    /**
+     * @notice Reverts if the agent vault is invalid.
+     * @param agentVaultId The agent vault ID.
+     */
+    error InvalidAgentVault(uint256 agentVaultId);
+
+    /**
+     * @notice Reverts if the agent is not available.
+     * @param agentVault The agent vault address.
+     */
+    error AgentNotAvailable(address agentVault);
+
+    /**
+     * Returns the list of registered agent vault IDs and their corresponding addresses.
+     * @return _agentVaultIds The list of registered agent vault IDs.
+     * @return _agentVaultAddresses The list of registered agent vault addresses.
+     */
+    function getAgentVaults()
+        external
+        view
+        returns (
+            uint256[] memory _agentVaultIds,
+            address[] memory _agentVaultAddresses
+        );
+}

flare/ICustomInstructionsFacet.sol

@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4 <0.9;
+
+/**
+ * @title ICustomInstructionsFacet
+ * @notice Interface for the CustomInstructionsFacet contract.
+ */
+interface ICustomInstructionsFacet {
+    /// @notice Struct containing custom call information
+    struct CustomCall {
+        /// @notice Target contract address
+        address targetContract;
+        /// @notice value (in wei) to send with the call
+        uint256 value;
+        /// @notice Call data
+        bytes data;
+    }
+
+    /**
+     * @notice Emitted when a custom instruction is registered.
+     * @param customInstructionHash The hash representing the registered instructions.
+     */
+    event CustomInstructionRegistered(bytes32 indexed customInstructionHash);
+
+    /**
+     * @notice Emitted when a custom instruction is already registered.
+     * @param customInstructionHash The hash representing the already registered instructions.
+     */
+    event CustomInstructionAlreadyRegistered(
+        bytes32 indexed customInstructionHash
+    );
+
+    /**
+     * @notice Reverts if the custom instruction is empty (zero custom calls).
+     */
+    error EmptyCustomInstruction();
+
+    /**
+     * @notice Reverts if the target address of a custom call is zero.
+     */
+    error TargetAddressZero();
+
+    /**
+     * @notice Reverts if the target address of a custom call is not a contract.
+     * @param target The target address.
+     */
+    error TargetNotAContract(address target);
+
+    /**
+     * @notice Register custom instruction and return the call hash.
+     * @param _customInstruction Custom instruction (array of custom calls) to register.
+     * @return _customInstructionHash The hash representing the registered custom instruction.
+     */
+    function registerCustomInstruction(
+        CustomCall[] memory _customInstruction
+    ) external returns (bytes32 _customInstructionHash);
+
+    /**
+     * @notice Get a custom instruction for a given call hash.
+     * @param _customInstructionHash The hash representing the custom instruction.
+     * @return _customInstruction Custom instruction (array of custom calls) for the hash.
+     */
+    function getCustomInstruction(
+        bytes32 _customInstructionHash
+    ) external view returns (CustomCall[] memory _customInstruction);
+    /**
+     * @notice Get paginated custom instruction hashes.
+     * @param _start The starting index.
+     * @param _end The ending index.
+     * @return _customInstructionHashes Array of custom instruction hashes for the requested page.
+     * @return _totalLength The total number of custom instruction hashes.
+     */
+    function getCustomInstructionHashes(
+        uint256 _start,
+        uint256 _end
+    )
+        external
+        view
+        returns (
+            bytes32[] memory _customInstructionHashes,
+            uint256 _totalLength
+        );
+
+    /**
+     * @notice Encode a custom instruction to get its call hash.
+     * @param _customInstruction Custom instruction (array of custom calls) to encode.
+     * @return _customInstructionHash The hash representing the custom instruction.
+     */
+    function encodeCustomInstruction(
+        CustomCall[] memory _customInstruction
+    ) external pure returns (bytes32 _customInstructionHash);
+}

flare/IExecutorsFacet.sol

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4 <0.9;
+
+/**
+ * @title IExecutorsFacet
+ * @notice Interface for the ExecutorsFacet contract.
+ */
+interface IExecutorsFacet {
+    /**
+     * @notice Emitted when the executor address is set.
+     * @param executor The new executor address.
+     */
+    event ExecutorSet(address executor);
+
+    /**
+     * @notice Emitted when the executor fee is set.
+     * @param executorFee The new executor fee.
+     */
+    event ExecutorFeeSet(uint256 executorFee);
+
+    /**
+     * @notice Reverts if the executor address is invalid.
+     */
+    error InvalidExecutor();
+
+    /**
+     * @notice Reverts if the executor fee is invalid.
+     */
+    error InvalidExecutorFee();
+
+    /**
+     * Returns the executor address and fee.
+     * @return _executor The executor address.
+     * @return _executorFee The executor fee (in wei).
+     */
+    function getExecutorInfo()
+        external
+        view
+        returns (address payable _executor, uint256 _executorFee);
+}

flare/IInstructionFeesFacet.sol

@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4 <0.9;
+
+/**
+ * @title IInstructionFeesFacet
+ * @notice Interface for the InstructionFeesFacet contract.
+ */
+interface IInstructionFeesFacet {
+    /**
+     * @notice Emitted when the default instruction fee is set.
+     * @param defaultInstructionFee The new default instruction fee.
+     */
+    event DefaultInstructionFeeSet(uint256 defaultInstructionFee);
+
+    /**
+     * @notice Emitted when an instruction-specific fee is set.
+     * @param instructionId The instruction ID.
+     * @param instructionFee The fee for the instruction.
+     */
+    event InstructionFeeSet(
+        uint256 indexed instructionId,
+        uint256 instructionFee
+    );
+
+    /**
+     * @notice Emitted when an instruction-specific fee is removed.
+     * @param instructionId The instruction ID.
+     */
+    event InstructionFeeRemoved(uint256 indexed instructionId);
+
+    /**
+     * @notice Reverts if array lengths do not match.
+     */
+    error InstructionFeesLengthsMismatch();
+
+    /**
+     * @notice Reverts if the instruction fee is invalid.
+     * @param instructionId The instruction ID.
+     */
+    error InvalidInstructionFee(uint256 instructionId);
+
+    /**
+     * @notice Reverts if the instruction fee is not set.
+     * @param instructionId The instruction ID.
+     */
+    error InstructionFeeNotSet(uint256 instructionId);
+
+    /**
+     * @notice Returns the default instruction fee.
+     * @return The default instruction fee in underlying asset's smallest unit (e.g., drops for XRP).
+     */
+    function getDefaultInstructionFee() external view returns (uint256);
+
+    /**
+     * @notice Returns the instruction fee for a given instruction ID.
+     * @param _instructionId The ID of the instruction.
+     * @return The instruction fee in underlying asset's smallest unit (e.g., drops for XRP).
+     */
+    function getInstructionFee(
+        uint256 _instructionId
+    ) external view returns (uint256);
+}