Initial commit

contracts/interfaces/IPolicyModule.sol

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+/**
+ * @title IPolicyModule
+ * @notice Interface for policy modules
+ * @dev Policy modules enforce governance rules and risk limits
+ */
+interface IPolicyModule {
+    /**
+     * @notice Policy decision result
+     * @param allowed Whether the action is allowed
+     * @param reason Reason for denial (if not allowed)
+     */
+    struct PolicyDecision {
+        bool allowed;
+        string reason;
+    }
+
+    /**
+     * @notice Evaluate policy for a proposed action
+     * @param actionType Type of action (encoded as bytes32)
+     * @param actionData Action-specific data
+     * @return decision Policy decision
+     */
+    function evaluate(
+        bytes32 actionType,
+        bytes memory actionData
+    ) external view returns (PolicyDecision memory decision);
+
+    /**
+     * @notice Get policy module name
+     * @return name Module name
+     */
+    function name() external pure returns (string memory name);
+
+    /**
+     * @notice Check if module is enabled
+     * @return enabled True if enabled
+     */
+    function isEnabled() external view returns (bool enabled);
+
+    /**
+     * @notice Enable or disable the module
+     * @param enabled New enabled status
+     */
+    function setEnabled(bool enabled) external;
+}
+