ERC7579ModuleConfigLib

Git Source

Title: ERC7579ModuleConfigLib

Authors: David Dada <daveproxy80@gmail.com> (https://github.com/dadadave80), Modified from ERC-7579 reference implementation (https://github.com/erc7579/erc7579-implementation)

Logic + ERC-7201 storage for the ERC-7579 module registry, consuming all four module types: EXECUTOR (2 — drives batches via executeFromExecutor), VALIDATOR (1 — authorizes user ops in ERC4337Validation), HOOK (4 — the single global hook wrapping execution), and FALLBACK (3 — per-selector handlers dispatched by AccountDiamond on a facet-map miss).

Constants

_ACCOUNT_ID

string private constant _ACCOUNT_ID = "lattice.diamond-account.0.1.0";

Functions

erc7579ModuleConfigStorage

function erc7579ModuleConfigStorage() internal pure returns (ERC7579ModuleConfigStorage storage $);

Returns

__ERC7579ModuleConfig_init

Registers the three ERC-7579 interface ids the Diamond supports.

function __ERC7579ModuleConfig_init() internal;

registerInterfaces

function registerInterfaces() internal;

accountId

function accountId() internal pure returns (string memory);

Returns

supportsModule

function supportsModule(uint256 moduleTypeId) internal pure returns (bool);

Parameters

Returns

hook

The installed global hook (type 4), or address(0) if none.

function hook() internal view returns (address);

Returns

fallbackHandlerFor

The fallback handler (type 3) for selector, or a zero-address handler if none. Read by AccountDiamond on a facet-map miss.

function fallbackHandlerFor(bytes4 selector) internal view returns (address handler, bytes1 callType);

Parameters

Returns

isModuleInstalled

function isModuleInstalled(uint256 moduleTypeId, address module, bytes calldata additionalContext)
        internal
        view
        returns (bool);

Parameters

Returns

isInstalled

Whether module is installed as moduleTypeId — the context-free form for internal consumers (e.g. the validation facet's per-op validator lookup).

function isInstalled(uint256 moduleTypeId, address module) internal view returns (bool);

Parameters

Returns

installModule

Installs module as moduleTypeId. Caller must be the account itself or an admin; the module must report the type via isModuleType. Calls module.onInstall(initData).

function installModule(uint256 moduleTypeId, address module, bytes calldata initData) internal;

Parameters

uninstallModule

Uninstalls module. Caller must be the account itself or an admin. Calls onUninstall.

function uninstallModule(uint256 moduleTypeId, address module, bytes calldata deInitData) internal;

Parameters

executeFromExecutor

Runs a batch on behalf of msg.sender, which must be an installed executor module (type 2). Wrapped by the global hook (if any), like the owner/session-key execute path.

function executeFromExecutor(bytes32 mode, bytes calldata executionCalldata)
        internal
        returns (bytes[] memory results);

Parameters

Returns

preExecutionHook

Runs the global hook's preCheck (if installed) before an execution, returning the hook and its opaque context for the matching postExecutionHook. A reverting hook blocks the execution.

function preExecutionHook(bytes calldata msgData) internal returns (address h, bytes memory hookData);

Parameters

Returns

postExecutionHook

Runs the global hook's postCheck (if h is non-zero) after an execution.

function postExecutionHook(address h, bytes memory hookData) internal;

Parameters

_authorizeConfig

function _authorizeConfig() private view;