[ETHEREUM-CONTRACTS] ClearMacro forwarder (+ Permit2 variant)

[d10r]

Summary

Introduces a ClearMacro Forwarder that runs macros via EIP-712 signed payloads (action + security). Includes an optional Permit2 variant for flows where the user also transfers/upgrades tokens in the same signature.

ClearMacro Forwarder

• Contract: ClearMacroForwarder — executes macros on behalf of a signer. Payload: macro-specific action (opaque; macro defines EIP-712 type/struct hash) and security (domain, provider, validity window, ERC-4337-style nonce).
• Flow: Relayer or signer calls runMacro(macro, params, signer, signature). Forwarder verifies signature, validates validity window and nonce, enforces provider ACL, then runs the macro.
• Interfaces: IClearMacroForwarder (payload, runMacro, encodeParams, type getters), IClearMacro (extends IMacro with EIP-712 metadata: getPrimaryTypeName, getActionTypeDefinition, getActionStructHash).
• Scripts for deployment and macro-provider ACL; Foundry tests for signature, nonce, validity, provider checks and encoding.

Permit2 variant (optional)

• Contract: Permit2ClearMacroForwarder — same ClearMacro payload, bound via Permit2 witness; entrypoint runPermit2AndMacro(...).
• Use case: One signature: pull via Permit2 → optional upgrade to SuperToken (forwarder) → run macro. For users who already have a Permit2 allowance.

[github-actions]

Changelog Reminder

Reminder to update the CHANGELOG.md for any of the modified packages in this PR.

• CHANGELOG.md modified
• Double check before merge

[codecov]

Codecov Report

❌ Patch coverage is 92.71523% with 11 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...cts/contracts/utils/Permit2ClearMacroForwarder.sol	88.88%	6 Missing ⚠️
...ereum-contracts/contracts/utils/ClearMacroBase.sol	90.00%	3 Missing ⚠️
...-contracts/contracts/utils/ClearMacroForwarder.sol	98.38%	1 Missing ⚠️
...ereum-contracts/contracts/utils/MacroForwarder.sol	66.66%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!