Add ERC-7579 Social Recovery Executor Module (In Progress)

contracts/account/README.adoc

@@ -6,8 +6,10 @@ This directory includes contracts to build accounts for ERC-4337. These include:
 
  * {AccountCore}: An ERC-4337 smart account implementation that includes the core logic to process user operations.
  * {Account}: An extension of `AccountCore` that implements the recommended features for ERC-4337 smart accounts.
- * {AccountSignerERC7702}: An account implementation with low-level signature validation performed by an EOA.
+ * {AccountERC7579}: An extension of `AccountCore` that implements support for ERC-7579 modules.
+ * {AccountERC7579Hooked}: An extension of `AccountERC7579` with support for a single hook module (type 4).
  * {ERC7821}: Minimal batch executor implementation contracts. Useful to enable easy batch execution for smart contracts.
+ * {ERC7579SocialRecoveryExecutor}: A social recovery module for ERC-7579 accounts.
 
 == Core
 
@@ -17,10 +19,18 @@ This directory includes contracts to build accounts for ERC-4337. These include:
 
 == Extensions
 
-{{SignerERC7702}}
+{{AccountERC7579}}
 
-{{AccountERC7759}}
-
-{{AccountERC7759Hooked}}
+{{AccountERC7579Hooked}}
 
 {{ERC7821}}
+
+{{ERC7579Modules}}
+
+== ERC7579 Modules
+
+This section includes several ERC-7579 Module implementations for {AccountERC7579}:
+
+ * {ERC7579SocialRecoveryExecutor}: A social recovery module enabling account reconfiguration through a timelocked guardian-based consensus mechanism.
+
+{{ERC7579SocialRecoveryExecutor}}

contracts/mocks/account/modules/ERC7579SocialRecoveryExecutorMock.sol

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import {ERC7579SocialRecoveryExecutor} from "../../../account/extensions/ERC7579Modules/ERC7579SocialRecoveryExecutor.sol";
+
+contract ERC7579SocialRecoveryExecutorMock is ERC7579SocialRecoveryExecutor {
+    constructor(string memory name, string memory version) ERC7579SocialRecoveryExecutor(name, version) {}
+
+    // helper for testing signature validation
+    function validateGuardianSignatures(
+        address account,
+        GuardianSignature[] calldata guardianSignatures,
+        bytes32 digest
+    ) public view virtual {
+        super._validateGuardianSignatures(account, guardianSignatures, digest);
+    }
+}

contracts/mocks/account/modules/ERC7579ValidatorMock.sol

@@ -22,6 +22,14 @@ abstract contract ERC7579ValidatorMock is ERC7579ModuleMock(MODULE_TYPE_VALIDATO
         super.onUninstall(data);
     }
 
+    function updateSigner(address newSigner) public virtual {
+        _associatedSigners[msg.sender] = newSigner;
+    }
+
+    function getSigner(address sender) public view virtual returns (address) {
+        return _associatedSigners[sender];
+    }
+
     function validateUserOp(
         PackedUserOperation calldata userOp,
         bytes32 userOpHash

scripts/prepare-docs.sh

@@ -23,4 +23,4 @@ for f in "$examples_source_dir"/**/*.sol; do
   sed -Ee '/^import/s|"(\.\./)+|"@openzeppelin/community-contracts/|' "$f" > "$examples_target_dir/$name"
 done
 
-node scripts/gen-nav.js "$OUTDIR" > "$OUTDIR/../nav.adoc"
+node scripts/gen-nav.js "$OUTDIR" > "$OUTDIR/../nav.adoc"