From 86fe1f1d73011e32597120692bda6b6130dd2c45 Mon Sep 17 00:00:00 2001
From: Ryan Sauge <71391932+rya-sge@users.noreply.github.com>
Date: Tue, 10 Mar 2026 11:29:20 +0100
Subject: [PATCH 1/2] Update code coverage and add missing tests

---
 README.md                                     |   46 +-
 .../RuleAddressSet.sol.func-sort-c.html       |   88 +-
 .../RuleAddressSet.sol.func.html              |   88 +-
 .../RuleAddressSet.sol.gcov.html              |  338 +--
 ...uleAddressSetInternal.sol.func-sort-c.html |   54 +-
 .../RuleAddressSetInternal.sol.func.html      |   54 +-
 .../RuleAddressSetInternal.sol.gcov.html      |  150 +-
 .../RuleAddressSet}/index-sort-b.html         |   44 +-
 .../RuleAddressSet}/index-sort-f.html         |   46 +-
 .../RuleAddressSet}/index-sort-l.html         |   46 +-
 .../RuleAddressSet}/index.html                |   44 +-
 .../RuleERC2980Internal.sol.func-sort-c.html  |  129 +
 .../RuleERC2980Internal.sol.func.html         |  129 +
 .../RuleERC2980Internal.sol.gcov.html         |  205 ++
 .../abstract/RuleERC2980/index-sort-b.html    |  107 +
 .../abstract/RuleERC2980/index-sort-f.html    |  107 +
 .../abstract/RuleERC2980/index-sort-l.html    |  107 +
 .../coverage/abstract/RuleERC2980/index.html  |  107 +
 .../RuleBlacklistBase.sol.func-sort-c.html    |  117 +
 .../base/RuleBlacklistBase.sol.func.html      |  117 +
 .../base/RuleBlacklistBase.sol.gcov.html      |  210 ++
 .../base/RuleERC2980Base.sol.func-sort-c.html |  213 ++
 .../base/RuleERC2980Base.sol.func.html        |  213 ++
 .../base/RuleERC2980Base.sol.gcov.html        |  473 ++++
 ...eIdentityRegistryBase.sol.func-sort-c.html |  129 +
 .../RuleIdentityRegistryBase.sol.func.html    |  129 +
 .../RuleIdentityRegistryBase.sol.gcov.html    |  229 ++
 ...uleMaxTotalSupplyBase.sol.func-sort-c.html |  129 +
 .../base/RuleMaxTotalSupplyBase.sol.func.html |  129 +
 .../base/RuleMaxTotalSupplyBase.sol.gcov.html |  204 ++
 ...RuleSanctionsListBase.sol.func-sort-c.html |  133 ++
 .../base/RuleSanctionsListBase.sol.func.html  |  133 ++
 .../base/RuleSanctionsListBase.sol.gcov.html  |  227 ++
 .../RuleWhitelistBase.sol.func-sort-c.html    |  113 +
 .../base/RuleWhitelistBase.sol.func.html      |  113 +
 .../base/RuleWhitelistBase.sol.gcov.html      |  166 ++
 ...eWhitelistWrapperBase.sol.func-sort-c.html |  137 ++
 .../RuleWhitelistWrapperBase.sol.func.html    |  137 ++
 .../RuleWhitelistWrapperBase.sol.gcov.html}   |  525 ++--
 .../coverage/abstract/base/index-sort-b.html  |  179 ++
 .../coverage/abstract/base/index-sort-f.html  |  179 ++
 .../coverage/abstract/base/index-sort-l.html  |  179 ++
 .../coverage/abstract/base/index.html         |  179 ++
 .../core/RuleNFTAdapter.sol.func-sort-c.html  |  113 +
 .../core/RuleNFTAdapter.sol.func.html         |  113 +
 .../core/RuleNFTAdapter.sol.gcov.html}        |  300 ++-
 ...leTransferValidation.sol.func-sort-c.html} |   36 +-
 .../RuleTransferValidation.sol.func.html}     |   36 +-
 .../RuleTransferValidation.sol.gcov.html}     |  176 +-
 .../RuleWhitelistShared.sol.func-sort-c.html} |   30 +-
 .../core/RuleWhitelistShared.sol.func.html}   |   32 +-
 .../core/RuleWhitelistShared.sol.gcov.html}   |  227 +-
 .../coverage/abstract/core/index-sort-b.html  |  131 +
 .../coverage/abstract/core/index-sort-f.html  |  131 +
 .../coverage/abstract/core/index-sort-l.html  |  131 +
 .../coverage/abstract/core/index.html         |  131 +
 .../RuleBlacklist.sol.func-sort-c.html        |   68 +-
 .../RuleBlacklist.sol.func.html               |   68 +-
 .../deployment/RuleBlacklist.sol.gcov.html    |  138 ++
 ...BlacklistOwnable2Step.sol.func-sort-c.html |  101 +
 .../RuleBlacklistOwnable2Step.sol.func.html   |  101 +
 .../RuleBlacklistOwnable2Step.sol.gcov.html   |  120 +
 .../RuleERC2980.sol.func-sort-c.html          |  113 +
 .../deployment/RuleERC2980.sol.func.html      |  113 +
 .../deployment/RuleERC2980.sol.gcov.html      |  168 ++
 ...leERC2980Ownable2Step.sol.func-sort-c.html |  109 +
 .../RuleERC2980Ownable2Step.sol.func.html     |  109 +
 .../RuleERC2980Ownable2Step.sol.gcov.html     |  124 +
 .../RuleIdentityRegistry.sol.func-sort-c.html |   89 +
 .../RuleIdentityRegistry.sol.func.html        |   89 +
 .../RuleIdentityRegistry.sol.gcov.html        |  121 +
 ...yRegistryOwnable2Step.sol.func-sort-c.html |   85 +
 ...IdentityRegistryOwnable2Step.sol.func.html |   85 +
 ...IdentityRegistryOwnable2Step.sol.gcov.html |  101 +
 .../RuleMaxTotalSupply.sol.func-sort-c.html   |   89 +
 .../RuleMaxTotalSupply.sol.func.html          |   89 +
 .../RuleMaxTotalSupply.sol.gcov.html          |  125 +
 ...talSupplyOwnable2Step.sol.func-sort-c.html |   85 +
 ...leMaxTotalSupplyOwnable2Step.sol.func.html |   85 +
 ...leMaxTotalSupplyOwnable2Step.sol.gcov.html |  104 +
 .../RuleSanctionsList.sol.func-sort-c.html    |  101 +
 .../RuleSanctionsList.sol.func.html           |  101 +
 .../RuleSanctionsList.sol.gcov.html           |  143 ++
 ...tionsListOwnable2Step.sol.func-sort-c.html |   97 +
 ...uleSanctionsListOwnable2Step.sol.func.html |   97 +
 ...uleSanctionsListOwnable2Step.sol.gcov.html |  119 +
 .../RuleWhitelist.sol.func-sort-c.html        |   50 +-
 .../RuleWhitelist.sol.func.html               |   50 +-
 .../deployment/RuleWhitelist.sol.gcov.html    |  158 ++
 ...WhitelistOwnable2Step.sol.func-sort-c.html |  105 +
 .../RuleWhitelistOwnable2Step.sol.func.html   |  105 +
 .../RuleWhitelistOwnable2Step.sol.gcov.html   |  122 +
 .../RuleWhitelistWrapper.sol.func-sort-c.html |   64 +-
 .../RuleWhitelistWrapper.sol.func.html        |   66 +-
 .../RuleWhitelistWrapper.sol.gcov.html        |  183 ++
 ...stWrapperOwnable2Step.sol.func-sort-c.html |  101 +
 ...WhitelistWrapperOwnable2Step.sol.func.html |  101 +
 ...WhitelistWrapperOwnable2Step.sol.gcov.html |  136 ++
 .../coverage/deployment/index-sort-b.html     |  263 ++
 .../coverage/deployment/index-sort-f.html     |  263 ++
 .../coverage/deployment/index-sort-l.html     |  263 ++
 doc/coverage/coverage/deployment/index.html   |  263 ++
 ...ntrolModuleStandalone.sol.func-sort-c.html |   16 +-
 ...ccessControlModuleStandalone.sol.func.html |   16 +-
 ...ccessControlModuleStandalone.sol.gcov.html |   75 +-
 .../VersionModule.sol.func-sort-c.html        |   85 +
 .../src/modules/VersionModule.sol.func.html   |   85 +
 .../src/modules/VersionModule.sol.gcov.html   |  102 +
 .../dev/Rules/src/modules/index-sort-b.html   |   30 +-
 .../dev/Rules/src/modules/index-sort-f.html   |   30 +-
 .../dev/Rules/src/modules/index-sort-l.html   |   30 +-
 .../Pictures/dev/Rules/src/modules/index.html |   30 +-
 ...ditionalTransferLight.sol.func-sort-c.html |  105 +
 ...RuleConditionalTransferLight.sol.func.html |  105 +
 ...RuleConditionalTransferLight.sol.gcov.html |  141 ++
 ...sferLightOwnable2Step.sol.func-sort-c.html |   93 +
 ...nalTransferLightOwnable2Step.sol.func.html |   93 +
 ...nalTransferLightOwnable2Step.sol.gcov.html |  114 +
 ...onalTransferLightBase.sol.func-sort-c.html |  153 ++
 ...ConditionalTransferLightBase.sol.func.html |  153 ++
 ...onditionalTransferLightBase.sol.gcov.html} |  403 ++--
 .../operation/abstract/index-sort-b.html      |  107 +
 .../operation/abstract/index-sort-f.html      |  107 +
 .../operation/abstract/index-sort-l.html      |  107 +
 .../src/rules/operation/abstract/index.html   |  107 +
 .../src/rules/operation}/index-sort-b.html    |   56 +-
 .../src/rules/operation}/index-sort-f.html    |   60 +-
 .../src/rules/operation}/index-sort-l.html    |   60 +-
 .../dev/Rules/src/rules/operation}/index.html |   56 +-
 doc/coverage/coverage/index-sort-b.html       |  114 +-
 doc/coverage/coverage/index-sort-f.html       |  116 +-
 doc/coverage/coverage/index-sort-l.html       |  116 +-
 doc/coverage/coverage/index.html              |  116 +-
 .../RuleSanctionsList.sol.func-sort-c.html    |  149 --
 .../RuleSanctionsList.sol.func.html           |  149 --
 .../RuleWhitelistWrapper.sol.gcov.html        |  285 ---
 .../coverage/validation/index-sort-b.html     |  143 --
 .../coverage/validation/index-sort-f.html     |  143 --
 .../coverage/validation/index-sort-l.html     |  143 --
 doc/coverage/coverage/validation/index.html   |  143 --
 doc/coverage/lcov.info                        | 2125 +++++++++++++----
 doc/schema/{RuleEngine => RuleEngine.drawio}  |    0
 .../rule/IncomeVault-claimDividend.drawio.png |  Bin 100066 -> 0 bytes
 .../conditionalTransfer-Storage.drawio.png    |  Bin 89794 -> 0 bytes
 ...ionalTransfer-automaticTransfer.drawio.png |  Bin 83764 -> 0 bytes
 ...nditionalTransfer-state machine.drawio.png |  Bin 53914 -> 0 bytes
 doc/schema/rule/conditionalTransfer.drawio    |    1 -
 .../rule/conditionalTransferCMTAT.drawio.png  |  Bin 84882 -> 0 bytes
 doc/schema/rule/conditionalTransferTime.png   |  Bin 29921 -> 0 bytes
 doc/script/convert_links_for_pdf.sh           |   47 +
 .../access-control-RuleEngine.png             |  Bin 30462 -> 0 bytes
 doc/technical/RuleBlacklist.md                |    2 +-
 .../RuleConditionalTransferLight.sol          |    5 +-
 .../DeploymentOperationCoverage.t.sol         |  195 ++
 ...ionalTransferLightApproveAndTransfer.t.sol |   41 +
 ...alTransferLightRuleEngineIntegration.t.sol |    4 +-
 .../RuleConditionalTransferLightUnit.t.sol    |   19 +
 test/RuleERC2980/RuleERC2980.t.sol            |   32 +
 .../RuleIdentityRegistryOwnable2Step.t.sol    |   52 +
 .../RuleIdentityRegistryUnit.t.sol            |   39 +
 .../RuleMaxTotalSupplyOwnable2Step.t.sol      |   51 +
 .../RuleMaxTotalSupplyUnit.t.sol              |   20 +
 .../RuleSanctionsListOwnable2Step.t.sol       |   72 +
 test/RuleWhitelist/RuleWhitelist.t.sol        |   21 +
 test/RuleWhitelist/WhitelistWrapper.t.sol     |   59 +
 test/TransferContext/TransferContext.t.sol    |   24 +
 166 files changed, 16943 insertions(+), 3600 deletions(-)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html (50%)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSet.sol.func.html (50%)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html (75%)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html (56%)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html (56%)
 rename doc/coverage/coverage/{validation => }/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html (67%)
 rename doc/coverage/coverage/{validation/abstract => abstract/RuleAddressSet}/index-sort-b.html (74%)
 rename doc/coverage/coverage/{validation/abstract => abstract/RuleAddressSet}/index-sort-f.html (74%)
 rename doc/coverage/coverage/{validation/abstract => abstract/RuleAddressSet}/index-sort-l.html (74%)
 rename doc/coverage/coverage/{validation/abstract => abstract/RuleAddressSet}/index.html (74%)
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/index-sort-b.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/index-sort-f.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/index-sort-l.html
 create mode 100644 doc/coverage/coverage/abstract/RuleERC2980/index.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.gcov.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func.html
 rename doc/coverage/coverage/{validation/RuleSanctionsList.sol.gcov.html => abstract/base/RuleWhitelistWrapperBase.sol.gcov.html} (55%)
 create mode 100644 doc/coverage/coverage/abstract/base/index-sort-b.html
 create mode 100644 doc/coverage/coverage/abstract/base/index-sort-f.html
 create mode 100644 doc/coverage/coverage/abstract/base/index-sort-l.html
 create mode 100644 doc/coverage/coverage/abstract/base/index.html
 create mode 100644 doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func.html
 rename doc/coverage/coverage/{validation/RuleWhitelist.sol.gcov.html => abstract/core/RuleNFTAdapter.sol.gcov.html} (52%)
 rename doc/coverage/coverage/{validation/abstract/RuleValidateTransfer.sol.func-sort-c.html => abstract/core/RuleTransferValidation.sol.func-sort-c.html} (62%)
 rename doc/coverage/coverage/{validation/abstract/RuleValidateTransfer.sol.func.html => abstract/core/RuleTransferValidation.sol.func.html} (62%)
 rename doc/coverage/coverage/{validation/abstract/RuleValidateTransfer.sol.gcov.html => abstract/core/RuleTransferValidation.sol.gcov.html} (66%)
 rename doc/coverage/coverage/{validation/abstract/RuleWhitelistCommon.sol.func-sort-c.html => abstract/core/RuleWhitelistShared.sol.func-sort-c.html} (71%)
 rename doc/coverage/coverage/{validation/abstract/RuleWhitelistCommon.sol.func.html => abstract/core/RuleWhitelistShared.sol.func.html} (71%)
 rename doc/coverage/coverage/{validation/abstract/RuleWhitelistCommon.sol.gcov.html => abstract/core/RuleWhitelistShared.sol.gcov.html} (82%)
 create mode 100644 doc/coverage/coverage/abstract/core/index-sort-b.html
 create mode 100644 doc/coverage/coverage/abstract/core/index-sort-f.html
 create mode 100644 doc/coverage/coverage/abstract/core/index-sort-l.html
 create mode 100644 doc/coverage/coverage/abstract/core/index.html
 rename doc/coverage/coverage/{validation => deployment}/RuleBlacklist.sol.func-sort-c.html (61%)
 rename doc/coverage/coverage/{validation => deployment}/RuleBlacklist.sol.func.html (61%)
 create mode 100644 doc/coverage/coverage/deployment/RuleBlacklist.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsList.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsList.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsList.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.gcov.html
 rename doc/coverage/coverage/{validation => deployment}/RuleWhitelist.sol.func-sort-c.html (73%)
 rename doc/coverage/coverage/{validation => deployment}/RuleWhitelist.sol.func.html (73%)
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelist.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.gcov.html
 rename doc/coverage/coverage/{validation => deployment}/RuleWhitelistWrapper.sol.func-sort-c.html (64%)
 rename doc/coverage/coverage/{validation => deployment}/RuleWhitelistWrapper.sol.func.html (64%)
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/deployment/index-sort-b.html
 create mode 100644 doc/coverage/coverage/deployment/index-sort-f.html
 create mode 100644 doc/coverage/coverage/deployment/index-sort-l.html
 create mode 100644 doc/coverage/coverage/deployment/index.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.gcov.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.gcov.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.gcov.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func-sort-c.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func.html
 rename doc/coverage/coverage/{validation/RuleBlacklist.sol.gcov.html => home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.gcov.html} (50%)
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-b.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-f.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-l.html
 create mode 100644 doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html
 rename doc/coverage/coverage/{validation/abstract/RuleAddressSet => home/ryan/Pictures/dev/Rules/src/rules/operation}/index-sort-b.html (54%)
 rename doc/coverage/coverage/{validation/abstract/RuleAddressSet => home/ryan/Pictures/dev/Rules/src/rules/operation}/index-sort-f.html (54%)
 rename doc/coverage/coverage/{validation/abstract/RuleAddressSet => home/ryan/Pictures/dev/Rules/src/rules/operation}/index-sort-l.html (54%)
 rename doc/coverage/coverage/{validation/abstract/RuleAddressSet => home/ryan/Pictures/dev/Rules/src/rules/operation}/index.html (54%)
 delete mode 100644 doc/coverage/coverage/validation/RuleSanctionsList.sol.func-sort-c.html
 delete mode 100644 doc/coverage/coverage/validation/RuleSanctionsList.sol.func.html
 delete mode 100644 doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.gcov.html
 delete mode 100644 doc/coverage/coverage/validation/index-sort-b.html
 delete mode 100644 doc/coverage/coverage/validation/index-sort-f.html
 delete mode 100644 doc/coverage/coverage/validation/index-sort-l.html
 delete mode 100644 doc/coverage/coverage/validation/index.html
 rename doc/schema/{RuleEngine => RuleEngine.drawio} (100%)
 delete mode 100644 doc/schema/rule/IncomeVault-claimDividend.drawio.png
 delete mode 100644 doc/schema/rule/conditionalTransfer-Storage.drawio.png
 delete mode 100644 doc/schema/rule/conditionalTransfer-automaticTransfer.drawio.png
 delete mode 100644 doc/schema/rule/conditionalTransfer-state machine.drawio.png
 delete mode 100644 doc/schema/rule/conditionalTransfer.drawio
 delete mode 100644 doc/schema/rule/conditionalTransferCMTAT.drawio.png
 delete mode 100644 doc/schema/rule/conditionalTransferTime.png
 create mode 100755 doc/script/convert_links_for_pdf.sh
 delete mode 100644 doc/security/accessControl/access-control-RuleEngine.png
 create mode 100644 test/Coverage/DeploymentOperationCoverage.t.sol
 create mode 100644 test/RuleIdentityRegistry/Ownable/RuleIdentityRegistryOwnable2Step.t.sol
 create mode 100644 test/RuleMaxTotalSupply/Ownable/RuleMaxTotalSupplyOwnable2Step.t.sol
 create mode 100644 test/RuleSanctionList/Ownable/RuleSanctionsListOwnable2Step.t.sol

diff --git a/README.md b/README.md
index 6f437b2..ace16e8 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@ Each rule can be used **standalone**, directly plugged into a CMTAT token, **or*
 
 **Status:** *Repository under active development*
 
+Latest update: completed 100% coverage across `src/` contracts, including direct coverage for `RuleAddressSet.contains(address)`, mint/burn-path coverage for `RuleConditionalTransferLightBase.detectTransferRestriction(...)`, and removal of an unreachable duplicate admin-zero check in `RuleConditionalTransferLight` constructor.
+
 ## Table of Contents
 
 [TOC]
@@ -58,7 +60,7 @@ forge test
 
 Each Rule implements the interface `IRuleEngine` defined in CMTAT.
 
-This interface declares the ERC-3643 functions `transferred`(read-write) and `canTransfer`(ready-only) with several other functions related to [ERC-1404](https://github.com/ethereum/eips/issues/1404), [ERC-7551](https://ethereum-magicians.org/t/erc-7551-crypto-security-token-smart-contract-interface-ewpg-reworked/25477) and [ERC-3643](https://eips.ethereum.org/EIPS/eip-3643).
+This interface declares the ERC-3643 functions `transferred`(read-write) and `canTransfer`(read-only) with several other functions related to [ERC-1404](https://github.com/ethereum/eips/issues/1404), [ERC-7551](https://ethereum-magicians.org/t/erc-7551-crypto-security-token-smart-contract-interface-ewpg-reworked/25477) and [ERC-3643](https://eips.ethereum.org/EIPS/eip-3643).
 
 ## Specifications
 
@@ -344,18 +346,18 @@ Several rules are available in multiple access-control variants. Use the simples
 
 ### Summary tab
 
-| Rule                                                         | Type <br />[ready-only / read-write] | ERC-721 / ERC-1155 | ERC-3643 | Security Audit planned in the roadmap | Description                                                  |
+| Rule                                                         | Type <br />[read-only / read-write] | ERC-721 / ERC-1155 | ERC-3643 | Security Audit planned in the roadmap | Description                                                  |
 | ------------------------------------------------------------ | ------------------------------------ | ------------------ | -------- | ------------------------------------- | ------------------------------------------------------------ |
-| RuleWhitelist                                                | Ready-only                           | ☑                  | ☑        | ☑                                     | This rule can be used to restrict transfers from/to only addresses inside a whitelist. |
-| RuleWhitelistWrapper                                         | Ready-only                           | ☑                  | ☑        | ☑                                     | This rule can be used to restrict transfers from/to only addresses inside a group of whitelist rules managed by different operators. |
-| RuleBlacklist                                                | Ready-only                           | ☑                  | ☑        | ☑                                     | This rule can be used to forbid transfer from/to addresses in the blacklist |
-| RuleSanctionList                                             | Ready-only                           | ☑                  | ☑        | ☑                                     | The purpose of this contract is to use the oracle contract from [Chainalysis](https://go.chainalysis.com/chainalysis-oracle-docs.html) to forbid transfer from/to an address included in a sanctions designation (US, EU, or UN). |
-| RuleMaxTotalSupply                                           | Ready-only                           | —                  | ☑        | ☑                                     | This rule limits minting so that the total supply never exceeds a configured maximum. |
-| RuleIdentityRegistry                                         | Ready-only                           | ☑                  | ☑        | ☑                                     | This rule checks the ERC-3643 Identity Registry for transfer participants when configured. |
-| RuleERC2980                                                  | Ready-only                           | ☑                  | ☑        | ☒                                     | ERC-2980 Swiss Compliant rule combining a whitelist (recipient-only) and a frozenlist (blocks both sender and recipient). Frozenlist takes priority over whitelist. |
-| RuleConditionalTransferLight                                | Ready-Write                          | —                  | ☑        | ☒<br /> (experimental rule)           | This rule requires that transfers have to be approved by an operator before being executed. Each approval is consumed once and the same transfer can be approved multiple times. |
-| [RuleConditionalTransfer](https://github.com/CMTA/RuleConditionalTransfer) (external) | Ready-Write | — | ☑ | ☒<br /> (experimental rule) | Full-featured approval-based transfer rule implementing Swiss law *Vinkulierung*. Supports automatic approval after three months, automatic transfer execution, and a conditional whitelist for address pairs that bypass approval. Maintained in a separate repository. |
-| [RuleSelf](https://github.com/rya-sge/ruleself) (community) | — | — | — | ☒<br /> (community project) | Community-maintained rule project. Not developed or maintained by CMTA. |
+| RuleWhitelist                                                | Read-only                          | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule can be used to restrict transfers from/to only addresses inside a whitelist. |
+| RuleWhitelistWrapper                                         | Read-Only                           | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule can be used to restrict transfers from/to only addresses inside a group of whitelist rules managed by different operators. |
+| RuleBlacklist                                                | Read-Only                           | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule can be used to forbid transfer from/to addresses in the blacklist |
+| RuleSanctionList                                             | Read-Only                           | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | The purpose of this contract is to use the oracle contract from [Chainalysis](https://go.chainalysis.com/chainalysis-oracle-docs.html) to forbid transfer from/to an address included in a sanctions designation (US, EU, or UN). |
+| RuleMaxTotalSupply                                           | Read-Only                          | <strong><span style="color: #b00020;">&#x2718;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule limits minting so that the total supply never exceeds a configured maximum. |
+| RuleIdentityRegistry                                         | Read-Only                          | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule checks the ERC-3643 Identity Registry for transfer participants when configured. |
+| RuleERC2980                                                  | Read-Only                          | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | ERC-2980 Swiss Compliant rule combining a whitelist (recipient-only) and a frozenlist (blocks both sender and recipient). Frozenlist takes priority over whitelist. |
+| RuleConditionalTransferLight                                | Read-Write                          | <strong><span style="color: #b00020;">&#x2718;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | This rule requires that transfers have to be approved by an operator before being executed. Each approval is consumed once and the same transfer can be approved multiple times. |
+| [RuleConditionalTransfer](https://github.com/CMTA/RuleConditionalTransfer) (external) | Read-Write | <strong><span style="color: #b00020;">&#x2718;</span></strong> | <strong><span style="color: #1e7e34;">&#x2714;</span></strong> | <strong><span style="color: #b00020;">&#x2718;</span></strong><br /> (experimental rule) | Full-featured approval-based transfer rule implementing Swiss law *Vinkulierung*. Supports automatic approval after three months, automatic transfer execution, and a conditional whitelist for address pairs that bypass approval. Maintained in a separate repository. |
+| [RuleSelf](https://github.com/rya-sge/ruleself) (community) | — | <strong><span style="color: #b00020;">&#x2718;</span></strong> | — | <strong><span style="color: #b00020;">&#x2718;</span></strong><br /> (community project) | Use [Self](https://self.xyz), a zero-knowledge identity  solution to determine which is allowed to interact with the token.<br />Community-maintained rule project. Not developed or maintained by CMTA. |
 
 All rules are compatible with CMTAT, as noted earlier in this README.
 
@@ -365,14 +367,14 @@ Detailed technical documentation for each rule is available in [`doc/technical/`
 
 | Rule | Document |
 | ---- | -------- |
-| RuleWhitelist | [RuleWhitelist.md](doc/technical/RuleWhitelist.md) |
-| RuleWhitelistWrapper | [RuleWhitelistWrapper.md](doc/technical/RuleWhitelistWrapper.md) |
-| RuleBlacklist | [RuleBlacklist.md](doc/technical/RuleBlacklist.md) |
-| RuleSanctionsList | [RuleSanctionList.md](doc/technical/RuleSanctionList.md) |
-| RuleMaxTotalSupply | [RuleMaxTotalSupply.md](doc/technical/RuleMaxTotalSupply.md) |
-| RuleIdentityRegistry | [RuleIdentityRegistry.md](doc/technical/RuleIdentityRegistry.md) |
-| RuleERC2980 | [RuleERC2980.md](doc/technical/RuleERC2980.md) |
-| RuleConditionalTransferLight | [RuleConditionalTransferLight.md](doc/technical/RuleConditionalTransferLight.md) |
+| RuleWhitelist | [RuleWhitelist.md](./doc/technical/RuleWhitelist.md) |
+| RuleWhitelistWrapper | [RuleWhitelistWrapper.md](./doc/technical/RuleWhitelistWrapper.md) |
+| RuleBlacklist | [RuleBlacklist.md](./doc/technical/RuleBlacklist.md) |
+| RuleSanctionsList | [RuleSanctionList.md](./doc/technical/RuleSanctionList.md) |
+| RuleMaxTotalSupply | [RuleMaxTotalSupply.md](./doc/technical/RuleMaxTotalSupply.md) |
+| RuleIdentityRegistry | [RuleIdentityRegistry.md](./doc/technical/RuleIdentityRegistry.md) |
+| RuleERC2980 | [RuleERC2980.md](./doc/technical/RuleERC2980.md) |
+| RuleConditionalTransferLight | [RuleConditionalTransferLight.md](./doc/technical/RuleConditionalTransferLight.md) |
 
 ### Operational Notes
 
@@ -667,6 +669,10 @@ To run a specific test, use
 forge test --match-contract <contract name> --match-test <function name>
 ```
 
+- For `RuleConditionalTransferLight` fuzz/integration tests, note that mint and burn paths (`from == address(0)` or `to == address(0)`) are intentionally exempt from approval consumption.
+- Ownable2Step variants also include dedicated tests for ownership transfer and manager-only functions (IdentityRegistry, MaxTotalSupply, SanctionsList).
+- Coverage-focused tests also target deployment wrappers and operation-rule overloads (`created`, `destroyed`, spender-aware `transferred`) to improve line/function coverage in `src/rules/operation` and `src/rules/validation/deployment`.
+
 Generate gas report
 
 ```bash
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html
similarity index 50%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html
index 6808037..65bc64a 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func-sort-c.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSet.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSet.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (<a href="RuleAddressSet.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (<a href="RuleAddressSet.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,92 +31,100 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">28</td>
-            <td class="headerCovTableEntry">32</td>
-            <td class="headerCovTableEntryMed">87.5 %</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleAddressSet.sol.func.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleAddressSet.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#155">RuleAddressSet._msgData</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#123">RuleAddressSet.contains</a></td>
+              <td class="coverFnHi">2</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#121">RuleAddressSet.contains</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#157">RuleAddressSet._msgData</a></td>
+              <td class="coverFnHi">4</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#100">RuleAddressSet.removeAddress</a></td>
-              <td class="coverFnHi">3</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#101">RuleAddressSet.onlyAddressListRemove</a></td>
+              <td class="coverFnHi">8</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#73">RuleAddressSet.removeAddresses</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#86">RuleAddressSet.removeAddress</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#132">RuleAddressSet.isAddressListed</a></td>
+              <td class="coverFnHi">67</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#73">RuleAddressSet.addAddress</a></td>
+              <td class="coverFnHi">105</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#61">RuleAddressSet.addAddresses</a></td>
-              <td class="coverFnHi">17</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#141">RuleAddressSet.areAddressesListed</a></td>
+              <td class="coverFnHi">108</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#112">RuleAddressSet.listedAddressCount</a></td>
-              <td class="coverFnHi">24</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#61">RuleAddressSet.removeAddresses</a></td>
+              <td class="coverFnHi">260</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#85">RuleAddressSet.addAddress</a></td>
-              <td class="coverFnHi">52</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#49">RuleAddressSet.addAddresses</a></td>
+              <td class="coverFnHi">275</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#130">RuleAddressSet.isAddressListed</a></td>
-              <td class="coverFnHi">60</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#96">RuleAddressSet.onlyAddressListAdd</a></td>
+              <td class="coverFnHi">275</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#139">RuleAddressSet.areAddressesListed</a></td>
-              <td class="coverFnHi">84</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#114">RuleAddressSet.listedAddressCount</a></td>
+              <td class="coverFnHi">536</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#160">RuleAddressSet._contextSuffixLength</a></td>
-              <td class="coverFnHi">207</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#152">RuleAddressSet._msgSender</a></td>
+              <td class="coverFnHi">882</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#150">RuleAddressSet._msgSender</a></td>
-              <td class="coverFnHi">207</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#162">RuleAddressSet._contextSuffixLength</a></td>
+              <td class="coverFnHi">886</td>
             </tr>
   </table>
   <br>
   </center>
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func.html
similarity index 50%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func.html
index 3ebf795..5984b78 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.func.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.func.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSet.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSet.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (<a href="RuleAddressSet.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (<a href="RuleAddressSet.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,92 +31,100 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">28</td>
-            <td class="headerCovTableEntry">32</td>
-            <td class="headerCovTableEntryMed">87.5 %</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleAddressSet.sol.func-sort-c.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleAddressSet.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#160">RuleAddressSet._contextSuffixLength</a></td>
-              <td class="coverFnHi">207</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#162">RuleAddressSet._contextSuffixLength</a></td>
+              <td class="coverFnHi">886</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#155">RuleAddressSet._msgData</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#157">RuleAddressSet._msgData</a></td>
+              <td class="coverFnHi">4</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#150">RuleAddressSet._msgSender</a></td>
-              <td class="coverFnHi">207</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#152">RuleAddressSet._msgSender</a></td>
+              <td class="coverFnHi">882</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#85">RuleAddressSet.addAddress</a></td>
-              <td class="coverFnHi">52</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#73">RuleAddressSet.addAddress</a></td>
+              <td class="coverFnHi">105</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#61">RuleAddressSet.addAddresses</a></td>
-              <td class="coverFnHi">17</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#49">RuleAddressSet.addAddresses</a></td>
+              <td class="coverFnHi">275</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#139">RuleAddressSet.areAddressesListed</a></td>
-              <td class="coverFnHi">84</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#141">RuleAddressSet.areAddressesListed</a></td>
+              <td class="coverFnHi">108</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#121">RuleAddressSet.contains</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#123">RuleAddressSet.contains</a></td>
+              <td class="coverFnHi">2</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#130">RuleAddressSet.isAddressListed</a></td>
-              <td class="coverFnHi">60</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#132">RuleAddressSet.isAddressListed</a></td>
+              <td class="coverFnHi">67</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#112">RuleAddressSet.listedAddressCount</a></td>
-              <td class="coverFnHi">24</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#114">RuleAddressSet.listedAddressCount</a></td>
+              <td class="coverFnHi">536</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#100">RuleAddressSet.removeAddress</a></td>
-              <td class="coverFnHi">3</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#96">RuleAddressSet.onlyAddressListAdd</a></td>
+              <td class="coverFnHi">275</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#73">RuleAddressSet.removeAddresses</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#101">RuleAddressSet.onlyAddressListRemove</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#86">RuleAddressSet.removeAddress</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleAddressSet.sol.gcov.html#61">RuleAddressSet.removeAddresses</a></td>
+              <td class="coverFnHi">260</td>
             </tr>
   </table>
   <br>
   </center>
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html
similarity index 75%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html
index cded5ef..cef3ac8 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSet.sol.gcov.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSet.sol</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSet.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (source / <a href="RuleAddressSet.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSet.sol<span style="font-size: 80%;"> (source / <a href="RuleAddressSet.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,34 +31,34 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">28</td>
-            <td class="headerCovTableEntry">32</td>
-            <td class="headerCovTableEntryMed">87.5 %</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntry">34</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <table cellpadding=0 cellspacing=0 border=0>
@@ -72,168 +72,170 @@
 <a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
 <a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
 <a name="3"><span class="lineNum">       3 </span>                :            : </a>
-<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
-<a name="5"><span class="lineNum">       5 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context, Context} from &quot;../../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleAddressSetInternal} from &quot;./RuleAddressSetInternal.sol&quot;;</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleAddressSetInvariantStorage} from &quot;./invariantStorage/RuleAddressSetInvariantStorage.sol&quot;;</a>
-<a name="8"><span class="lineNum">       8 </span>                :            : /* ==== Interfaces === */</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {IIdentityRegistryContains} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : import {IAddressList} from &quot;../../../interfaces/IAddressList.sol&quot;;</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
-<a name="12"><span class="lineNum">      12 </span>                :            :  * @title Rule Address Set</a>
-<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Manages a permissioned set of addresses related to rule logic.</a>
-<a name="14"><span class="lineNum">      14 </span>                :            :  * @dev</a>
-<a name="15"><span class="lineNum">      15 </span>                :            :  * - Provides controlled functions for adding and removing addresses.</a>
-<a name="16"><span class="lineNum">      16 </span>                :            :  * - Integrates `AccessControl` for role-based access.</a>
-<a name="17"><span class="lineNum">      17 </span>                :            :  * - Supports gasless transactions via ERC-2771 meta-transactions.</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :  * - Extends internal logic defined in {RuleAddressSetInternal}.</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :  */</a>
-<a name="20"><span class="lineNum">      20 </span>                :            : </a>
-<a name="21"><span class="lineNum">      21 </span>                :            : abstract contract RuleAddressSet is</a>
-<a name="22"><span class="lineNum">      22 </span>                :            :     AccessControlModuleStandalone,</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :     MetaTxModuleStandalone,</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :     RuleAddressSetInternal,</a>
-<a name="25"><span class="lineNum">      25 </span>                :            :     RuleAddressSetInvariantStorage,</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :     IAddressList</a>
-<a name="27"><span class="lineNum">      27 </span>                :            : {</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :                                 STATE</a>
-<a name="30"><span class="lineNum">      30 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="31"><span class="lineNum">      31 </span>                :            : </a>
-<a name="32"><span class="lineNum">      32 </span>                :            :     /// @notice Cached number of currently listed addresses.</a>
-<a name="33"><span class="lineNum">      33 </span>                :            :     uint256 private _listedAddressCountCache;</a>
-<a name="34"><span class="lineNum">      34 </span>                :            : </a>
-<a name="35"><span class="lineNum">      35 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="36"><span class="lineNum">      36 </span>                :            :                               CONSTRUCTOR</a>
-<a name="37"><span class="lineNum">      37 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="38"><span class="lineNum">      38 </span>                :            : </a>
-<a name="39"><span class="lineNum">      39 </span>                :            :     /**</a>
-<a name="40"><span class="lineNum">      40 </span>                :            :      * @notice Initializes the RuleAddressSet contract.</a>
-<a name="41"><span class="lineNum">      41 </span>                :            :      * @param admin The address granted the default admin role.</a>
-<a name="42"><span class="lineNum">      42 </span>                :            :      * @param forwarderIrrevocable Address of the ERC2771 forwarder (for meta-transactions).</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :      * @dev Reverts if the admin address is the zero address.</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :      */</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :     constructor(address admin, address forwarderIrrevocable)</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :         MetaTxModuleStandalone(forwarderIrrevocable)</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :         AccessControlModuleStandalone(admin)</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :     {</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :         // nothing to do</a>
-<a name="50"><span class="lineNum">      50 </span>                :            :     }</a>
-<a name="51"><span class="lineNum">      51 </span>                :            : </a>
-<a name="52"><span class="lineNum">      52 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="53"><span class="lineNum">      53 </span>                :            :                               CORE LOGIC</a>
-<a name="54"><span class="lineNum">      54 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context} from &quot;../../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleAddressSetInternal} from &quot;./RuleAddressSetInternal.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleAddressSetInvariantStorage} from &quot;./invariantStorage/RuleAddressSetInvariantStorage.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : /* ==== Interfaces === */</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IIdentityRegistryContains} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {IAddressList} from &quot;../../../interfaces/IAddressList.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @title Rule Address Set</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @notice Manages a permissioned set of addresses related to rule logic.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @dev</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * - Provides controlled functions for adding and removing addresses.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * - Integrates `AccessControl` for role-based access.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  * - Supports gasless transactions via ERC-2771 meta-transactions.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  * - Extends internal logic defined in {RuleAddressSetInternal}.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  */</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :            : abstract contract RuleAddressSet is</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :     MetaTxModuleStandalone,</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     RuleAddressSetInternal,</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     RuleAddressSetInvariantStorage,</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     IAddressList</a>
+<a name="25"><span class="lineNum">      25 </span>                :            : {</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :                                 STATE</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="29"><span class="lineNum">      29 </span>                :            : </a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :                               CONSTRUCTOR</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="33"><span class="lineNum">      33 </span>                :            : </a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     /**</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      * @notice Initializes the RuleAddressSet contract.</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :      * @param forwarderIrrevocable Address of the ERC2771 forwarder (for meta-transactions).</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :      */</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :     constructor(address forwarderIrrevocable) MetaTxModuleStandalone(forwarderIrrevocable) {}</a>
+<a name="39"><span class="lineNum">      39 </span>                :            : </a>
+<a name="40"><span class="lineNum">      40 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :                               CORE LOGIC</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="43"><span class="lineNum">      43 </span>                :            : </a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     /**</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :      * @notice Adds multiple addresses to the set.</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :      * @dev</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :      * - Does not revert if an address is already listed.</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_ADD_ROLE`.</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :      * @param targetAddresses Array of addresses to be added.</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :      */</a>
+<a name="51"><span class="lineNum">      51 </span>                :<span class="lineCov">        275 :     function addAddresses(address[] calldata targetAddresses) public onlyAddressListAdd {</span></a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">        274 :         _addAddresses(targetAddresses);</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">        274 :         emit AddAddresses(targetAddresses);</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :            :     }</a>
 <a name="55"><span class="lineNum">      55 </span>                :            : </a>
 <a name="56"><span class="lineNum">      56 </span>                :            :     /**</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :      * @notice Adds multiple addresses to the set.</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :      * @notice Removes multiple addresses from the set.</a>
 <a name="58"><span class="lineNum">      58 </span>                :            :      * @dev</a>
-<a name="59"><span class="lineNum">      59 </span>                :            :      * - Does not revert if an address is already listed.</a>
-<a name="60"><span class="lineNum">      60 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_ADD_ROLE`.</a>
-<a name="61"><span class="lineNum">      61 </span>                :            :      * @param targetAddresses Array of addresses to be added.</a>
+<a name="59"><span class="lineNum">      59 </span>                :            :      * - Does not revert if an address is not listed.</a>
+<a name="60"><span class="lineNum">      60 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_REMOVE_ROLE`.</a>
+<a name="61"><span class="lineNum">      61 </span>                :            :      * @param targetAddresses Array of addresses to remove.</a>
 <a name="62"><span class="lineNum">      62 </span>                :            :      */</a>
-<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">         17 :     function addAddresses(address[] calldata targetAddresses) public onlyRole(ADDRESS_LIST_ADD_ROLE) {</span></a>
-<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">         16 :         _addAddresses(targetAddresses);</span></a>
-<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">         16 :         emit AddAddresses(targetAddresses);</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">        260 :     function removeAddresses(address[] calldata targetAddresses) public onlyAddressListRemove {</span></a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">        259 :         _removeAddresses(targetAddresses);</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">        259 :         emit RemoveAddresses(targetAddresses);</span></a>
 <a name="66"><span class="lineNum">      66 </span>                :            :     }</a>
 <a name="67"><span class="lineNum">      67 </span>                :            : </a>
 <a name="68"><span class="lineNum">      68 </span>                :            :     /**</a>
-<a name="69"><span class="lineNum">      69 </span>                :            :      * @notice Removes multiple addresses from the set.</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :      * @notice Adds a single address to the set.</a>
 <a name="70"><span class="lineNum">      70 </span>                :            :      * @dev</a>
-<a name="71"><span class="lineNum">      71 </span>                :            :      * - Does not revert if an address is not listed.</a>
-<a name="72"><span class="lineNum">      72 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_REMOVE_ROLE`.</a>
-<a name="73"><span class="lineNum">      73 </span>                :            :      * @param targetAddresses Array of addresses to remove.</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :      * - Reverts if the address is already listed.</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_ADD_ROLE`.</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :      * @param targetAddress The address to be added.</a>
 <a name="74"><span class="lineNum">      74 </span>                :            :      */</a>
-<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">          4 :     function removeAddresses(address[] calldata targetAddresses) public onlyRole(ADDRESS_LIST_REMOVE_ROLE) {</span></a>
-<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">          3 :         _removeAddresses(targetAddresses);</span></a>
-<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">          3 :         emit RemoveAddresses(targetAddresses);</span></a>
-<a name="78"><span class="lineNum">      78 </span>                :            :     }</a>
-<a name="79"><span class="lineNum">      79 </span>                :            : </a>
-<a name="80"><span class="lineNum">      80 </span>                :            :     /**</a>
-<a name="81"><span class="lineNum">      81 </span>                :            :      * @notice Adds a single address to the set.</a>
-<a name="82"><span class="lineNum">      82 </span>                :            :      * @dev</a>
-<a name="83"><span class="lineNum">      83 </span>                :            :      * - Reverts if the address is already listed.</a>
-<a name="84"><span class="lineNum">      84 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_ADD_ROLE`.</a>
-<a name="85"><span class="lineNum">      85 </span>                :            :      * @param targetAddress The address to be added.</a>
-<a name="86"><span class="lineNum">      86 </span>                :            :      */</a>
-<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">         52 :     function addAddress(address targetAddress) public onlyRole(ADDRESS_LIST_ADD_ROLE) {</span></a>
-<a name="88"><span class="lineNum">      88 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">         51 :         if (_isAddressListed(targetAddress)) {</span></a>
-<a name="89"><span class="lineNum">      89 </span>                :<span class="lineCov">          1 :             revert RuleAddressSet_AddressAlreadyListed();</span></a>
-<a name="90"><span class="lineNum">      90 </span>                :            :         }</a>
-<a name="91"><span class="lineNum">      91 </span>                :<span class="lineCov">         50 :         _addAddress(targetAddress);</span></a>
-<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">         50 :         emit AddAddress(targetAddress);</span></a>
-<a name="93"><span class="lineNum">      93 </span>                :            :     }</a>
-<a name="94"><span class="lineNum">      94 </span>                :            : </a>
-<a name="95"><span class="lineNum">      95 </span>                :            :     /**</a>
-<a name="96"><span class="lineNum">      96 </span>                :            :      * @notice Removes a single address from the set.</a>
-<a name="97"><span class="lineNum">      97 </span>                :            :      * @dev</a>
-<a name="98"><span class="lineNum">      98 </span>                :            :      * - Reverts if the address is not listed.</a>
-<a name="99"><span class="lineNum">      99 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_REMOVE_ROLE`.</a>
-<a name="100"><span class="lineNum">     100 </span>                :            :      * @param targetAddress The address to be removed.</a>
-<a name="101"><span class="lineNum">     101 </span>                :            :      */</a>
-<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">          3 :     function removeAddress(address targetAddress) public onlyRole(ADDRESS_LIST_REMOVE_ROLE) {</span></a>
-<a name="103"><span class="lineNum">     103 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         if (!_isAddressListed(targetAddress)) {</span></a>
-<a name="104"><span class="lineNum">     104 </span>                :<span class="lineCov">          1 :             revert RuleAddressSet_AddressNotFound();</span></a>
-<a name="105"><span class="lineNum">     105 </span>                :            :         }</a>
-<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">          1 :         _removeAddress(targetAddress);</span></a>
-<a name="107"><span class="lineNum">     107 </span>                :<span class="lineCov">          1 :         emit RemoveAddress(targetAddress);</span></a>
-<a name="108"><span class="lineNum">     108 </span>                :            :     }</a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">        105 :     function addAddress(address targetAddress) public onlyAddressListAdd {</span></a>
+<a name="76"><span class="lineNum">      76 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 101 times"> + </span>]:<span class="lineCov">        102 :         require(!_isAddressListed(targetAddress), RuleAddressSet_AddressAlreadyListed());</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">        101 :         _addAddress(targetAddress);</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">        101 :         emit AddAddress(targetAddress);</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     }</a>
+<a name="80"><span class="lineNum">      80 </span>                :            : </a>
+<a name="81"><span class="lineNum">      81 </span>                :            :     /**</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :      * @notice Removes a single address from the set.</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :      * @dev</a>
+<a name="84"><span class="lineNum">      84 </span>                :            :      * - Reverts if the address is not listed.</a>
+<a name="85"><span class="lineNum">      85 </span>                :            :      * - Accessible only by accounts with the `ADDRESS_LIST_REMOVE_ROLE`.</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :      * @param targetAddress The address to be removed.</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :      */</a>
+<a name="88"><span class="lineNum">      88 </span>                :<span class="lineCov">          8 :     function removeAddress(address targetAddress) public onlyAddressListRemove {</span></a>
+<a name="89"><span class="lineNum">      89 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 4 times"> + </span>]:<span class="lineCov">          5 :         require(_isAddressListed(targetAddress), RuleAddressSet_AddressNotFound());</span></a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">          4 :         _removeAddress(targetAddress);</span></a>
+<a name="91"><span class="lineNum">      91 </span>                :<span class="lineCov">          4 :         emit RemoveAddress(targetAddress);</span></a>
+<a name="92"><span class="lineNum">      92 </span>                :            :     }</a>
+<a name="93"><span class="lineNum">      93 </span>                :            : </a>
+<a name="94"><span class="lineNum">      94 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :                             ACCESS CONTROL</a>
+<a name="96"><span class="lineNum">      96 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="97"><span class="lineNum">      97 </span>                :            : </a>
+<a name="98"><span class="lineNum">      98 </span>                :<span class="lineCov">        275 :     modifier onlyAddressListAdd() {</span></a>
+<a name="99"><span class="lineNum">      99 </span>                :<span class="lineCov">        275 :         _authorizeAddressListAdd();</span></a>
+<a name="100"><span class="lineNum">     100 </span>                :            :         _;</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :     }</a>
+<a name="102"><span class="lineNum">     102 </span>                :            : </a>
+<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">          8 :     modifier onlyAddressListRemove() {</span></a>
+<a name="104"><span class="lineNum">     104 </span>                :<span class="lineCov">          8 :         _authorizeAddressListRemove();</span></a>
+<a name="105"><span class="lineNum">     105 </span>                :            :         _;</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :     }</a>
+<a name="107"><span class="lineNum">     107 </span>                :            : </a>
+<a name="108"><span class="lineNum">     108 </span>                :            :     function _authorizeAddressListAdd() internal view virtual;</a>
 <a name="109"><span class="lineNum">     109 </span>                :            : </a>
-<a name="110"><span class="lineNum">     110 </span>                :            :     /**</a>
-<a name="111"><span class="lineNum">     111 </span>                :            :      * @notice Returns the total number of currently listed addresses.</a>
-<a name="112"><span class="lineNum">     112 </span>                :            :      * @return count The number of listed addresses.</a>
-<a name="113"><span class="lineNum">     113 </span>                :            :      */</a>
-<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">         24 :     function listedAddressCount() public view returns (uint256 count) {</span></a>
-<a name="115"><span class="lineNum">     115 </span>                :<span class="lineCov">         24 :         count = _listedAddressCount();</span></a>
-<a name="116"><span class="lineNum">     116 </span>                :            :     }</a>
-<a name="117"><span class="lineNum">     117 </span>                :            : </a>
-<a name="118"><span class="lineNum">     118 </span>                :            :     /**</a>
-<a name="119"><span class="lineNum">     119 </span>                :            :      * @notice Checks whether a specific address is currently listed.</a>
-<a name="120"><span class="lineNum">     120 </span>                :            :      * @param targetAddress The address to check.</a>
-<a name="121"><span class="lineNum">     121 </span>                :            :      * @return isListed True if listed, false otherwise.</a>
-<a name="122"><span class="lineNum">     122 </span>                :            :      */</a>
-<a name="123"><span class="lineNum">     123 </span>                :<span class="lineNoCov">          0 :     function contains(address targetAddress) public view override(IIdentityRegistryContains) returns (bool isListed) {</span></a>
-<a name="124"><span class="lineNum">     124 </span>                :<span class="lineNoCov">          0 :         isListed = _isAddressListed(targetAddress);</span></a>
-<a name="125"><span class="lineNum">     125 </span>                :            :     }</a>
-<a name="126"><span class="lineNum">     126 </span>                :            : </a>
-<a name="127"><span class="lineNum">     127 </span>                :            :     /**</a>
-<a name="128"><span class="lineNum">     128 </span>                :            :      * @notice Checks whether a specific address is currently listed.</a>
-<a name="129"><span class="lineNum">     129 </span>                :            :      * @param targetAddress The address to check.</a>
-<a name="130"><span class="lineNum">     130 </span>                :            :      * @return isListed True if listed, false otherwise.</a>
-<a name="131"><span class="lineNum">     131 </span>                :            :      */</a>
-<a name="132"><span class="lineNum">     132 </span>                :<span class="lineCov">         60 :     function isAddressListed(address targetAddress) public view returns (bool isListed) {</span></a>
-<a name="133"><span class="lineNum">     133 </span>                :<span class="lineCov">        219 :         isListed = _isAddressListed(targetAddress);</span></a>
-<a name="134"><span class="lineNum">     134 </span>                :            :     }</a>
-<a name="135"><span class="lineNum">     135 </span>                :            : </a>
-<a name="136"><span class="lineNum">     136 </span>                :            :     /**</a>
-<a name="137"><span class="lineNum">     137 </span>                :            :      * @notice Checks multiple addresses in a single call.</a>
-<a name="138"><span class="lineNum">     138 </span>                :            :      * @param targetAddresses Array of addresses to check.</a>
-<a name="139"><span class="lineNum">     139 </span>                :            :      * @return results Array of booleans corresponding to listing status.</a>
-<a name="140"><span class="lineNum">     140 </span>                :            :      */</a>
-<a name="141"><span class="lineNum">     141 </span>                :<span class="lineCov">         84 :     function areAddressesListed(address[] memory targetAddresses) public view returns (bool[] memory results) {</span></a>
-<a name="142"><span class="lineNum">     142 </span>                :<span class="lineCov">         84 :         results = new bool[](targetAddresses.length);</span></a>
-<a name="143"><span class="lineNum">     143 </span>                :<span class="lineCov">         84 :         for (uint256 i = 0; i &lt; targetAddresses.length; ++i) {</span></a>
-<a name="144"><span class="lineNum">     144 </span>                :<span class="lineCov">        191 :             results[i] = _isAddressListed(targetAddresses[i]);</span></a>
-<a name="145"><span class="lineNum">     145 </span>                :            :         }</a>
-<a name="146"><span class="lineNum">     146 </span>                :            :     }</a>
-<a name="147"><span class="lineNum">     147 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="148"><span class="lineNum">     148 </span>                :            :                              ERC-2771 META TX</a>
-<a name="149"><span class="lineNum">     149 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="150"><span class="lineNum">     150 </span>                :            : </a>
-<a name="151"><span class="lineNum">     151 </span>                :            :     /// @inheritdoc ERC2771Context</a>
-<a name="152"><span class="lineNum">     152 </span>                :<span class="lineCov">        207 :     function _msgSender() internal view override(ERC2771Context, Context) returns (address sender) {</span></a>
-<a name="153"><span class="lineNum">     153 </span>                :<span class="lineCov">        207 :         return ERC2771Context._msgSender();</span></a>
-<a name="154"><span class="lineNum">     154 </span>                :            :     }</a>
-<a name="155"><span class="lineNum">     155 </span>                :            : </a>
-<a name="156"><span class="lineNum">     156 </span>                :            :     /// @inheritdoc ERC2771Context</a>
-<a name="157"><span class="lineNum">     157 </span>                :<span class="lineNoCov">          0 :     function _msgData() internal view override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
-<a name="158"><span class="lineNum">     158 </span>                :<span class="lineNoCov">          0 :         return ERC2771Context._msgData();</span></a>
-<a name="159"><span class="lineNum">     159 </span>                :            :     }</a>
-<a name="160"><span class="lineNum">     160 </span>                :            : </a>
-<a name="161"><span class="lineNum">     161 </span>                :            :     /// @inheritdoc ERC2771Context</a>
-<a name="162"><span class="lineNum">     162 </span>                :<span class="lineCov">        207 :     function _contextSuffixLength() internal view override(ERC2771Context, Context) returns (uint256) {</span></a>
-<a name="163"><span class="lineNum">     163 </span>                :<span class="lineCov">        207 :         return ERC2771Context._contextSuffixLength();</span></a>
-<a name="164"><span class="lineNum">     164 </span>                :            :     }</a>
-<a name="165"><span class="lineNum">     165 </span>                :            : }</a>
+<a name="110"><span class="lineNum">     110 </span>                :            :     function _authorizeAddressListRemove() internal view virtual;</a>
+<a name="111"><span class="lineNum">     111 </span>                :            : </a>
+<a name="112"><span class="lineNum">     112 </span>                :            :     /**</a>
+<a name="113"><span class="lineNum">     113 </span>                :            :      * @notice Returns the total number of currently listed addresses.</a>
+<a name="114"><span class="lineNum">     114 </span>                :            :      * @return count The number of listed addresses.</a>
+<a name="115"><span class="lineNum">     115 </span>                :            :      */</a>
+<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">        536 :     function listedAddressCount() public view returns (uint256 count) {</span></a>
+<a name="117"><span class="lineNum">     117 </span>                :<span class="lineCov">        536 :         count = _listedAddressCount();</span></a>
+<a name="118"><span class="lineNum">     118 </span>                :            :     }</a>
+<a name="119"><span class="lineNum">     119 </span>                :            : </a>
+<a name="120"><span class="lineNum">     120 </span>                :            :     /**</a>
+<a name="121"><span class="lineNum">     121 </span>                :            :      * @notice Checks whether a specific address is currently listed.</a>
+<a name="122"><span class="lineNum">     122 </span>                :            :      * @param targetAddress The address to check.</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :      * @return isListed True if listed, false otherwise.</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :      */</a>
+<a name="125"><span class="lineNum">     125 </span>                :<span class="lineCov">          2 :     function contains(address targetAddress) public view override(IIdentityRegistryContains) returns (bool isListed) {</span></a>
+<a name="126"><span class="lineNum">     126 </span>                :<span class="lineCov">          2 :         isListed = _isAddressListed(targetAddress);</span></a>
+<a name="127"><span class="lineNum">     127 </span>                :            :     }</a>
+<a name="128"><span class="lineNum">     128 </span>                :            : </a>
+<a name="129"><span class="lineNum">     129 </span>                :            :     /**</a>
+<a name="130"><span class="lineNum">     130 </span>                :            :      * @notice Checks whether a specific address is currently listed.</a>
+<a name="131"><span class="lineNum">     131 </span>                :            :      * @param targetAddress The address to check.</a>
+<a name="132"><span class="lineNum">     132 </span>                :            :      * @return isListed True if listed, false otherwise.</a>
+<a name="133"><span class="lineNum">     133 </span>                :            :      */</a>
+<a name="134"><span class="lineNum">     134 </span>                :<span class="lineCov">         67 :     function isAddressListed(address targetAddress) public view returns (bool isListed) {</span></a>
+<a name="135"><span class="lineNum">     135 </span>                :<span class="lineCov">        383 :         isListed = _isAddressListed(targetAddress);</span></a>
+<a name="136"><span class="lineNum">     136 </span>                :            :     }</a>
+<a name="137"><span class="lineNum">     137 </span>                :            : </a>
+<a name="138"><span class="lineNum">     138 </span>                :            :     /**</a>
+<a name="139"><span class="lineNum">     139 </span>                :            :      * @notice Checks multiple addresses in a single call.</a>
+<a name="140"><span class="lineNum">     140 </span>                :            :      * @param targetAddresses Array of addresses to check.</a>
+<a name="141"><span class="lineNum">     141 </span>                :            :      * @return results Array of booleans corresponding to listing status.</a>
+<a name="142"><span class="lineNum">     142 </span>                :            :      */</a>
+<a name="143"><span class="lineNum">     143 </span>                :<span class="lineCov">        108 :     function areAddressesListed(address[] memory targetAddresses) public view returns (bool[] memory results) {</span></a>
+<a name="144"><span class="lineNum">     144 </span>                :<span class="lineCov">        108 :         results = new bool[](targetAddresses.length);</span></a>
+<a name="145"><span class="lineNum">     145 </span>                :<span class="lineCov">        108 :         for (uint256 i = 0; i &lt; targetAddresses.length; ++i) {</span></a>
+<a name="146"><span class="lineNum">     146 </span>                :<span class="lineCov">        244 :             results[i] = _isAddressListed(targetAddresses[i]);</span></a>
+<a name="147"><span class="lineNum">     147 </span>                :            :         }</a>
+<a name="148"><span class="lineNum">     148 </span>                :            :     }</a>
+<a name="149"><span class="lineNum">     149 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="150"><span class="lineNum">     150 </span>                :            :                              ERC-2771 META TX</a>
+<a name="151"><span class="lineNum">     151 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="152"><span class="lineNum">     152 </span>                :            : </a>
+<a name="153"><span class="lineNum">     153 </span>                :            :     /// @inheritdoc ERC2771Context</a>
+<a name="154"><span class="lineNum">     154 </span>                :<span class="lineCov">        882 :     function _msgSender() internal view virtual override(ERC2771Context) returns (address sender) {</span></a>
+<a name="155"><span class="lineNum">     155 </span>                :<span class="lineCov">        882 :         return ERC2771Context._msgSender();</span></a>
+<a name="156"><span class="lineNum">     156 </span>                :            :     }</a>
+<a name="157"><span class="lineNum">     157 </span>                :            : </a>
+<a name="158"><span class="lineNum">     158 </span>                :            :     /// @inheritdoc ERC2771Context</a>
+<a name="159"><span class="lineNum">     159 </span>                :<span class="lineCov">          4 :     function _msgData() internal view virtual override(ERC2771Context) returns (bytes calldata) {</span></a>
+<a name="160"><span class="lineNum">     160 </span>                :<span class="lineCov">          4 :         return ERC2771Context._msgData();</span></a>
+<a name="161"><span class="lineNum">     161 </span>                :            :     }</a>
+<a name="162"><span class="lineNum">     162 </span>                :            : </a>
+<a name="163"><span class="lineNum">     163 </span>                :            :     /// @inheritdoc ERC2771Context</a>
+<a name="164"><span class="lineNum">     164 </span>                :<span class="lineCov">        886 :     function _contextSuffixLength() internal view virtual override(ERC2771Context) returns (uint256) {</span></a>
+<a name="165"><span class="lineNum">     165 </span>                :<span class="lineCov">        886 :         return ERC2771Context._contextSuffixLength();</span></a>
+<a name="166"><span class="lineNum">     166 </span>                :            :     }</a>
+<a name="167"><span class="lineNum">     167 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
@@ -241,7 +243,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html
similarity index 56%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html
index 715669b..a58da58 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func-sort-c.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSetInternal.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (<a href="RuleAddressSetInternal.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (<a href="RuleAddressSetInternal.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -49,54 +49,54 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntryHi">-</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleAddressSetInternal.sol.func.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleAddressSetInternal.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#65">RuleAddressSetInternal._removeAddress</a></td>
-              <td class="coverFnHi">1</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#83">RuleAddressSetInternal._removeAddress</a></td>
+              <td class="coverFnHi">4</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#47">RuleAddressSetInternal._removeAddresses</a></td>
-              <td class="coverFnHi">3</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#75">RuleAddressSetInternal._addAddress</a></td>
+              <td class="coverFnHi">101</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#34">RuleAddressSetInternal._addAddresses</a></td>
-              <td class="coverFnHi">16</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#58">RuleAddressSetInternal._removeAddresses</a></td>
+              <td class="coverFnHi">259</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#73">RuleAddressSetInternal._listedAddressCount</a></td>
-              <td class="coverFnHi">24</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#36">RuleAddressSetInternal._addAddresses</a></td>
+              <td class="coverFnHi">274</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#57">RuleAddressSetInternal._addAddress</a></td>
-              <td class="coverFnHi">50</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#91">RuleAddressSetInternal._listedAddressCount</a></td>
+              <td class="coverFnHi">536</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#82">RuleAddressSetInternal._isAddressListed</a></td>
-              <td class="coverFnHi">463</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#100">RuleAddressSetInternal._isAddressListed</a></td>
+              <td class="coverFnHi">738</td>
             </tr>
   </table>
   <br>
   </center>
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html
similarity index 56%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html
index bfbd673..c1510d8 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.func.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSetInternal.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (<a href="RuleAddressSetInternal.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (<a href="RuleAddressSetInternal.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -49,54 +49,54 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntryHi">-</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleAddressSetInternal.sol.func-sort-c.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleAddressSetInternal.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#57">RuleAddressSetInternal._addAddress</a></td>
-              <td class="coverFnHi">50</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#75">RuleAddressSetInternal._addAddress</a></td>
+              <td class="coverFnHi">101</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#34">RuleAddressSetInternal._addAddresses</a></td>
-              <td class="coverFnHi">16</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#36">RuleAddressSetInternal._addAddresses</a></td>
+              <td class="coverFnHi">274</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#82">RuleAddressSetInternal._isAddressListed</a></td>
-              <td class="coverFnHi">463</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#100">RuleAddressSetInternal._isAddressListed</a></td>
+              <td class="coverFnHi">738</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#73">RuleAddressSetInternal._listedAddressCount</a></td>
-              <td class="coverFnHi">24</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#91">RuleAddressSetInternal._listedAddressCount</a></td>
+              <td class="coverFnHi">536</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#65">RuleAddressSetInternal._removeAddress</a></td>
-              <td class="coverFnHi">1</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#83">RuleAddressSetInternal._removeAddress</a></td>
+              <td class="coverFnHi">4</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#47">RuleAddressSetInternal._removeAddresses</a></td>
-              <td class="coverFnHi">3</td>
+              <td class="coverFn"><a href="RuleAddressSetInternal.sol.gcov.html#58">RuleAddressSetInternal._removeAddresses</a></td>
+              <td class="coverFnHi">259</td>
             </tr>
   </table>
   <br>
   </center>
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html
similarity index 67%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html
index c60105a..9518c01 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/RuleAddressSetInternal.sol.gcov.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - abstract/RuleAddressSet/RuleAddressSetInternal.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">validation/abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (source / <a href="RuleAddressSetInternal.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleAddressSet</a> - RuleAddressSetInternal.sol<span style="font-size: 80%;"> (source / <a href="RuleAddressSetInternal.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -49,16 +49,16 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntry">0</td>
-            <td class="headerCovTableEntryHi">-</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <table cellpadding=0 cellspacing=0 border=0>
@@ -103,59 +103,77 @@
 <a name="32"><span class="lineNum">      32 </span>                :            :      * - Does not revert if an address is already listed.</a>
 <a name="33"><span class="lineNum">      33 </span>                :            :      * - Skips existing entries silently.</a>
 <a name="34"><span class="lineNum">      34 </span>                :            :      * @param addressesToAdd The array of addresses to add.</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :      */</a>
-<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">         16 :     function _addAddresses(address[] calldata addressesToAdd) internal {</span></a>
-<a name="37"><span class="lineNum">      37 </span>                :<span class="lineCov">         16 :         for (uint256 i = 0; i &lt; addressesToAdd.length; ++i) {</span></a>
-<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">         34 :             _listedAddresses.add(addressesToAdd[i]);</span></a>
-<a name="39"><span class="lineNum">      39 </span>                :            :         }</a>
-<a name="40"><span class="lineNum">      40 </span>                :            :     }</a>
-<a name="41"><span class="lineNum">      41 </span>                :            : </a>
-<a name="42"><span class="lineNum">      42 </span>                :            :     /**</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :      * @notice Removes multiple addresses from the set.</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :      * @dev</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :      * - Does not revert if an address is not found.</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :      * - Skips non-existing entries silently.</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :      * @param addressesToRemove The array of addresses to remove.</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :      */</a>
-<a name="49"><span class="lineNum">      49 </span>                :<span class="lineCov">          3 :     function _removeAddresses(address[] calldata addressesToRemove) internal {</span></a>
-<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">          3 :         for (uint256 i = 0; i &lt; addressesToRemove.length; ++i) {</span></a>
-<a name="51"><span class="lineNum">      51 </span>                :<span class="lineCov">          7 :             _listedAddresses.remove(addressesToRemove[i]);</span></a>
-<a name="52"><span class="lineNum">      52 </span>                :            :         }</a>
-<a name="53"><span class="lineNum">      53 </span>                :            :     }</a>
-<a name="54"><span class="lineNum">      54 </span>                :            : </a>
-<a name="55"><span class="lineNum">      55 </span>                :            :     /**</a>
-<a name="56"><span class="lineNum">      56 </span>                :            :      * @notice Adds a single address to the set.</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :      * @param targetAddress The address to add.</a>
-<a name="58"><span class="lineNum">      58 </span>                :            :      */</a>
-<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">         50 :     function _addAddress(address targetAddress) internal {</span></a>
-<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">         50 :         _listedAddresses.add(targetAddress);</span></a>
-<a name="61"><span class="lineNum">      61 </span>                :            :     }</a>
-<a name="62"><span class="lineNum">      62 </span>                :            : </a>
-<a name="63"><span class="lineNum">      63 </span>                :            :     /**</a>
-<a name="64"><span class="lineNum">      64 </span>                :            :      * @notice Removes a single address from the set.</a>
-<a name="65"><span class="lineNum">      65 </span>                :            :      * @param targetAddress The address to remove.</a>
-<a name="66"><span class="lineNum">      66 </span>                :            :      */</a>
-<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">          1 :     function _removeAddress(address targetAddress) internal {</span></a>
-<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">          1 :         _listedAddresses.remove(targetAddress);</span></a>
-<a name="69"><span class="lineNum">      69 </span>                :            :     }</a>
-<a name="70"><span class="lineNum">      70 </span>                :            : </a>
-<a name="71"><span class="lineNum">      71 </span>                :            :     /**</a>
-<a name="72"><span class="lineNum">      72 </span>                :            :      * @notice Returns the total number of listed addresses.</a>
-<a name="73"><span class="lineNum">      73 </span>                :            :      * @return count The number of listed addresses.</a>
-<a name="74"><span class="lineNum">      74 </span>                :            :      */</a>
-<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">         24 :     function _listedAddressCount() internal view returns (uint256 count) {</span></a>
-<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">         24 :         count = _listedAddresses.length();</span></a>
-<a name="77"><span class="lineNum">      77 </span>                :            :     }</a>
-<a name="78"><span class="lineNum">      78 </span>                :            : </a>
-<a name="79"><span class="lineNum">      79 </span>                :            :     /**</a>
-<a name="80"><span class="lineNum">      80 </span>                :            :      * @notice Checks if an address is listed.</a>
-<a name="81"><span class="lineNum">      81 </span>                :            :      * @param targetAddress The address to check.</a>
-<a name="82"><span class="lineNum">      82 </span>                :            :      * @return isListed True if the address is listed, false otherwise.</a>
-<a name="83"><span class="lineNum">      83 </span>                :            :      */</a>
-<a name="84"><span class="lineNum">      84 </span>                :<span class="lineCov">        463 :     function _isAddressListed(address targetAddress) internal view returns (bool isListed) {</span></a>
-<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">        463 :         isListed = _listedAddresses.contains(targetAddress);</span></a>
-<a name="86"><span class="lineNum">      86 </span>                :            :     }</a>
-<a name="87"><span class="lineNum">      87 </span>                :            : }</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      * @return added The number of newly added addresses.</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :      * @return skipped The number of addresses that were already listed.</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :      */</a>
+<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">        274 :     function _addAddresses(address[] calldata addressesToAdd)</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         internal</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         returns (uint256 added, uint256 skipped)</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :     {</a>
+<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">        274 :         for (uint256 i = 0; i &lt; addressesToAdd.length; ++i) {</span></a>
+<a name="43"><span class="lineNum">      43 </span>        [<span class="branchCov" title="Branch 0 was taken 548 times"> + </span><span class="branchCov" title="Branch 1 was taken 258 times"> + </span>]:<span class="lineCov">        806 :             if (_listedAddresses.add(addressesToAdd[i])) {</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">        548 :                 added += 1;</span></a>
+<a name="45"><span class="lineNum">      45 </span>                :            :             } else {</a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">        258 :                 skipped += 1;</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :             }</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         }</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     }</a>
+<a name="50"><span class="lineNum">      50 </span>                :            : </a>
+<a name="51"><span class="lineNum">      51 </span>                :            :     /**</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :      * @notice Removes multiple addresses from the set.</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :      * @dev</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :      * - Does not revert if an address is not found.</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :      * - Skips non-existing entries silently.</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :      * @param addressesToRemove The array of addresses to remove.</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :      * @return removed The number of addresses removed.</a>
+<a name="58"><span class="lineNum">      58 </span>                :            :      * @return skipped The number of addresses that were not listed.</a>
+<a name="59"><span class="lineNum">      59 </span>                :            :      */</a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">        259 :     function _removeAddresses(address[] calldata addressesToRemove)</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :            :         internal</a>
+<a name="62"><span class="lineNum">      62 </span>                :            :         returns (uint256 removed, uint256 skipped)</a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     {</a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">        259 :         for (uint256 i = 0; i &lt; addressesToRemove.length; ++i) {</span></a>
+<a name="65"><span class="lineNum">      65 </span>        [<span class="branchCov" title="Branch 0 was taken 518 times"> + </span><span class="branchCov" title="Branch 1 was taken 257 times"> + </span>]:<span class="lineCov">        775 :             if (_listedAddresses.remove(addressesToRemove[i])) {</span></a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">        518 :                 removed += 1;</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :            :             } else {</a>
+<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">        257 :                 skipped += 1;</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :            :             }</a>
+<a name="70"><span class="lineNum">      70 </span>                :            :         }</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :     }</a>
+<a name="72"><span class="lineNum">      72 </span>                :            : </a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     /**</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :      * @notice Adds a single address to the set.</a>
+<a name="75"><span class="lineNum">      75 </span>                :            :      * @param targetAddress The address to add.</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :      */</a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">        101 :     function _addAddress(address targetAddress) internal virtual {</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">        101 :         _listedAddresses.add(targetAddress);</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     }</a>
+<a name="80"><span class="lineNum">      80 </span>                :            : </a>
+<a name="81"><span class="lineNum">      81 </span>                :            :     /**</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :      * @notice Removes a single address from the set.</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :      * @param targetAddress The address to remove.</a>
+<a name="84"><span class="lineNum">      84 </span>                :            :      */</a>
+<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">          4 :     function _removeAddress(address targetAddress) internal virtual {</span></a>
+<a name="86"><span class="lineNum">      86 </span>                :<span class="lineCov">          4 :         _listedAddresses.remove(targetAddress);</span></a>
+<a name="87"><span class="lineNum">      87 </span>                :            :     }</a>
+<a name="88"><span class="lineNum">      88 </span>                :            : </a>
+<a name="89"><span class="lineNum">      89 </span>                :            :     /**</a>
+<a name="90"><span class="lineNum">      90 </span>                :            :      * @notice Returns the total number of listed addresses.</a>
+<a name="91"><span class="lineNum">      91 </span>                :            :      * @return count The number of listed addresses.</a>
+<a name="92"><span class="lineNum">      92 </span>                :            :      */</a>
+<a name="93"><span class="lineNum">      93 </span>                :<span class="lineCov">        536 :     function _listedAddressCount() internal view virtual returns (uint256 count) {</span></a>
+<a name="94"><span class="lineNum">      94 </span>                :<span class="lineCov">        536 :         count = _listedAddresses.length();</span></a>
+<a name="95"><span class="lineNum">      95 </span>                :            :     }</a>
+<a name="96"><span class="lineNum">      96 </span>                :            : </a>
+<a name="97"><span class="lineNum">      97 </span>                :            :     /**</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :      * @notice Checks if an address is listed.</a>
+<a name="99"><span class="lineNum">      99 </span>                :            :      * @param targetAddress The address to check.</a>
+<a name="100"><span class="lineNum">     100 </span>                :            :      * @return isListed True if the address is listed, false otherwise.</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :      */</a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">        738 :     function _isAddressListed(address targetAddress) internal view virtual returns (bool isListed) {</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">        738 :         isListed = _listedAddresses.contains(targetAddress);</span></a>
+<a name="104"><span class="lineNum">     104 </span>                :            :     }</a>
+<a name="105"><span class="lineNum">     105 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
@@ -163,7 +181,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/index-sort-b.html b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-b.html
similarity index 74%
rename from doc/coverage/coverage/validation/abstract/index-sort-b.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/index-sort-b.html
index 5fe0919..f299290 100644
--- a/doc/coverage/coverage/validation/abstract/index-sort-b.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-b.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract</title>
+  <title>LCOV - lcov.info - abstract/RuleAddressSet</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - validation/abstract</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleAddressSet</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,26 +31,26 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">29</td>
-            <td class="headerCovTableEntry">31</td>
-            <td class="headerCovTableEntryHi">93.5 %</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -82,28 +82,28 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleValidateTransfer.sol.gcov.html">RuleValidateTransfer.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../amber.png" width=80 height=10 alt="80.0%"><img src="../../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">8 / 10</td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">4 / 5</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">34 / 34</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleWhitelistCommon.sol.gcov.html">RuleWhitelistCommon.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">21 / 21</td>
+      <td class="coverNumHi">18 / 18</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">6 / 6</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/validation/abstract/index-sort-f.html b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-f.html
similarity index 74%
rename from doc/coverage/coverage/validation/abstract/index-sort-f.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/index-sort-f.html
index b7e1816..3713f5e 100644
--- a/doc/coverage/coverage/validation/abstract/index-sort-f.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-f.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract</title>
+  <title>LCOV - lcov.info - abstract/RuleAddressSet</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - validation/abstract</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleAddressSet</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,26 +31,26 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">29</td>
-            <td class="headerCovTableEntry">31</td>
-            <td class="headerCovTableEntryHi">93.5 %</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -82,28 +82,28 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleValidateTransfer.sol.gcov.html">RuleValidateTransfer.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../amber.png" width=80 height=10 alt="80.0%"><img src="../../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">8 / 10</td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">4 / 5</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleWhitelistCommon.sol.gcov.html">RuleWhitelistCommon.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">21 / 21</td>
+      <td class="coverNumHi">34 / 34</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">6 / 6</td>
+      <td class="coverNumHi">13 / 13</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/validation/abstract/index-sort-l.html b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-l.html
similarity index 74%
rename from doc/coverage/coverage/validation/abstract/index-sort-l.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/index-sort-l.html
index f752721..2a0de5c 100644
--- a/doc/coverage/coverage/validation/abstract/index-sort-l.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/index-sort-l.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract</title>
+  <title>LCOV - lcov.info - abstract/RuleAddressSet</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - validation/abstract</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleAddressSet</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,26 +31,26 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">29</td>
-            <td class="headerCovTableEntry">31</td>
-            <td class="headerCovTableEntryHi">93.5 %</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -82,28 +82,28 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleValidateTransfer.sol.gcov.html">RuleValidateTransfer.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../amber.png" width=80 height=10 alt="80.0%"><img src="../../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">8 / 10</td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">4 / 5</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleWhitelistCommon.sol.gcov.html">RuleWhitelistCommon.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">21 / 21</td>
+      <td class="coverNumHi">34 / 34</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">6 / 6</td>
+      <td class="coverNumHi">13 / 13</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/validation/abstract/index.html b/doc/coverage/coverage/abstract/RuleAddressSet/index.html
similarity index 74%
rename from doc/coverage/coverage/validation/abstract/index.html
rename to doc/coverage/coverage/abstract/RuleAddressSet/index.html
index 34817f4..9eb35f0 100644
--- a/doc/coverage/coverage/validation/abstract/index.html
+++ b/doc/coverage/coverage/abstract/RuleAddressSet/index.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract</title>
+  <title>LCOV - lcov.info - abstract/RuleAddressSet</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - validation/abstract</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleAddressSet</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,26 +31,26 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">29</td>
-            <td class="headerCovTableEntry">31</td>
-            <td class="headerCovTableEntryHi">93.5 %</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntry">52</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -82,28 +82,28 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleValidateTransfer.sol.gcov.html">RuleValidateTransfer.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../amber.png" width=80 height=10 alt="80.0%"><img src="../../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">8 / 10</td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">4 / 5</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">34 / 34</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleWhitelistCommon.sol.gcov.html">RuleWhitelistCommon.sol</a></td>
+      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">21 / 21</td>
+      <td class="coverNumHi">18 / 18</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">6 / 6</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func-sort-c.html b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func-sort-c.html
new file mode 100644
index 0000000..d226506
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func-sort-c.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980/RuleERC2980Internal.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleERC2980</a> - RuleERC2980Internal.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Internal.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleERC2980Internal.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#90">RuleERC2980Internal._removeFrozenlistAddresses</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#44">RuleERC2980Internal._removeWhitelistAddresses</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#77">RuleERC2980Internal._addFrozenlistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#31">RuleERC2980Internal._addWhitelistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#115">RuleERC2980Internal._frozenlistCount</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#107">RuleERC2980Internal._removeFrozenlistAddress</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#61">RuleERC2980Internal._removeWhitelistAddress</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#69">RuleERC2980Internal._whitelistCount</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#103">RuleERC2980Internal._addFrozenlistAddress</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#57">RuleERC2980Internal._addWhitelistAddress</a></td>
+              <td class="coverFnHi">39</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#65">RuleERC2980Internal._isWhitelisted</a></td>
+              <td class="coverFnHi">82</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#111">RuleERC2980Internal._isFrozen</a></td>
+              <td class="coverFnHi">90</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func.html b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func.html
new file mode 100644
index 0000000..446e1ca
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.func.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980/RuleERC2980Internal.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleERC2980</a> - RuleERC2980Internal.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Internal.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleERC2980Internal.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#103">RuleERC2980Internal._addFrozenlistAddress</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#77">RuleERC2980Internal._addFrozenlistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#57">RuleERC2980Internal._addWhitelistAddress</a></td>
+              <td class="coverFnHi">39</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#31">RuleERC2980Internal._addWhitelistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#115">RuleERC2980Internal._frozenlistCount</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#111">RuleERC2980Internal._isFrozen</a></td>
+              <td class="coverFnHi">90</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#65">RuleERC2980Internal._isWhitelisted</a></td>
+              <td class="coverFnHi">82</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#107">RuleERC2980Internal._removeFrozenlistAddress</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#90">RuleERC2980Internal._removeFrozenlistAddresses</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#61">RuleERC2980Internal._removeWhitelistAddress</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#44">RuleERC2980Internal._removeWhitelistAddresses</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Internal.sol.gcov.html#69">RuleERC2980Internal._whitelistCount</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.gcov.html b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.gcov.html
new file mode 100644
index 0000000..324d892
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/RuleERC2980Internal.sol.gcov.html
@@ -0,0 +1,205 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980/RuleERC2980Internal.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/RuleERC2980</a> - RuleERC2980Internal.sol<span style="font-size: 80%;"> (source / <a href="RuleERC2980Internal.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : /* ==== OpenZeppelin === */</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {EnumerableSet} from &quot;OZ/utils/structs/EnumerableSet.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : </a>
+<a name="7"><span class="lineNum">       7 </span>                :            : /**</a>
+<a name="8"><span class="lineNum">       8 </span>                :            :  * @title RuleERC2980Internal</a>
+<a name="9"><span class="lineNum">       9 </span>                :            :  * @notice Internal storage and helpers for two independent address sets:</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  *         a whitelist and a frozenlist, following the same pattern as {RuleAddressSetInternal}.</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @dev</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * - Whitelist: only whitelisted addresses may receive tokens.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * - Frozenlist: frozen addresses may neither send nor receive tokens.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * - Batch operations do not revert when individual entries are already present or absent.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  */</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : abstract contract RuleERC2980Internal {</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     using EnumerableSet for EnumerableSet.AddressSet;</a>
+<a name="18"><span class="lineNum">      18 </span>                :            : </a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :                              STATE VARIABLES</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="22"><span class="lineNum">      22 </span>                :            : </a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     /// @dev Addresses allowed to receive tokens.</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     EnumerableSet.AddressSet private _whitelist;</a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     /// @dev Addresses completely blocked from sending and receiving tokens.</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :     EnumerableSet.AddressSet private _frozenlist;</a>
+<a name="28"><span class="lineNum">      28 </span>                :            : </a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :                           WHITELIST — INTERNAL</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="32"><span class="lineNum">      32 </span>                :            : </a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          4 :     function _addWhitelistAddresses(address[] calldata addressesToAdd)</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :            :         internal</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :         returns (uint256 added, uint256 skipped)</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     {</a>
+<a name="37"><span class="lineNum">      37 </span>                :<span class="lineCov">          4 :         for (uint256 i = 0; i &lt; addressesToAdd.length; ++i) {</span></a>
+<a name="38"><span class="lineNum">      38 </span>        [<span class="branchCov" title="Branch 0 was taken 5 times"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          6 :             if (_whitelist.add(addressesToAdd[i])) {</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">          5 :                 added += 1;</span></a>
+<a name="40"><span class="lineNum">      40 </span>                :            :             } else {</a>
+<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">          1 :                 skipped += 1;</span></a>
+<a name="42"><span class="lineNum">      42 </span>                :            :             }</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         }</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     }</a>
+<a name="45"><span class="lineNum">      45 </span>                :            : </a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">          3 :     function _removeWhitelistAddresses(address[] calldata addressesToRemove)</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         internal</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         returns (uint256 removed, uint256 skipped)</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     {</a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">          3 :         for (uint256 i = 0; i &lt; addressesToRemove.length; ++i) {</span></a>
+<a name="51"><span class="lineNum">      51 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :             if (_whitelist.remove(addressesToRemove[i])) {</span></a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">          2 :                 removed += 1;</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :            :             } else {</a>
+<a name="54"><span class="lineNum">      54 </span>                :<span class="lineCov">          1 :                 skipped += 1;</span></a>
+<a name="55"><span class="lineNum">      55 </span>                :            :             }</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :         }</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :     }</a>
+<a name="58"><span class="lineNum">      58 </span>                :            : </a>
+<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">         39 :     function _addWhitelistAddress(address targetAddress) internal virtual {</span></a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">         39 :         _whitelist.add(targetAddress);</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :            :     }</a>
+<a name="62"><span class="lineNum">      62 </span>                :            : </a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">          4 :     function _removeWhitelistAddress(address targetAddress) internal virtual {</span></a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">          4 :         _whitelist.remove(targetAddress);</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :            :     }</a>
+<a name="66"><span class="lineNum">      66 </span>                :            : </a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">         82 :     function _isWhitelisted(address targetAddress) internal view virtual returns (bool) {</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">         82 :         return _whitelist.contains(targetAddress);</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :            :     }</a>
+<a name="70"><span class="lineNum">      70 </span>                :            : </a>
+<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">          5 :     function _whitelistCount() internal view virtual returns (uint256) {</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :<span class="lineCov">          5 :         return _whitelist.length();</span></a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     }</a>
+<a name="74"><span class="lineNum">      74 </span>                :            : </a>
+<a name="75"><span class="lineNum">      75 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :                          FROZENLIST — INTERNAL</a>
+<a name="77"><span class="lineNum">      77 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="78"><span class="lineNum">      78 </span>                :            : </a>
+<a name="79"><span class="lineNum">      79 </span>                :<span class="lineCov">          4 :     function _addFrozenlistAddresses(address[] calldata addressesToAdd)</span></a>
+<a name="80"><span class="lineNum">      80 </span>                :            :         internal</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :         returns (uint256 added, uint256 skipped)</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     {</a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">          4 :         for (uint256 i = 0; i &lt; addressesToAdd.length; ++i) {</span></a>
+<a name="84"><span class="lineNum">      84 </span>        [<span class="branchCov" title="Branch 0 was taken 5 times"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          6 :             if (_frozenlist.add(addressesToAdd[i])) {</span></a>
+<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">          5 :                 added += 1;</span></a>
+<a name="86"><span class="lineNum">      86 </span>                :            :             } else {</a>
+<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">          1 :                 skipped += 1;</span></a>
+<a name="88"><span class="lineNum">      88 </span>                :            :             }</a>
+<a name="89"><span class="lineNum">      89 </span>                :            :         }</a>
+<a name="90"><span class="lineNum">      90 </span>                :            :     }</a>
+<a name="91"><span class="lineNum">      91 </span>                :            : </a>
+<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">          2 :     function _removeFrozenlistAddresses(address[] calldata addressesToRemove)</span></a>
+<a name="93"><span class="lineNum">      93 </span>                :            :         internal</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         returns (uint256 removed, uint256 skipped)</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :     {</a>
+<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">          2 :         for (uint256 i = 0; i &lt; addressesToRemove.length; ++i) {</span></a>
+<a name="97"><span class="lineNum">      97 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :             if (_frozenlist.remove(addressesToRemove[i])) {</span></a>
+<a name="98"><span class="lineNum">      98 </span>                :<span class="lineCov">          1 :                 removed += 1;</span></a>
+<a name="99"><span class="lineNum">      99 </span>                :            :             } else {</a>
+<a name="100"><span class="lineNum">     100 </span>                :<span class="lineCov">          1 :                 skipped += 1;</span></a>
+<a name="101"><span class="lineNum">     101 </span>                :            :             }</a>
+<a name="102"><span class="lineNum">     102 </span>                :            :         }</a>
+<a name="103"><span class="lineNum">     103 </span>                :            :     }</a>
+<a name="104"><span class="lineNum">     104 </span>                :            : </a>
+<a name="105"><span class="lineNum">     105 </span>                :<span class="lineCov">         18 :     function _addFrozenlistAddress(address targetAddress) internal virtual {</span></a>
+<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">         18 :         _frozenlist.add(targetAddress);</span></a>
+<a name="107"><span class="lineNum">     107 </span>                :            :     }</a>
+<a name="108"><span class="lineNum">     108 </span>                :            : </a>
+<a name="109"><span class="lineNum">     109 </span>                :<span class="lineCov">          4 :     function _removeFrozenlistAddress(address targetAddress) internal virtual {</span></a>
+<a name="110"><span class="lineNum">     110 </span>                :<span class="lineCov">          4 :         _frozenlist.remove(targetAddress);</span></a>
+<a name="111"><span class="lineNum">     111 </span>                :            :     }</a>
+<a name="112"><span class="lineNum">     112 </span>                :            : </a>
+<a name="113"><span class="lineNum">     113 </span>                :<span class="lineCov">         90 :     function _isFrozen(address targetAddress) internal view virtual returns (bool) {</span></a>
+<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">         90 :         return _frozenlist.contains(targetAddress);</span></a>
+<a name="115"><span class="lineNum">     115 </span>                :            :     }</a>
+<a name="116"><span class="lineNum">     116 </span>                :            : </a>
+<a name="117"><span class="lineNum">     117 </span>                :<span class="lineCov">          4 :     function _frozenlistCount() internal view virtual returns (uint256) {</span></a>
+<a name="118"><span class="lineNum">     118 </span>                :<span class="lineCov">          4 :         return _frozenlist.length();</span></a>
+<a name="119"><span class="lineNum">     119 </span>                :            :     }</a>
+<a name="120"><span class="lineNum">     120 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/index-sort-b.html b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-b.html
new file mode 100644
index 0000000..446dbb6
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-b.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleERC2980</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Internal.sol.gcov.html">RuleERC2980Internal.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/index-sort-f.html b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-f.html
new file mode 100644
index 0000000..774722e
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-f.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleERC2980</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Internal.sol.gcov.html">RuleERC2980Internal.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/index-sort-l.html b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-l.html
new file mode 100644
index 0000000..c94493f
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/index-sort-l.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleERC2980</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Internal.sol.gcov.html">RuleERC2980Internal.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/RuleERC2980/index.html b/doc/coverage/coverage/abstract/RuleERC2980/index.html
new file mode 100644
index 0000000..07b52e2
--- /dev/null
+++ b/doc/coverage/coverage/abstract/RuleERC2980/index.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/RuleERC2980</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/RuleERC2980</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntry">36</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Internal.sol.gcov.html">RuleERC2980Internal.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func-sort-c.html
new file mode 100644
index 0000000..72252b1
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func-sort-c.html
@@ -0,0 +1,117 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleBlacklistBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleBlacklistBase.sol<span style="font-size: 80%;"> (<a href="RuleBlacklistBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleBlacklistBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#94">RuleBlacklistBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#111">RuleBlacklistBase._transferredFrom</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#44">RuleBlacklistBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#55">RuleBlacklistBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#32">RuleBlacklistBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#81">RuleBlacklistBase.transferred.0</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#103">RuleBlacklistBase._transferred</a></td>
+              <td class="coverFnHi">61</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#73">RuleBlacklistBase.supportsInterface</a></td>
+              <td class="coverFnHi">61</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#18">RuleBlacklistBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">106</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func.html
new file mode 100644
index 0000000..44a9b55
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.func.html
@@ -0,0 +1,117 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleBlacklistBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleBlacklistBase.sol<span style="font-size: 80%;"> (<a href="RuleBlacklistBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleBlacklistBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#18">RuleBlacklistBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">106</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#32">RuleBlacklistBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#103">RuleBlacklistBase._transferred</a></td>
+              <td class="coverFnHi">61</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#111">RuleBlacklistBase._transferredFrom</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#44">RuleBlacklistBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#55">RuleBlacklistBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#73">RuleBlacklistBase.supportsInterface</a></td>
+              <td class="coverFnHi">61</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#81">RuleBlacklistBase.transferred.0</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistBase.sol.gcov.html#94">RuleBlacklistBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.gcov.html
new file mode 100644
index 0000000..a3fe955
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleBlacklistBase.sol.gcov.html
@@ -0,0 +1,210 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleBlacklistBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleBlacklistBase.sol<span style="font-size: 80%;"> (source / <a href="RuleBlacklistBase.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {RuleAddressSet} from &quot;../RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleNFTAdapter} from &quot;../core/RuleNFTAdapter.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleTransferValidation} from &quot;../core/RuleTransferValidation.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleBlacklistInvariantStorage} from &quot;../RuleAddressSet/invariantStorage/RuleBlacklistInvariantStorage.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : </a>
+<a name="13"><span class="lineNum">      13 </span>                :            : /**</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @title RuleBlacklistBase</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * @notice Core blacklist logic without access-control policy.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  */</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : abstract contract RuleBlacklistBase is RuleAddressSet, RuleNFTAdapter, RuleBlacklistInvariantStorage {</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     constructor(address forwarderIrrevocable) RuleAddressSet(forwarderIrrevocable) {}</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">        106 :     function _detectTransferRestriction(address from, address to, uint256 /* value */ )</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         internal</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :         view</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :         override</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         returns (uint8)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     {</a>
+<a name="26"><span class="lineNum">      26 </span>        [<span class="branchCov" title="Branch 0 was taken 23 times"> + </span><span class="branchCov" title="Branch 1 was taken 64 times"> + </span>]:<span class="lineCov">        106 :         if (isAddressListed(from)) {</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">         23 :             return CODE_ADDRESS_FROM_IS_BLACKLISTED;</span></a>
+<a name="28"><span class="lineNum">      28 </span>           [<span class="branchCov" title="Branch 0 was taken 19 times"> + </span>]:<span class="lineCov">         83 :         } else if (isAddressListed(to)) {</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">         19 :             return CODE_ADDRESS_TO_IS_BLACKLISTED;</span></a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         }</a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">         64 :         return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     }</a>
+<a name="33"><span class="lineNum">      33 </span>                :            : </a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         22 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :            :         internal</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :         view</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :         override</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         returns (uint8)</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :     {</a>
+<a name="40"><span class="lineNum">      40 </span>           [<span class="branchCov" title="Branch 0 was taken 8 times"> + </span>]:<span class="lineCov">         22 :         if (isAddressListed(spender)) {</span></a>
+<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">          8 :             return CODE_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
+<a name="42"><span class="lineNum">      42 </span>                :            :         }</a>
+<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">         14 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     }</a>
+<a name="45"><span class="lineNum">      45 </span>                :            : </a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">          4 :     function canReturnTransferRestrictionCode(uint8 restrictionCode)</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         public</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         pure</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         virtual</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :         override(IRule)</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         returns (bool)</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :     {</a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">          4 :         return restrictionCode == CODE_ADDRESS_FROM_IS_BLACKLISTED || restrictionCode == CODE_ADDRESS_TO_IS_BLACKLISTED</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :<span class="lineCov">          1 :             || restrictionCode == CODE_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
+<a name="55"><span class="lineNum">      55 </span>                :            :     }</a>
+<a name="56"><span class="lineNum">      56 </span>                :            : </a>
+<a name="57"><span class="lineNum">      57 </span>                :<span class="lineCov">         12 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="58"><span class="lineNum">      58 </span>                :            :         public</a>
+<a name="59"><span class="lineNum">      59 </span>                :            :         pure</a>
+<a name="60"><span class="lineNum">      60 </span>                :            :         virtual</a>
+<a name="61"><span class="lineNum">      61 </span>                :            :         override(IERC1404)</a>
+<a name="62"><span class="lineNum">      62 </span>                :            :         returns (string memory)</a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     {</a>
+<a name="64"><span class="lineNum">      64 </span>        [<span class="branchCov" title="Branch 0 was taken 5 times"> + </span><span class="branchCov" title="Branch 1 was taken 3 times"> + </span>]:<span class="lineCov">         12 :         if (restrictionCode == CODE_ADDRESS_FROM_IS_BLACKLISTED) {</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">          5 :             return TEXT_ADDRESS_FROM_IS_BLACKLISTED;</span></a>
+<a name="66"><span class="lineNum">      66 </span>        [<span class="branchCov" title="Branch 0 was taken 3 times"> + </span><span class="branchCov" title="Branch 1 was taken 3 times"> + </span>]:<span class="lineCov">          7 :         } else if (restrictionCode == CODE_ADDRESS_TO_IS_BLACKLISTED) {</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">          3 :             return TEXT_ADDRESS_TO_IS_BLACKLISTED;</span></a>
+<a name="68"><span class="lineNum">      68 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 3 times"> + </span>]:<span class="lineCov">          4 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_IS_BLACKLISTED) {</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
+<a name="70"><span class="lineNum">      70 </span>                :            :         } else {</a>
+<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">          3 :             return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         }</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     }</a>
+<a name="74"><span class="lineNum">      74 </span>                :            : </a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">         61 :     function supportsInterface(bytes4 interfaceId) public view virtual override(RuleTransferValidation) returns (bool) {</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">         61 :         return RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :            :     }</a>
+<a name="78"><span class="lineNum">      78 </span>                :            : </a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     /**</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :      * @inheritdoc IERC3643IComplianceContract</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :      * @dev Validation only; does not modify state.</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :      */</a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">         58 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="84"><span class="lineNum">      84 </span>                :            :         public</a>
+<a name="85"><span class="lineNum">      85 </span>                :            :         view</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :         virtual</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :     {</a>
+<a name="89"><span class="lineNum">      89 </span>                :<span class="lineCov">         58 :         _transferred(from, to, value);</span></a>
+<a name="90"><span class="lineNum">      90 </span>                :            :     }</a>
+<a name="91"><span class="lineNum">      91 </span>                :            : </a>
+<a name="92"><span class="lineNum">      92 </span>                :            :     /**</a>
+<a name="93"><span class="lineNum">      93 </span>                :            :      * @inheritdoc IRuleEngine</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :      * @dev Validation only; does not modify state.</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :      */</a>
+<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :            :         public</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :         view</a>
+<a name="99"><span class="lineNum">      99 </span>                :            :         virtual</a>
+<a name="100"><span class="lineNum">     100 </span>                :            :         override(IRuleEngine)</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :     {</a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">          2 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :            :     }</a>
+<a name="104"><span class="lineNum">     104 </span>                :            : </a>
+<a name="105"><span class="lineNum">     105 </span>                :<span class="lineCov">         61 :     function _transferred(address from, address to, uint256 value) internal view virtual override {</span></a>
+<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">         61 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="107"><span class="lineNum">     107 </span>        [<span class="branchCov" title="Branch 0 was taken 15 times"> + </span><span class="branchCov" title="Branch 1 was taken 46 times"> + </span>]:<span class="lineCov">         61 :         require(</span></a>
+<a name="108"><span class="lineNum">     108 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="109"><span class="lineNum">     109 </span>                :            :             RuleBlacklist_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="110"><span class="lineNum">     110 </span>                :            :         );</a>
+<a name="111"><span class="lineNum">     111 </span>                :            :     }</a>
+<a name="112"><span class="lineNum">     112 </span>                :            : </a>
+<a name="113"><span class="lineNum">     113 </span>                :<span class="lineCov">          4 :     function _transferredFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="114"><span class="lineNum">     114 </span>                :            :         internal</a>
+<a name="115"><span class="lineNum">     115 </span>                :            :         view</a>
+<a name="116"><span class="lineNum">     116 </span>                :            :         virtual</a>
+<a name="117"><span class="lineNum">     117 </span>                :            :         override</a>
+<a name="118"><span class="lineNum">     118 </span>                :            :     {</a>
+<a name="119"><span class="lineNum">     119 </span>                :<span class="lineCov">          4 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="120"><span class="lineNum">     120 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          4 :         require(</span></a>
+<a name="121"><span class="lineNum">     121 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="122"><span class="lineNum">     122 </span>                :            :             RuleBlacklist_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :         );</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :     }</a>
+<a name="125"><span class="lineNum">     125 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func-sort-c.html
new file mode 100644
index 0000000..b58d1b5
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func-sort-c.html
@@ -0,0 +1,213 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleERC2980Base.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleERC2980Base.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Base.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleERC2980Base.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#327">RuleERC2980Base.areFrozen</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#246">RuleERC2980Base.areWhitelisted</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#338">RuleERC2980Base.supportsInterface</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#379">RuleERC2980Base._msgData</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#361">RuleERC2980Base.onlyFrozenlistRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#270">RuleERC2980Base.removeFrozenlistAddresses</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#91">RuleERC2980Base.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#108">RuleERC2980Base._transferredFrom</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#233">RuleERC2980Base.isVerified</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#320">RuleERC2980Base.frozenlist</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#306">RuleERC2980Base.frozenlistAddressCount</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#174">RuleERC2980Base.removeWhitelistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#82">RuleERC2980Base.transferred.0</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#100">RuleERC2980Base._transferred</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#125">RuleERC2980Base.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#137">RuleERC2980Base.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#224">RuleERC2980Base.whitelist</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#210">RuleERC2980Base.whitelistAddressCount</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#261">RuleERC2980Base.addFrozenlistAddresses</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#165">RuleERC2980Base.addWhitelistAddresses</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#356">RuleERC2980Base.onlyFrozenlistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#346">RuleERC2980Base.onlyWhitelistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#351">RuleERC2980Base.onlyWhitelistRemove</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#297">RuleERC2980Base.removeFrozenlistAddress</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#201">RuleERC2980Base.removeWhitelistAddress</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#65">RuleERC2980Base._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#313">RuleERC2980Base.isFrozen</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#217">RuleERC2980Base.isWhitelisted</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#45">RuleERC2980Base._detectTransferRestriction</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#283">RuleERC2980Base.addFrozenlistAddress</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#187">RuleERC2980Base.addWhitelistAddress</a></td>
+              <td class="coverFnHi">43</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#375">RuleERC2980Base._msgSender</a></td>
+              <td class="coverFnHi">267</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#383">RuleERC2980Base._contextSuffixLength</a></td>
+              <td class="coverFnHi">269</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func.html b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func.html
new file mode 100644
index 0000000..fa4bcca
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.func.html
@@ -0,0 +1,213 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleERC2980Base.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleERC2980Base.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Base.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleERC2980Base.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#383">RuleERC2980Base._contextSuffixLength</a></td>
+              <td class="coverFnHi">269</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#45">RuleERC2980Base._detectTransferRestriction</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#65">RuleERC2980Base._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#379">RuleERC2980Base._msgData</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#375">RuleERC2980Base._msgSender</a></td>
+              <td class="coverFnHi">267</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#100">RuleERC2980Base._transferred</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#108">RuleERC2980Base._transferredFrom</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#283">RuleERC2980Base.addFrozenlistAddress</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#261">RuleERC2980Base.addFrozenlistAddresses</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#187">RuleERC2980Base.addWhitelistAddress</a></td>
+              <td class="coverFnHi">43</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#165">RuleERC2980Base.addWhitelistAddresses</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#327">RuleERC2980Base.areFrozen</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#246">RuleERC2980Base.areWhitelisted</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#125">RuleERC2980Base.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#320">RuleERC2980Base.frozenlist</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#306">RuleERC2980Base.frozenlistAddressCount</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#313">RuleERC2980Base.isFrozen</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#233">RuleERC2980Base.isVerified</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#217">RuleERC2980Base.isWhitelisted</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#137">RuleERC2980Base.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#356">RuleERC2980Base.onlyFrozenlistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#361">RuleERC2980Base.onlyFrozenlistRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#346">RuleERC2980Base.onlyWhitelistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#351">RuleERC2980Base.onlyWhitelistRemove</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#297">RuleERC2980Base.removeFrozenlistAddress</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#270">RuleERC2980Base.removeFrozenlistAddresses</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#201">RuleERC2980Base.removeWhitelistAddress</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#174">RuleERC2980Base.removeWhitelistAddresses</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#338">RuleERC2980Base.supportsInterface</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#82">RuleERC2980Base.transferred.0</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#91">RuleERC2980Base.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#224">RuleERC2980Base.whitelist</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Base.sol.gcov.html#210">RuleERC2980Base.whitelistAddressCount</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.gcov.html
new file mode 100644
index 0000000..89784e8
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleERC2980Base.sol.gcov.html
@@ -0,0 +1,473 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleERC2980Base.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleERC2980Base.sol<span style="font-size: 80%;"> (source / <a href="RuleERC2980Base.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntry">102</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntry">33</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntry">25</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context} from &quot;../../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleERC2980Internal} from &quot;../RuleERC2980/RuleERC2980Internal.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleERC2980InvariantStorage} from &quot;../RuleERC2980/invariantStorage/RuleERC2980InvariantStorage.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleNFTAdapter} from &quot;../core/RuleNFTAdapter.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleTransferValidation} from &quot;../core/RuleTransferValidation.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /* ==== Interfaces === */</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {IERC2980} from &quot;../../../interfaces/IERC2980.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {IIdentityRegistryVerified} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : </a>
+<a name="17"><span class="lineNum">      17 </span>                :            : /**</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  * @title RuleERC2980Base</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :  * @notice Core ERC-2980 Swiss Compliant transfer restriction logic combining a whitelist and a frozenlist.</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :  * @dev</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :  * Transfer logic (frozenlist takes priority over whitelist):</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :  * 1. If `from`, `to`, or `spender` is frozen → transfer is blocked.</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :  * 2. If `to` is not whitelisted → transfer is blocked.</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :  * Note: `from` does NOT need to be whitelisted to send tokens it already holds.</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :  *</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :  * Provides public management functions for both lists with abstract authorization hooks</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :  * so concrete subclasses can plug in their preferred access-control mechanism.</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :  */</a>
+<a name="29"><span class="lineNum">      29 </span>                :            : abstract contract RuleERC2980Base is</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     MetaTxModuleStandalone,</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :     RuleERC2980Internal,</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     RuleERC2980InvariantStorage,</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     RuleNFTAdapter,</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     IERC2980,</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     IIdentityRegistryVerified</a>
+<a name="36"><span class="lineNum">      36 </span>                :            : {</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :                               CONSTRUCTOR</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="40"><span class="lineNum">      40 </span>                :            : </a>
+<a name="41"><span class="lineNum">      41 </span>                :            :     constructor(address forwarderIrrevocable) MetaTxModuleStandalone(forwarderIrrevocable) {}</a>
+<a name="42"><span class="lineNum">      42 </span>                :            : </a>
+<a name="43"><span class="lineNum">      43 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :                          TRANSFER RESTRICTION LOGIC</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="46"><span class="lineNum">      46 </span>                :            : </a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">         22 :     function _detectTransferRestriction(address from, address to, uint256 /* value */ )</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         internal</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         view</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :         virtual</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         override</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :         returns (uint8)</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :     {</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         // Frozenlist check has priority</a>
+<a name="55"><span class="lineNum">      55 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 14 times"> + </span>]:<span class="lineCov">         22 :         if (_isFrozen(from)) {</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_FROM_IS_FROZEN;</span></a>
+<a name="57"><span class="lineNum">      57 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">         18 :         } else if (_isFrozen(to)) {</span></a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_TO_IS_FROZEN;</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :            :         }</a>
+<a name="60"><span class="lineNum">      60 </span>                :            :         // Whitelist check: only the recipient must be whitelisted</a>
+<a name="61"><span class="lineNum">      61 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">         14 :         if (!_isWhitelisted(to)) {</span></a>
+<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :            :         }</a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">         10 :         return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :            :     }</a>
+<a name="66"><span class="lineNum">      66 </span>                :            : </a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">          8 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :            :         internal</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :         view</a>
+<a name="70"><span class="lineNum">      70 </span>                :            :         virtual</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :         override</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         returns (uint8)</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     {</a>
+<a name="74"><span class="lineNum">      74 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">          8 :         if (_isFrozen(spender)) {</span></a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_SPENDER_IS_FROZEN;</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :            :         }</a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">          4 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :            :     }</a>
+<a name="79"><span class="lineNum">      79 </span>                :            : </a>
+<a name="80"><span class="lineNum">      80 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :                         ERC-3643 / IRuleEngine HOOKS</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="83"><span class="lineNum">      83 </span>                :            : </a>
+<a name="84"><span class="lineNum">      84 </span>                :<span class="lineCov">          4 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="85"><span class="lineNum">      85 </span>                :            :         public</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :         view</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :         virtual</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="89"><span class="lineNum">      89 </span>                :            :     {</a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">          4 :         _transferred(from, to, value);</span></a>
+<a name="91"><span class="lineNum">      91 </span>                :            :     }</a>
+<a name="92"><span class="lineNum">      92 </span>                :            : </a>
+<a name="93"><span class="lineNum">      93 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         public</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :         view</a>
+<a name="96"><span class="lineNum">      96 </span>                :            :         virtual</a>
+<a name="97"><span class="lineNum">      97 </span>                :            :         override(IRuleEngine)</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :     {</a>
+<a name="99"><span class="lineNum">      99 </span>                :<span class="lineCov">          2 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="100"><span class="lineNum">     100 </span>                :            :     }</a>
+<a name="101"><span class="lineNum">     101 </span>                :            : </a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">          5 :     function _transferred(address from, address to, uint256 value) internal view virtual override {</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">          5 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="104"><span class="lineNum">     104 </span>        [<span class="branchCov" title="Branch 0 was taken 3 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          5 :         require(</span></a>
+<a name="105"><span class="lineNum">     105 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :             RuleERC2980_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="107"><span class="lineNum">     107 </span>                :            :         );</a>
+<a name="108"><span class="lineNum">     108 </span>                :            :     }</a>
+<a name="109"><span class="lineNum">     109 </span>                :            : </a>
+<a name="110"><span class="lineNum">     110 </span>                :<span class="lineCov">          3 :     function _transferredFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="111"><span class="lineNum">     111 </span>                :            :         internal</a>
+<a name="112"><span class="lineNum">     112 </span>                :            :         view</a>
+<a name="113"><span class="lineNum">     113 </span>                :            :         virtual</a>
+<a name="114"><span class="lineNum">     114 </span>                :            :         override</a>
+<a name="115"><span class="lineNum">     115 </span>                :            :     {</a>
+<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">          3 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="117"><span class="lineNum">     117 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          3 :         require(</span></a>
+<a name="118"><span class="lineNum">     118 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="119"><span class="lineNum">     119 </span>                :            :             RuleERC2980_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="120"><span class="lineNum">     120 </span>                :            :         );</a>
+<a name="121"><span class="lineNum">     121 </span>                :            :     }</a>
+<a name="122"><span class="lineNum">     122 </span>                :            : </a>
+<a name="123"><span class="lineNum">     123 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :                       RESTRICTION CODE HELPERS</a>
+<a name="125"><span class="lineNum">     125 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="126"><span class="lineNum">     126 </span>                :            : </a>
+<a name="127"><span class="lineNum">     127 </span>                :<span class="lineCov">          5 :     function canReturnTransferRestrictionCode(uint8 restrictionCode)</span></a>
+<a name="128"><span class="lineNum">     128 </span>                :            :         public</a>
+<a name="129"><span class="lineNum">     129 </span>                :            :         pure</a>
+<a name="130"><span class="lineNum">     130 </span>                :            :         virtual</a>
+<a name="131"><span class="lineNum">     131 </span>                :            :         override(IRule)</a>
+<a name="132"><span class="lineNum">     132 </span>                :            :         returns (bool)</a>
+<a name="133"><span class="lineNum">     133 </span>                :            :     {</a>
+<a name="134"><span class="lineNum">     134 </span>                :<span class="lineCov">          5 :         return restrictionCode == CODE_ADDRESS_FROM_IS_FROZEN || restrictionCode == CODE_ADDRESS_TO_IS_FROZEN</span></a>
+<a name="135"><span class="lineNum">     135 </span>                :<span class="lineCov">          3 :             || restrictionCode == CODE_ADDRESS_SPENDER_IS_FROZEN</span></a>
+<a name="136"><span class="lineNum">     136 </span>                :<span class="lineCov">          2 :             || restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="137"><span class="lineNum">     137 </span>                :            :     }</a>
+<a name="138"><span class="lineNum">     138 </span>                :            : </a>
+<a name="139"><span class="lineNum">     139 </span>                :<span class="lineCov">          5 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="140"><span class="lineNum">     140 </span>                :            :         public</a>
+<a name="141"><span class="lineNum">     141 </span>                :            :         pure</a>
+<a name="142"><span class="lineNum">     142 </span>                :            :         virtual</a>
+<a name="143"><span class="lineNum">     143 </span>                :            :         override(IERC1404)</a>
+<a name="144"><span class="lineNum">     144 </span>                :            :         returns (string memory)</a>
+<a name="145"><span class="lineNum">     145 </span>                :            :     {</a>
+<a name="146"><span class="lineNum">     146 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          5 :         if (restrictionCode == CODE_ADDRESS_FROM_IS_FROZEN) {</span></a>
+<a name="147"><span class="lineNum">     147 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_FROM_IS_FROZEN;</span></a>
+<a name="148"><span class="lineNum">     148 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          4 :         } else if (restrictionCode == CODE_ADDRESS_TO_IS_FROZEN) {</span></a>
+<a name="149"><span class="lineNum">     149 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_TO_IS_FROZEN;</span></a>
+<a name="150"><span class="lineNum">     150 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_IS_FROZEN) {</span></a>
+<a name="151"><span class="lineNum">     151 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_IS_FROZEN;</span></a>
+<a name="152"><span class="lineNum">     152 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         } else if (restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED) {</span></a>
+<a name="153"><span class="lineNum">     153 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="154"><span class="lineNum">     154 </span>                :            :         } else {</a>
+<a name="155"><span class="lineNum">     155 </span>                :<span class="lineCov">          1 :             return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="156"><span class="lineNum">     156 </span>                :            :         }</a>
+<a name="157"><span class="lineNum">     157 </span>                :            :     }</a>
+<a name="158"><span class="lineNum">     158 </span>                :            : </a>
+<a name="159"><span class="lineNum">     159 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="160"><span class="lineNum">     160 </span>                :            :                        WHITELIST MANAGEMENT</a>
+<a name="161"><span class="lineNum">     161 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="162"><span class="lineNum">     162 </span>                :            : </a>
+<a name="163"><span class="lineNum">     163 </span>                :            :     /**</a>
+<a name="164"><span class="lineNum">     164 </span>                :            :      * @notice Adds multiple addresses to the whitelist.</a>
+<a name="165"><span class="lineNum">     165 </span>                :            :      * @dev Does not revert if an address is already listed.</a>
+<a name="166"><span class="lineNum">     166 </span>                :            :      */</a>
+<a name="167"><span class="lineNum">     167 </span>                :<span class="lineCov">          6 :     function addWhitelistAddresses(address[] calldata targetAddresses) public onlyWhitelistAdd {</span></a>
+<a name="168"><span class="lineNum">     168 </span>                :<span class="lineCov">          4 :         _addWhitelistAddresses(targetAddresses);</span></a>
+<a name="169"><span class="lineNum">     169 </span>                :<span class="lineCov">          4 :         emit AddWhitelistAddresses(targetAddresses);</span></a>
+<a name="170"><span class="lineNum">     170 </span>                :            :     }</a>
+<a name="171"><span class="lineNum">     171 </span>                :            : </a>
+<a name="172"><span class="lineNum">     172 </span>                :            :     /**</a>
+<a name="173"><span class="lineNum">     173 </span>                :            :      * @notice Removes multiple addresses from the whitelist.</a>
+<a name="174"><span class="lineNum">     174 </span>                :            :      * @dev Does not revert if an address is not listed.</a>
+<a name="175"><span class="lineNum">     175 </span>                :            :      */</a>
+<a name="176"><span class="lineNum">     176 </span>                :<span class="lineCov">          4 :     function removeWhitelistAddresses(address[] calldata targetAddresses) public onlyWhitelistRemove {</span></a>
+<a name="177"><span class="lineNum">     177 </span>                :<span class="lineCov">          3 :         _removeWhitelistAddresses(targetAddresses);</span></a>
+<a name="178"><span class="lineNum">     178 </span>                :<span class="lineCov">          3 :         emit RemoveWhitelistAddresses(targetAddresses);</span></a>
+<a name="179"><span class="lineNum">     179 </span>                :            :     }</a>
+<a name="180"><span class="lineNum">     180 </span>                :            : </a>
+<a name="181"><span class="lineNum">     181 </span>                :            :     /**</a>
+<a name="182"><span class="lineNum">     182 </span>                :            :      * @notice Adds a single address to the whitelist.</a>
+<a name="183"><span class="lineNum">     183 </span>                :            :      * @dev</a>
+<a name="184"><span class="lineNum">     184 </span>                :            :      * Reverts if the address is already listed.</a>
+<a name="185"><span class="lineNum">     185 </span>                :            :      * Deviation from ERC-2980 `Whitelistable` example interface: the spec's `addAddressToWhitelist`</a>
+<a name="186"><span class="lineNum">     186 </span>                :            :      * returns `false` on duplicates instead of reverting. This implementation follows the codebase</a>
+<a name="187"><span class="lineNum">     187 </span>                :            :      * convention of reverting on invalid single-item operations.</a>
+<a name="188"><span class="lineNum">     188 </span>                :            :      */</a>
+<a name="189"><span class="lineNum">     189 </span>                :<span class="lineCov">         43 :     function addWhitelistAddress(address targetAddress) public onlyWhitelistAdd {</span></a>
+<a name="190"><span class="lineNum">     190 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 39 times"> + </span>]:<span class="lineCov">         40 :         require(!_isWhitelisted(targetAddress), RuleERC2980_AddressAlreadyListed());</span></a>
+<a name="191"><span class="lineNum">     191 </span>                :<span class="lineCov">         39 :         _addWhitelistAddress(targetAddress);</span></a>
+<a name="192"><span class="lineNum">     192 </span>                :<span class="lineCov">         39 :         emit AddWhitelistAddress(targetAddress);</span></a>
+<a name="193"><span class="lineNum">     193 </span>                :            :     }</a>
+<a name="194"><span class="lineNum">     194 </span>                :            : </a>
+<a name="195"><span class="lineNum">     195 </span>                :            :     /**</a>
+<a name="196"><span class="lineNum">     196 </span>                :            :      * @notice Removes a single address from the whitelist.</a>
+<a name="197"><span class="lineNum">     197 </span>                :            :      * @dev</a>
+<a name="198"><span class="lineNum">     198 </span>                :            :      * Reverts if the address is not listed.</a>
+<a name="199"><span class="lineNum">     199 </span>                :            :      * Deviation from ERC-2980 `Whitelistable` example interface: the spec's `removeAddressFromWhitelist`</a>
+<a name="200"><span class="lineNum">     200 </span>                :            :      * returns `false` when not found instead of reverting. This implementation follows the codebase</a>
+<a name="201"><span class="lineNum">     201 </span>                :            :      * convention of reverting on invalid single-item operations.</a>
+<a name="202"><span class="lineNum">     202 </span>                :            :      */</a>
+<a name="203"><span class="lineNum">     203 </span>                :<span class="lineCov">          7 :     function removeWhitelistAddress(address targetAddress) public onlyWhitelistRemove {</span></a>
+<a name="204"><span class="lineNum">     204 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 4 times"> + </span>]:<span class="lineCov">          5 :         require(_isWhitelisted(targetAddress), RuleERC2980_AddressNotFound());</span></a>
+<a name="205"><span class="lineNum">     205 </span>                :<span class="lineCov">          4 :         _removeWhitelistAddress(targetAddress);</span></a>
+<a name="206"><span class="lineNum">     206 </span>                :<span class="lineCov">          4 :         emit RemoveWhitelistAddress(targetAddress);</span></a>
+<a name="207"><span class="lineNum">     207 </span>                :            :     }</a>
+<a name="208"><span class="lineNum">     208 </span>                :            : </a>
+<a name="209"><span class="lineNum">     209 </span>                :            :     /**</a>
+<a name="210"><span class="lineNum">     210 </span>                :            :      * @notice Returns the number of whitelisted addresses.</a>
+<a name="211"><span class="lineNum">     211 </span>                :            :      */</a>
+<a name="212"><span class="lineNum">     212 </span>                :<span class="lineCov">          5 :     function whitelistAddressCount() public view returns (uint256) {</span></a>
+<a name="213"><span class="lineNum">     213 </span>                :<span class="lineCov">          5 :         return _whitelistCount();</span></a>
+<a name="214"><span class="lineNum">     214 </span>                :            :     }</a>
+<a name="215"><span class="lineNum">     215 </span>                :            : </a>
+<a name="216"><span class="lineNum">     216 </span>                :            :     /**</a>
+<a name="217"><span class="lineNum">     217 </span>                :            :      * @notice Returns true if the address is in the whitelist.</a>
+<a name="218"><span class="lineNum">     218 </span>                :            :      */</a>
+<a name="219"><span class="lineNum">     219 </span>                :<span class="lineCov">         13 :     function isWhitelisted(address targetAddress) public view returns (bool) {</span></a>
+<a name="220"><span class="lineNum">     220 </span>                :<span class="lineCov">         13 :         return _isWhitelisted(targetAddress);</span></a>
+<a name="221"><span class="lineNum">     221 </span>                :            :     }</a>
+<a name="222"><span class="lineNum">     222 </span>                :            : </a>
+<a name="223"><span class="lineNum">     223 </span>                :            :     /**</a>
+<a name="224"><span class="lineNum">     224 </span>                :            :      * @notice ERC-2980 getter: returns true if the address is whitelisted.</a>
+<a name="225"><span class="lineNum">     225 </span>                :            :      */</a>
+<a name="226"><span class="lineNum">     226 </span>                :<span class="lineCov">          5 :     function whitelist(address _operator) public view virtual override(IERC2980) returns (bool) {</span></a>
+<a name="227"><span class="lineNum">     227 </span>                :<span class="lineCov">          5 :         return _isWhitelisted(_operator);</span></a>
+<a name="228"><span class="lineNum">     228 </span>                :            :     }</a>
+<a name="229"><span class="lineNum">     229 </span>                :            : </a>
+<a name="230"><span class="lineNum">     230 </span>                :            :     /**</a>
+<a name="231"><span class="lineNum">     231 </span>                :            :      * @notice Returns true if the address is whitelisted (identity-verified).</a>
+<a name="232"><span class="lineNum">     232 </span>                :            :      * @dev Reflects whitelist membership only. Frozen status is intentionally excluded:</a>
+<a name="233"><span class="lineNum">     233 </span>                :            :      * freezing is a temporary enforcement action and does not revoke identity verification.</a>
+<a name="234"><span class="lineNum">     234 </span>                :            :      */</a>
+<a name="235"><span class="lineNum">     235 </span>                :<span class="lineCov">          3 :     function isVerified(address targetAddress)</span></a>
+<a name="236"><span class="lineNum">     236 </span>                :            :         public</a>
+<a name="237"><span class="lineNum">     237 </span>                :            :         view</a>
+<a name="238"><span class="lineNum">     238 </span>                :            :         virtual</a>
+<a name="239"><span class="lineNum">     239 </span>                :            :         override(IIdentityRegistryVerified)</a>
+<a name="240"><span class="lineNum">     240 </span>                :            :         returns (bool)</a>
+<a name="241"><span class="lineNum">     241 </span>                :            :     {</a>
+<a name="242"><span class="lineNum">     242 </span>                :<span class="lineCov">          3 :         return _isWhitelisted(targetAddress);</span></a>
+<a name="243"><span class="lineNum">     243 </span>                :            :     }</a>
+<a name="244"><span class="lineNum">     244 </span>                :            : </a>
+<a name="245"><span class="lineNum">     245 </span>                :            :     /**</a>
+<a name="246"><span class="lineNum">     246 </span>                :            :      * @notice Checks multiple addresses for whitelist membership.</a>
+<a name="247"><span class="lineNum">     247 </span>                :            :      */</a>
+<a name="248"><span class="lineNum">     248 </span>                :<span class="lineCov">          1 :     function areWhitelisted(address[] memory targetAddresses) public view returns (bool[] memory results) {</span></a>
+<a name="249"><span class="lineNum">     249 </span>                :<span class="lineCov">          1 :         results = new bool[](targetAddresses.length);</span></a>
+<a name="250"><span class="lineNum">     250 </span>                :<span class="lineCov">          1 :         for (uint256 i = 0; i &lt; targetAddresses.length; ++i) {</span></a>
+<a name="251"><span class="lineNum">     251 </span>                :<span class="lineCov">          2 :             results[i] = _isWhitelisted(targetAddresses[i]);</span></a>
+<a name="252"><span class="lineNum">     252 </span>                :            :         }</a>
+<a name="253"><span class="lineNum">     253 </span>                :            :     }</a>
+<a name="254"><span class="lineNum">     254 </span>                :            : </a>
+<a name="255"><span class="lineNum">     255 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="256"><span class="lineNum">     256 </span>                :            :                       FROZENLIST MANAGEMENT</a>
+<a name="257"><span class="lineNum">     257 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="258"><span class="lineNum">     258 </span>                :            : </a>
+<a name="259"><span class="lineNum">     259 </span>                :            :     /**</a>
+<a name="260"><span class="lineNum">     260 </span>                :            :      * @notice Adds multiple addresses to the frozenlist.</a>
+<a name="261"><span class="lineNum">     261 </span>                :            :      * @dev Does not revert if an address is already listed.</a>
+<a name="262"><span class="lineNum">     262 </span>                :            :      */</a>
+<a name="263"><span class="lineNum">     263 </span>                :<span class="lineCov">          6 :     function addFrozenlistAddresses(address[] calldata targetAddresses) public onlyFrozenlistAdd {</span></a>
+<a name="264"><span class="lineNum">     264 </span>                :<span class="lineCov">          4 :         _addFrozenlistAddresses(targetAddresses);</span></a>
+<a name="265"><span class="lineNum">     265 </span>                :<span class="lineCov">          4 :         emit AddFrozenlistAddresses(targetAddresses);</span></a>
+<a name="266"><span class="lineNum">     266 </span>                :            :     }</a>
+<a name="267"><span class="lineNum">     267 </span>                :            : </a>
+<a name="268"><span class="lineNum">     268 </span>                :            :     /**</a>
+<a name="269"><span class="lineNum">     269 </span>                :            :      * @notice Removes multiple addresses from the frozenlist.</a>
+<a name="270"><span class="lineNum">     270 </span>                :            :      * @dev Does not revert if an address is not listed.</a>
+<a name="271"><span class="lineNum">     271 </span>                :            :      */</a>
+<a name="272"><span class="lineNum">     272 </span>                :<span class="lineCov">          2 :     function removeFrozenlistAddresses(address[] calldata targetAddresses) public onlyFrozenlistRemove {</span></a>
+<a name="273"><span class="lineNum">     273 </span>                :<span class="lineCov">          2 :         _removeFrozenlistAddresses(targetAddresses);</span></a>
+<a name="274"><span class="lineNum">     274 </span>                :<span class="lineCov">          2 :         emit RemoveFrozenlistAddresses(targetAddresses);</span></a>
+<a name="275"><span class="lineNum">     275 </span>                :            :     }</a>
+<a name="276"><span class="lineNum">     276 </span>                :            : </a>
+<a name="277"><span class="lineNum">     277 </span>                :            :     /**</a>
+<a name="278"><span class="lineNum">     278 </span>                :            :      * @notice Adds a single address to the frozenlist.</a>
+<a name="279"><span class="lineNum">     279 </span>                :            :      * @dev</a>
+<a name="280"><span class="lineNum">     280 </span>                :            :      * Reverts if the address is already listed.</a>
+<a name="281"><span class="lineNum">     281 </span>                :            :      * Deviation from ERC-2980 `Freezable` example interface: the spec's `addAddressToFrozenlist`</a>
+<a name="282"><span class="lineNum">     282 </span>                :            :      * returns `false` on duplicates instead of reverting. This implementation follows the codebase</a>
+<a name="283"><span class="lineNum">     283 </span>                :            :      * convention of reverting on invalid single-item operations.</a>
+<a name="284"><span class="lineNum">     284 </span>                :            :      */</a>
+<a name="285"><span class="lineNum">     285 </span>                :<span class="lineCov">         22 :     function addFrozenlistAddress(address targetAddress) public onlyFrozenlistAdd {</span></a>
+<a name="286"><span class="lineNum">     286 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 18 times"> + </span>]:<span class="lineCov">         19 :         require(!_isFrozen(targetAddress), RuleERC2980_AddressAlreadyListed());</span></a>
+<a name="287"><span class="lineNum">     287 </span>                :<span class="lineCov">         18 :         _addFrozenlistAddress(targetAddress);</span></a>
+<a name="288"><span class="lineNum">     288 </span>                :<span class="lineCov">         18 :         emit AddFrozenlistAddress(targetAddress);</span></a>
+<a name="289"><span class="lineNum">     289 </span>                :            :     }</a>
+<a name="290"><span class="lineNum">     290 </span>                :            : </a>
+<a name="291"><span class="lineNum">     291 </span>                :            :     /**</a>
+<a name="292"><span class="lineNum">     292 </span>                :            :      * @notice Removes a single address from the frozenlist.</a>
+<a name="293"><span class="lineNum">     293 </span>                :            :      * @dev</a>
+<a name="294"><span class="lineNum">     294 </span>                :            :      * Reverts if the address is not listed.</a>
+<a name="295"><span class="lineNum">     295 </span>                :            :      * Deviation from ERC-2980 `Freezable` example interface: the spec's `removeAddressFromFrozenlist`</a>
+<a name="296"><span class="lineNum">     296 </span>                :            :      * returns `false` when not found instead of reverting. This implementation follows the codebase</a>
+<a name="297"><span class="lineNum">     297 </span>                :            :      * convention of reverting on invalid single-item operations.</a>
+<a name="298"><span class="lineNum">     298 </span>                :            :      */</a>
+<a name="299"><span class="lineNum">     299 </span>                :<span class="lineCov">          7 :     function removeFrozenlistAddress(address targetAddress) public onlyFrozenlistRemove {</span></a>
+<a name="300"><span class="lineNum">     300 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 4 times"> + </span>]:<span class="lineCov">          5 :         require(_isFrozen(targetAddress), RuleERC2980_AddressNotFound());</span></a>
+<a name="301"><span class="lineNum">     301 </span>                :<span class="lineCov">          4 :         _removeFrozenlistAddress(targetAddress);</span></a>
+<a name="302"><span class="lineNum">     302 </span>                :<span class="lineCov">          4 :         emit RemoveFrozenlistAddress(targetAddress);</span></a>
+<a name="303"><span class="lineNum">     303 </span>                :            :     }</a>
+<a name="304"><span class="lineNum">     304 </span>                :            : </a>
+<a name="305"><span class="lineNum">     305 </span>                :            :     /**</a>
+<a name="306"><span class="lineNum">     306 </span>                :            :      * @notice Returns the number of frozen addresses.</a>
+<a name="307"><span class="lineNum">     307 </span>                :            :      */</a>
+<a name="308"><span class="lineNum">     308 </span>                :<span class="lineCov">          4 :     function frozenlistAddressCount() public view returns (uint256) {</span></a>
+<a name="309"><span class="lineNum">     309 </span>                :<span class="lineCov">          4 :         return _frozenlistCount();</span></a>
+<a name="310"><span class="lineNum">     310 </span>                :            :     }</a>
+<a name="311"><span class="lineNum">     311 </span>                :            : </a>
+<a name="312"><span class="lineNum">     312 </span>                :            :     /**</a>
+<a name="313"><span class="lineNum">     313 </span>                :            :      * @notice Returns true if the address is in the frozenlist.</a>
+<a name="314"><span class="lineNum">     314 </span>                :            :      */</a>
+<a name="315"><span class="lineNum">     315 </span>                :<span class="lineCov">         12 :     function isFrozen(address targetAddress) public view returns (bool) {</span></a>
+<a name="316"><span class="lineNum">     316 </span>                :<span class="lineCov">         12 :         return _isFrozen(targetAddress);</span></a>
+<a name="317"><span class="lineNum">     317 </span>                :            :     }</a>
+<a name="318"><span class="lineNum">     318 </span>                :            : </a>
+<a name="319"><span class="lineNum">     319 </span>                :            :     /**</a>
+<a name="320"><span class="lineNum">     320 </span>                :            :      * @notice ERC-2980 getter: returns true if the address is frozen.</a>
+<a name="321"><span class="lineNum">     321 </span>                :            :      */</a>
+<a name="322"><span class="lineNum">     322 </span>                :<span class="lineCov">          4 :     function frozenlist(address _operator) public view virtual override(IERC2980) returns (bool) {</span></a>
+<a name="323"><span class="lineNum">     323 </span>                :<span class="lineCov">          4 :         return _isFrozen(_operator);</span></a>
+<a name="324"><span class="lineNum">     324 </span>                :            :     }</a>
+<a name="325"><span class="lineNum">     325 </span>                :            : </a>
+<a name="326"><span class="lineNum">     326 </span>                :            :     /**</a>
+<a name="327"><span class="lineNum">     327 </span>                :            :      * @notice Checks multiple addresses for frozenlist membership.</a>
+<a name="328"><span class="lineNum">     328 </span>                :            :      */</a>
+<a name="329"><span class="lineNum">     329 </span>                :<span class="lineCov">          1 :     function areFrozen(address[] memory targetAddresses) public view returns (bool[] memory results) {</span></a>
+<a name="330"><span class="lineNum">     330 </span>                :<span class="lineCov">          1 :         results = new bool[](targetAddresses.length);</span></a>
+<a name="331"><span class="lineNum">     331 </span>                :<span class="lineCov">          1 :         for (uint256 i = 0; i &lt; targetAddresses.length; ++i) {</span></a>
+<a name="332"><span class="lineNum">     332 </span>                :<span class="lineCov">          2 :             results[i] = _isFrozen(targetAddresses[i]);</span></a>
+<a name="333"><span class="lineNum">     333 </span>                :            :         }</a>
+<a name="334"><span class="lineNum">     334 </span>                :            :     }</a>
+<a name="335"><span class="lineNum">     335 </span>                :            : </a>
+<a name="336"><span class="lineNum">     336 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="337"><span class="lineNum">     337 </span>                :            :                           INTERFACE SUPPORT</a>
+<a name="338"><span class="lineNum">     338 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="339"><span class="lineNum">     339 </span>                :            : </a>
+<a name="340"><span class="lineNum">     340 </span>                :<span class="lineCov">          1 :     function supportsInterface(bytes4 interfaceId) public view virtual override(RuleTransferValidation) returns (bool) {</span></a>
+<a name="341"><span class="lineNum">     341 </span>                :<span class="lineCov">          1 :         return RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="342"><span class="lineNum">     342 </span>                :            :     }</a>
+<a name="343"><span class="lineNum">     343 </span>                :            : </a>
+<a name="344"><span class="lineNum">     344 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="345"><span class="lineNum">     345 </span>                :            :                             ACCESS CONTROL</a>
+<a name="346"><span class="lineNum">     346 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="347"><span class="lineNum">     347 </span>                :            : </a>
+<a name="348"><span class="lineNum">     348 </span>                :<span class="lineCov">          6 :     modifier onlyWhitelistAdd() {</span></a>
+<a name="349"><span class="lineNum">     349 </span>                :<span class="lineCov">          6 :         _authorizeWhitelistAdd();</span></a>
+<a name="350"><span class="lineNum">     350 </span>                :            :         _;</a>
+<a name="351"><span class="lineNum">     351 </span>                :            :     }</a>
+<a name="352"><span class="lineNum">     352 </span>                :            : </a>
+<a name="353"><span class="lineNum">     353 </span>                :<span class="lineCov">          7 :     modifier onlyWhitelistRemove() {</span></a>
+<a name="354"><span class="lineNum">     354 </span>                :<span class="lineCov">          7 :         _authorizeWhitelistRemove();</span></a>
+<a name="355"><span class="lineNum">     355 </span>                :            :         _;</a>
+<a name="356"><span class="lineNum">     356 </span>                :            :     }</a>
+<a name="357"><span class="lineNum">     357 </span>                :            : </a>
+<a name="358"><span class="lineNum">     358 </span>                :<span class="lineCov">          6 :     modifier onlyFrozenlistAdd() {</span></a>
+<a name="359"><span class="lineNum">     359 </span>                :<span class="lineCov">          6 :         _authorizeFrozenlistAdd();</span></a>
+<a name="360"><span class="lineNum">     360 </span>                :            :         _;</a>
+<a name="361"><span class="lineNum">     361 </span>                :            :     }</a>
+<a name="362"><span class="lineNum">     362 </span>                :            : </a>
+<a name="363"><span class="lineNum">     363 </span>                :<span class="lineCov">          2 :     modifier onlyFrozenlistRemove() {</span></a>
+<a name="364"><span class="lineNum">     364 </span>                :<span class="lineCov">          2 :         _authorizeFrozenlistRemove();</span></a>
+<a name="365"><span class="lineNum">     365 </span>                :            :         _;</a>
+<a name="366"><span class="lineNum">     366 </span>                :            :     }</a>
+<a name="367"><span class="lineNum">     367 </span>                :            : </a>
+<a name="368"><span class="lineNum">     368 </span>                :            :     function _authorizeWhitelistAdd() internal view virtual;</a>
+<a name="369"><span class="lineNum">     369 </span>                :            :     function _authorizeWhitelistRemove() internal view virtual;</a>
+<a name="370"><span class="lineNum">     370 </span>                :            :     function _authorizeFrozenlistAdd() internal view virtual;</a>
+<a name="371"><span class="lineNum">     371 </span>                :            :     function _authorizeFrozenlistRemove() internal view virtual;</a>
+<a name="372"><span class="lineNum">     372 </span>                :            : </a>
+<a name="373"><span class="lineNum">     373 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="374"><span class="lineNum">     374 </span>                :            :                              ERC-2771 META TX</a>
+<a name="375"><span class="lineNum">     375 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="376"><span class="lineNum">     376 </span>                :            : </a>
+<a name="377"><span class="lineNum">     377 </span>                :<span class="lineCov">        267 :     function _msgSender() internal view virtual override(ERC2771Context) returns (address sender) {</span></a>
+<a name="378"><span class="lineNum">     378 </span>                :<span class="lineCov">        267 :         return ERC2771Context._msgSender();</span></a>
+<a name="379"><span class="lineNum">     379 </span>                :            :     }</a>
+<a name="380"><span class="lineNum">     380 </span>                :            : </a>
+<a name="381"><span class="lineNum">     381 </span>                :<span class="lineCov">          2 :     function _msgData() internal view virtual override(ERC2771Context) returns (bytes calldata) {</span></a>
+<a name="382"><span class="lineNum">     382 </span>                :<span class="lineCov">          2 :         return ERC2771Context._msgData();</span></a>
+<a name="383"><span class="lineNum">     383 </span>                :            :     }</a>
+<a name="384"><span class="lineNum">     384 </span>                :            : </a>
+<a name="385"><span class="lineNum">     385 </span>                :<span class="lineCov">        269 :     function _contextSuffixLength() internal view virtual override(ERC2771Context) returns (uint256) {</span></a>
+<a name="386"><span class="lineNum">     386 </span>                :<span class="lineCov">        269 :         return ERC2771Context._contextSuffixLength();</span></a>
+<a name="387"><span class="lineNum">     387 </span>                :            :     }</a>
+<a name="388"><span class="lineNum">     388 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func-sort-c.html
new file mode 100644
index 0000000..2aa4d9c
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func-sort-c.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleIdentityRegistryBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleIdentityRegistryBase.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistryBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleIdentityRegistryBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#90">RuleIdentityRegistryBase._transferred</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#98">RuleIdentityRegistryBase._transferredFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#74">RuleIdentityRegistryBase.transferred.0</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#82">RuleIdentityRegistryBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#111">RuleIdentityRegistryBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#116">RuleIdentityRegistryBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#23">RuleIdentityRegistryBase.setIdentityRegistry</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#29">RuleIdentityRegistryBase.clearIdentityRegistry</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#136">RuleIdentityRegistryBase.onlyIdentityRegistryManager</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#56">RuleIdentityRegistryBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">9</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#34">RuleIdentityRegistryBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#17">RuleIdentityRegistryBase.constructor</a></td>
+              <td class="coverFnHi">26</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func.html
new file mode 100644
index 0000000..9fdf83a
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.func.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleIdentityRegistryBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleIdentityRegistryBase.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistryBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleIdentityRegistryBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#34">RuleIdentityRegistryBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#56">RuleIdentityRegistryBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">9</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#90">RuleIdentityRegistryBase._transferred</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#98">RuleIdentityRegistryBase._transferredFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#111">RuleIdentityRegistryBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#29">RuleIdentityRegistryBase.clearIdentityRegistry</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#17">RuleIdentityRegistryBase.constructor</a></td>
+              <td class="coverFnHi">26</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#116">RuleIdentityRegistryBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#136">RuleIdentityRegistryBase.onlyIdentityRegistryManager</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#23">RuleIdentityRegistryBase.setIdentityRegistry</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#74">RuleIdentityRegistryBase.transferred.0</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryBase.sol.gcov.html#82">RuleIdentityRegistryBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.gcov.html
new file mode 100644
index 0000000..a9ee475
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleIdentityRegistryBase.sol.gcov.html
@@ -0,0 +1,229 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleIdentityRegistryBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleIdentityRegistryBase.sol<span style="font-size: 80%;"> (source / <a href="RuleIdentityRegistryBase.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {RuleNFTAdapter} from &quot;../core/RuleNFTAdapter.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleIdentityRegistryInvariantStorage} from &quot;../invariant/RuleIdentityRegistryInvariantStorage.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {IIdentityRegistryVerified} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : </a>
+<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @title RuleIdentityRegistryBase</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Checks the ERC-3643 Identity Registry for transfer participants when configured.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @dev Burns (to == address(0)) are allowed even if the sender is not verified.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  */</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : abstract contract RuleIdentityRegistryBase is RuleNFTAdapter, RuleIdentityRegistryInvariantStorage {</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     IIdentityRegistryVerified public identityRegistry;</a>
+<a name="18"><span class="lineNum">      18 </span>                :            : </a>
+<a name="19"><span class="lineNum">      19 </span>                :<span class="lineCov">         26 :     constructor(address identityRegistry_) {</span></a>
+<a name="20"><span class="lineNum">      20 </span>           [<span class="branchCov" title="Branch 0 was taken 25 times"> + </span>]:<span class="lineCov">         26 :         if (identityRegistry_ != address(0)) {</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :<span class="lineCov">         25 :             identityRegistry = IIdentityRegistryVerified(identityRegistry_);</span></a>
+<a name="22"><span class="lineNum">      22 </span>                :            :         }</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     }</a>
+<a name="24"><span class="lineNum">      24 </span>                :            : </a>
+<a name="25"><span class="lineNum">      25 </span>                :<span class="lineCov">          4 :     function setIdentityRegistry(address newRegistry) public onlyIdentityRegistryManager {</span></a>
+<a name="26"><span class="lineNum">      26 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(newRegistry != address(0), RuleIdentityRegistry_RegistryAddressZeroNotAllowed());</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">          1 :         identityRegistry = IIdentityRegistryVerified(newRegistry);</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">          1 :         emit IdentityRegistryUpdated(newRegistry);</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     }</a>
+<a name="30"><span class="lineNum">      30 </span>                :            : </a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">          5 :     function clearIdentityRegistry() public onlyIdentityRegistryManager {</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">          3 :         identityRegistry = IIdentityRegistryVerified(address(0));</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          3 :         emit IdentityRegistryUpdated(address(0));</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     }</a>
+<a name="35"><span class="lineNum">      35 </span>                :            : </a>
+<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">         16 :     function _detectTransferRestriction(address from, address to, uint256 /* value */)</span></a>
+<a name="37"><span class="lineNum">      37 </span>                :            :         internal</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         view</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         override</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         returns (uint8)</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :     {</a>
+<a name="42"><span class="lineNum">      42 </span>           [<span class="branchCov" title="Branch 0 was taken 3 times"> + </span>]:<span class="lineCov">         16 :         if (address(identityRegistry) == address(0)) {</span></a>
+<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">          3 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :            :         }</a>
+<a name="45"><span class="lineNum">      45 </span>           [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span>]:<span class="lineCov">         13 :         if (to == address(0)) {</span></a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">          2 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         }</a>
+<a name="48"><span class="lineNum">      48 </span>                :            : </a>
+<a name="49"><span class="lineNum">      49 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">         11 :         if (from != address(0) &amp;&amp; !identityRegistry.isVerified(from)) {</span></a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_FROM_NOT_VERIFIED;</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         }</a>
+<a name="52"><span class="lineNum">      52 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          7 :         if (to != address(0) &amp;&amp; !identityRegistry.isVerified(to)) {</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">          1 :             return CODE_ADDRESS_TO_NOT_VERIFIED;</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         }</a>
+<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">          6 :         return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     }</a>
+<a name="57"><span class="lineNum">      57 </span>                :            : </a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">          9 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :            :         internal</a>
+<a name="60"><span class="lineNum">      60 </span>                :            :         view</a>
+<a name="61"><span class="lineNum">      61 </span>                :            :         override</a>
+<a name="62"><span class="lineNum">      62 </span>                :            :         returns (uint8)</a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     {</a>
+<a name="64"><span class="lineNum">      64 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          9 :         if (address(identityRegistry) == address(0)) {</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">          1 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="66"><span class="lineNum">      66 </span>                :            :         }</a>
+<a name="67"><span class="lineNum">      67 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          8 :         if (to == address(0)) {</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">          1 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :            :         }</a>
+<a name="70"><span class="lineNum">      70 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">          7 :         if (spender != address(0) &amp;&amp; !identityRegistry.isVerified(spender)) {</span></a>
+<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">          4 :             return CODE_ADDRESS_SPENDER_NOT_VERIFIED;</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         }</a>
+<a name="73"><span class="lineNum">      73 </span>                :<span class="lineCov">          3 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="74"><span class="lineNum">      74 </span>                :            :     }</a>
+<a name="75"><span class="lineNum">      75 </span>                :            : </a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">          2 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :            :         public</a>
+<a name="78"><span class="lineNum">      78 </span>                :            :         view</a>
+<a name="79"><span class="lineNum">      79 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :     {</a>
+<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">          2 :         _transferred(from, to, value);</span></a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     }</a>
+<a name="83"><span class="lineNum">      83 </span>                :            : </a>
+<a name="84"><span class="lineNum">      84 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="85"><span class="lineNum">      85 </span>                :            :         public</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :         view</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :         override(IRuleEngine)</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :     {</a>
+<a name="89"><span class="lineNum">      89 </span>                :<span class="lineCov">          2 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="90"><span class="lineNum">      90 </span>                :            :     }</a>
+<a name="91"><span class="lineNum">      91 </span>                :            : </a>
+<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">          2 :     function _transferred(address from, address to, uint256 value) internal view virtual override {</span></a>
+<a name="93"><span class="lineNum">      93 </span>                :<span class="lineCov">          2 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="94"><span class="lineNum">      94 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(</span></a>
+<a name="95"><span class="lineNum">      95 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="96"><span class="lineNum">      96 </span>                :            :             RuleIdentityRegistry_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="97"><span class="lineNum">      97 </span>                :            :         );</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :     }</a>
+<a name="99"><span class="lineNum">      99 </span>                :            : </a>
+<a name="100"><span class="lineNum">     100 </span>                :<span class="lineCov">          2 :     function _transferredFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="101"><span class="lineNum">     101 </span>                :            :         internal</a>
+<a name="102"><span class="lineNum">     102 </span>                :            :         view</a>
+<a name="103"><span class="lineNum">     103 </span>                :            :         virtual</a>
+<a name="104"><span class="lineNum">     104 </span>                :            :         override</a>
+<a name="105"><span class="lineNum">     105 </span>                :            :     {</a>
+<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">          2 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="107"><span class="lineNum">     107 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(</span></a>
+<a name="108"><span class="lineNum">     108 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="109"><span class="lineNum">     109 </span>                :            :             RuleIdentityRegistry_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="110"><span class="lineNum">     110 </span>                :            :         );</a>
+<a name="111"><span class="lineNum">     111 </span>                :            :     }</a>
+<a name="112"><span class="lineNum">     112 </span>                :            : </a>
+<a name="113"><span class="lineNum">     113 </span>                :<span class="lineCov">          4 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override returns (bool) {</span></a>
+<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">          4 :         return restrictionCode == CODE_ADDRESS_FROM_NOT_VERIFIED || restrictionCode == CODE_ADDRESS_TO_NOT_VERIFIED</span></a>
+<a name="115"><span class="lineNum">     115 </span>                :<span class="lineCov">          2 :             || restrictionCode == CODE_ADDRESS_SPENDER_NOT_VERIFIED;</span></a>
+<a name="116"><span class="lineNum">     116 </span>                :            :     }</a>
+<a name="117"><span class="lineNum">     117 </span>                :            : </a>
+<a name="118"><span class="lineNum">     118 </span>                :<span class="lineCov">          4 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="119"><span class="lineNum">     119 </span>                :            :         public</a>
+<a name="120"><span class="lineNum">     120 </span>                :            :         pure</a>
+<a name="121"><span class="lineNum">     121 </span>                :            :         override(IERC1404)</a>
+<a name="122"><span class="lineNum">     122 </span>                :            :         returns (string memory)</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :     {</a>
+<a name="124"><span class="lineNum">     124 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          4 :         if (restrictionCode == CODE_ADDRESS_FROM_NOT_VERIFIED) {</span></a>
+<a name="125"><span class="lineNum">     125 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_FROM_NOT_VERIFIED;</span></a>
+<a name="126"><span class="lineNum">     126 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         } else if (restrictionCode == CODE_ADDRESS_TO_NOT_VERIFIED) {</span></a>
+<a name="127"><span class="lineNum">     127 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_TO_NOT_VERIFIED;</span></a>
+<a name="128"><span class="lineNum">     128 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_NOT_VERIFIED) {</span></a>
+<a name="129"><span class="lineNum">     129 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_NOT_VERIFIED;</span></a>
+<a name="130"><span class="lineNum">     130 </span>                :            :         }</a>
+<a name="131"><span class="lineNum">     131 </span>                :<span class="lineCov">          1 :         return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="132"><span class="lineNum">     132 </span>                :            :     }</a>
+<a name="133"><span class="lineNum">     133 </span>                :            : </a>
+<a name="134"><span class="lineNum">     134 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="135"><span class="lineNum">     135 </span>                :            :                             ACCESS CONTROL</a>
+<a name="136"><span class="lineNum">     136 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="137"><span class="lineNum">     137 </span>                :            : </a>
+<a name="138"><span class="lineNum">     138 </span>                :<span class="lineCov">          5 :     modifier onlyIdentityRegistryManager() {</span></a>
+<a name="139"><span class="lineNum">     139 </span>                :<span class="lineCov">          5 :         _authorizeIdentityRegistryManager();</span></a>
+<a name="140"><span class="lineNum">     140 </span>                :            :         _;</a>
+<a name="141"><span class="lineNum">     141 </span>                :            :     }</a>
+<a name="142"><span class="lineNum">     142 </span>                :            : </a>
+<a name="143"><span class="lineNum">     143 </span>                :            :     function _authorizeIdentityRegistryManager() internal view virtual;</a>
+<a name="144"><span class="lineNum">     144 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func-sort-c.html
new file mode 100644
index 0000000..b09fc06
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func-sort-c.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleMaxTotalSupplyBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleMaxTotalSupplyBase.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupplyBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleMaxTotalSupplyBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#50">RuleMaxTotalSupplyBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#75">RuleMaxTotalSupplyBase._transferred</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#83">RuleMaxTotalSupplyBase._transferredFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#91">RuleMaxTotalSupplyBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#95">RuleMaxTotalSupplyBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#59">RuleMaxTotalSupplyBase.transferred.0</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#67">RuleMaxTotalSupplyBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#29">RuleMaxTotalSupplyBase.setTokenContract</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#18">RuleMaxTotalSupplyBase.constructor</a></td>
+              <td class="coverFnHi">25</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#111">RuleMaxTotalSupplyBase.onlyMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#24">RuleMaxTotalSupplyBase.setMaxTotalSupply</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#35">RuleMaxTotalSupplyBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">271</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func.html
new file mode 100644
index 0000000..d697da8
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.func.html
@@ -0,0 +1,129 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleMaxTotalSupplyBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleMaxTotalSupplyBase.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupplyBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleMaxTotalSupplyBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#35">RuleMaxTotalSupplyBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">271</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#50">RuleMaxTotalSupplyBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#75">RuleMaxTotalSupplyBase._transferred</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#83">RuleMaxTotalSupplyBase._transferredFrom</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#91">RuleMaxTotalSupplyBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#18">RuleMaxTotalSupplyBase.constructor</a></td>
+              <td class="coverFnHi">25</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#95">RuleMaxTotalSupplyBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#111">RuleMaxTotalSupplyBase.onlyMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#24">RuleMaxTotalSupplyBase.setMaxTotalSupply</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#29">RuleMaxTotalSupplyBase.setTokenContract</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#59">RuleMaxTotalSupplyBase.transferred.0</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyBase.sol.gcov.html#67">RuleMaxTotalSupplyBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.gcov.html
new file mode 100644
index 0000000..d9659ad
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleMaxTotalSupplyBase.sol.gcov.html
@@ -0,0 +1,204 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleMaxTotalSupplyBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleMaxTotalSupplyBase.sol<span style="font-size: 80%;"> (source / <a href="RuleMaxTotalSupplyBase.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntry">37</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {RuleMaxTotalSupplyInvariantStorage} from &quot;../invariant/RuleMaxTotalSupplyInvariantStorage.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {ITotalSupply} from &quot;../../../interfaces/ITotalSupply.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleTransferValidation} from &quot;../core/RuleTransferValidation.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : </a>
+<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @title RuleMaxTotalSupplyBase</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Restricts minting so that total supply never exceeds a maximum value.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  */</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : abstract contract RuleMaxTotalSupplyBase is RuleTransferValidation, RuleMaxTotalSupplyInvariantStorage {</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     /// @dev tokenContract is trusted to return a correct totalSupply.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     ITotalSupply public tokenContract;</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     uint256 public maxTotalSupply;</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">         25 :     constructor(address tokenContract_, uint256 maxTotalSupply_) {</span></a>
+<a name="21"><span class="lineNum">      21 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 24 times"> + </span>]:<span class="lineCov">         25 :         require(tokenContract_ != address(0), RuleMaxTotalSupply_TokenAddressZeroNotAllowed());</span></a>
+<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">         24 :         tokenContract = ITotalSupply(tokenContract_);</span></a>
+<a name="23"><span class="lineNum">      23 </span>                :<span class="lineCov">         24 :         maxTotalSupply = maxTotalSupply_;</span></a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     }</a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">        260 :     function setMaxTotalSupply(uint256 newMaxTotalSupply) public onlyMaxTotalSupplyManager {</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">        258 :         maxTotalSupply = newMaxTotalSupply;</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">        258 :         emit MaxTotalSupplyUpdated(newMaxTotalSupply);</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     }</a>
+<a name="30"><span class="lineNum">      30 </span>                :            : </a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">          4 :     function setTokenContract(address newTokenContract) public onlyMaxTotalSupplyManager {</span></a>
+<a name="32"><span class="lineNum">      32 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(newTokenContract != address(0), RuleMaxTotalSupply_TokenAddressZeroNotAllowed());</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          1 :         tokenContract = ITotalSupply(newTokenContract);</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">          1 :         emit TokenContractUpdated(newTokenContract);</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     }</a>
+<a name="36"><span class="lineNum">      36 </span>                :            : </a>
+<a name="37"><span class="lineNum">      37 </span>                :<span class="lineCov">        271 :     function _detectTransferRestriction(address from, address /* to */, uint256 value)</span></a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         internal</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         view</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         override</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :         returns (uint8)</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :     {</a>
+<a name="43"><span class="lineNum">      43 </span>           [<span class="branchCov" title="Branch 0 was taken 268 times"> + </span>]:<span class="lineCov">        271 :         if (from == address(0)) {</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">        268 :             uint256 currentSupply = tokenContract.totalSupply();</span></a>
+<a name="45"><span class="lineNum">      45 </span>           [<span class="branchCov" title="Branch 0 was taken 179 times"> + </span>]:<span class="lineCov">        268 :             if (currentSupply + value &gt; maxTotalSupply) {</span></a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">        179 :                 return CODE_MAX_TOTAL_SUPPLY_EXCEEDED;</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :             }</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         }</a>
+<a name="49"><span class="lineNum">      49 </span>                :<span class="lineCov">         92 :         return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="50"><span class="lineNum">      50 </span>                :            :     }</a>
+<a name="51"><span class="lineNum">      51 </span>                :            : </a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">          2 :     function _detectTransferRestrictionFrom(address, address from, address to, uint256 value)</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :            :         internal</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         view</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :         override</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :         returns (uint8)</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :     {</a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">          2 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :            :     }</a>
+<a name="60"><span class="lineNum">      60 </span>                :            : </a>
+<a name="61"><span class="lineNum">      61 </span>                :<span class="lineCov">          2 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="62"><span class="lineNum">      62 </span>                :            :         public</a>
+<a name="63"><span class="lineNum">      63 </span>                :            :         view</a>
+<a name="64"><span class="lineNum">      64 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="65"><span class="lineNum">      65 </span>                :            :     {</a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">          2 :         _transferred(from, to, value);</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :            :     }</a>
+<a name="68"><span class="lineNum">      68 </span>                :            : </a>
+<a name="69"><span class="lineNum">      69 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="70"><span class="lineNum">      70 </span>                :            :         public</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :         view</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         override(IRuleEngine)</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     {</a>
+<a name="74"><span class="lineNum">      74 </span>                :<span class="lineCov">          2 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="75"><span class="lineNum">      75 </span>                :            :     }</a>
+<a name="76"><span class="lineNum">      76 </span>                :            : </a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">          2 :     function _transferred(address from, address to, uint256 value) internal view virtual {</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">          2 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="79"><span class="lineNum">      79 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(</span></a>
+<a name="80"><span class="lineNum">      80 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :             RuleMaxTotalSupply_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :         );</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :     }</a>
+<a name="84"><span class="lineNum">      84 </span>                :            : </a>
+<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">          2 :     function _transferredFrom(address spender, address from, address to, uint256 value) internal view virtual {</span></a>
+<a name="86"><span class="lineNum">      86 </span>                :<span class="lineCov">          2 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="87"><span class="lineNum">      87 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(</span></a>
+<a name="88"><span class="lineNum">      88 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="89"><span class="lineNum">      89 </span>                :            :             RuleMaxTotalSupply_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="90"><span class="lineNum">      90 </span>                :            :         );</a>
+<a name="91"><span class="lineNum">      91 </span>                :            :     }</a>
+<a name="92"><span class="lineNum">      92 </span>                :            : </a>
+<a name="93"><span class="lineNum">      93 </span>                :<span class="lineCov">          2 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override returns (bool) {</span></a>
+<a name="94"><span class="lineNum">      94 </span>                :<span class="lineCov">          2 :         return restrictionCode == CODE_MAX_TOTAL_SUPPLY_EXCEEDED;</span></a>
+<a name="95"><span class="lineNum">      95 </span>                :            :     }</a>
+<a name="96"><span class="lineNum">      96 </span>                :            : </a>
+<a name="97"><span class="lineNum">      97 </span>                :<span class="lineCov">          2 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="98"><span class="lineNum">      98 </span>                :            :         public</a>
+<a name="99"><span class="lineNum">      99 </span>                :            :         pure</a>
+<a name="100"><span class="lineNum">     100 </span>                :            :         override(IERC1404)</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :         returns (string memory)</a>
+<a name="102"><span class="lineNum">     102 </span>                :            :     {</a>
+<a name="103"><span class="lineNum">     103 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         if (restrictionCode == CODE_MAX_TOTAL_SUPPLY_EXCEEDED) {</span></a>
+<a name="104"><span class="lineNum">     104 </span>                :<span class="lineCov">          1 :             return TEXT_MAX_TOTAL_SUPPLY_EXCEEDED;</span></a>
+<a name="105"><span class="lineNum">     105 </span>                :            :         }</a>
+<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">          1 :         return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="107"><span class="lineNum">     107 </span>                :            :     }</a>
+<a name="108"><span class="lineNum">     108 </span>                :            : </a>
+<a name="109"><span class="lineNum">     109 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="110"><span class="lineNum">     110 </span>                :            :                             ACCESS CONTROL</a>
+<a name="111"><span class="lineNum">     111 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="112"><span class="lineNum">     112 </span>                :            : </a>
+<a name="113"><span class="lineNum">     113 </span>                :<span class="lineCov">        260 :     modifier onlyMaxTotalSupplyManager() {</span></a>
+<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">        260 :         _authorizeMaxTotalSupplyManager();</span></a>
+<a name="115"><span class="lineNum">     115 </span>                :            :         _;</a>
+<a name="116"><span class="lineNum">     116 </span>                :            :     }</a>
+<a name="117"><span class="lineNum">     117 </span>                :            : </a>
+<a name="118"><span class="lineNum">     118 </span>                :            :     function _authorizeMaxTotalSupplyManager() internal view virtual;</a>
+<a name="119"><span class="lineNum">     119 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func-sort-c.html
new file mode 100644
index 0000000..9280236
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func-sort-c.html
@@ -0,0 +1,133 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleSanctionsListBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleSanctionsListBase.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsListBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleSanctionsListBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#96">RuleSanctionsListBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#112">RuleSanctionsListBase._transferredFrom</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#58">RuleSanctionsListBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#84">RuleSanctionsListBase.clearSanctionListOracle</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#134">RuleSanctionsListBase.onlySanctionListManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#63">RuleSanctionsListBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#42">RuleSanctionsListBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#79">RuleSanctionsListBase.setSanctionListOracle</a></td>
+              <td class="coverFnHi">17</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#125">RuleSanctionsListBase._setSanctionListOracle</a></td>
+              <td class="coverFnHi">37</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#88">RuleSanctionsListBase.transferred.0</a></td>
+              <td class="coverFnHi">43</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#18">RuleSanctionsListBase.constructor</a></td>
+              <td class="coverFnHi">46</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#104">RuleSanctionsListBase._transferred</a></td>
+              <td class="coverFnHi">47</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#26">RuleSanctionsListBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">84</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func.html
new file mode 100644
index 0000000..7fac67d
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.func.html
@@ -0,0 +1,133 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleSanctionsListBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleSanctionsListBase.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsListBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleSanctionsListBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#26">RuleSanctionsListBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">84</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#42">RuleSanctionsListBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#125">RuleSanctionsListBase._setSanctionListOracle</a></td>
+              <td class="coverFnHi">37</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#104">RuleSanctionsListBase._transferred</a></td>
+              <td class="coverFnHi">47</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#112">RuleSanctionsListBase._transferredFrom</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#58">RuleSanctionsListBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#84">RuleSanctionsListBase.clearSanctionListOracle</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#18">RuleSanctionsListBase.constructor</a></td>
+              <td class="coverFnHi">46</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#63">RuleSanctionsListBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#134">RuleSanctionsListBase.onlySanctionListManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#79">RuleSanctionsListBase.setSanctionListOracle</a></td>
+              <td class="coverFnHi">17</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#88">RuleSanctionsListBase.transferred.0</a></td>
+              <td class="coverFnHi">43</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListBase.sol.gcov.html#96">RuleSanctionsListBase.transferred.1</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.gcov.html
new file mode 100644
index 0000000..aa0ff72
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleSanctionsListBase.sol.gcov.html
@@ -0,0 +1,227 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleSanctionsListBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleSanctionsListBase.sol<span style="font-size: 80%;"> (source / <a href="RuleSanctionsListBase.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntry">47</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntry">13</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {MetaTxModuleStandalone} from &quot;../../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleSanctionsListInvariantStorage} from &quot;../invariant/RuleSanctionsListInvariantStorage.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleNFTAdapter} from &quot;../core/RuleNFTAdapter.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {ISanctionsList} from &quot;../../../interfaces/ISanctionsList.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : </a>
+<a name="13"><span class="lineNum">      13 </span>                :            : /**</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @title RuleSanctionsListBase</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * @notice Compliance rule enforcing sanctions-screening for token transfers.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  */</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : abstract contract RuleSanctionsListBase is MetaTxModuleStandalone, RuleNFTAdapter, RuleSanctionsListInvariantStorage {</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     ISanctionsList public sanctionsList;</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">         46 :     constructor(address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         MetaTxModuleStandalone(forwarderIrrevocable)</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     {</a>
+<a name="23"><span class="lineNum">      23 </span>           [<span class="branchCov" title="Branch 0 was taken 20 times"> + </span>]:<span class="lineCov">         45 :         if (address(sanctionContractOracle_) != address(0)) {</span></a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">         20 :             _setSanctionListOracle(sanctionContractOracle_);</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         }</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     }</a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">         84 :     function _detectTransferRestriction(address from, address to, uint256 /* value */)</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         internal</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         view</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :         override</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :         returns (uint8)</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     {</a>
+<a name="34"><span class="lineNum">      34 </span>           [<span class="branchCov" title="Branch 0 was taken 77 times"> + </span>]:<span class="lineCov">         84 :         if (address(sanctionsList) != address(0)) {</span></a>
+<a name="35"><span class="lineNum">      35 </span>        [<span class="branchCov" title="Branch 0 was taken 10 times"> + </span><span class="branchCov" title="Branch 1 was taken 55 times"> + </span>]:<span class="lineCov">         77 :             if (sanctionsList.isSanctioned(from)) {</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">         10 :                 return CODE_ADDRESS_FROM_IS_SANCTIONED;</span></a>
+<a name="37"><span class="lineNum">      37 </span>           [<span class="branchCov" title="Branch 0 was taken 12 times"> + </span>]:<span class="lineCov">         67 :             } else if (sanctionsList.isSanctioned(to)) {</span></a>
+<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">         12 :                 return CODE_ADDRESS_TO_IS_SANCTIONED;</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :            :             }</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         }</a>
+<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">         62 :         return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="42"><span class="lineNum">      42 </span>                :            :     }</a>
+<a name="43"><span class="lineNum">      43 </span>                :            : </a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">         16 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="45"><span class="lineNum">      45 </span>                :            :         internal</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :         view</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         virtual</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         override</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         returns (uint8)</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :     {</a>
+<a name="51"><span class="lineNum">      51 </span>           [<span class="branchCov" title="Branch 0 was taken 15 times"> + </span>]:<span class="lineCov">         16 :         if (address(sanctionsList) != address(0)) {</span></a>
+<a name="52"><span class="lineNum">      52 </span>           [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span>]:<span class="lineCov">         15 :             if (sanctionsList.isSanctioned(spender)) {</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">          6 :                 return CODE_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :            :             }</a>
+<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">          9 :             return _detectTransferRestriction(from, to, value);</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :            :         }</a>
+<a name="57"><span class="lineNum">      57 </span>                :<span class="lineCov">          1 :         return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="58"><span class="lineNum">      58 </span>                :            :     }</a>
+<a name="59"><span class="lineNum">      59 </span>                :            : </a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">          3 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override(IRule) returns (bool) {</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :<span class="lineCov">          3 :         return restrictionCode == CODE_ADDRESS_FROM_IS_SANCTIONED || restrictionCode == CODE_ADDRESS_TO_IS_SANCTIONED</span></a>
+<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">          1 :             || restrictionCode == CODE_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     }</a>
+<a name="64"><span class="lineNum">      64 </span>                :            : </a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">          4 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="66"><span class="lineNum">      66 </span>                :            :         public</a>
+<a name="67"><span class="lineNum">      67 </span>                :            :         pure</a>
+<a name="68"><span class="lineNum">      68 </span>                :            :         override(IERC1404)</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :         returns (string memory)</a>
+<a name="70"><span class="lineNum">      70 </span>                :            :     {</a>
+<a name="71"><span class="lineNum">      71 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          4 :         if (restrictionCode == CODE_ADDRESS_FROM_IS_SANCTIONED) {</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_FROM_IS_SANCTIONED;</span></a>
+<a name="73"><span class="lineNum">      73 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         } else if (restrictionCode == CODE_ADDRESS_TO_IS_SANCTIONED) {</span></a>
+<a name="74"><span class="lineNum">      74 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_TO_IS_SANCTIONED;</span></a>
+<a name="75"><span class="lineNum">      75 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_IS_SANCTIONED) {</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :            :         }</a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">          1 :         return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     }</a>
+<a name="80"><span class="lineNum">      80 </span>                :            : </a>
+<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">         17 :     function setSanctionListOracle(ISanctionsList sanctionContractOracle_) public virtual onlySanctionListManager {</span></a>
+<a name="82"><span class="lineNum">      82 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 14 times"> + </span>]:<span class="lineCov">         15 :         require(address(sanctionContractOracle_) != address(0), RuleSanctionsList_OracleAddressZeroNotAllowed());</span></a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">         14 :         _setSanctionListOracle(sanctionContractOracle_);</span></a>
+<a name="84"><span class="lineNum">      84 </span>                :            :     }</a>
+<a name="85"><span class="lineNum">      85 </span>                :            : </a>
+<a name="86"><span class="lineNum">      86 </span>                :<span class="lineCov">          3 :     function clearSanctionListOracle() public virtual onlySanctionListManager {</span></a>
+<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">          3 :         _setSanctionListOracle(ISanctionsList(address(0)));</span></a>
+<a name="88"><span class="lineNum">      88 </span>                :            :     }</a>
+<a name="89"><span class="lineNum">      89 </span>                :            : </a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">         43 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="91"><span class="lineNum">      91 </span>                :            :         public</a>
+<a name="92"><span class="lineNum">      92 </span>                :            :         view</a>
+<a name="93"><span class="lineNum">      93 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :     {</a>
+<a name="95"><span class="lineNum">      95 </span>                :<span class="lineCov">         43 :         _transferred(from, to, value);</span></a>
+<a name="96"><span class="lineNum">      96 </span>                :            :     }</a>
+<a name="97"><span class="lineNum">      97 </span>                :            : </a>
+<a name="98"><span class="lineNum">      98 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="99"><span class="lineNum">      99 </span>                :            :         public</a>
+<a name="100"><span class="lineNum">     100 </span>                :            :         view</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :         override(IRuleEngine)</a>
+<a name="102"><span class="lineNum">     102 </span>                :            :     {</a>
+<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">          2 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="104"><span class="lineNum">     104 </span>                :            :     }</a>
+<a name="105"><span class="lineNum">     105 </span>                :            : </a>
+<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">         47 :     function _transferred(address from, address to, uint256 value) internal view virtual override {</span></a>
+<a name="107"><span class="lineNum">     107 </span>                :<span class="lineCov">         47 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="108"><span class="lineNum">     108 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 41 times"> + </span>]:<span class="lineCov">         47 :         require(</span></a>
+<a name="109"><span class="lineNum">     109 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="110"><span class="lineNum">     110 </span>                :            :             RuleSanctionsList_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="111"><span class="lineNum">     111 </span>                :            :         );</a>
+<a name="112"><span class="lineNum">     112 </span>                :            :     }</a>
+<a name="113"><span class="lineNum">     113 </span>                :            : </a>
+<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">          3 :     function _transferredFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="115"><span class="lineNum">     115 </span>                :            :         internal</a>
+<a name="116"><span class="lineNum">     116 </span>                :            :         view</a>
+<a name="117"><span class="lineNum">     117 </span>                :            :         virtual</a>
+<a name="118"><span class="lineNum">     118 </span>                :            :         override</a>
+<a name="119"><span class="lineNum">     119 </span>                :            :     {</a>
+<a name="120"><span class="lineNum">     120 </span>                :<span class="lineCov">          3 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="121"><span class="lineNum">     121 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         require(</span></a>
+<a name="122"><span class="lineNum">     122 </span>                :            :             code == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :             RuleSanctionsList_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :         );</a>
+<a name="125"><span class="lineNum">     125 </span>                :            :     }</a>
+<a name="126"><span class="lineNum">     126 </span>                :            : </a>
+<a name="127"><span class="lineNum">     127 </span>                :<span class="lineCov">         37 :     function _setSanctionListOracle(ISanctionsList sanctionContractOracle_) internal virtual {</span></a>
+<a name="128"><span class="lineNum">     128 </span>                :<span class="lineCov">         37 :         sanctionsList = sanctionContractOracle_;</span></a>
+<a name="129"><span class="lineNum">     129 </span>                :<span class="lineCov">         37 :         emit SetSanctionListOracle(sanctionContractOracle_);</span></a>
+<a name="130"><span class="lineNum">     130 </span>                :            :     }</a>
+<a name="131"><span class="lineNum">     131 </span>                :            : </a>
+<a name="132"><span class="lineNum">     132 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="133"><span class="lineNum">     133 </span>                :            :                             ACCESS CONTROL</a>
+<a name="134"><span class="lineNum">     134 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="135"><span class="lineNum">     135 </span>                :            : </a>
+<a name="136"><span class="lineNum">     136 </span>                :<span class="lineCov">          3 :     modifier onlySanctionListManager() {</span></a>
+<a name="137"><span class="lineNum">     137 </span>                :<span class="lineCov">          3 :         _authorizeSanctionListManager();</span></a>
+<a name="138"><span class="lineNum">     138 </span>                :            :         _;</a>
+<a name="139"><span class="lineNum">     139 </span>                :            :     }</a>
+<a name="140"><span class="lineNum">     140 </span>                :            : </a>
+<a name="141"><span class="lineNum">     141 </span>                :            :     function _authorizeSanctionListManager() internal view virtual;</a>
+<a name="142"><span class="lineNum">     142 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func-sort-c.html
new file mode 100644
index 0000000..33acb11
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func-sort-c.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistBase.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#61">RuleWhitelistBase._setCheckSpender</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#46">RuleWhitelistBase.isVerified</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#73">RuleWhitelistBase.onlyCheckSpenderManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#56">RuleWhitelistBase.setCheckSpender</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#32">RuleWhitelistBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#65">RuleWhitelistBase.supportsInterface</a></td>
+              <td class="coverFnHi">27</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#17">RuleWhitelistBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">51</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#13">RuleWhitelistBase.constructor</a></td>
+              <td class="coverFnHi">157</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func.html
new file mode 100644
index 0000000..d99a4bf
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.func.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistBase.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#17">RuleWhitelistBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">51</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#32">RuleWhitelistBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#61">RuleWhitelistBase._setCheckSpender</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#13">RuleWhitelistBase.constructor</a></td>
+              <td class="coverFnHi">157</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#46">RuleWhitelistBase.isVerified</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#73">RuleWhitelistBase.onlyCheckSpenderManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#56">RuleWhitelistBase.setCheckSpender</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistBase.sol.gcov.html#65">RuleWhitelistBase.supportsInterface</a></td>
+              <td class="coverFnHi">27</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.gcov.html
new file mode 100644
index 0000000..cb753c6
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistBase.sol.gcov.html
@@ -0,0 +1,166 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistBase.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistBase.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntry">23</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {RuleAddressSet} from &quot;../RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {RuleWhitelistShared} from &quot;../core/RuleWhitelistShared.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleTransferValidation} from &quot;../core/RuleTransferValidation.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IIdentityRegistryVerified} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : </a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @title RuleWhitelistBase</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @notice Core whitelist logic without access-control policy.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  */</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : abstract contract RuleWhitelistBase is RuleAddressSet, RuleWhitelistShared, IIdentityRegistryVerified {</a>
+<a name="15"><span class="lineNum">      15 </span>                :<span class="lineCov">        157 :     constructor(address forwarderIrrevocable, bool checkSpender_) RuleAddressSet(forwarderIrrevocable) {</span></a>
+<a name="16"><span class="lineNum">      16 </span>                :<span class="lineCov">        157 :         checkSpender = checkSpender_;</span></a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     }</a>
+<a name="18"><span class="lineNum">      18 </span>                :            : </a>
+<a name="19"><span class="lineNum">      19 </span>                :<span class="lineCov">         51 :     function _detectTransferRestriction(address from, address to, uint256 /* value */ )</span></a>
+<a name="20"><span class="lineNum">      20 </span>                :            :         internal</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         view</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :         virtual</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :         override</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         returns (uint8)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     {</a>
+<a name="26"><span class="lineNum">      26 </span>        [<span class="branchCov" title="Branch 0 was taken 13 times"> + </span><span class="branchCov" title="Branch 1 was taken 28 times"> + </span>]:<span class="lineCov">         51 :         if (!isAddressListed(from)) {</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">         13 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
+<a name="28"><span class="lineNum">      28 </span>           [<span class="branchCov" title="Branch 0 was taken 10 times"> + </span>]:<span class="lineCov">         38 :         } else if (!isAddressListed(to)) {</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">         10 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         }</a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">         28 :         return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     }</a>
+<a name="33"><span class="lineNum">      33 </span>                :            : </a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         18 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :            :         internal</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :         view</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :         virtual</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         override</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         returns (uint8)</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :     {</a>
+<a name="41"><span class="lineNum">      41 </span>           [<span class="branchCov" title="Branch 0 was taken 8 times"> + </span>]:<span class="lineCov">         18 :         if (checkSpender &amp;&amp; !isAddressListed(spender)) {</span></a>
+<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">          8 :             return CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         }</a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">         10 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="45"><span class="lineNum">      45 </span>                :            :     }</a>
+<a name="46"><span class="lineNum">      46 </span>                :            : </a>
+<a name="47"><span class="lineNum">      47 </span>                :            : </a>
+<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">          2 :     function isVerified(address targetAddress)</span></a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         public</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :         view</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         virtual</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :         override(IIdentityRegistryVerified)</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :         returns (bool isListed)</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :     {</a>
+<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">          2 :         isListed = _isAddressListed(targetAddress);</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     }</a>
+<a name="57"><span class="lineNum">      57 </span>                :            : </a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">          3 :     function setCheckSpender(bool value) public virtual onlyCheckSpenderManager {</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">          2 :         _setCheckSpender(value);</span></a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">          2 :         emit CheckSpenderUpdated(value);</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :            :     }</a>
+<a name="62"><span class="lineNum">      62 </span>                :            : </a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">          2 :     function _setCheckSpender(bool value) internal virtual {</span></a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">          2 :         checkSpender = value;</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :            :     }</a>
+<a name="66"><span class="lineNum">      66 </span>                :            : </a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">         27 :     function supportsInterface(bytes4 interfaceId) public view virtual override(RuleTransferValidation) returns (bool) {</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">         27 :         return RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :            :     }</a>
+<a name="70"><span class="lineNum">      70 </span>                :            : </a>
+<a name="71"><span class="lineNum">      71 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :                             ACCESS CONTROL</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="74"><span class="lineNum">      74 </span>                :            : </a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">          3 :     modifier onlyCheckSpenderManager() {</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">          3 :         _authorizeCheckSpenderManager();</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :            :         _;</a>
+<a name="78"><span class="lineNum">      78 </span>                :            :     }</a>
+<a name="79"><span class="lineNum">      79 </span>                :            : </a>
+<a name="80"><span class="lineNum">      80 </span>                :            :     function _authorizeCheckSpenderManager() internal view virtual;</a>
+<a name="81"><span class="lineNum">      81 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func-sort-c.html b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func-sort-c.html
new file mode 100644
index 0000000..62a206a
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func-sort-c.html
@@ -0,0 +1,137 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistWrapperBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistWrapperBase.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapperBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistWrapperBase.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#151">RuleWhitelistWrapperBase._transferred.1</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#235">RuleWhitelistWrapperBase._msgData</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#206">RuleWhitelistWrapperBase._setCheckSpender</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#114">RuleWhitelistWrapperBase.isVerified</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#214">RuleWhitelistWrapperBase.onlyCheckSpenderManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#137">RuleWhitelistWrapperBase.setCheckSpender</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#142">RuleWhitelistWrapperBase._transferred.0</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#69">RuleWhitelistWrapperBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">20</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#48">RuleWhitelistWrapperBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">34</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#34">RuleWhitelistWrapperBase.constructor</a></td>
+              <td class="coverFnHi">44</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#169">RuleWhitelistWrapperBase._detectTransferRestrictionForTargets</a></td>
+              <td class="coverFnHi">57</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#100">RuleWhitelistWrapperBase.supportsInterface</a></td>
+              <td class="coverFnHi">62</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#228">RuleWhitelistWrapperBase._msgSender</a></td>
+              <td class="coverFnHi">145</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#242">RuleWhitelistWrapperBase._contextSuffixLength</a></td>
+              <td class="coverFnHi">147</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func.html b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func.html
new file mode 100644
index 0000000..643e123
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.func.html
@@ -0,0 +1,137 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistWrapperBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistWrapperBase.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapperBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistWrapperBase.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#242">RuleWhitelistWrapperBase._contextSuffixLength</a></td>
+              <td class="coverFnHi">147</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#48">RuleWhitelistWrapperBase._detectTransferRestriction</a></td>
+              <td class="coverFnHi">34</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#169">RuleWhitelistWrapperBase._detectTransferRestrictionForTargets</a></td>
+              <td class="coverFnHi">57</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#69">RuleWhitelistWrapperBase._detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">20</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#235">RuleWhitelistWrapperBase._msgData</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#228">RuleWhitelistWrapperBase._msgSender</a></td>
+              <td class="coverFnHi">145</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#206">RuleWhitelistWrapperBase._setCheckSpender</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#142">RuleWhitelistWrapperBase._transferred.0</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#151">RuleWhitelistWrapperBase._transferred.1</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#34">RuleWhitelistWrapperBase.constructor</a></td>
+              <td class="coverFnHi">44</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#114">RuleWhitelistWrapperBase.isVerified</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#214">RuleWhitelistWrapperBase.onlyCheckSpenderManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#137">RuleWhitelistWrapperBase.setCheckSpender</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperBase.sol.gcov.html#100">RuleWhitelistWrapperBase.supportsInterface</a></td>
+              <td class="coverFnHi">62</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleSanctionsList.sol.gcov.html b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.gcov.html
similarity index 55%
rename from doc/coverage/coverage/validation/RuleSanctionsList.sol.gcov.html
rename to doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.gcov.html
index 1d03613..2a4e421 100644
--- a/doc/coverage/coverage/validation/RuleSanctionsList.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/base/RuleWhitelistWrapperBase.sol.gcov.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleSanctionsList.sol</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
+  <title>LCOV - lcov.info - abstract/base/RuleWhitelistWrapperBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (source / <a href="RuleSanctionsList.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/base</a> - RuleWhitelistWrapperBase.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistWrapperBase.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,34 +31,34 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">54</td>
-            <td class="headerCovTableEntryHi">92.6 %</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntry">67</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">18</td>
-            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <table cellpadding=0 cellspacing=0 border=0>
@@ -73,266 +73,249 @@
 <a name="2"><span class="lineNum">       2 </span>                :            : </a>
 <a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
 <a name="4"><span class="lineNum">       4 </span>                :            : </a>
-<a name="5"><span class="lineNum">       5 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : /* ==== Abtract contracts === */</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context, Context} from &quot;../../modules/MetaTxModuleStandalone.sol&quot;;</a>
-<a name="8"><span class="lineNum">       8 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../modules/AccessControlModuleStandalone.sol&quot;;</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleSanctionsListInvariantStorage} from &quot;./abstract/RuleSanctionsListInvariantStorage.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleValidateTransfer, RuleValidateTransfer} from &quot;./abstract/RuleValidateTransfer.sol&quot;;</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : /* ==== Interfaces === */</a>
-<a name="12"><span class="lineNum">      12 </span>                :            : import {ISanctionsList} from &quot;../interfaces/ISanctionsList.sol&quot;;</a>
-<a name="13"><span class="lineNum">      13 </span>                :            : import {IERC7943NonFungibleComplianceExtend} from &quot;../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : /* ==== OpenZeppelin === */</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context} from &quot;../../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleWhitelistShared} from &quot;../core/RuleWhitelistShared.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {RuleTransferValidation} from &quot;../core/RuleTransferValidation.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /* ==== RuleEngine === */</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : import {RulesManagementModule} from &quot;RuleEngine/modules/RulesManagementModule.sol&quot;;</a>
 <a name="14"><span class="lineNum">      14 </span>                :            : /* ==== CMTAT === */</a>
 <a name="15"><span class="lineNum">      15 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
-<a name="16"><span class="lineNum">      16 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
-<a name="17"><span class="lineNum">      17 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
-<a name="18"><span class="lineNum">      18 </span>                :            : /* ==== IRuleEngine === */</a>
-<a name="19"><span class="lineNum">      19 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
-<a name="20"><span class="lineNum">      20 </span>                :            : </a>
-<a name="21"><span class="lineNum">      21 </span>                :            : </a>
-<a name="22"><span class="lineNum">      22 </span>                :            : /**</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :  * @title RuleSanctionsList</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :  * @notice Compliance rule enforcing sanctions-screening for token transfers.</a>
-<a name="25"><span class="lineNum">      25 </span>                :            :  * @dev</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :  *  This rule integrates a sanctions-oracle (e.g., Chainalysis) and blocks</a>
-<a name="27"><span class="lineNum">      27 </span>                :            :  *  transfers when:</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :  *    - the sender is sanctioned,</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :  *    - the recipient is sanctioned,</a>
-<a name="30"><span class="lineNum">      30 </span>                :            :  *    - or the spender/operator is sanctioned.</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :  *</a>
-<a name="32"><span class="lineNum">      32 </span>                :            :  *  Features:</a>
-<a name="33"><span class="lineNum">      33 </span>                :            :  *    - Supports ERC-1404, ERC-3643 (transferred) and ERC-7943 non-fungible compliance flows.</a>
-<a name="34"><span class="lineNum">      34 </span>                :            :  *    - Oracle address can be updated by accounts holding `SANCTIONLIST_ROLE`.</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :  *    - Zero oracle address disables sanctions checks (all transfers allowed).</a>
-<a name="36"><span class="lineNum">      36 </span>                :            :  *</a>
-<a name="37"><span class="lineNum">      37 </span>                :            :  *  The rule is designed for RuleEngine or for direct integration with</a>
-<a name="38"><span class="lineNum">      38 </span>                :            :  *  CMTAT / ERC-3643 compliant tokens.</a>
-<a name="39"><span class="lineNum">      39 </span>                :            :  */</a>
-<a name="40"><span class="lineNum">      40 </span>                :            : contract RuleSanctionsList is</a>
-<a name="41"><span class="lineNum">      41 </span>                :            :     AccessControlModuleStandalone,</a>
-<a name="42"><span class="lineNum">      42 </span>                :            :     MetaTxModuleStandalone,</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :     RuleValidateTransfer,</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :     RuleSanctionsListInvariantStorage</a>
-<a name="45"><span class="lineNum">      45 </span>                :            : {</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :     ISanctionsList public sanctionsList;</a>
-<a name="47"><span class="lineNum">      47 </span>                :            : </a>
-<a name="48"><span class="lineNum">      48 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :                               CONSTRUCTOR</a>
-<a name="50"><span class="lineNum">      50 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="51"><span class="lineNum">      51 </span>                :            :     /**</a>
-<a name="52"><span class="lineNum">      52 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
-<a name="53"><span class="lineNum">      53 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
-<a name="54"><span class="lineNum">      54 </span>                :            :      */</a>
-<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">         17 :     constructor(address admin, address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)</span></a>
-<a name="56"><span class="lineNum">      56 </span>                :            :         MetaTxModuleStandalone(forwarderIrrevocable)</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :         AccessControlModuleStandalone(admin)</a>
-<a name="58"><span class="lineNum">      58 </span>                :            :     {</a>
-<a name="59"><span class="lineNum">      59 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">         16 :         if (address(sanctionContractOracle_) != address(0)) {</span></a>
-<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">          1 :             _setSanctionListOracle(sanctionContractOracle_);</span></a>
-<a name="61"><span class="lineNum">      61 </span>                :            :         }</a>
-<a name="62"><span class="lineNum">      62 </span>                :            :     }</a>
-<a name="63"><span class="lineNum">      63 </span>                :            : </a>
-<a name="64"><span class="lineNum">      64 </span>                :            :     /* ============  View Functions ============ */</a>
-<a name="65"><span class="lineNum">      65 </span>                :            : </a>
-<a name="66"><span class="lineNum">      66 </span>                :            :     /**</a>
-<a name="67"><span class="lineNum">      67 </span>                :            :      * @notice Check if an addres is in the SanctionsList or not</a>
-<a name="68"><span class="lineNum">      68 </span>                :            :      * @param from the origin address</a>
-<a name="69"><span class="lineNum">      69 </span>                :            :      * @param to the destination address</a>
-<a name="70"><span class="lineNum">      70 </span>                :            :      * @return The restricion code or REJECTED_CODE_BASE.TRANSFER_OK</a>
-<a name="71"><span class="lineNum">      71 </span>                :            :      *</a>
-<a name="72"><span class="lineNum">      72 </span>                :            :      */</a>
-<a name="73"><span class="lineNum">      73 </span>                :<span class="lineCov">         17 :     function detectTransferRestriction(address from, address to, uint256 /*value */ )</span></a>
-<a name="74"><span class="lineNum">      74 </span>                :            :         public</a>
-<a name="75"><span class="lineNum">      75 </span>                :            :         view</a>
-<a name="76"><span class="lineNum">      76 </span>                :            :         override(IERC1404)</a>
-<a name="77"><span class="lineNum">      77 </span>                :            :         returns (uint8)</a>
-<a name="78"><span class="lineNum">      78 </span>                :            :     {</a>
-<a name="79"><span class="lineNum">      79 </span>           [<span class="branchCov" title="Branch 0 was taken 30 times"> + </span>]:<span class="lineCov">         35 :         if (address(sanctionsList) != address(0)) {</span></a>
-<a name="80"><span class="lineNum">      80 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 14 times"> + </span>]:<span class="lineCov">         30 :             if (sanctionsList.isSanctioned(from)) {</span></a>
-<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">          6 :                 return CODE_ADDRESS_FROM_IS_SANCTIONED;</span></a>
-<a name="82"><span class="lineNum">      82 </span>           [<span class="branchCov" title="Branch 0 was taken 10 times"> + </span>]:<span class="lineCov">         24 :             } else if (sanctionsList.isSanctioned(to)) {</span></a>
-<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">         10 :                 return CODE_ADDRESS_TO_IS_SANCTIONED;</span></a>
-<a name="84"><span class="lineNum">      84 </span>                :            :             }</a>
-<a name="85"><span class="lineNum">      85 </span>                :            :         }</a>
-<a name="86"><span class="lineNum">      86 </span>                :<span class="lineCov">         19 :         return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="87"><span class="lineNum">      87 </span>                :            :     }</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : /* ==== Interfaces === */</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : import {IAddressList} from &quot;../../../interfaces/IAddressList.sol&quot;;</a>
+<a name="18"><span class="lineNum">      18 </span>                :            : import {IIdentityRegistryVerified} from &quot;../../../interfaces/IIdentityRegistry.sol&quot;;</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :            : /**</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :  * @title Wrapper to call several different whitelist rules (base)</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :  * @dev Child rules must implement {IAddressList}.</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :  */</a>
+<a name="24"><span class="lineNum">      24 </span>                :            : abstract contract RuleWhitelistWrapperBase is</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     RulesManagementModule,</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     MetaTxModuleStandalone,</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :     RuleWhitelistShared,</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :     IIdentityRegistryVerified</a>
+<a name="29"><span class="lineNum">      29 </span>                :            : {</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :                               CONSTRUCTOR</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     /**</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      */</a>
+<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">         44 :     constructor(address forwarderIrrevocable, bool checkSpender_)</span></a>
+<a name="37"><span class="lineNum">      37 </span>                :            :         MetaTxModuleStandalone(forwarderIrrevocable)</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :     {</a>
+<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">         44 :         checkSpender = checkSpender_;</span></a>
+<a name="40"><span class="lineNum">      40 </span>                :            :     }</a>
+<a name="41"><span class="lineNum">      41 </span>                :            : </a>
+<a name="42"><span class="lineNum">      42 </span>                :            :     /* ============  View Functions ============ */</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :     /**</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :      * @notice Go through all the whitelist rules to know if a restriction exists on the transfer</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :      * @param from the origin address</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :      * @param to the destination address</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :      * @return The restricion code or REJECTED_CODE_BASE.TRANSFER_OK</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :      *</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :      */</a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">         34 :     function _detectTransferRestriction(address from, address to, uint256 /* value */)</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         internal</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :         view</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :         virtual</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         override</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :         returns (uint8)</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     {</a>
+<a name="57"><span class="lineNum">      57 </span>                :<span class="lineCov">         34 :         address[] memory targetAddress = new address[](2);</span></a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">         34 :         targetAddress[0] = from;</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">         34 :         targetAddress[1] = to;</span></a>
+<a name="60"><span class="lineNum">      60 </span>                :            : </a>
+<a name="61"><span class="lineNum">      61 </span>                :<span class="lineCov">         34 :         bool[] memory result = _detectTransferRestrictionForTargets(targetAddress);</span></a>
+<a name="62"><span class="lineNum">      62 </span>        [<span class="branchCov" title="Branch 0 was taken 13 times"> + </span><span class="branchCov" title="Branch 1 was taken 13 times"> + </span>]:<span class="lineCov">         34 :         if (!result[0]) {</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">         13 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
+<a name="64"><span class="lineNum">      64 </span>        [<span class="branchCov" title="Branch 0 was taken 8 times"> + </span><span class="branchCov" title="Branch 1 was taken 13 times"> + </span>]:<span class="lineCov">         21 :         } else if (!result[1]) {</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">          8 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="66"><span class="lineNum">      66 </span>                :            :         } else {</a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">         13 :             return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :            :         }</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :     }</a>
+<a name="70"><span class="lineNum">      70 </span>                :            : </a>
+<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">         20 :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         internal</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :         view</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :         virtual</a>
+<a name="75"><span class="lineNum">      75 </span>                :            :         override</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :         returns (uint8)</a>
+<a name="77"><span class="lineNum">      77 </span>                :            :     {</a>
+<a name="78"><span class="lineNum">      78 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">         20 :         if (!checkSpender) {</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :<span class="lineCov">          1 :             return _detectTransferRestriction(from, to, value);</span></a>
+<a name="80"><span class="lineNum">      80 </span>                :            :         }</a>
+<a name="81"><span class="lineNum">      81 </span>                :            : </a>
+<a name="82"><span class="lineNum">      82 </span>                :<span class="lineCov">         19 :         address[] memory targetAddress = new address[](3);</span></a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">         19 :         targetAddress[0] = from;</span></a>
+<a name="84"><span class="lineNum">      84 </span>                :<span class="lineCov">         19 :         targetAddress[1] = to;</span></a>
+<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">         19 :         targetAddress[2] = spender;</span></a>
+<a name="86"><span class="lineNum">      86 </span>                :            : </a>
+<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">         19 :         bool[] memory result = _detectTransferRestrictionForTargets(targetAddress);</span></a>
 <a name="88"><span class="lineNum">      88 </span>                :            : </a>
-<a name="89"><span class="lineNum">      89 </span>                :            :     /**</a>
-<a name="90"><span class="lineNum">      90 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="91"><span class="lineNum">      91 </span>                :            :      */</a>
-<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">          9 :     function detectTransferRestriction(address from, address to, uint256, /* tokenId */ uint256 value)</span></a>
-<a name="93"><span class="lineNum">      93 </span>                :            :         public</a>
-<a name="94"><span class="lineNum">      94 </span>                :            :         view</a>
-<a name="95"><span class="lineNum">      95 </span>                :            :         virtual</a>
-<a name="96"><span class="lineNum">      96 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="97"><span class="lineNum">      97 </span>                :            :         returns (uint8)</a>
-<a name="98"><span class="lineNum">      98 </span>                :            :     {</a>
-<a name="99"><span class="lineNum">      99 </span>                :<span class="lineCov">          9 :         return detectTransferRestriction(from, to, value);</span></a>
-<a name="100"><span class="lineNum">     100 </span>                :            :     }</a>
+<a name="89"><span class="lineNum">      89 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 9 times"> + </span>]:<span class="lineCov">         19 :         if (!result[0]) {</span></a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">          1 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
+<a name="91"><span class="lineNum">      91 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 9 times"> + </span>]:<span class="lineCov">         18 :         } else if (!result[1]) {</span></a>
+<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">          1 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="93"><span class="lineNum">      93 </span>        [<span class="branchCov" title="Branch 0 was taken 8 times"> + </span><span class="branchCov" title="Branch 1 was taken 9 times"> + </span>]:<span class="lineCov">         17 :         } else if (!result[2]) {</span></a>
+<a name="94"><span class="lineNum">      94 </span>                :<span class="lineCov">          8 :             return CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
+<a name="95"><span class="lineNum">      95 </span>                :            :         } else {</a>
+<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">          9 :             return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :            :         }</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :     }</a>
+<a name="99"><span class="lineNum">      99 </span>                :            : </a>
+<a name="100"><span class="lineNum">     100 </span>                :            :     // ERC-7943 tokenId overloads are provided by {RuleNFTAdapter} via RuleWhitelistShared.</a>
 <a name="101"><span class="lineNum">     101 </span>                :            : </a>
-<a name="102"><span class="lineNum">     102 </span>                :            :     /**</a>
-<a name="103"><span class="lineNum">     103 </span>                :            :      * @inheritdoc IERC1404Extend</a>
-<a name="104"><span class="lineNum">     104 </span>                :            :      */</a>
-<a name="105"><span class="lineNum">     105 </span>                :<span class="lineCov">         11 :     function detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
-<a name="106"><span class="lineNum">     106 </span>                :            :         public</a>
-<a name="107"><span class="lineNum">     107 </span>                :            :         view</a>
-<a name="108"><span class="lineNum">     108 </span>                :            :         virtual</a>
-<a name="109"><span class="lineNum">     109 </span>                :            :         override(IERC1404Extend)</a>
-<a name="110"><span class="lineNum">     110 </span>                :            :         returns (uint8)</a>
-<a name="111"><span class="lineNum">     111 </span>                :            :     {</a>
-<a name="112"><span class="lineNum">     112 </span>           [<span class="branchCov" title="Branch 0 was taken 13 times"> + </span>]:<span class="lineCov">         14 :         if (address(sanctionsList) != address(0)) {</span></a>
-<a name="113"><span class="lineNum">     113 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 9 times"> + </span>]:<span class="lineCov">         13 :             if (sanctionsList.isSanctioned(spender)) {</span></a>
-<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">          4 :                 return CODE_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
-<a name="115"><span class="lineNum">     115 </span>                :            :             } else {</a>
-<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">          9 :                 return detectTransferRestriction(from, to, value);</span></a>
-<a name="117"><span class="lineNum">     117 </span>                :            :             }</a>
-<a name="118"><span class="lineNum">     118 </span>                :            :         }</a>
-<a name="119"><span class="lineNum">     119 </span>                :<span class="lineCov">          1 :         return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="120"><span class="lineNum">     120 </span>                :            :     }</a>
-<a name="121"><span class="lineNum">     121 </span>                :            : </a>
-<a name="122"><span class="lineNum">     122 </span>                :<span class="lineCov">          3 :     function detectTransferRestrictionFrom(</span></a>
-<a name="123"><span class="lineNum">     123 </span>                :            :         address spender,</a>
-<a name="124"><span class="lineNum">     124 </span>                :            :         address from,</a>
-<a name="125"><span class="lineNum">     125 </span>                :            :         address to,</a>
-<a name="126"><span class="lineNum">     126 </span>                :            :         uint256, /* tokenId */</a>
-<a name="127"><span class="lineNum">     127 </span>                :            :         uint256 value</a>
-<a name="128"><span class="lineNum">     128 </span>                :            :     ) public view virtual override(IERC7943NonFungibleComplianceExtend) returns (uint8) {</a>
-<a name="129"><span class="lineNum">     129 </span>                :<span class="lineCov">          3 :         return detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="130"><span class="lineNum">     130 </span>                :            :     }</a>
-<a name="131"><span class="lineNum">     131 </span>                :            : </a>
-<a name="132"><span class="lineNum">     132 </span>                :            :     /**</a>
-<a name="133"><span class="lineNum">     133 </span>                :            :      * @notice To know if the restriction code is valid for this rule or not.</a>
-<a name="134"><span class="lineNum">     134 </span>                :            :      * @param restrictionCode The target restriction code</a>
-<a name="135"><span class="lineNum">     135 </span>                :            :      * @return true if the restriction code is known, false otherwise</a>
-<a name="136"><span class="lineNum">     136 </span>                :            :      *</a>
-<a name="137"><span class="lineNum">     137 </span>                :            :      */</a>
-<a name="138"><span class="lineNum">     138 </span>                :<span class="lineCov">          3 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override(IRule) returns (bool) {</span></a>
-<a name="139"><span class="lineNum">     139 </span>                :<span class="lineCov">          3 :         return restrictionCode == CODE_ADDRESS_FROM_IS_SANCTIONED || restrictionCode == CODE_ADDRESS_TO_IS_SANCTIONED</span></a>
-<a name="140"><span class="lineNum">     140 </span>                :<span class="lineCov">          1 :             || restrictionCode == CODE_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
-<a name="141"><span class="lineNum">     141 </span>                :            :     }</a>
-<a name="142"><span class="lineNum">     142 </span>                :            : </a>
-<a name="143"><span class="lineNum">     143 </span>                :            :     /**</a>
-<a name="144"><span class="lineNum">     144 </span>                :            :      * @notice Return the corresponding message</a>
-<a name="145"><span class="lineNum">     145 </span>                :            :      * @param restrictionCode The target restriction code</a>
-<a name="146"><span class="lineNum">     146 </span>                :            :      * @return true if the transfer is valid, false otherwise</a>
-<a name="147"><span class="lineNum">     147 </span>                :            :      *</a>
-<a name="148"><span class="lineNum">     148 </span>                :            :      */</a>
-<a name="149"><span class="lineNum">     149 </span>                :<span class="lineCov">          4 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
-<a name="150"><span class="lineNum">     150 </span>                :            :         public</a>
-<a name="151"><span class="lineNum">     151 </span>                :            :         pure</a>
-<a name="152"><span class="lineNum">     152 </span>                :            :         virtual</a>
-<a name="153"><span class="lineNum">     153 </span>                :            :         override(IERC1404)</a>
-<a name="154"><span class="lineNum">     154 </span>                :            :         returns (string memory)</a>
-<a name="155"><span class="lineNum">     155 </span>                :            :     {</a>
-<a name="156"><span class="lineNum">     156 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          4 :         if (restrictionCode == CODE_ADDRESS_FROM_IS_SANCTIONED) {</span></a>
-<a name="157"><span class="lineNum">     157 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_FROM_IS_SANCTIONED;</span></a>
-<a name="158"><span class="lineNum">     158 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         } else if (restrictionCode == CODE_ADDRESS_TO_IS_SANCTIONED) {</span></a>
-<a name="159"><span class="lineNum">     159 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_TO_IS_SANCTIONED;</span></a>
-<a name="160"><span class="lineNum">     160 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_IS_SANCTIONED) {</span></a>
-<a name="161"><span class="lineNum">     161 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_IS_SANCTIONED;</span></a>
-<a name="162"><span class="lineNum">     162 </span>                :            :         } else {</a>
-<a name="163"><span class="lineNum">     163 </span>                :<span class="lineCov">          1 :             return TEXT_CODE_NOT_FOUND;</span></a>
-<a name="164"><span class="lineNum">     164 </span>                :            :         }</a>
-<a name="165"><span class="lineNum">     165 </span>                :            :     }</a>
-<a name="166"><span class="lineNum">     166 </span>                :            : </a>
-<a name="167"><span class="lineNum">     167 </span>                :<span class="lineNoCov">          0 :     function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControl, RuleValidateTransfer) returns (bool) {</span></a>
-<a name="168"><span class="lineNum">     168 </span>                :<span class="lineNoCov">          0 :         return AccessControl.supportsInterface(interfaceId) || RuleValidateTransfer.supportsInterface(interfaceId);</span></a>
-<a name="169"><span class="lineNum">     169 </span>                :            :     }</a>
-<a name="170"><span class="lineNum">     170 </span>                :            : </a>
-<a name="171"><span class="lineNum">     171 </span>                :            :     /* ============  State Functions ============ */</a>
-<a name="172"><span class="lineNum">     172 </span>                :            :     /**</a>
-<a name="173"><span class="lineNum">     173 </span>                :            :      * @notice Set the oracle contract</a>
-<a name="174"><span class="lineNum">     174 </span>                :            :      * @param sanctionContractOracle_ address of your oracle contract</a>
-<a name="175"><span class="lineNum">     175 </span>                :            :      * @dev zero address is authorized to authorize all transfers</a>
-<a name="176"><span class="lineNum">     176 </span>                :            :      */</a>
-<a name="177"><span class="lineNum">     177 </span>                :<span class="lineCov">         14 :     function setSanctionListOracle(ISanctionsList sanctionContractOracle_) public virtual onlyRole(SANCTIONLIST_ROLE) {</span></a>
-<a name="178"><span class="lineNum">     178 </span>                :<span class="lineCov">         13 :         _setSanctionListOracle(sanctionContractOracle_);</span></a>
-<a name="179"><span class="lineNum">     179 </span>                :            :     }</a>
-<a name="180"><span class="lineNum">     180 </span>                :            : </a>
-<a name="181"><span class="lineNum">     181 </span>                :            :     /**</a>
-<a name="182"><span class="lineNum">     182 </span>                :            :      * @inheritdoc IERC3643IComplianceContract</a>
-<a name="183"><span class="lineNum">     183 </span>                :            :      */</a>
-<a name="184"><span class="lineNum">     184 </span>                :<span class="lineCov">          3 :     function transferred(address from, address to, uint256 value)</span></a>
-<a name="185"><span class="lineNum">     185 </span>                :            :         public</a>
-<a name="186"><span class="lineNum">     186 </span>                :            :         view</a>
-<a name="187"><span class="lineNum">     187 </span>                :            :         virtual</a>
-<a name="188"><span class="lineNum">     188 </span>                :            :         override(IERC3643IComplianceContract)</a>
-<a name="189"><span class="lineNum">     189 </span>                :            :     {</a>
-<a name="190"><span class="lineNum">     190 </span>                :<span class="lineCov">          7 :         uint8 code = this.detectTransferRestriction(from, to, value);</span></a>
-<a name="191"><span class="lineNum">     191 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 3 times"> + </span>]:<span class="lineCov">          7 :         require(</span></a>
-<a name="192"><span class="lineNum">     192 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="193"><span class="lineNum">     193 </span>                :            :             RuleSanctionsList_InvalidTransfer(address(this), from, to, value, code)</a>
-<a name="194"><span class="lineNum">     194 </span>                :            :         );</a>
-<a name="195"><span class="lineNum">     195 </span>                :            :     }</a>
-<a name="196"><span class="lineNum">     196 </span>                :            : </a>
-<a name="197"><span class="lineNum">     197 </span>                :            :     </a>
-<a name="198"><span class="lineNum">     198 </span>                :            :     /**</a>
-<a name="199"><span class="lineNum">     199 </span>                :            :      * @inheritdoc IRuleEngine</a>
-<a name="200"><span class="lineNum">     200 </span>                :            :      */</a>
-<a name="201"><span class="lineNum">     201 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
-<a name="202"><span class="lineNum">     202 </span>                :            :         public</a>
-<a name="203"><span class="lineNum">     203 </span>                :            :         view</a>
-<a name="204"><span class="lineNum">     204 </span>                :            :         virtual</a>
-<a name="205"><span class="lineNum">     205 </span>                :            :         override(IRuleEngine)</a>
-<a name="206"><span class="lineNum">     206 </span>                :            :     {</a>
-<a name="207"><span class="lineNum">     207 </span>                :<span class="lineCov">          3 :         uint8 code = this.detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="208"><span class="lineNum">     208 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          3 :         require(</span></a>
-<a name="209"><span class="lineNum">     209 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="210"><span class="lineNum">     210 </span>                :            :             RuleSanctionsList_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
-<a name="211"><span class="lineNum">     211 </span>                :            :         );</a>
-<a name="212"><span class="lineNum">     212 </span>                :            :     }</a>
-<a name="213"><span class="lineNum">     213 </span>                :            : </a>
-<a name="214"><span class="lineNum">     214 </span>                :<span class="lineCov">          1 :     function transferred(address spender, address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="215"><span class="lineNum">     215 </span>                :            :         public</a>
-<a name="216"><span class="lineNum">     216 </span>                :            :         view</a>
-<a name="217"><span class="lineNum">     217 </span>                :            :         virtual</a>
-<a name="218"><span class="lineNum">     218 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="219"><span class="lineNum">     219 </span>                :            :     {</a>
-<a name="220"><span class="lineNum">     220 </span>                :<span class="lineCov">          1 :         transferred(spender, from, to, value);</span></a>
-<a name="221"><span class="lineNum">     221 </span>                :            :     }</a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">         62 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :            :         public</a>
+<a name="104"><span class="lineNum">     104 </span>                :            :         view</a>
+<a name="105"><span class="lineNum">     105 </span>                :            :         virtual</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :         override(AccessControl, RuleTransferValidation)</a>
+<a name="107"><span class="lineNum">     107 </span>                :            :         returns (bool)</a>
+<a name="108"><span class="lineNum">     108 </span>                :            :     {</a>
+<a name="109"><span class="lineNum">     109 </span>                :<span class="lineCov">         62 :         return AccessControl.supportsInterface(interfaceId) || RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="110"><span class="lineNum">     110 </span>                :            :     }</a>
+<a name="111"><span class="lineNum">     111 </span>                :            : </a>
+<a name="112"><span class="lineNum">     112 </span>                :            :     /**</a>
+<a name="113"><span class="lineNum">     113 </span>                :            :      * @notice Returns true if the address is listed in at least one child whitelist rule.</a>
+<a name="114"><span class="lineNum">     114 </span>                :            :      * @dev Delegates to the same child-rule scan used by transfer restriction checks.</a>
+<a name="115"><span class="lineNum">     115 </span>                :            :      */</a>
+<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">          4 :     function isVerified(address targetAddress)</span></a>
+<a name="117"><span class="lineNum">     117 </span>                :            :         public</a>
+<a name="118"><span class="lineNum">     118 </span>                :            :         view</a>
+<a name="119"><span class="lineNum">     119 </span>                :            :         virtual</a>
+<a name="120"><span class="lineNum">     120 </span>                :            :         override(IIdentityRegistryVerified)</a>
+<a name="121"><span class="lineNum">     121 </span>                :            :         returns (bool)</a>
+<a name="122"><span class="lineNum">     122 </span>                :            :     {</a>
+<a name="123"><span class="lineNum">     123 </span>                :<span class="lineCov">          4 :         address[] memory targets = new address[](1);</span></a>
+<a name="124"><span class="lineNum">     124 </span>                :<span class="lineCov">          4 :         targets[0] = targetAddress;</span></a>
+<a name="125"><span class="lineNum">     125 </span>                :<span class="lineCov">          4 :         bool[] memory result = _detectTransferRestrictionForTargets(targets);</span></a>
+<a name="126"><span class="lineNum">     126 </span>                :<span class="lineCov">          4 :         return result[0];</span></a>
+<a name="127"><span class="lineNum">     127 </span>                :            :     }</a>
+<a name="128"><span class="lineNum">     128 </span>                :            : </a>
+<a name="129"><span class="lineNum">     129 </span>                :            :     /* ============  Access control ============ */</a>
+<a name="130"><span class="lineNum">     130 </span>                :            : </a>
+<a name="131"><span class="lineNum">     131 </span>                :            :     /**</a>
+<a name="132"><span class="lineNum">     132 </span>                :            :      * @notice Sets whether the rule should enforce spender-based checks.</a>
+<a name="133"><span class="lineNum">     133 </span>                :            :      * @dev</a>
+<a name="134"><span class="lineNum">     134 </span>                :            :      *  - Restricted to holders of the manager role.</a>
+<a name="135"><span class="lineNum">     135 </span>                :            :      *  - Updates the internal `checkSpender` flag.</a>
+<a name="136"><span class="lineNum">     136 </span>                :            :      *  - Emits a {CheckSpenderUpdated} event.</a>
+<a name="137"><span class="lineNum">     137 </span>                :            :      * @param value The new state of the `checkSpender` flag.</a>
+<a name="138"><span class="lineNum">     138 </span>                :            :      */</a>
+<a name="139"><span class="lineNum">     139 </span>                :<span class="lineCov">          4 :     function setCheckSpender(bool value) public virtual onlyCheckSpenderManager {</span></a>
+<a name="140"><span class="lineNum">     140 </span>                :<span class="lineCov">          3 :         _setCheckSpender(value);</span></a>
+<a name="141"><span class="lineNum">     141 </span>                :<span class="lineCov">          3 :         emit CheckSpenderUpdated(value);</span></a>
+<a name="142"><span class="lineNum">     142 </span>                :            :     }</a>
+<a name="143"><span class="lineNum">     143 </span>                :            : </a>
+<a name="144"><span class="lineNum">     144 </span>                :<span class="lineCov">         13 :     function _transferred(address from, address to, uint256 value)</span></a>
+<a name="145"><span class="lineNum">     145 </span>                :            :         internal</a>
+<a name="146"><span class="lineNum">     146 </span>                :            :         view</a>
+<a name="147"><span class="lineNum">     147 </span>                :            :         virtual</a>
+<a name="148"><span class="lineNum">     148 </span>                :            :         override(RulesManagementModule, RuleWhitelistShared)</a>
+<a name="149"><span class="lineNum">     149 </span>                :            :     {</a>
+<a name="150"><span class="lineNum">     150 </span>                :<span class="lineCov">         13 :         RuleWhitelistShared._transferred(from, to, value);</span></a>
+<a name="151"><span class="lineNum">     151 </span>                :            :     }</a>
+<a name="152"><span class="lineNum">     152 </span>                :            : </a>
+<a name="153"><span class="lineNum">     153 </span>                :<span class="lineCov">          1 :     function _transferred(address spender, address from, address to, uint256 value)</span></a>
+<a name="154"><span class="lineNum">     154 </span>                :            :         internal</a>
+<a name="155"><span class="lineNum">     155 </span>                :            :         view</a>
+<a name="156"><span class="lineNum">     156 </span>                :            :         virtual</a>
+<a name="157"><span class="lineNum">     157 </span>                :            :         override(RulesManagementModule)</a>
+<a name="158"><span class="lineNum">     158 </span>                :            :     {</a>
+<a name="159"><span class="lineNum">     159 </span>                :<span class="lineCov">          1 :         RuleWhitelistShared._transferredFrom(spender, from, to, value);</span></a>
+<a name="160"><span class="lineNum">     160 </span>                :            :     }</a>
+<a name="161"><span class="lineNum">     161 </span>                :            : </a>
+<a name="162"><span class="lineNum">     162 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="163"><span class="lineNum">     163 </span>                :            :                             INTERNAL/PRIVATE FUNCTIONS</a>
+<a name="164"><span class="lineNum">     164 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="165"><span class="lineNum">     165 </span>                :            : </a>
+<a name="166"><span class="lineNum">     166 </span>                :            :     /**</a>
+<a name="167"><span class="lineNum">     167 </span>                :            :      * @notice Evaluates target addresses across all child rules.</a>
+<a name="168"><span class="lineNum">     168 </span>                :            :      * @param targetAddress Addresses to validate (from/to[/spender]).</a>
+<a name="169"><span class="lineNum">     169 </span>                :            :      * @return result Boolean array aligned with targetAddress indicating if each address is listed.</a>
+<a name="170"><span class="lineNum">     170 </span>                :            :      */</a>
+<a name="171"><span class="lineNum">     171 </span>                :<span class="lineCov">         57 :     function _detectTransferRestrictionForTargets(address[] memory targetAddress)</span></a>
+<a name="172"><span class="lineNum">     172 </span>                :            :         internal</a>
+<a name="173"><span class="lineNum">     173 </span>                :            :         view</a>
+<a name="174"><span class="lineNum">     174 </span>                :            :         virtual</a>
+<a name="175"><span class="lineNum">     175 </span>                :            :         returns (bool[] memory)</a>
+<a name="176"><span class="lineNum">     176 </span>                :            :     {</a>
+<a name="177"><span class="lineNum">     177 </span>                :<span class="lineCov">         57 :         uint256 rulesLength = rulesCount();</span></a>
+<a name="178"><span class="lineNum">     178 </span>                :<span class="lineCov">         57 :         bool[] memory result = new bool[](targetAddress.length);</span></a>
+<a name="179"><span class="lineNum">     179 </span>                :<span class="lineCov">         57 :         for (uint256 i = 0; i &lt; rulesLength; ++i) {</span></a>
+<a name="180"><span class="lineNum">     180 </span>                :            :             // Call the whitelist rules</a>
+<a name="181"><span class="lineNum">     181 </span>                :            :             // Gas cost grows with the number of rules. Keep the wrapper list bounded.</a>
+<a name="182"><span class="lineNum">     182 </span>                :<span class="lineCov">        105 :             bool[] memory isListed = IAddressList(rule(i)).areAddressesListed(targetAddress);</span></a>
+<a name="183"><span class="lineNum">     183 </span>                :<span class="lineCov">        105 :             for (uint256 j = 0; j &lt; targetAddress.length; ++j) {</span></a>
+<a name="184"><span class="lineNum">     184 </span>           [<span class="branchCov" title="Branch 0 was taken 85 times"> + </span>]:<span class="lineCov">         85 :                 if (isListed[j]) {</span></a>
+<a name="185"><span class="lineNum">     185 </span>                :<span class="lineCov">         85 :                     result[j] = true;</span></a>
+<a name="186"><span class="lineNum">     186 </span>                :            :                 }</a>
+<a name="187"><span class="lineNum">     187 </span>                :            :             }</a>
+<a name="188"><span class="lineNum">     188 </span>                :            : </a>
+<a name="189"><span class="lineNum">     189 </span>                :            :             // Break early if all listed</a>
+<a name="190"><span class="lineNum">     190 </span>                :<span class="lineCov">        105 :             bool allListed = true;</span></a>
+<a name="191"><span class="lineNum">     191 </span>                :<span class="lineCov">        105 :             for (uint256 k = 0; k &lt; result.length; ++k) {</span></a>
+<a name="192"><span class="lineNum">     192 </span>           [<span class="branchCov" title="Branch 0 was taken 81 times"> + </span>]:<span class="lineCov">        201 :                 if (!result[k]) {</span></a>
+<a name="193"><span class="lineNum">     193 </span>                :<span class="lineCov">         81 :                     allListed = false;</span></a>
+<a name="194"><span class="lineNum">     194 </span>                :<span class="lineCov">         81 :                     break;</span></a>
+<a name="195"><span class="lineNum">     195 </span>                :            :                 }</a>
+<a name="196"><span class="lineNum">     196 </span>                :            :             }</a>
+<a name="197"><span class="lineNum">     197 </span>           [<span class="branchCov" title="Branch 0 was taken 24 times"> + </span>]:<span class="lineCov">         24 :             if (allListed) {</span></a>
+<a name="198"><span class="lineNum">     198 </span>                :<span class="lineCov">         24 :                 break;</span></a>
+<a name="199"><span class="lineNum">     199 </span>                :            :             }</a>
+<a name="200"><span class="lineNum">     200 </span>                :            :         }</a>
+<a name="201"><span class="lineNum">     201 </span>                :<span class="lineCov">         57 :         return result;</span></a>
+<a name="202"><span class="lineNum">     202 </span>                :            :     }</a>
+<a name="203"><span class="lineNum">     203 </span>                :            : </a>
+<a name="204"><span class="lineNum">     204 </span>                :            :     /**</a>
+<a name="205"><span class="lineNum">     205 </span>                :            :      * @notice Internal helper to update the `checkSpender` flag.</a>
+<a name="206"><span class="lineNum">     206 </span>                :            :      * @param value New flag value.</a>
+<a name="207"><span class="lineNum">     207 </span>                :            :      */</a>
+<a name="208"><span class="lineNum">     208 </span>                :<span class="lineCov">          3 :     function _setCheckSpender(bool value) internal virtual {</span></a>
+<a name="209"><span class="lineNum">     209 </span>                :<span class="lineCov">          3 :         checkSpender = value;</span></a>
+<a name="210"><span class="lineNum">     210 </span>                :            :     }</a>
+<a name="211"><span class="lineNum">     211 </span>                :            : </a>
+<a name="212"><span class="lineNum">     212 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="213"><span class="lineNum">     213 </span>                :            :                             ACCESS CONTROL</a>
+<a name="214"><span class="lineNum">     214 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="215"><span class="lineNum">     215 </span>                :            : </a>
+<a name="216"><span class="lineNum">     216 </span>                :<span class="lineCov">          4 :     modifier onlyCheckSpenderManager() {</span></a>
+<a name="217"><span class="lineNum">     217 </span>                :<span class="lineCov">          4 :         _authorizeCheckSpenderManager();</span></a>
+<a name="218"><span class="lineNum">     218 </span>                :            :         _;</a>
+<a name="219"><span class="lineNum">     219 </span>                :            :     }</a>
+<a name="220"><span class="lineNum">     220 </span>                :            : </a>
+<a name="221"><span class="lineNum">     221 </span>                :            :     function _authorizeCheckSpenderManager() internal virtual;</a>
 <a name="222"><span class="lineNum">     222 </span>                :            : </a>
-<a name="223"><span class="lineNum">     223 </span>                :<span class="lineCov">          4 :     function transferred(address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="224"><span class="lineNum">     224 </span>                :            :         public</a>
-<a name="225"><span class="lineNum">     225 </span>                :            :         view</a>
-<a name="226"><span class="lineNum">     226 </span>                :            :         virtual</a>
-<a name="227"><span class="lineNum">     227 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="228"><span class="lineNum">     228 </span>                :            :     {</a>
-<a name="229"><span class="lineNum">     229 </span>                :<span class="lineCov">          4 :         transferred(from, to, value);</span></a>
-<a name="230"><span class="lineNum">     230 </span>                :            :     }</a>
-<a name="231"><span class="lineNum">     231 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="232"><span class="lineNum">     232 </span>                :            :                             INTERNAL FUNCTIONS</a>
-<a name="233"><span class="lineNum">     233 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="234"><span class="lineNum">     234 </span>                :            : </a>
-<a name="235"><span class="lineNum">     235 </span>                :<span class="lineCov">         14 :     function _setSanctionListOracle(ISanctionsList sanctionContractOracle_) internal {</span></a>
-<a name="236"><span class="lineNum">     236 </span>                :<span class="lineCov">         14 :         sanctionsList = sanctionContractOracle_;</span></a>
-<a name="237"><span class="lineNum">     237 </span>                :<span class="lineCov">         14 :         emit SetSanctionListOracle(sanctionContractOracle_);</span></a>
-<a name="238"><span class="lineNum">     238 </span>                :            :     }</a>
-<a name="239"><span class="lineNum">     239 </span>                :            : </a>
-<a name="240"><span class="lineNum">     240 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="241"><span class="lineNum">     241 </span>                :            :                            ERC-2771</a>
-<a name="242"><span class="lineNum">     242 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="243"><span class="lineNum">     243 </span>                :            : </a>
-<a name="244"><span class="lineNum">     244 </span>                :            :     /**</a>
-<a name="245"><span class="lineNum">     245 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="246"><span class="lineNum">     246 </span>                :            :      */</a>
-<a name="247"><span class="lineNum">     247 </span>                :<span class="lineCov">         30 :     function _msgSender() internal view override(ERC2771Context, Context) returns (address sender) {</span></a>
-<a name="248"><span class="lineNum">     248 </span>                :<span class="lineCov">         30 :         return ERC2771Context._msgSender();</span></a>
-<a name="249"><span class="lineNum">     249 </span>                :            :     }</a>
-<a name="250"><span class="lineNum">     250 </span>                :            : </a>
-<a name="251"><span class="lineNum">     251 </span>                :            :     /**</a>
-<a name="252"><span class="lineNum">     252 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="253"><span class="lineNum">     253 </span>                :            :      */</a>
-<a name="254"><span class="lineNum">     254 </span>                :<span class="lineNoCov">          0 :     function _msgData() internal view override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
-<a name="255"><span class="lineNum">     255 </span>                :<span class="lineNoCov">          0 :         return ERC2771Context._msgData();</span></a>
-<a name="256"><span class="lineNum">     256 </span>                :            :     }</a>
-<a name="257"><span class="lineNum">     257 </span>                :            : </a>
-<a name="258"><span class="lineNum">     258 </span>                :            :     /**</a>
-<a name="259"><span class="lineNum">     259 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="260"><span class="lineNum">     260 </span>                :            :      */</a>
-<a name="261"><span class="lineNum">     261 </span>                :<span class="lineCov">         30 :     function _contextSuffixLength() internal view override(ERC2771Context, Context) returns (uint256) {</span></a>
-<a name="262"><span class="lineNum">     262 </span>                :<span class="lineCov">         30 :         return ERC2771Context._contextSuffixLength();</span></a>
-<a name="263"><span class="lineNum">     263 </span>                :            :     }</a>
-<a name="264"><span class="lineNum">     264 </span>                :            : }</a>
+<a name="223"><span class="lineNum">     223 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="224"><span class="lineNum">     224 </span>                :            :                            ERC-2771</a>
+<a name="225"><span class="lineNum">     225 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="226"><span class="lineNum">     226 </span>                :            : </a>
+<a name="227"><span class="lineNum">     227 </span>                :            :     /**</a>
+<a name="228"><span class="lineNum">     228 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
+<a name="229"><span class="lineNum">     229 </span>                :            :      */</a>
+<a name="230"><span class="lineNum">     230 </span>                :<span class="lineCov">        145 :     function _msgSender() internal view virtual override(ERC2771Context, Context) returns (address sender) {</span></a>
+<a name="231"><span class="lineNum">     231 </span>                :<span class="lineCov">        145 :         return ERC2771Context._msgSender();</span></a>
+<a name="232"><span class="lineNum">     232 </span>                :            :     }</a>
+<a name="233"><span class="lineNum">     233 </span>                :            : </a>
+<a name="234"><span class="lineNum">     234 </span>                :            :     /**</a>
+<a name="235"><span class="lineNum">     235 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
+<a name="236"><span class="lineNum">     236 </span>                :            :      */</a>
+<a name="237"><span class="lineNum">     237 </span>                :<span class="lineCov">          2 :     function _msgData() internal view virtual override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
+<a name="238"><span class="lineNum">     238 </span>                :<span class="lineCov">          2 :         return ERC2771Context._msgData();</span></a>
+<a name="239"><span class="lineNum">     239 </span>                :            :     }</a>
+<a name="240"><span class="lineNum">     240 </span>                :            : </a>
+<a name="241"><span class="lineNum">     241 </span>                :            :     /**</a>
+<a name="242"><span class="lineNum">     242 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
+<a name="243"><span class="lineNum">     243 </span>                :            :      */</a>
+<a name="244"><span class="lineNum">     244 </span>                :<span class="lineCov">        147 :     function _contextSuffixLength() internal view virtual override(ERC2771Context, Context) returns (uint256) {</span></a>
+<a name="245"><span class="lineNum">     245 </span>                :<span class="lineCov">        147 :         return ERC2771Context._contextSuffixLength();</span></a>
+<a name="246"><span class="lineNum">     246 </span>                :            :     }</a>
+<a name="247"><span class="lineNum">     247 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
@@ -340,7 +323,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/abstract/base/index-sort-b.html b/doc/coverage/coverage/abstract/base/index-sort-b.html
new file mode 100644
index 0000000..c0dd6a1
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/index-sort-b.html
@@ -0,0 +1,179 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/base</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistBase.sol.gcov.html">RuleWhitelistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">23 / 23</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyBase.sol.gcov.html">RuleMaxTotalSupplyBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">37 / 37</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistBase.sol.gcov.html">RuleBlacklistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperBase.sol.gcov.html">RuleWhitelistWrapperBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">67 / 67</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListBase.sol.gcov.html">RuleSanctionsListBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">47 / 47</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryBase.sol.gcov.html">RuleIdentityRegistryBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Base.sol.gcov.html">RuleERC2980Base.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">102 / 102</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">25 / 25</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/index-sort-f.html b/doc/coverage/coverage/abstract/base/index-sort-f.html
new file mode 100644
index 0000000..fd1f168
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/index-sort-f.html
@@ -0,0 +1,179 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/base</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistBase.sol.gcov.html">RuleWhitelistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">23 / 23</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistBase.sol.gcov.html">RuleBlacklistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryBase.sol.gcov.html">RuleIdentityRegistryBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyBase.sol.gcov.html">RuleMaxTotalSupplyBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">37 / 37</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListBase.sol.gcov.html">RuleSanctionsListBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">47 / 47</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperBase.sol.gcov.html">RuleWhitelistWrapperBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">67 / 67</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Base.sol.gcov.html">RuleERC2980Base.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">102 / 102</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">25 / 25</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/index-sort-l.html b/doc/coverage/coverage/abstract/base/index-sort-l.html
new file mode 100644
index 0000000..10250aa
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/index-sort-l.html
@@ -0,0 +1,179 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/base</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistBase.sol.gcov.html">RuleWhitelistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">23 / 23</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistBase.sol.gcov.html">RuleBlacklistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyBase.sol.gcov.html">RuleMaxTotalSupplyBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">37 / 37</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListBase.sol.gcov.html">RuleSanctionsListBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">47 / 47</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryBase.sol.gcov.html">RuleIdentityRegistryBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperBase.sol.gcov.html">RuleWhitelistWrapperBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">67 / 67</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Base.sol.gcov.html">RuleERC2980Base.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">102 / 102</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">25 / 25</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/base/index.html b/doc/coverage/coverage/abstract/base/index.html
new file mode 100644
index 0000000..a56fb4a
--- /dev/null
+++ b/doc/coverage/coverage/abstract/base/index.html
@@ -0,0 +1,179 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/base</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/base</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntry">360</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntry">101</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntry">105</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistBase.sol.gcov.html">RuleBlacklistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Base.sol.gcov.html">RuleERC2980Base.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">102 / 102</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">33 / 33</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">25 / 25</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryBase.sol.gcov.html">RuleIdentityRegistryBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyBase.sol.gcov.html">RuleMaxTotalSupplyBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">37 / 37</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListBase.sol.gcov.html">RuleSanctionsListBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">47 / 47</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">13 / 13</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistBase.sol.gcov.html">RuleWhitelistBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">23 / 23</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperBase.sol.gcov.html">RuleWhitelistWrapperBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">67 / 67</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func-sort-c.html b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func-sort-c.html
new file mode 100644
index 0000000..2a2a676
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func-sort-c.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core/RuleNFTAdapter.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleNFTAdapter.sol<span style="font-size: 80%;"> (<a href="RuleNFTAdapter.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">20</td>
+            <td class="headerCovTableEntry">20</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleNFTAdapter.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#112">RuleNFTAdapter.transferred.2</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#123">RuleNFTAdapter.transferred.3</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#101">RuleNFTAdapter.transferred.1</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#76">RuleNFTAdapter.canTransferFrom</a></td>
+              <td class="coverFnHi">10</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#51">RuleNFTAdapter.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#90">RuleNFTAdapter.transferred.0</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#64">RuleNFTAdapter.canTransfer</a></td>
+              <td class="coverFnHi">14</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#38">RuleNFTAdapter.detectTransferRestriction</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func.html b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func.html
new file mode 100644
index 0000000..0ee21a8
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.func.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core/RuleNFTAdapter.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleNFTAdapter.sol<span style="font-size: 80%;"> (<a href="RuleNFTAdapter.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">20</td>
+            <td class="headerCovTableEntry">20</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleNFTAdapter.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#64">RuleNFTAdapter.canTransfer</a></td>
+              <td class="coverFnHi">14</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#76">RuleNFTAdapter.canTransferFrom</a></td>
+              <td class="coverFnHi">10</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#38">RuleNFTAdapter.detectTransferRestriction</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#51">RuleNFTAdapter.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#90">RuleNFTAdapter.transferred.0</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#101">RuleNFTAdapter.transferred.1</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#112">RuleNFTAdapter.transferred.2</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleNFTAdapter.sol.gcov.html#123">RuleNFTAdapter.transferred.3</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleWhitelist.sol.gcov.html b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.gcov.html
similarity index 52%
rename from doc/coverage/coverage/validation/RuleWhitelist.sol.gcov.html
rename to doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.gcov.html
index 09c1d37..ea62082 100644
--- a/doc/coverage/coverage/validation/RuleWhitelist.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/core/RuleNFTAdapter.sol.gcov.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelist.sol</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
+  <title>LCOV - lcov.info - abstract/core/RuleNFTAdapter.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelist.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleNFTAdapter.sol<span style="font-size: 80%;"> (source / <a href="RuleNFTAdapter.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,34 +31,34 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">16</td>
             <td class="headerCovTableEntry">20</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">20</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntry">7</td>
-            <td class="headerCovTableEntryLo">71.4 %</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <table cellpadding=0 cellspacing=0 border=0>
@@ -72,149 +72,135 @@
 <a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
 <a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
 <a name="3"><span class="lineNum">       3 </span>                :            : </a>
-<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
-<a name="5"><span class="lineNum">       5 </span>                :            : /* ==== Abtract contracts === */</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleAddressSet} from &quot;./abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleWhitelistCommon, RuleValidateTransfer} from &quot;./abstract/RuleWhitelistCommon.sol&quot;;</a>
-<a name="8"><span class="lineNum">       8 </span>                :            : /* ==== CMTAT === */</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : /* ==== Interfaces === */</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : import {IIdentityRegistryVerified} from &quot;../interfaces/IIdentityRegistry.sol&quot;;</a>
-<a name="12"><span class="lineNum">      12 </span>                :            : import {</a>
-<a name="13"><span class="lineNum">      13 </span>                :            :     IERC7943NonFungibleCompliance,</a>
-<a name="14"><span class="lineNum">      14 </span>                :            :     IERC7943NonFungibleComplianceExtend</a>
-<a name="15"><span class="lineNum">      15 </span>                :            : } from &quot;../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
-<a name="16"><span class="lineNum">      16 </span>                :            : </a>
-<a name="17"><span class="lineNum">      17 </span>                :            : /**</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :  * @title Rule Whitelist</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :  * @notice Manages a whitelist of authorized addresses and enforces whitelist-based transfer restrictions.</a>
-<a name="20"><span class="lineNum">      20 </span>                :            :  * @dev</a>
-<a name="21"><span class="lineNum">      21 </span>                :            :  * - Inherits core address management logic from {RuleAddressSet}.</a>
-<a name="22"><span class="lineNum">      22 </span>                :            :  * - Integrates restriction code logic from {RuleWhitelistCommon}.</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :  * - Implements {IERC1404} to return specific restriction codes for non-whitelisted transfers.</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :  */</a>
-<a name="25"><span class="lineNum">      25 </span>                :            : contract RuleWhitelist is RuleAddressSet, RuleWhitelistCommon, IIdentityRegistryVerified {</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="27"><span class="lineNum">      27 </span>                :            :                               CONSTRUCTOR</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :     /**</a>
-<a name="30"><span class="lineNum">      30 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
-<a name="32"><span class="lineNum">      32 </span>                :            :      */</a>
-<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">        102 :     constructor(address admin, address forwarderIrrevocable, bool checkSpender_)</span></a>
-<a name="34"><span class="lineNum">      34 </span>                :            :         RuleAddressSet(admin, forwarderIrrevocable)</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :     {</a>
-<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">        101 :         checkSpender = checkSpender_;</span></a>
-<a name="37"><span class="lineNum">      37 </span>                :            :     }</a>
-<a name="38"><span class="lineNum">      38 </span>                :            : </a>
-<a name="39"><span class="lineNum">      39 </span>                :            :     /* ============  View Functions ============ */</a>
-<a name="40"><span class="lineNum">      40 </span>                :            : </a>
-<a name="41"><span class="lineNum">      41 </span>                :            :     /**</a>
-<a name="42"><span class="lineNum">      42 </span>                :            :      * @notice Detects whether a transfer between two addresses is allowed under the whitelist rule.</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :      * @dev</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :      * - Returns a restriction code indicating why a transfer is blocked.</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :      * - Implements the `IERC1404.detectTransferRestriction` interface.</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :      * @param from The address sending tokens.</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :      * @param to The address receiving tokens.</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :      * @return code Restriction code (e.g., `TRANSFER_OK` or specific whitelist rejection).</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :      *</a>
-<a name="50"><span class="lineNum">      50 </span>                :            :      * | Condition | Returned Code |</a>
-<a name="51"><span class="lineNum">      51 </span>                :            :      * |------------|---------------|</a>
-<a name="52"><span class="lineNum">      52 </span>                :            :      * | `from` not whitelisted | `CODE_ADDRESS_FROM_NOT_WHITELISTED` |</a>
-<a name="53"><span class="lineNum">      53 </span>                :            :      * | `to` not whitelisted | `CODE_ADDRESS_TO_NOT_WHITELISTED` |</a>
-<a name="54"><span class="lineNum">      54 </span>                :            :      * | Both whitelisted | `TRANSFER_OK` |</a>
-<a name="55"><span class="lineNum">      55 </span>                :            :      */</a>
-<a name="56"><span class="lineNum">      56 </span>                :<span class="lineCov">         20 :     function detectTransferRestriction(address from, address to, uint256 /* value */ )</span></a>
-<a name="57"><span class="lineNum">      57 </span>                :            :         public</a>
-<a name="58"><span class="lineNum">      58 </span>                :            :         view</a>
-<a name="59"><span class="lineNum">      59 </span>                :            :         virtual</a>
-<a name="60"><span class="lineNum">      60 </span>                :            :         override(IERC1404)</a>
-<a name="61"><span class="lineNum">      61 </span>                :            :         returns (uint8 code)</a>
-<a name="62"><span class="lineNum">      62 </span>                :            :     {</a>
-<a name="63"><span class="lineNum">      63 </span>        [<span class="branchCov" title="Branch 0 was taken 11 times"> + </span><span class="branchCov" title="Branch 1 was taken 16 times"> + </span>]:<span class="lineCov">         33 :         if (!isAddressListed(from)) {</span></a>
-<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">         11 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
-<a name="65"><span class="lineNum">      65 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 16 times"> + </span>]:<span class="lineCov">         22 :         } else if (!isAddressListed(to)) {</span></a>
-<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">          6 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
-<a name="67"><span class="lineNum">      67 </span>                :            :         } else {</a>
-<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">         16 :             return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="69"><span class="lineNum">      69 </span>                :            :         }</a>
-<a name="70"><span class="lineNum">      70 </span>                :            :     }</a>
-<a name="71"><span class="lineNum">      71 </span>                :            : </a>
-<a name="72"><span class="lineNum">      72 </span>                :            :     /**</a>
-<a name="73"><span class="lineNum">      73 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="74"><span class="lineNum">      74 </span>                :            :      */</a>
-<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">          7 :     function detectTransferRestriction(address from, address to, uint256, /* tokenId */ uint256 value)</span></a>
-<a name="76"><span class="lineNum">      76 </span>                :            :         public</a>
-<a name="77"><span class="lineNum">      77 </span>                :            :         view</a>
-<a name="78"><span class="lineNum">      78 </span>                :            :         virtual</a>
-<a name="79"><span class="lineNum">      79 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="80"><span class="lineNum">      80 </span>                :            :         returns (uint8)</a>
-<a name="81"><span class="lineNum">      81 </span>                :            :     {</a>
-<a name="82"><span class="lineNum">      82 </span>                :<span class="lineCov">          7 :         return detectTransferRestriction(from, to, value);</span></a>
-<a name="83"><span class="lineNum">      83 </span>                :            :     }</a>
-<a name="84"><span class="lineNum">      84 </span>                :            : </a>
-<a name="85"><span class="lineNum">      85 </span>                :            :     /**</a>
-<a name="86"><span class="lineNum">      86 </span>                :            :      * @notice Detects transfer restriction for delegated transfers (`transferFrom`).</a>
-<a name="87"><span class="lineNum">      87 </span>                :            :      * @dev</a>
-<a name="88"><span class="lineNum">      88 </span>                :            :      * - Checks the `spender`, `from`, and `to` addresses for whitelist compliance.</a>
-<a name="89"><span class="lineNum">      89 </span>                :            :      * - Implements `IERC1404Extend.detectTransferRestrictionFrom`.</a>
-<a name="90"><span class="lineNum">      90 </span>                :            :      * @param spender The address initiating the transfer on behalf of another.</a>
-<a name="91"><span class="lineNum">      91 </span>                :            :      * @param from The address from which tokens are transferred.</a>
-<a name="92"><span class="lineNum">      92 </span>                :            :      * @param to The address receiving the tokens.</a>
-<a name="93"><span class="lineNum">      93 </span>                :            :      * @param value The amount being transferred (unused in this check).</a>
-<a name="94"><span class="lineNum">      94 </span>                :            :      * @return code Restriction code, or `TRANSFER_OK` if all parties are whitelisted.</a>
-<a name="95"><span class="lineNum">      95 </span>                :            :      *</a>
-<a name="96"><span class="lineNum">      96 </span>                :            :      * | Condition | Returned Code |</a>
-<a name="97"><span class="lineNum">      97 </span>                :            :      * |------------|---------------|</a>
-<a name="98"><span class="lineNum">      98 </span>                :            :      * | `spender` not whitelisted | `CODE_ADDRESS_SPENDER_NOT_WHITELISTED` |</a>
-<a name="99"><span class="lineNum">      99 </span>                :            :      * | `from` or `to` not whitelisted | respective restriction code from `detectTransferRestriction` |</a>
-<a name="100"><span class="lineNum">     100 </span>                :            :      * | All whitelisted | `TRANSFER_OK` |</a>
-<a name="101"><span class="lineNum">     101 </span>                :            :      */</a>
-<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">         10 :     function detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
-<a name="103"><span class="lineNum">     103 </span>                :            :         public</a>
-<a name="104"><span class="lineNum">     104 </span>                :            :         view</a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {</a>
+<a name="8"><span class="lineNum">       8 </span>                :            :     IERC7943NonFungibleCompliance,</a>
+<a name="9"><span class="lineNum">       9 </span>                :            :     IERC7943NonFungibleComplianceExtend</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : } from &quot;../../../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {RuleTransferValidation} from &quot;./RuleTransferValidation.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : import {ITransferContext} from &quot;../../../interfaces/ITransferContext.sol&quot;;</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : </a>
+<a name="14"><span class="lineNum">      14 </span>                :            : /**</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * @title Rule NFT Adapter</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  * @notice Provides ERC-7943 overloads for rules that already implement core transfer checks.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  * @dev Delegates tokenId overloads to RuleTransferValidation's internal hooks.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  */</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : abstract contract RuleNFTAdapter is RuleTransferValidation, IERC7943NonFungibleComplianceExtend, ITransferContext {</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :     bytes4 internal constant TRANSFERRED_SELECTOR_ERC3643 =</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         IERC3643IComplianceContract.transferred.selector;</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     bytes4 internal constant TRANSFERRED_SELECTOR_RULE_ENGINE =</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :         IRuleEngine.transferred.selector;</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     bytes4 internal constant TRANSFERRED_SELECTOR_ERC7943 =</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         bytes4(keccak256(&quot;transferred(address,address,uint256,uint256)&quot;));</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     bytes4 internal constant TRANSFERRED_SELECTOR_ERC7943_FROM =</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :         bytes4(keccak256(&quot;transferred(address,address,address,uint256,uint256)&quot;));</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :     /**</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :      * @notice Internal hook for post-transfer validation or state updates.</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :      */</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :     function _transferred(address from, address to, uint256 value) internal virtual;</a>
+<a name="32"><span class="lineNum">      32 </span>                :            : </a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     /**</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :      * @notice Internal hook for post-transfer validation or state updates (spender-aware).</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      */</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     function _transferredFrom(address spender, address from, address to, uint256 value) internal virtual;</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     /**</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :      */</a>
+<a name="40"><span class="lineNum">      40 </span>                :<span class="lineCov">         16 :     function detectTransferRestriction(address from, address to, uint256 /* tokenId */, uint256 value)</span></a>
+<a name="41"><span class="lineNum">      41 </span>                :            :         public</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :         view</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         virtual</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :         returns (uint8)</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :     {</a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">         16 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :            :     }</a>
+<a name="49"><span class="lineNum">      49 </span>                :            : </a>
+<a name="50"><span class="lineNum">      50 </span>                :            :     /**</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :      */</a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">         12 :     function detectTransferRestrictionFrom(</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         address spender,</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :         address from,</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :         address to,</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :         uint256 /* tokenId */,</a>
+<a name="58"><span class="lineNum">      58 </span>                :            :         uint256 value</a>
+<a name="59"><span class="lineNum">      59 </span>                :            :     ) public view virtual override(IERC7943NonFungibleComplianceExtend) returns (uint8) {</a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">         12 :         return _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :            :     }</a>
+<a name="62"><span class="lineNum">      62 </span>                :            : </a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     /**</a>
+<a name="64"><span class="lineNum">      64 </span>                :            :      * @inheritdoc IERC7943NonFungibleCompliance</a>
+<a name="65"><span class="lineNum">      65 </span>                :            :      */</a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">         14 :     function canTransfer(address from, address to, uint256 /* tokenId */, uint256 amount)</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :            :         public</a>
+<a name="68"><span class="lineNum">      68 </span>                :            :         view</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :         override(IERC7943NonFungibleCompliance)</a>
+<a name="70"><span class="lineNum">      70 </span>                :            :         returns (bool)</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :     {</a>
+<a name="72"><span class="lineNum">      72 </span>                :<span class="lineCov">         14 :         return _detectTransferRestriction(from, to, amount) == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="73"><span class="lineNum">      73 </span>                :            :     }</a>
+<a name="74"><span class="lineNum">      74 </span>                :            : </a>
+<a name="75"><span class="lineNum">      75 </span>                :            :     /**</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
+<a name="77"><span class="lineNum">      77 </span>                :            :      */</a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">         10 :     function canTransferFrom(address spender, address from, address to, uint256 /* tokenId */, uint256 value)</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :         public</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :         view</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :         virtual</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :         returns (bool)</a>
+<a name="84"><span class="lineNum">      84 </span>                :            :     {</a>
+<a name="85"><span class="lineNum">      85 </span>                :<span class="lineCov">         10 :         return _detectTransferRestrictionFrom(spender, from, to, value)</span></a>
+<a name="86"><span class="lineNum">      86 </span>                :            :             == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :     }</a>
+<a name="88"><span class="lineNum">      88 </span>                :            : </a>
+<a name="89"><span class="lineNum">      89 </span>                :            :     /**</a>
+<a name="90"><span class="lineNum">      90 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
+<a name="91"><span class="lineNum">      91 </span>                :            :      */</a>
+<a name="92"><span class="lineNum">      92 </span>                :<span class="lineCov">         13 :     function transferred(address from, address to, uint256 /* tokenId */, uint256 value)</span></a>
+<a name="93"><span class="lineNum">      93 </span>                :            :         public</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         virtual</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
+<a name="96"><span class="lineNum">      96 </span>                :            :     {</a>
+<a name="97"><span class="lineNum">      97 </span>                :<span class="lineCov">         13 :         _transferred(from, to, value);</span></a>
+<a name="98"><span class="lineNum">      98 </span>                :            :     }</a>
+<a name="99"><span class="lineNum">      99 </span>                :            : </a>
+<a name="100"><span class="lineNum">     100 </span>                :            :     /**</a>
+<a name="101"><span class="lineNum">     101 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
+<a name="102"><span class="lineNum">     102 </span>                :            :      */</a>
+<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">          8 :     function transferred(address spender, address from, address to, uint256 /* tokenId */, uint256 value)</span></a>
+<a name="104"><span class="lineNum">     104 </span>                :            :         public</a>
 <a name="105"><span class="lineNum">     105 </span>                :            :         virtual</a>
-<a name="106"><span class="lineNum">     106 </span>                :            :         override(IERC1404Extend)</a>
-<a name="107"><span class="lineNum">     107 </span>                :            :         returns (uint8 code)</a>
-<a name="108"><span class="lineNum">     108 </span>                :            :     {</a>
-<a name="109"><span class="lineNum">     109 </span>           [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span>]:<span class="lineCov">         12 :         if (checkSpender &amp;&amp; !isAddressListed(spender)) {</span></a>
-<a name="110"><span class="lineNum">     110 </span>                :<span class="lineCov">          6 :             return CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
-<a name="111"><span class="lineNum">     111 </span>                :            :         }</a>
-<a name="112"><span class="lineNum">     112 </span>                :<span class="lineCov">          6 :         return detectTransferRestriction(from, to, value);</span></a>
-<a name="113"><span class="lineNum">     113 </span>                :            :     }</a>
-<a name="114"><span class="lineNum">     114 </span>                :            : </a>
-<a name="115"><span class="lineNum">     115 </span>                :            :     /**</a>
-<a name="116"><span class="lineNum">     116 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="117"><span class="lineNum">     117 </span>                :            :      */</a>
-<a name="118"><span class="lineNum">     118 </span>                :<span class="lineCov">          2 :     function detectTransferRestrictionFrom(</span></a>
-<a name="119"><span class="lineNum">     119 </span>                :            :         address spender,</a>
-<a name="120"><span class="lineNum">     120 </span>                :            :         address from,</a>
-<a name="121"><span class="lineNum">     121 </span>                :            :         address to,</a>
-<a name="122"><span class="lineNum">     122 </span>                :            :         uint256, /* tokenId */</a>
-<a name="123"><span class="lineNum">     123 </span>                :            :         uint256 value</a>
-<a name="124"><span class="lineNum">     124 </span>                :            :     ) public view override(IERC7943NonFungibleComplianceExtend) returns (uint8) {</a>
-<a name="125"><span class="lineNum">     125 </span>                :<span class="lineCov">          2 :         return detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="126"><span class="lineNum">     126 </span>                :            :     }</a>
-<a name="127"><span class="lineNum">     127 </span>                :            : </a>
-<a name="128"><span class="lineNum">     128 </span>                :            :     /**</a>
-<a name="129"><span class="lineNum">     129 </span>                :            :      * @notice Checks whether a specific address is currently listed.</a>
-<a name="130"><span class="lineNum">     130 </span>                :            :      * @param targetAddress The address to check.</a>
-<a name="131"><span class="lineNum">     131 </span>                :            :      * @return isListed True if listed, false otherwise.</a>
-<a name="132"><span class="lineNum">     132 </span>                :            :      */</a>
-<a name="133"><span class="lineNum">     133 </span>                :<span class="lineNoCov">          0 :     function isVerified(address targetAddress)</span></a>
-<a name="134"><span class="lineNum">     134 </span>                :            :         public</a>
-<a name="135"><span class="lineNum">     135 </span>                :            :         view</a>
-<a name="136"><span class="lineNum">     136 </span>                :            :         virtual</a>
-<a name="137"><span class="lineNum">     137 </span>                :            :         override(IIdentityRegistryVerified)</a>
-<a name="138"><span class="lineNum">     138 </span>                :            :         returns (bool isListed)</a>
-<a name="139"><span class="lineNum">     139 </span>                :            :     {</a>
-<a name="140"><span class="lineNum">     140 </span>                :<span class="lineNoCov">          0 :         isListed = _isAddressListed(targetAddress);</span></a>
-<a name="141"><span class="lineNum">     141 </span>                :            :     }</a>
-<a name="142"><span class="lineNum">     142 </span>                :            : </a>
-<a name="143"><span class="lineNum">     143 </span>                :<span class="lineNoCov">          0 :     function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControl, RuleValidateTransfer) returns (bool) {</span></a>
-<a name="144"><span class="lineNum">     144 </span>                :<span class="lineNoCov">          0 :         return AccessControl.supportsInterface(interfaceId) || RuleValidateTransfer.supportsInterface(interfaceId);</span></a>
-<a name="145"><span class="lineNum">     145 </span>                :            :     }</a>
-<a name="146"><span class="lineNum">     146 </span>                :            : }</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
+<a name="107"><span class="lineNum">     107 </span>                :            :     {</a>
+<a name="108"><span class="lineNum">     108 </span>                :<span class="lineCov">          8 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="109"><span class="lineNum">     109 </span>                :            :     }</a>
+<a name="110"><span class="lineNum">     110 </span>                :            : </a>
+<a name="111"><span class="lineNum">     111 </span>                :            :     /**</a>
+<a name="112"><span class="lineNum">     112 </span>                :            :      * @inheritdoc ITransferContext</a>
+<a name="113"><span class="lineNum">     113 </span>                :            :      */</a>
+<a name="114"><span class="lineNum">     114 </span>                :<span class="lineCov">          2 :     function transferred(MultiTokenTransferContext calldata ctx) external virtual override {</span></a>
+<a name="115"><span class="lineNum">     115 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         if (ctx.sender != address(0)) {</span></a>
+<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">          1 :             _transferredFrom(ctx.sender, ctx.from, ctx.to, ctx.value);</span></a>
+<a name="117"><span class="lineNum">     117 </span>                :            :         } else {</a>
+<a name="118"><span class="lineNum">     118 </span>                :<span class="lineCov">          1 :             _transferred(ctx.from, ctx.to, ctx.value);</span></a>
+<a name="119"><span class="lineNum">     119 </span>                :            :         }</a>
+<a name="120"><span class="lineNum">     120 </span>                :            :     }</a>
+<a name="121"><span class="lineNum">     121 </span>                :            : </a>
+<a name="122"><span class="lineNum">     122 </span>                :            :     /**</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :      * @inheritdoc ITransferContext</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :      */</a>
+<a name="125"><span class="lineNum">     125 </span>                :<span class="lineCov">          2 :     function transferred(FungibleTransferContext calldata ctx) external virtual override {</span></a>
+<a name="126"><span class="lineNum">     126 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         if (ctx.sender != address(0)) {</span></a>
+<a name="127"><span class="lineNum">     127 </span>                :<span class="lineCov">          1 :             _transferredFrom(ctx.sender, ctx.from, ctx.to, ctx.value);</span></a>
+<a name="128"><span class="lineNum">     128 </span>                :            :         } else {</a>
+<a name="129"><span class="lineNum">     129 </span>                :<span class="lineCov">          1 :             _transferred(ctx.from, ctx.to, ctx.value);</span></a>
+<a name="130"><span class="lineNum">     130 </span>                :            :         }</a>
+<a name="131"><span class="lineNum">     131 </span>                :            :     }</a>
+<a name="132"><span class="lineNum">     132 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
@@ -222,7 +208,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func-sort-c.html b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func-sort-c.html
similarity index 62%
rename from doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func-sort-c.html
rename to doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func-sort-c.html
index 93f72fb..13a68b1 100644
--- a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func-sort-c.html
+++ b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func-sort-c.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleValidateTransfer.sol - functions</title>
+  <title>LCOV - lcov.info - abstract/core/RuleTransferValidation.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleValidateTransfer.sol<span style="font-size: 80%;"> (<a href="RuleValidateTransfer.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleTransferValidation.sol<span style="font-size: 80%;"> (<a href="RuleTransferValidation.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -65,28 +65,28 @@
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleValidateTransfer.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleTransferValidation.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#80">RuleValidateTransfer.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#87">RuleTransferValidation.canTransferFrom</a></td>
+              <td class="coverFnHi">12</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#56">RuleValidateTransfer.canTransferFrom.0</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#75">RuleTransferValidation.canTransfer</a></td>
+              <td class="coverFnHi">20</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#70">RuleValidateTransfer.canTransferFrom.1</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#57">RuleTransferValidation.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">36</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#24">RuleValidateTransfer.canTransfer.0</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#98">RuleTransferValidation.supportsInterface</a></td>
+              <td class="coverFnHi">195</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#43">RuleValidateTransfer.canTransfer.1</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#44">RuleTransferValidation.detectTransferRestriction</a></td>
+              <td class="coverFnHi">348</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func.html b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func.html
similarity index 62%
rename from doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func.html
rename to doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func.html
index f811a3f..91fe5a9 100644
--- a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.func.html
+++ b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.func.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleValidateTransfer.sol - functions</title>
+  <title>LCOV - lcov.info - abstract/core/RuleTransferValidation.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleValidateTransfer.sol<span style="font-size: 80%;"> (<a href="RuleValidateTransfer.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleTransferValidation.sol<span style="font-size: 80%;"> (<a href="RuleTransferValidation.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -66,27 +66,27 @@
     <tr><td><br></td></tr>
     <tr>
       <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleValidateTransfer.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleTransferValidation.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#24">RuleValidateTransfer.canTransfer.0</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#75">RuleTransferValidation.canTransfer</a></td>
+              <td class="coverFnHi">20</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#43">RuleValidateTransfer.canTransfer.1</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#87">RuleTransferValidation.canTransferFrom</a></td>
+              <td class="coverFnHi">12</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#56">RuleValidateTransfer.canTransferFrom.0</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#44">RuleTransferValidation.detectTransferRestriction</a></td>
+              <td class="coverFnHi">348</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#70">RuleValidateTransfer.canTransferFrom.1</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#57">RuleTransferValidation.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">36</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleValidateTransfer.sol.gcov.html#80">RuleValidateTransfer.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleTransferValidation.sol.gcov.html#98">RuleTransferValidation.supportsInterface</a></td>
+              <td class="coverFnHi">195</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.gcov.html b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.gcov.html
similarity index 66%
rename from doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.gcov.html
rename to doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.gcov.html
index 174dc57..67c4f57 100644
--- a/doc/coverage/coverage/validation/abstract/RuleValidateTransfer.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/core/RuleTransferValidation.sol.gcov.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleValidateTransfer.sol</title>
+  <title>LCOV - lcov.info - abstract/core/RuleTransferValidation.sol</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleValidateTransfer.sol<span style="font-size: 80%;"> (source / <a href="RuleValidateTransfer.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleTransferValidation.sol<span style="font-size: 80%;"> (source / <a href="RuleTransferValidation.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
             <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -74,86 +74,104 @@
 <a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
 <a name="4"><span class="lineNum">       4 </span>                :            : </a>
 <a name="5"><span class="lineNum">       5 </span>                :            : /* ==== CMTAT === */</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : import {IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
 <a name="7"><span class="lineNum">       7 </span>                :            : import {IERC3643ComplianceRead} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
 <a name="8"><span class="lineNum">       8 </span>                :            : import {IERC7551Compliance} from &quot;CMTAT/interfaces/tokenization/draft-IERC7551.sol&quot;;</a>
 <a name="9"><span class="lineNum">       9 </span>                :            : /* ==== RuleEngine === */</a>
 <a name="10"><span class="lineNum">      10 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : import {</a>
-<a name="12"><span class="lineNum">      12 </span>                :            :     IERC7943NonFungibleCompliance,</a>
-<a name="13"><span class="lineNum">      13 </span>                :            :     IERC7943NonFungibleComplianceExtend</a>
-<a name="14"><span class="lineNum">      14 </span>                :            : } from &quot;../../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
-<a name="15"><span class="lineNum">      15 </span>                :            : </a>
-<a name="16"><span class="lineNum">      16 </span>                :            : abstract contract RuleValidateTransfer is IERC7943NonFungibleComplianceExtend, IRule {</a>
-<a name="17"><span class="lineNum">      17 </span>                :            :     /**</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :      * @notice Validate a transfer</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :      * @param from the origin address</a>
-<a name="20"><span class="lineNum">      20 </span>                :            :      * @param to the destination address</a>
-<a name="21"><span class="lineNum">      21 </span>                :            :      * @param tokenId ERC-721 or ERC-1155 token Id</a>
-<a name="22"><span class="lineNum">      22 </span>                :            :      * @param amount to transfer, 1 for NFT</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :      * @return isValid =&gt; true if the transfer is valid, false otherwise</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :      *</a>
-<a name="25"><span class="lineNum">      25 </span>                :            :      */</a>
-<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">         14 :     function canTransfer(address from, address to, uint256 tokenId, uint256 amount)</span></a>
-<a name="27"><span class="lineNum">      27 </span>                :            :         public</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :         view</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :         override(IERC7943NonFungibleCompliance)</a>
-<a name="30"><span class="lineNum">      30 </span>                :            :         returns (bool isValid)</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :     {</a>
-<a name="32"><span class="lineNum">      32 </span>                :            :         // does not work without `this` keyword =&gt; &quot;Undeclared identifier&quot;</a>
-<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">         14 :         return this.detectTransferRestriction(from, to, tokenId, amount)</span></a>
-<a name="34"><span class="lineNum">      34 </span>                :            :             == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :     }</a>
-<a name="36"><span class="lineNum">      36 </span>                :            : </a>
-<a name="37"><span class="lineNum">      37 </span>                :            :     /**</a>
-<a name="38"><span class="lineNum">      38 </span>                :            :      * @notice Validate a transfer</a>
-<a name="39"><span class="lineNum">      39 </span>                :            :      * @param from the origin address</a>
-<a name="40"><span class="lineNum">      40 </span>                :            :      * @param to the destination address</a>
-<a name="41"><span class="lineNum">      41 </span>                :            :      * @param amount to transfer</a>
-<a name="42"><span class="lineNum">      42 </span>                :            :      * @return isValid =&gt; true if the transfer is valid, false otherwise</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :      *</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :      */</a>
-<a name="45"><span class="lineNum">      45 </span>                :<span class="lineCov">         14 :     function canTransfer(address from, address to, uint256 amount)</span></a>
-<a name="46"><span class="lineNum">      46 </span>                :            :         public</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :         view</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :         override(IERC3643ComplianceRead)</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :         returns (bool isValid)</a>
-<a name="50"><span class="lineNum">      50 </span>                :            :     {</a>
-<a name="51"><span class="lineNum">      51 </span>                :            :         // does not work without `this` keyword =&gt; &quot;Undeclared identifier&quot;</a>
-<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">         14 :         return this.detectTransferRestriction(from, to, amount) == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="53"><span class="lineNum">      53 </span>                :            :     }</a>
-<a name="54"><span class="lineNum">      54 </span>                :            : </a>
-<a name="55"><span class="lineNum">      55 </span>                :            :     /**</a>
-<a name="56"><span class="lineNum">      56 </span>                :            :      * @inheritdoc IERC7551Compliance</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :      */</a>
-<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">         10 :     function canTransferFrom(address spender, address from, address to, uint256 value)</span></a>
-<a name="59"><span class="lineNum">      59 </span>                :            :         public</a>
-<a name="60"><span class="lineNum">      60 </span>                :            :         view</a>
-<a name="61"><span class="lineNum">      61 </span>                :            :         virtual</a>
-<a name="62"><span class="lineNum">      62 </span>                :            :         override(IERC7551Compliance)</a>
-<a name="63"><span class="lineNum">      63 </span>                :            :         returns (bool)</a>
-<a name="64"><span class="lineNum">      64 </span>                :            :     {</a>
-<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">         20 :         return this.detectTransferRestrictionFrom(spender, from, to, value)</span></a>
-<a name="66"><span class="lineNum">      66 </span>                :            :             == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {RuleInterfaceId} from &quot;RuleEngine/modules/library/RuleInterfaceId.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /* ==== Modules === */</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : import {VersionModule} from &quot;../../../../modules/VersionModule.sol&quot;;</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : </a>
+<a name="15"><span class="lineNum">      15 </span>                :            : abstract contract RuleTransferValidation is VersionModule, IERC1404Extend, IERC3643ComplianceRead, IERC7551Compliance, IRule {</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     /**</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :      * @notice Internal transfer restriction check.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :      * @param from the origin address</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :      * @param to the destination address</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :      * @param value amount to transfer</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :      * @return restrictionCode The restriction code for this rule.</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :      */</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     function _detectTransferRestriction(address from, address to, uint256 value)</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         internal</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         view</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :         virtual</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :         returns (uint8 restrictionCode);</a>
+<a name="28"><span class="lineNum">      28 </span>                :            : </a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     /**</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :      * @notice Internal transfer restriction check for spender-initiated transfers.</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :      * @param spender the caller executing the transfer</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :      * @param from the origin address</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :      * @param to the destination address</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :      * @param value amount to transfer</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      * @return restrictionCode The restriction code for this rule.</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :      */</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     function _detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         internal</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         view</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         virtual</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :         returns (uint8 restrictionCode);</a>
+<a name="42"><span class="lineNum">      42 </span>                :            : </a>
+<a name="43"><span class="lineNum">      43 </span>                :            :     /**</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :      * @inheritdoc IERC1404</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :      */</a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">        348 :     function detectTransferRestriction(address from, address to, uint256 value)</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         public</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         view</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         virtual</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :         override(IERC1404)</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         returns (uint8)</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :     {</a>
+<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">        348 :         return _detectTransferRestriction(from, to, value);</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :            :     }</a>
+<a name="55"><span class="lineNum">      55 </span>                :            : </a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     /**</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :      * @inheritdoc IERC1404Extend</a>
+<a name="58"><span class="lineNum">      58 </span>                :            :      */</a>
+<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">         36 :     function detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="60"><span class="lineNum">      60 </span>                :            :         public</a>
+<a name="61"><span class="lineNum">      61 </span>                :            :         view</a>
+<a name="62"><span class="lineNum">      62 </span>                :            :         virtual</a>
+<a name="63"><span class="lineNum">      63 </span>                :            :         override(IERC1404Extend)</a>
+<a name="64"><span class="lineNum">      64 </span>                :            :         returns (uint8)</a>
+<a name="65"><span class="lineNum">      65 </span>                :            :     {</a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">         36 :         return _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
 <a name="67"><span class="lineNum">      67 </span>                :            :     }</a>
 <a name="68"><span class="lineNum">      68 </span>                :            : </a>
 <a name="69"><span class="lineNum">      69 </span>                :            :     /**</a>
-<a name="70"><span class="lineNum">      70 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="71"><span class="lineNum">      71 </span>                :            :      */</a>
-<a name="72"><span class="lineNum">      72 </span>                :<span class="lineCov">         10 :     function canTransferFrom(address spender, address from, address to, uint256 tokenId, uint256 value)</span></a>
-<a name="73"><span class="lineNum">      73 </span>                :            :         public</a>
-<a name="74"><span class="lineNum">      74 </span>                :            :         view</a>
-<a name="75"><span class="lineNum">      75 </span>                :            :         virtual</a>
-<a name="76"><span class="lineNum">      76 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="77"><span class="lineNum">      77 </span>                :            :         returns (bool)</a>
-<a name="78"><span class="lineNum">      78 </span>                :            :     {</a>
-<a name="79"><span class="lineNum">      79 </span>                :<span class="lineCov">         10 :         return canTransferFrom(spender, from, to, value);</span></a>
-<a name="80"><span class="lineNum">      80 </span>                :            :     }</a>
-<a name="81"><span class="lineNum">      81 </span>                :            : </a>
-<a name="82"><span class="lineNum">      82 </span>                :<span class="lineNoCov">          0 :     function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {</span></a>
-<a name="83"><span class="lineNum">      83 </span>                :<span class="lineNoCov">          0 :         return interfaceId == type(IRule).interfaceId;</span></a>
+<a name="70"><span class="lineNum">      70 </span>                :            :      * @notice Validate a transfer</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :      * @param from the origin address</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :      * @param to the destination address</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :      * @param amount to transfer</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :      * @return isValid =&gt; true if the transfer is valid, false otherwise</a>
+<a name="75"><span class="lineNum">      75 </span>                :            :      *</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :      */</a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">         20 :     function canTransfer(address from, address to, uint256 amount)</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :            :         public</a>
+<a name="79"><span class="lineNum">      79 </span>                :            :         view</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :         override(IERC3643ComplianceRead)</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :         returns (bool isValid)</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     {</a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">         20 :         return _detectTransferRestriction(from, to, amount) == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
 <a name="84"><span class="lineNum">      84 </span>                :            :     }</a>
-<a name="85"><span class="lineNum">      85 </span>                :            : }</a>
+<a name="85"><span class="lineNum">      85 </span>                :            : </a>
+<a name="86"><span class="lineNum">      86 </span>                :            :     /**</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :      * @inheritdoc IERC7551Compliance</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :      */</a>
+<a name="89"><span class="lineNum">      89 </span>                :<span class="lineCov">         12 :     function canTransferFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="90"><span class="lineNum">      90 </span>                :            :         public</a>
+<a name="91"><span class="lineNum">      91 </span>                :            :         view</a>
+<a name="92"><span class="lineNum">      92 </span>                :            :         virtual</a>
+<a name="93"><span class="lineNum">      93 </span>                :            :         override(IERC7551Compliance)</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         returns (bool)</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :     {</a>
+<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">         12 :         return _detectTransferRestrictionFrom(spender, from, to, value)</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :            :             == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :     }</a>
+<a name="99"><span class="lineNum">      99 </span>                :            : </a>
+<a name="100"><span class="lineNum">     100 </span>                :<span class="lineCov">        195 :     function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {</span></a>
+<a name="101"><span class="lineNum">     101 </span>                :<span class="lineCov">        195 :         return interfaceId == type(IRule).interfaceId || interfaceId == RuleInterfaceId.IRULE_INTERFACE_ID;</span></a>
+<a name="102"><span class="lineNum">     102 </span>                :            :     }</a>
+<a name="103"><span class="lineNum">     103 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
diff --git a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func-sort-c.html b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func-sort-c.html
similarity index 71%
rename from doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func-sort-c.html
rename to doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func-sort-c.html
index bf6dc6f..588fc1b 100644
--- a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func-sort-c.html
+++ b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func-sort-c.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleWhitelistCommon.sol - functions</title>
+  <title>LCOV - lcov.info - abstract/core/RuleWhitelistShared.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleWhitelistCommon.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistCommon.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleWhitelistShared.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistShared.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -37,7 +37,7 @@
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -65,32 +65,32 @@
   <table width="60%" cellpadding=1 cellspacing=1 border=0>
     <tr><td><br></td></tr>
     <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistCommon.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistShared.sol.func.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#95">RuleWhitelistCommon.transferred.1</a></td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#88">RuleWhitelistShared.transferred.1</a></td>
               <td class="coverFnHi">4</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#104">RuleWhitelistCommon.transferred.2</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#31">RuleWhitelistShared.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">10</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#113">RuleWhitelistCommon.transferred.3</a></td>
-              <td class="coverFnHi">5</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#100">RuleWhitelistShared._transferredFrom</a></td>
+              <td class="coverFnHi">11</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#36">RuleWhitelistCommon.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#43">RuleWhitelistShared.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">14</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#48">RuleWhitelistCommon.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#73">RuleWhitelistShared.transferred.0</a></td>
+              <td class="coverFnHi">19</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#77">RuleWhitelistCommon.transferred.0</a></td>
-              <td class="coverFnHi">17</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#92">RuleWhitelistShared._transferred</a></td>
+              <td class="coverFnHi">26</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func.html b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func.html
similarity index 71%
rename from doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func.html
rename to doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func.html
index 2fda202..956fe25 100644
--- a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.func.html
+++ b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.func.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleWhitelistCommon.sol - functions</title>
+  <title>LCOV - lcov.info - abstract/core/RuleWhitelistShared.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleWhitelistCommon.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistCommon.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleWhitelistShared.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistShared.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -37,7 +37,7 @@
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -66,31 +66,31 @@
     <tr><td><br></td></tr>
     <tr>
       <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistCommon.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistShared.sol.func-sort-c.html"><img src="../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#36">RuleWhitelistCommon.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#92">RuleWhitelistShared._transferred</a></td>
+              <td class="coverFnHi">26</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#48">RuleWhitelistCommon.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">14</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#100">RuleWhitelistShared._transferredFrom</a></td>
+              <td class="coverFnHi">11</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#77">RuleWhitelistCommon.transferred.0</a></td>
-              <td class="coverFnHi">17</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#31">RuleWhitelistShared.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">10</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#95">RuleWhitelistCommon.transferred.1</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#43">RuleWhitelistShared.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">14</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#104">RuleWhitelistCommon.transferred.2</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#73">RuleWhitelistShared.transferred.0</a></td>
+              <td class="coverFnHi">19</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistCommon.sol.gcov.html#113">RuleWhitelistCommon.transferred.3</a></td>
-              <td class="coverFnHi">5</td>
+              <td class="coverFn"><a href="RuleWhitelistShared.sol.gcov.html#88">RuleWhitelistShared.transferred.1</a></td>
+              <td class="coverFnHi">4</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.gcov.html b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.gcov.html
similarity index 82%
rename from doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.gcov.html
rename to doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.gcov.html
index 746edeb..e0552e4 100644
--- a/doc/coverage/coverage/validation/abstract/RuleWhitelistCommon.sol.gcov.html
+++ b/doc/coverage/coverage/abstract/core/RuleWhitelistShared.sol.gcov.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleWhitelistCommon.sol</title>
+  <title>LCOV - lcov.info - abstract/core/RuleWhitelistShared.sol</title>
   <link rel="stylesheet" type="text/css" href="../../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">validation/abstract</a> - RuleWhitelistCommon.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistCommon.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">abstract/core</a> - RuleWhitelistShared.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistShared.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -37,7 +37,7 @@
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">6</td>
@@ -76,122 +76,115 @@
 <a name="5"><span class="lineNum">       5 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
 <a name="6"><span class="lineNum">       6 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
 <a name="7"><span class="lineNum">       7 </span>                :            : /* ==== Abstract contracts === */</a>
-<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleWhitelistInvariantStorage} from &quot;./RuleAddressSet/invariantStorage/RuleWhitelistInvariantStorage.sol&quot;;</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleValidateTransfer} from &quot;./RuleValidateTransfer.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : /* ==== Interface === */</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : import {</a>
-<a name="12"><span class="lineNum">      12 </span>                :            :     IERC7943NonFungibleCompliance,</a>
-<a name="13"><span class="lineNum">      13 </span>                :            :     IERC7943NonFungibleComplianceExtend</a>
-<a name="14"><span class="lineNum">      14 </span>                :            : } from &quot;../../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
-<a name="15"><span class="lineNum">      15 </span>                :            : </a>
-<a name="16"><span class="lineNum">      16 </span>                :            : /**</a>
-<a name="17"><span class="lineNum">      17 </span>                :            :  * @title Rule Whitelist Common</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :  * @notice Provides common logic for validating whitelist-based transfer restrictions.</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :  * @dev</a>
-<a name="20"><span class="lineNum">      20 </span>                :            :  * - Implements ERC-3643–compatible `transferred` hooks to enforce whitelist checks.</a>
-<a name="21"><span class="lineNum">      21 </span>                :            :  * - Defines utility functions for restriction code validation and message mapping.</a>
-<a name="22"><span class="lineNum">      22 </span>                :            :  * - Inherits restriction code constants and messages from {RuleWhitelistInvariantStorage}.</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :  */</a>
-<a name="24"><span class="lineNum">      24 </span>                :            : abstract contract RuleWhitelistCommon is RuleValidateTransfer, RuleWhitelistInvariantStorage {</a>
-<a name="25"><span class="lineNum">      25 </span>                :            :     /**</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :      * Indicate if the spender is verified or not</a>
-<a name="27"><span class="lineNum">      27 </span>                :            :      */</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :     bool public checkSpender;</a>
-<a name="29"><span class="lineNum">      29 </span>                :            : </a>
-<a name="30"><span class="lineNum">      30 </span>                :            :     /* ============  View Functions ============ */</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :     /**</a>
-<a name="32"><span class="lineNum">      32 </span>                :            :      * @notice Checks whether a restriction code is recognized by this rule.</a>
-<a name="33"><span class="lineNum">      33 </span>                :            :      * @dev</a>
-<a name="34"><span class="lineNum">      34 </span>                :            :      * Used to verify if a returned restriction code belongs to the whitelist rule.</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :      * @param restrictionCode The restriction code to validate.</a>
-<a name="36"><span class="lineNum">      36 </span>                :            :      * @return isKnown True if the restriction code is recognized by this rule, false otherwise.</a>
-<a name="37"><span class="lineNum">      37 </span>                :            :      */</a>
-<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">         10 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override returns (bool isKnown) {</span></a>
-<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">         10 :         return restrictionCode == CODE_ADDRESS_FROM_NOT_WHITELISTED</span></a>
-<a name="40"><span class="lineNum">      40 </span>                :<span class="lineCov">          5 :             || restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED || restrictionCode == CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
-<a name="41"><span class="lineNum">      41 </span>                :            :     }</a>
-<a name="42"><span class="lineNum">      42 </span>                :            : </a>
-<a name="43"><span class="lineNum">      43 </span>                :            :     /**</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :      * @notice Returns the human-readable message corresponding to a restriction code.</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :      * @dev</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :      * Returns a descriptive text that explains why a transfer was restricted.</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :      * @param restrictionCode The restriction code to decode.</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :      * @return message A human-readable explanation of the restriction.</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :      */</a>
-<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">         14 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
-<a name="51"><span class="lineNum">      51 </span>                :            :         external</a>
-<a name="52"><span class="lineNum">      52 </span>                :            :         pure</a>
-<a name="53"><span class="lineNum">      53 </span>                :            :         override</a>
-<a name="54"><span class="lineNum">      54 </span>                :            :         returns (string memory message)</a>
-<a name="55"><span class="lineNum">      55 </span>                :            :     {</a>
-<a name="56"><span class="lineNum">      56 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">         14 :         if (restrictionCode == CODE_ADDRESS_FROM_NOT_WHITELISTED) {</span></a>
-<a name="57"><span class="lineNum">      57 </span>                :<span class="lineCov">          6 :             return TEXT_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
-<a name="58"><span class="lineNum">      58 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          8 :         } else if (restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED) {</span></a>
-<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">          4 :             return TEXT_ADDRESS_TO_NOT_WHITELISTED;</span></a>
-<a name="60"><span class="lineNum">      60 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          4 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_NOT_WHITELISTED) {</span></a>
-<a name="61"><span class="lineNum">      61 </span>                :<span class="lineCov">          2 :             return TEXT_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
-<a name="62"><span class="lineNum">      62 </span>                :            :         } else {</a>
-<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">          2 :             return TEXT_CODE_NOT_FOUND;</span></a>
-<a name="64"><span class="lineNum">      64 </span>                :            :         }</a>
-<a name="65"><span class="lineNum">      65 </span>                :            :     }</a>
-<a name="66"><span class="lineNum">      66 </span>                :            : </a>
-<a name="67"><span class="lineNum">      67 </span>                :            :     /* ============  State Functions ============ */</a>
-<a name="68"><span class="lineNum">      68 </span>                :            : </a>
-<a name="69"><span class="lineNum">      69 </span>                :            :     /**</a>
-<a name="70"><span class="lineNum">      70 </span>                :            :      * @notice ERC-3643 hook called when a transfer occurs.</a>
-<a name="71"><span class="lineNum">      71 </span>                :            :      * @dev</a>
-<a name="72"><span class="lineNum">      72 </span>                :            :      * - Validates that both `from` and `to` addresses are whitelisted.</a>
-<a name="73"><span class="lineNum">      73 </span>                :            :      * - Reverts if any restriction code other than `TRANSFER_OK` is returned.</a>
-<a name="74"><span class="lineNum">      74 </span>                :            :      * - Should be called during token transfer logic to enforce whitelist compliance.</a>
-<a name="75"><span class="lineNum">      75 </span>                :            :      * @param from The address sending tokens.</a>
-<a name="76"><span class="lineNum">      76 </span>                :            :      * @param to The address receiving tokens.</a>
-<a name="77"><span class="lineNum">      77 </span>                :            :      * @param value The token amount being transferred.</a>
-<a name="78"><span class="lineNum">      78 </span>                :            :      */</a>
-<a name="79"><span class="lineNum">      79 </span>                :<span class="lineCov">         17 :     function transferred(address from, address to, uint256 value) public view override(IERC3643IComplianceContract) {</span></a>
-<a name="80"><span class="lineNum">      80 </span>                :<span class="lineCov">         22 :         uint8 code = this.detectTransferRestriction(from, to, value);</span></a>
-<a name="81"><span class="lineNum">      81 </span>        [<span class="branchCov" title="Branch 0 was taken 14 times"> + </span><span class="branchCov" title="Branch 1 was taken 8 times"> + </span>]:<span class="lineCov">         22 :         require(</span></a>
-<a name="82"><span class="lineNum">      82 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="83"><span class="lineNum">      83 </span>                :            :             RuleWhitelist_InvalidTransfer(address(this), from, to, value, code)</a>
-<a name="84"><span class="lineNum">      84 </span>                :            :         );</a>
-<a name="85"><span class="lineNum">      85 </span>                :            :     }</a>
-<a name="86"><span class="lineNum">      86 </span>                :            : </a>
-<a name="87"><span class="lineNum">      87 </span>                :            :     /**</a>
-<a name="88"><span class="lineNum">      88 </span>                :            :      * @notice hook called when a delegated transfer occurs (`transferFrom`).</a>
-<a name="89"><span class="lineNum">      89 </span>                :            :      * @dev</a>
-<a name="90"><span class="lineNum">      90 </span>                :            :      * - Validates that `spender`, `from`, and `to` are all whitelisted.</a>
-<a name="91"><span class="lineNum">      91 </span>                :            :      * - Reverts if any restriction code other than `TRANSFER_OK` is returned.</a>
-<a name="92"><span class="lineNum">      92 </span>                :            :      * @param spender The address performing the transfer on behalf of another.</a>
-<a name="93"><span class="lineNum">      93 </span>                :            :      * @param from The address from which tokens are transferred.</a>
-<a name="94"><span class="lineNum">      94 </span>                :            :      * @param to The recipient address.</a>
-<a name="95"><span class="lineNum">      95 </span>                :            :      * @param value The token amount being transferred.</a>
-<a name="96"><span class="lineNum">      96 </span>                :            :      */</a>
-<a name="97"><span class="lineNum">      97 </span>                :<span class="lineCov">          4 :     function transferred(address spender, address from, address to, uint256 value) public view override(IRuleEngine) {</span></a>
-<a name="98"><span class="lineNum">      98 </span>                :<span class="lineCov">          8 :         uint8 code = this.detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="99"><span class="lineNum">      99 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 4 times"> + </span>]:<span class="lineCov">          8 :         require(</span></a>
-<a name="100"><span class="lineNum">     100 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="101"><span class="lineNum">     101 </span>                :            :             RuleWhitelist_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
-<a name="102"><span class="lineNum">     102 </span>                :            :         );</a>
-<a name="103"><span class="lineNum">     103 </span>                :            :     }</a>
-<a name="104"><span class="lineNum">     104 </span>                :            : </a>
-<a name="105"><span class="lineNum">     105 </span>                :            : </a>
-<a name="106"><span class="lineNum">     106 </span>                :<span class="lineCov">          4 :     function transferred(address spender, address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="107"><span class="lineNum">     107 </span>                :            :         public</a>
-<a name="108"><span class="lineNum">     108 </span>                :            :         view</a>
-<a name="109"><span class="lineNum">     109 </span>                :            :         virtual</a>
-<a name="110"><span class="lineNum">     110 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="111"><span class="lineNum">     111 </span>                :            :     {</a>
-<a name="112"><span class="lineNum">     112 </span>                :<span class="lineCov">          4 :         transferred(spender, from, to, value);</span></a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleWhitelistInvariantStorage} from &quot;../RuleAddressSet/invariantStorage/RuleWhitelistInvariantStorage.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleNFTAdapter} from &quot;./RuleNFTAdapter.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : </a>
+<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @title Rule Whitelist Shared</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Provides common logic for validating whitelist-based transfer restrictions.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @dev</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * - Implements ERC-3643–compatible `transferred` hooks to enforce whitelist checks.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  * - Defines utility functions for restriction code validation and message mapping.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  * - Inherits restriction code constants and messages from {RuleWhitelistInvariantStorage}.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  */</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : abstract contract RuleWhitelistShared is RuleNFTAdapter, RuleWhitelistInvariantStorage {</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :     /**</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :      * Indicate if the spender is verified or not</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :      */</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     bool public checkSpender;</a>
+<a name="24"><span class="lineNum">      24 </span>                :            : </a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     /* ============  View Functions ============ */</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     /**</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :      * @notice Checks whether a restriction code is recognized by this rule.</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :      * @dev</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :      * Used to verify if a returned restriction code belongs to the whitelist rule.</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :      * @param restrictionCode The restriction code to validate.</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :      * @return isKnown True if the restriction code is recognized by this rule, false otherwise.</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :      */</a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">         10 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override returns (bool isKnown) {</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         10 :         return restrictionCode == CODE_ADDRESS_FROM_NOT_WHITELISTED</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">          5 :             || restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED || restrictionCode == CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     }</a>
+<a name="37"><span class="lineNum">      37 </span>                :            : </a>
+<a name="38"><span class="lineNum">      38 </span>                :            :     /**</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :      * @notice Returns the human-readable message corresponding to a restriction code.</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :      * @dev</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :      * Returns a descriptive text that explains why a transfer was restricted.</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :      * @param restrictionCode The restriction code to decode.</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :      * @return message A human-readable explanation of the restriction.</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :      */</a>
+<a name="45"><span class="lineNum">      45 </span>                :<span class="lineCov">         14 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="46"><span class="lineNum">      46 </span>                :            :         external</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         pure</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         override</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         returns (string memory message)</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :     {</a>
+<a name="51"><span class="lineNum">      51 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">         14 :         if (restrictionCode == CODE_ADDRESS_FROM_NOT_WHITELISTED) {</span></a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">          6 :             return TEXT_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
+<a name="53"><span class="lineNum">      53 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          8 :         } else if (restrictionCode == CODE_ADDRESS_TO_NOT_WHITELISTED) {</span></a>
+<a name="54"><span class="lineNum">      54 </span>                :<span class="lineCov">          4 :             return TEXT_ADDRESS_TO_NOT_WHITELISTED;</span></a>
+<a name="55"><span class="lineNum">      55 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          4 :         } else if (restrictionCode == CODE_ADDRESS_SPENDER_NOT_WHITELISTED) {</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :<span class="lineCov">          2 :             return TEXT_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
+<a name="57"><span class="lineNum">      57 </span>                :            :         } else {</a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">          2 :             return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :            :         }</a>
+<a name="60"><span class="lineNum">      60 </span>                :            :     }</a>
+<a name="61"><span class="lineNum">      61 </span>                :            : </a>
+<a name="62"><span class="lineNum">      62 </span>                :            :     /* ============  State Functions ============ */</a>
+<a name="63"><span class="lineNum">      63 </span>                :            : </a>
+<a name="64"><span class="lineNum">      64 </span>                :            :     /**</a>
+<a name="65"><span class="lineNum">      65 </span>                :            :      * @notice ERC-3643 hook called when a transfer occurs.</a>
+<a name="66"><span class="lineNum">      66 </span>                :            :      * @dev</a>
+<a name="67"><span class="lineNum">      67 </span>                :            :      * - Validates that both `from` and `to` addresses are whitelisted.</a>
+<a name="68"><span class="lineNum">      68 </span>                :            :      * - Reverts if any restriction code other than `TRANSFER_OK` is returned.</a>
+<a name="69"><span class="lineNum">      69 </span>                :            :      * - Validation only; does not modify state.</a>
+<a name="70"><span class="lineNum">      70 </span>                :            :      * - Should be called during token transfer logic to enforce whitelist compliance.</a>
+<a name="71"><span class="lineNum">      71 </span>                :            :      * @param from The address sending tokens.</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :      * @param to The address receiving tokens.</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :      * @param value The token amount being transferred.</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :      */</a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">         19 :     function transferred(address from, address to, uint256 value) public view override(IERC3643IComplianceContract) {</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">         19 :         _transferred(from, to, value);</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :            :     }</a>
+<a name="78"><span class="lineNum">      78 </span>                :            : </a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     /**</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :      * @notice hook called when a delegated transfer occurs (`transferFrom`).</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :      * @dev</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :      * - Validates that `spender`, `from`, and `to` are all whitelisted.</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :      * - Reverts if any restriction code other than `TRANSFER_OK` is returned.</a>
+<a name="84"><span class="lineNum">      84 </span>                :            :      * - Validation only; does not modify state.</a>
+<a name="85"><span class="lineNum">      85 </span>                :            :      * @param spender The address performing the transfer on behalf of another.</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :      * @param from The address from which tokens are transferred.</a>
+<a name="87"><span class="lineNum">      87 </span>                :            :      * @param to The recipient address.</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :      * @param value The token amount being transferred.</a>
+<a name="89"><span class="lineNum">      89 </span>                :            :      */</a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">          4 :     function transferred(address spender, address from, address to, uint256 value) public view override(IRuleEngine) {</span></a>
+<a name="91"><span class="lineNum">      91 </span>                :<span class="lineCov">          4 :         _transferredFrom(spender, from, to, value);</span></a>
+<a name="92"><span class="lineNum">      92 </span>                :            :     }</a>
+<a name="93"><span class="lineNum">      93 </span>                :            : </a>
+<a name="94"><span class="lineNum">      94 </span>                :<span class="lineCov">         26 :     function _transferred(address from, address to, uint256 value) internal view virtual override {</span></a>
+<a name="95"><span class="lineNum">      95 </span>                :<span class="lineCov">         26 :         uint8 code = _detectTransferRestriction(from, to, value);</span></a>
+<a name="96"><span class="lineNum">      96 </span>        [<span class="branchCov" title="Branch 0 was taken 14 times"> + </span><span class="branchCov" title="Branch 1 was taken 12 times"> + </span>]:<span class="lineCov">         26 :         require(</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="98"><span class="lineNum">      98 </span>                :            :             RuleWhitelist_InvalidTransfer(address(this), from, to, value, code)</a>
+<a name="99"><span class="lineNum">      99 </span>                :            :         );</a>
+<a name="100"><span class="lineNum">     100 </span>                :            :     }</a>
+<a name="101"><span class="lineNum">     101 </span>                :            : </a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">         11 :     function _transferredFrom(address spender, address from, address to, uint256 value)</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :            :         internal</a>
+<a name="104"><span class="lineNum">     104 </span>                :            :         view</a>
+<a name="105"><span class="lineNum">     105 </span>                :            :         virtual</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :         override</a>
+<a name="107"><span class="lineNum">     107 </span>                :            :     {</a>
+<a name="108"><span class="lineNum">     108 </span>                :<span class="lineCov">         11 :         uint8 code = _detectTransferRestrictionFrom(spender, from, to, value);</span></a>
+<a name="109"><span class="lineNum">     109 </span>        [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span><span class="branchCov" title="Branch 1 was taken 7 times"> + </span>]:<span class="lineCov">         11 :         require(</span></a>
+<a name="110"><span class="lineNum">     110 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
+<a name="111"><span class="lineNum">     111 </span>                :            :             RuleWhitelist_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
+<a name="112"><span class="lineNum">     112 </span>                :            :         );</a>
 <a name="113"><span class="lineNum">     113 </span>                :            :     }</a>
 <a name="114"><span class="lineNum">     114 </span>                :            : </a>
-<a name="115"><span class="lineNum">     115 </span>                :<span class="lineCov">          5 :     function transferred(address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="116"><span class="lineNum">     116 </span>                :            :         public</a>
-<a name="117"><span class="lineNum">     117 </span>                :            :         view</a>
-<a name="118"><span class="lineNum">     118 </span>                :            :         virtual</a>
-<a name="119"><span class="lineNum">     119 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="120"><span class="lineNum">     120 </span>                :            :     {</a>
-<a name="121"><span class="lineNum">     121 </span>                :<span class="lineCov">          5 :         transferred(from, to, value);</span></a>
-<a name="122"><span class="lineNum">     122 </span>                :            :     }</a>
-<a name="123"><span class="lineNum">     123 </span>                :            : }</a>
+<a name="115"><span class="lineNum">     115 </span>                :            : </a>
+<a name="116"><span class="lineNum">     116 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
diff --git a/doc/coverage/coverage/abstract/core/index-sort-b.html b/doc/coverage/coverage/abstract/core/index-sort-b.html
new file mode 100644
index 0000000..226fe72
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/index-sort-b.html
@@ -0,0 +1,131 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/core</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleTransferValidation.sol.gcov.html">RuleTransferValidation.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleNFTAdapter.sol.gcov.html">RuleNFTAdapter.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">20 / 20</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistShared.sol.gcov.html">RuleWhitelistShared.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">21 / 21</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/core/index-sort-f.html b/doc/coverage/coverage/abstract/core/index-sort-f.html
new file mode 100644
index 0000000..e680dc9
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/index-sort-f.html
@@ -0,0 +1,131 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/core</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleTransferValidation.sol.gcov.html">RuleTransferValidation.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistShared.sol.gcov.html">RuleWhitelistShared.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">21 / 21</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleNFTAdapter.sol.gcov.html">RuleNFTAdapter.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">20 / 20</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/core/index-sort-l.html b/doc/coverage/coverage/abstract/core/index-sort-l.html
new file mode 100644
index 0000000..e557c1e
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/index-sort-l.html
@@ -0,0 +1,131 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/core</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleTransferValidation.sol.gcov.html">RuleTransferValidation.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleNFTAdapter.sol.gcov.html">RuleNFTAdapter.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">20 / 20</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistShared.sol.gcov.html">RuleWhitelistShared.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">21 / 21</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/abstract/core/index.html b/doc/coverage/coverage/abstract/core/index.html
new file mode 100644
index 0000000..be497f9
--- /dev/null
+++ b/doc/coverage/coverage/abstract/core/index.html
@@ -0,0 +1,131 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - abstract/core</title>
+  <link rel="stylesheet" type="text/css" href="../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - abstract/core</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntry">51</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntry">19</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleNFTAdapter.sol.gcov.html">RuleNFTAdapter.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">20 / 20</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleTransferValidation.sol.gcov.html">RuleTransferValidation.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistShared.sol.gcov.html">RuleWhitelistShared.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">21 / 21</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleBlacklist.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleBlacklist.sol.func-sort-c.html
similarity index 61%
rename from doc/coverage/coverage/validation/RuleBlacklist.sol.func-sort-c.html
rename to doc/coverage/coverage/deployment/RuleBlacklist.sol.func-sort-c.html
index 09bb6da..7a9f3cd 100644
--- a/doc/coverage/coverage/validation/RuleBlacklist.sol.func-sort-c.html
+++ b/doc/coverage/coverage/deployment/RuleBlacklist.sol.func-sort-c.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleBlacklist.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleBlacklist.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (<a href="RuleBlacklist.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (<a href="RuleBlacklist.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">35</td>
-            <td class="headerCovTableEntry">37</td>
-            <td class="headerCovTableEntryHi">94.6 %</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,48 +69,28 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#136">RuleBlacklist.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#155">RuleBlacklist.transferred.1</a></td>
-              <td class="coverFnHi">2</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#168">RuleBlacklist.transferred.2</a></td>
-              <td class="coverFnHi">2</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#177">RuleBlacklist.transferred.3</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#101">RuleBlacklist.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#85">RuleBlacklist.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#38">RuleBlacklist._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#57">RuleBlacklist.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">7</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#44">RuleBlacklist._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#118">RuleBlacklist.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">8</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#36">RuleBlacklist._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">28</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#142">RuleBlacklist.transferred.0</a></td>
-              <td class="coverFnHi">9</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#40">RuleBlacklist._msgSender</a></td>
+              <td class="coverFnHi">83</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#69">RuleBlacklist.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">16</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#48">RuleBlacklist._contextSuffixLength</a></td>
+              <td class="coverFnHi">84</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#39">RuleBlacklist.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">22</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#26">RuleBlacklist.supportsInterface</a></td>
+              <td class="coverFnHi">91</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/RuleBlacklist.sol.func.html b/doc/coverage/coverage/deployment/RuleBlacklist.sol.func.html
similarity index 61%
rename from doc/coverage/coverage/validation/RuleBlacklist.sol.func.html
rename to doc/coverage/coverage/deployment/RuleBlacklist.sol.func.html
index 7644183..a7a1b13 100644
--- a/doc/coverage/coverage/validation/RuleBlacklist.sol.func.html
+++ b/doc/coverage/coverage/deployment/RuleBlacklist.sol.func.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleBlacklist.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleBlacklist.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (<a href="RuleBlacklist.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (<a href="RuleBlacklist.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">35</td>
-            <td class="headerCovTableEntry">37</td>
-            <td class="headerCovTableEntryHi">94.6 %</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,48 +69,28 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleBlacklist.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#101">RuleBlacklist.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#39">RuleBlacklist.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">22</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#57">RuleBlacklist.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">7</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#69">RuleBlacklist.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">16</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#85">RuleBlacklist.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#118">RuleBlacklist.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">8</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#36">RuleBlacklist._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">28</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#136">RuleBlacklist.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#38">RuleBlacklist._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#142">RuleBlacklist.transferred.0</a></td>
-              <td class="coverFnHi">9</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#48">RuleBlacklist._contextSuffixLength</a></td>
+              <td class="coverFnHi">84</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#155">RuleBlacklist.transferred.1</a></td>
-              <td class="coverFnHi">2</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#44">RuleBlacklist._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#168">RuleBlacklist.transferred.2</a></td>
-              <td class="coverFnHi">2</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#40">RuleBlacklist._msgSender</a></td>
+              <td class="coverFnHi">83</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#177">RuleBlacklist.transferred.3</a></td>
-              <td class="coverFnHi">3</td>
+              <td class="coverFn"><a href="RuleBlacklist.sol.gcov.html#26">RuleBlacklist.supportsInterface</a></td>
+              <td class="coverFnHi">91</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/deployment/RuleBlacklist.sol.gcov.html b/doc/coverage/coverage/deployment/RuleBlacklist.sol.gcov.html
new file mode 100644
index 0000000..1f3c2dd
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleBlacklist.sol.gcov.html
@@ -0,0 +1,138 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleBlacklist.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (source / <a href="RuleBlacklist.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : </a>
+<a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="4"><span class="lineNum">       4 </span>                :            : </a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleBlacklistBase} from &quot;../abstract/base/RuleBlacklistBase.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleAddressSet} from &quot;../abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : </a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /**</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @title a blacklist manager</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  */</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : contract RuleBlacklist is RuleBlacklistBase, AccessControlModuleStandalone {</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :                               CONSTRUCTOR</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     /**</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :      */</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     constructor(address admin, address forwarderIrrevocable)</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         RuleBlacklistBase(forwarderIrrevocable)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     {}</a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">         91 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         public</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         view</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :         virtual</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :         override(AccessControlEnumerable, RuleBlacklistBase)</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :         returns (bool)</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     {</a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">         91 :         return AccessControlEnumerable.supportsInterface(interfaceId) || RuleBlacklistBase.supportsInterface(interfaceId);</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     }</a>
+<a name="37"><span class="lineNum">      37 </span>                :            : </a>
+<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">         28 :     function _authorizeAddressListAdd() internal view virtual override onlyRole(ADDRESS_LIST_ADD_ROLE) {}</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :            : </a>
+<a name="40"><span class="lineNum">      40 </span>                :<span class="lineCov">          1 :     function _authorizeAddressListRemove() internal view virtual override onlyRole(ADDRESS_LIST_REMOVE_ROLE) {}</span></a>
+<a name="41"><span class="lineNum">      41 </span>                :            : </a>
+<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">         83 :     function _msgSender() internal view virtual override(Context, RuleAddressSet) returns (address sender) {</span></a>
+<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">         83 :         return super._msgSender();</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     }</a>
+<a name="45"><span class="lineNum">      45 </span>                :            : </a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleAddressSet) returns (bytes calldata) {</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :            :     }</a>
+<a name="49"><span class="lineNum">      49 </span>                :            : </a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">         84 :     function _contextSuffixLength() internal view virtual override(Context, RuleAddressSet) returns (uint256) {</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :<span class="lineCov">         84 :         return super._contextSuffixLength();</span></a>
+<a name="52"><span class="lineNum">      52 </span>                :            :     }</a>
+<a name="53"><span class="lineNum">      53 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..4f6c52b
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleBlacklistOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklistOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleBlacklistOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleBlacklistOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#26">RuleBlacklistOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#18">RuleBlacklistOwnable2Step._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#20">RuleBlacklistOwnable2Step._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#22">RuleBlacklistOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#30">RuleBlacklistOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func.html
new file mode 100644
index 0000000..3adf440
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.func.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleBlacklistOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklistOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleBlacklistOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleBlacklistOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#18">RuleBlacklistOwnable2Step._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#20">RuleBlacklistOwnable2Step._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#30">RuleBlacklistOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#26">RuleBlacklistOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleBlacklistOwnable2Step.sol.gcov.html#22">RuleBlacklistOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..1c015a0
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleBlacklistOwnable2Step.sol.gcov.html
@@ -0,0 +1,120 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleBlacklistOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleBlacklistOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleBlacklistOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleBlacklistBase} from &quot;../abstract/base/RuleBlacklistBase.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleAddressSet} from &quot;../abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : </a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @title RuleBlacklistOwnable2Step</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @notice Ownable2Step variant of RuleBlacklist with owner-based authorization hooks.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  */</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : contract RuleBlacklistOwnable2Step is RuleBlacklistBase, Ownable2Step {</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :     constructor(address owner, address forwarderIrrevocable)</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :         RuleBlacklistBase(forwarderIrrevocable)</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :         Ownable(owner)</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     {}</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">          2 :     function _authorizeAddressListAdd() internal view virtual override onlyOwner {}</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            : </a>
+<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">          2 :     function _authorizeAddressListRemove() internal view virtual override onlyOwner {}</span></a>
+<a name="23"><span class="lineNum">      23 </span>                :            : </a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">         12 :     function _msgSender() internal view virtual override(Context, RuleAddressSet) returns (address sender) {</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :<span class="lineCov">         12 :         return super._msgSender();</span></a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     }</a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleAddressSet) returns (bytes calldata) {</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     }</a>
+<a name="31"><span class="lineNum">      31 </span>                :            : </a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">         13 :     function _contextSuffixLength() internal view virtual override(Context, RuleAddressSet) returns (uint256) {</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">         13 :         return super._contextSuffixLength();</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     }</a>
+<a name="35"><span class="lineNum">      35 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleERC2980.sol.func-sort-c.html
new file mode 100644
index 0000000..5982600
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980.sol.func-sort-c.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980.sol<span style="font-size: 80%;"> (<a href="RuleERC2980.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleERC2980.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#74">RuleERC2980._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#48">RuleERC2980.supportsInterface</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#68">RuleERC2980._authorizeFrozenlistRemove</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#64">RuleERC2980._authorizeWhitelistRemove</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#66">RuleERC2980._authorizeFrozenlistAdd</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#62">RuleERC2980._authorizeWhitelistAdd</a></td>
+              <td class="coverFnHi">42</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#70">RuleERC2980._msgSender</a></td>
+              <td class="coverFnHi">237</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#78">RuleERC2980._contextSuffixLength</a></td>
+              <td class="coverFnHi">238</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980.sol.func.html b/doc/coverage/coverage/deployment/RuleERC2980.sol.func.html
new file mode 100644
index 0000000..2fc8959
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980.sol.func.html
@@ -0,0 +1,113 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980.sol<span style="font-size: 80%;"> (<a href="RuleERC2980.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleERC2980.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#66">RuleERC2980._authorizeFrozenlistAdd</a></td>
+              <td class="coverFnHi">22</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#68">RuleERC2980._authorizeFrozenlistRemove</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#62">RuleERC2980._authorizeWhitelistAdd</a></td>
+              <td class="coverFnHi">42</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#64">RuleERC2980._authorizeWhitelistRemove</a></td>
+              <td class="coverFnHi">8</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#78">RuleERC2980._contextSuffixLength</a></td>
+              <td class="coverFnHi">238</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#74">RuleERC2980._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#70">RuleERC2980._msgSender</a></td>
+              <td class="coverFnHi">237</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980.sol.gcov.html#48">RuleERC2980.supportsInterface</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980.sol.gcov.html b/doc/coverage/coverage/deployment/RuleERC2980.sol.gcov.html
new file mode 100644
index 0000000..44437e3
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980.sol.gcov.html
@@ -0,0 +1,168 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980.sol<span style="font-size: 80%;"> (source / <a href="RuleERC2980.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntry">12</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleERC2980Base} from &quot;../abstract/base/RuleERC2980Base.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : </a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @title RuleERC2980</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @notice ERC-2980 Swiss Compliant transfer rule combining a whitelist and a frozenlist.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @dev</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * - Whitelist: only whitelisted addresses may receive tokens.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  *   Senders do not need to be whitelisted.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  * - Frozenlist: frozen addresses are blocked from both sending and receiving.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  *   Frozenlist check takes priority over the whitelist check.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  *</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :  * Access control uses {AccessControlModuleStandalone}:</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :  * - `WHITELIST_ADD_ROLE`    — may add addresses to the whitelist.</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :  * - `WHITELIST_REMOVE_ROLE` — may remove addresses from the whitelist.</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :  * - `FROZENLIST_ADD_ROLE`   — may add addresses to the frozenlist.</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :  * - `FROZENLIST_REMOVE_ROLE`— may remove addresses from the frozenlist.</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :  * - `DEFAULT_ADMIN_ROLE`    — implicitly holds all roles.</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :  *</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :  * Restriction codes:</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :  * - 60: sender is frozen</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :  * - 61: recipient is frozen</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :  * - 62: spender is frozen</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :  * - 63: recipient is not whitelisted</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :  */</a>
+<a name="32"><span class="lineNum">      32 </span>                :            : contract RuleERC2980 is RuleERC2980Base, AccessControlModuleStandalone {</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="34"><span class="lineNum">      34 </span>                :            :                               CONSTRUCTOR</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="36"><span class="lineNum">      36 </span>                :            : </a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     /**</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :      * @param admin Address that receives `DEFAULT_ADMIN_ROLE` (implicitly holds all roles).</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :      * @param forwarderIrrevocable Address of the ERC-2771 forwarder for meta-transactions.</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :      */</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :     constructor(address admin, address forwarderIrrevocable)</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :         RuleERC2980Base(forwarderIrrevocable)</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     {}</a>
+<a name="45"><span class="lineNum">      45 </span>                :            : </a>
+<a name="46"><span class="lineNum">      46 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :                            INTERFACE SUPPORT</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="49"><span class="lineNum">      49 </span>                :            : </a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">          1 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         public</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :         view</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :         virtual</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :         override(AccessControlEnumerable, RuleERC2980Base)</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :         returns (bool)</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     {</a>
+<a name="57"><span class="lineNum">      57 </span>                :<span class="lineCov">          1 :         return AccessControlEnumerable.supportsInterface(interfaceId) || RuleERC2980Base.supportsInterface(interfaceId);</span></a>
+<a name="58"><span class="lineNum">      58 </span>                :            :     }</a>
+<a name="59"><span class="lineNum">      59 </span>                :            : </a>
+<a name="60"><span class="lineNum">      60 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="61"><span class="lineNum">      61 </span>                :            :                             ACCESS CONTROL</a>
+<a name="62"><span class="lineNum">      62 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="63"><span class="lineNum">      63 </span>                :            : </a>
+<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">         42 :     function _authorizeWhitelistAdd() internal view virtual override onlyRole(WHITELIST_ADD_ROLE) {}</span></a>
+<a name="65"><span class="lineNum">      65 </span>                :            : </a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">          8 :     function _authorizeWhitelistRemove() internal view virtual override onlyRole(WHITELIST_REMOVE_ROLE) {}</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :            : </a>
+<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">         22 :     function _authorizeFrozenlistAdd() internal view virtual override onlyRole(FROZENLIST_ADD_ROLE) {}</span></a>
+<a name="69"><span class="lineNum">      69 </span>                :            : </a>
+<a name="70"><span class="lineNum">      70 </span>                :<span class="lineCov">          7 :     function _authorizeFrozenlistRemove() internal view virtual override onlyRole(FROZENLIST_REMOVE_ROLE) {}</span></a>
+<a name="71"><span class="lineNum">      71 </span>                :            : </a>
+<a name="72"><span class="lineNum">      72 </span>                :<span class="lineCov">        237 :     function _msgSender() internal view virtual override(Context, RuleERC2980Base) returns (address sender) {</span></a>
+<a name="73"><span class="lineNum">      73 </span>                :<span class="lineCov">        237 :         return super._msgSender();</span></a>
+<a name="74"><span class="lineNum">      74 </span>                :            :     }</a>
+<a name="75"><span class="lineNum">      75 </span>                :            : </a>
+<a name="76"><span class="lineNum">      76 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleERC2980Base) returns (bytes calldata) {</span></a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :            :     }</a>
+<a name="79"><span class="lineNum">      79 </span>                :            : </a>
+<a name="80"><span class="lineNum">      80 </span>                :<span class="lineCov">        238 :     function _contextSuffixLength() internal view virtual override(Context, RuleERC2980Base) returns (uint256) {</span></a>
+<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">        238 :         return super._contextSuffixLength();</span></a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     }</a>
+<a name="83"><span class="lineNum">      83 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..6a57dc8
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func-sort-c.html
@@ -0,0 +1,109 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980Ownable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980Ownable2Step.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Ownable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleERC2980Ownable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#30">RuleERC2980Ownable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#24">RuleERC2980Ownable2Step._authorizeFrozenlistRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#20">RuleERC2980Ownable2Step._authorizeWhitelistRemove</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#22">RuleERC2980Ownable2Step._authorizeFrozenlistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#18">RuleERC2980Ownable2Step._authorizeWhitelistAdd</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#26">RuleERC2980Ownable2Step._msgSender</a></td>
+              <td class="coverFnHi">30</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#34">RuleERC2980Ownable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">31</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func.html
new file mode 100644
index 0000000..06ea5a4
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.func.html
@@ -0,0 +1,109 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980Ownable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980Ownable2Step.sol<span style="font-size: 80%;"> (<a href="RuleERC2980Ownable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleERC2980Ownable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#22">RuleERC2980Ownable2Step._authorizeFrozenlistAdd</a></td>
+              <td class="coverFnHi">6</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#24">RuleERC2980Ownable2Step._authorizeFrozenlistRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#18">RuleERC2980Ownable2Step._authorizeWhitelistAdd</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#20">RuleERC2980Ownable2Step._authorizeWhitelistRemove</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#34">RuleERC2980Ownable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">31</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#30">RuleERC2980Ownable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleERC2980Ownable2Step.sol.gcov.html#26">RuleERC2980Ownable2Step._msgSender</a></td>
+              <td class="coverFnHi">30</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.gcov.html
new file mode 100644
index 0000000..58cf267
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleERC2980Ownable2Step.sol.gcov.html
@@ -0,0 +1,124 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleERC2980Ownable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleERC2980Ownable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleERC2980Ownable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleERC2980Base} from &quot;../abstract/base/RuleERC2980Base.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : </a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /**</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  * @title RuleERC2980Ownable2Step</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @notice Ownable2Step variant of RuleERC2980 with owner-based authorization hooks.</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @dev All whitelist and frozenlist management functions are restricted to the contract owner.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  */</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : contract RuleERC2980Ownable2Step is RuleERC2980Base, Ownable2Step {</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :     constructor(address owner, address forwarderIrrevocable)</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :         RuleERC2980Base(forwarderIrrevocable)</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :         Ownable(owner)</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     {}</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">          7 :     function _authorizeWhitelistAdd() internal view virtual override onlyOwner {}</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            : </a>
+<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">          3 :     function _authorizeWhitelistRemove() internal view virtual override onlyOwner {}</span></a>
+<a name="23"><span class="lineNum">      23 </span>                :            : </a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">          6 :     function _authorizeFrozenlistAdd() internal view virtual override onlyOwner {}</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">          2 :     function _authorizeFrozenlistRemove() internal view virtual override onlyOwner {}</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">         30 :     function _msgSender() internal view virtual override(Context, RuleERC2980Base) returns (address sender) {</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">         30 :         return super._msgSender();</span></a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     }</a>
+<a name="31"><span class="lineNum">      31 </span>                :            : </a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleERC2980Base) returns (bytes calldata) {</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     }</a>
+<a name="35"><span class="lineNum">      35 </span>                :            : </a>
+<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">         31 :     function _contextSuffixLength() internal view virtual override(Context, RuleERC2980Base) returns (uint256) {</span></a>
+<a name="37"><span class="lineNum">      37 </span>                :<span class="lineCov">         31 :         return super._contextSuffixLength();</span></a>
+<a name="38"><span class="lineNum">      38 </span>                :            :     }</a>
+<a name="39"><span class="lineNum">      39 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func-sort-c.html
new file mode 100644
index 0000000..c671fdf
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func-sort-c.html
@@ -0,0 +1,89 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistry.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistry.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistry.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleIdentityRegistry.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistry.sol.gcov.html#33">RuleIdentityRegistry._authorizeIdentityRegistryManager</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistry.sol.gcov.html#18">RuleIdentityRegistry.supportsInterface</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func.html b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func.html
new file mode 100644
index 0000000..03a6311
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.func.html
@@ -0,0 +1,89 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistry.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistry.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistry.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleIdentityRegistry.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistry.sol.gcov.html#33">RuleIdentityRegistry._authorizeIdentityRegistryManager</a></td>
+              <td class="coverFnHi">5</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistry.sol.gcov.html#18">RuleIdentityRegistry.supportsInterface</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.gcov.html b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.gcov.html
new file mode 100644
index 0000000..29c87c5
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistry.sol.gcov.html
@@ -0,0 +1,121 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistry.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistry.sol<span style="font-size: 80%;"> (source / <a href="RuleIdentityRegistry.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleIdentityRegistryBase} from &quot;../abstract/base/RuleIdentityRegistryBase.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleTransferValidation} from &quot;../abstract/core/RuleTransferValidation.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : </a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /**</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  * @title RuleIdentityRegistry</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @notice Checks the ERC-3643 Identity Registry for transfer participants when configured.</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @dev Burns (to == address(0)) are allowed even if the sender is not verified.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  */</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : contract RuleIdentityRegistry is AccessControlModuleStandalone, RuleIdentityRegistryBase {</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :     constructor(address admin, address identityRegistry_)</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :         RuleIdentityRegistryBase(identityRegistry_)</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     {}</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">         15 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         public</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :         view</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :         virtual</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         override(AccessControlEnumerable, RuleTransferValidation)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         returns (bool)</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     {</a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">         15 :         return AccessControlEnumerable.supportsInterface(interfaceId)</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">         10 :             || RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     }</a>
+<a name="30"><span class="lineNum">      30 </span>                :            : </a>
+<a name="31"><span class="lineNum">      31 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :                             ACCESS CONTROL</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="34"><span class="lineNum">      34 </span>                :            : </a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">          5 :     function _authorizeIdentityRegistryManager() internal view virtual override onlyRole(DEFAULT_ADMIN_ROLE) {}</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..f0edaeb
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistryOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistryOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleIdentityRegistryOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html#13">RuleIdentityRegistryOwnable2Step._authorizeIdentityRegistryManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func.html
new file mode 100644
index 0000000..f36b6a3
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.func.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistryOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistryOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html#13">RuleIdentityRegistryOwnable2Step._authorizeIdentityRegistryManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..c5464a5
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleIdentityRegistryOwnable2Step.sol.gcov.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleIdentityRegistryOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleIdentityRegistryOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleIdentityRegistryOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleIdentityRegistryBase} from &quot;../abstract/base/RuleIdentityRegistryBase.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : </a>
+<a name="8"><span class="lineNum">       8 </span>                :            : /**</a>
+<a name="9"><span class="lineNum">       9 </span>                :            :  * @title RuleIdentityRegistryOwnable2Step</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  * @notice Ownable2Step variant of RuleIdentityRegistry.</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  */</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : contract RuleIdentityRegistryOwnable2Step is RuleIdentityRegistryBase, Ownable2Step {</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :     constructor(address owner, address identityRegistry_) RuleIdentityRegistryBase(identityRegistry_) Ownable(owner) {}</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : </a>
+<a name="15"><span class="lineNum">      15 </span>                :<span class="lineCov">          4 :     function _authorizeIdentityRegistryManager() internal view virtual override onlyOwner {}</span></a>
+<a name="16"><span class="lineNum">      16 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func-sort-c.html
new file mode 100644
index 0000000..3d362ea
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func-sort-c.html
@@ -0,0 +1,89 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupply.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupply.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupply.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleMaxTotalSupply.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupply.sol.gcov.html#22">RuleMaxTotalSupply.supportsInterface</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupply.sol.gcov.html#37">RuleMaxTotalSupply._authorizeMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func.html
new file mode 100644
index 0000000..461eca6
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.func.html
@@ -0,0 +1,89 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupply.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupply.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupply.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleMaxTotalSupply.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupply.sol.gcov.html#37">RuleMaxTotalSupply._authorizeMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">260</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupply.sol.gcov.html#22">RuleMaxTotalSupply.supportsInterface</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.gcov.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.gcov.html
new file mode 100644
index 0000000..6933e67
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupply.sol.gcov.html
@@ -0,0 +1,125 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupply.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupply.sol<span style="font-size: 80%;"> (source / <a href="RuleMaxTotalSupply.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleMaxTotalSupplyBase} from &quot;../abstract/base/RuleMaxTotalSupplyBase.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleTransferValidation} from &quot;../abstract/core/RuleTransferValidation.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : </a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /**</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  * @title RuleMaxTotalSupply</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @notice Restricts minting so that total supply never exceeds a maximum value.</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  */</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : contract RuleMaxTotalSupply is AccessControlModuleStandalone, RuleMaxTotalSupplyBase {</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :     /**</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :      * @param admin Address that receives the default admin role.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :      * @param tokenContract_ Token contract that exposes totalSupply (must be non-zero).</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :      * @param maxTotalSupply_ Initial maximum supply.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :      */</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     constructor(address admin, address tokenContract_, uint256 maxTotalSupply_)</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :         RuleMaxTotalSupplyBase(tokenContract_, maxTotalSupply_)</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     {}</a>
+<a name="23"><span class="lineNum">      23 </span>                :            : </a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">         15 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         public</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :         view</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :         virtual</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :         override(AccessControlEnumerable, RuleTransferValidation)</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         returns (bool)</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     {</a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">         15 :         return AccessControlEnumerable.supportsInterface(interfaceId)</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">         10 :             || RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     }</a>
+<a name="34"><span class="lineNum">      34 </span>                :            : </a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :                             ACCESS CONTROL</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="38"><span class="lineNum">      38 </span>                :            : </a>
+<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">        260 :     function _authorizeMaxTotalSupplyManager() internal view virtual override onlyRole(DEFAULT_ADMIN_ROLE) {}</span></a>
+<a name="40"><span class="lineNum">      40 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..8f2bc94
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupplyOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupplyOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleMaxTotalSupplyOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html#16">RuleMaxTotalSupplyOwnable2Step._authorizeMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func.html
new file mode 100644
index 0000000..9d21145
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.func.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupplyOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupplyOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html#16">RuleMaxTotalSupplyOwnable2Step._authorizeMaxTotalSupplyManager</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..e3cdd2f
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleMaxTotalSupplyOwnable2Step.sol.gcov.html
@@ -0,0 +1,104 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleMaxTotalSupplyOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleMaxTotalSupplyOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleMaxTotalSupplyOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {RuleMaxTotalSupplyBase} from &quot;../abstract/base/RuleMaxTotalSupplyBase.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : </a>
+<a name="8"><span class="lineNum">       8 </span>                :            : /**</a>
+<a name="9"><span class="lineNum">       9 </span>                :            :  * @title RuleMaxTotalSupplyOwnable2Step</a>
+<a name="10"><span class="lineNum">      10 </span>                :            :  * @notice Ownable2Step variant of RuleMaxTotalSupply.</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  */</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : contract RuleMaxTotalSupplyOwnable2Step is RuleMaxTotalSupplyBase, Ownable2Step {</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :     constructor(address owner, address tokenContract_, uint256 maxTotalSupply_)</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :         RuleMaxTotalSupplyBase(tokenContract_, maxTotalSupply_)</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :         Ownable(owner)</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     {}</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : </a>
+<a name="18"><span class="lineNum">      18 </span>                :<span class="lineCov">          4 :     function _authorizeMaxTotalSupplyManager() internal view virtual override onlyOwner {}</span></a>
+<a name="19"><span class="lineNum">      19 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func-sort-c.html
new file mode 100644
index 0000000..1594a91
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func-sort-c.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsList.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsList.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleSanctionsList.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#49">RuleSanctionsList._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#39">RuleSanctionsList._authorizeSanctionListManager</a></td>
+              <td class="coverFnHi">17</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#45">RuleSanctionsList._msgSender</a></td>
+              <td class="coverFnHi">57</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#53">RuleSanctionsList._contextSuffixLength</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#24">RuleSanctionsList.supportsInterface</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func.html b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func.html
new file mode 100644
index 0000000..dcf5ed0
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.func.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsList.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsList.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleSanctionsList.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#39">RuleSanctionsList._authorizeSanctionListManager</a></td>
+              <td class="coverFnHi">17</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#53">RuleSanctionsList._contextSuffixLength</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#49">RuleSanctionsList._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#45">RuleSanctionsList._msgSender</a></td>
+              <td class="coverFnHi">57</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#24">RuleSanctionsList.supportsInterface</a></td>
+              <td class="coverFnHi">58</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsList.sol.gcov.html b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.gcov.html
new file mode 100644
index 0000000..5b789dd
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsList.sol.gcov.html
@@ -0,0 +1,143 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsList.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (source / <a href="RuleSanctionsList.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntry">10</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context} from &quot;../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleSanctionsListBase} from &quot;../abstract/base/RuleSanctionsListBase.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleTransferValidation} from &quot;../abstract/core/RuleTransferValidation.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {ISanctionsList} from &quot;../../interfaces/ISanctionsList.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : </a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /**</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @title RuleSanctionsList</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @notice Compliance rule enforcing sanctions-screening for token transfers.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  */</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : contract RuleSanctionsList is AccessControlModuleStandalone, RuleSanctionsListBase {</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     /**</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :      */</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :     constructor(address admin, address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :         RuleSanctionsListBase(forwarderIrrevocable, sanctionContractOracle_)</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     {}</a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">         58 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :            :         public</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :         view</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         virtual</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         override(AccessControlEnumerable, RuleTransferValidation)</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :         returns (bool)</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     {</a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">         58 :         return AccessControlEnumerable.supportsInterface(interfaceId)</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         39 :             || RuleTransferValidation.supportsInterface(interfaceId);</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     }</a>
+<a name="36"><span class="lineNum">      36 </span>                :            : </a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :                             ACCESS CONTROL</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="40"><span class="lineNum">      40 </span>                :            : </a>
+<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">         17 :     function _authorizeSanctionListManager() internal view virtual override onlyRole(SANCTIONLIST_ROLE) {}</span></a>
+<a name="42"><span class="lineNum">      42 </span>                :            : </a>
+<a name="43"><span class="lineNum">      43 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :                            ERC-2771</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="46"><span class="lineNum">      46 </span>                :            : </a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">         57 :     function _msgSender() internal view virtual override(ERC2771Context, Context) returns (address sender) {</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">         57 :         return ERC2771Context._msgSender();</span></a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     }</a>
+<a name="50"><span class="lineNum">      50 </span>                :            : </a>
+<a name="51"><span class="lineNum">      51 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">          1 :         return ERC2771Context._msgData();</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :            :     }</a>
+<a name="54"><span class="lineNum">      54 </span>                :            : </a>
+<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">         58 :     function _contextSuffixLength() internal view virtual override(ERC2771Context, Context) returns (uint256) {</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :<span class="lineCov">         58 :         return ERC2771Context._contextSuffixLength();</span></a>
+<a name="57"><span class="lineNum">      57 </span>                :            :     }</a>
+<a name="58"><span class="lineNum">      58 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..d9f05d7
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,97 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsListOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsListOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsListOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleSanctionsListOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#25">RuleSanctionsListOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#19">RuleSanctionsListOwnable2Step._authorizeSanctionListManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#21">RuleSanctionsListOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">11</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#29">RuleSanctionsListOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func.html
new file mode 100644
index 0000000..62bd796
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.func.html
@@ -0,0 +1,97 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsListOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsListOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsListOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleSanctionsListOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#19">RuleSanctionsListOwnable2Step._authorizeSanctionListManager</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#29">RuleSanctionsListOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#25">RuleSanctionsListOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html#21">RuleSanctionsListOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">11</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..9cba0d5
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleSanctionsListOwnable2Step.sol.gcov.html
@@ -0,0 +1,119 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleSanctionsListOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleSanctionsListOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleSanctionsListOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context} from &quot;../../../modules/MetaTxModuleStandalone.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleSanctionsListBase} from &quot;../abstract/base/RuleSanctionsListBase.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {ISanctionsList} from &quot;../../interfaces/ISanctionsList.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : </a>
+<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @title RuleSanctionsListOwnable2Step</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Ownable2Step variant of RuleSanctionsList.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  */</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : contract RuleSanctionsListOwnable2Step is RuleSanctionsListBase, Ownable2Step {</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     constructor(address owner, address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :         RuleSanctionsListBase(forwarderIrrevocable, sanctionContractOracle_)</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :         Ownable(owner)</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     {}</a>
+<a name="20"><span class="lineNum">      20 </span>                :            : </a>
+<a name="21"><span class="lineNum">      21 </span>                :<span class="lineCov">          3 :     function _authorizeSanctionListManager() internal view virtual override onlyOwner {}</span></a>
+<a name="22"><span class="lineNum">      22 </span>                :            : </a>
+<a name="23"><span class="lineNum">      23 </span>                :<span class="lineCov">         11 :     function _msgSender() internal view virtual override(ERC2771Context, Context) returns (address sender) {</span></a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">         11 :         return ERC2771Context._msgSender();</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     }</a>
+<a name="26"><span class="lineNum">      26 </span>                :            : </a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">          1 :         return ERC2771Context._msgData();</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     }</a>
+<a name="30"><span class="lineNum">      30 </span>                :            : </a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">         13 :     function _contextSuffixLength() internal view virtual override(ERC2771Context, Context) returns (uint256) {</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">         13 :         return ERC2771Context._contextSuffixLength();</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     }</a>
+<a name="34"><span class="lineNum">      34 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleWhitelist.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleWhitelist.sol.func-sort-c.html
similarity index 73%
rename from doc/coverage/coverage/validation/RuleWhitelist.sol.func-sort-c.html
rename to doc/coverage/coverage/deployment/RuleWhitelist.sol.func-sort-c.html
index f9af8e7..86d6201 100644
--- a/doc/coverage/coverage/validation/RuleWhitelist.sol.func-sort-c.html
+++ b/doc/coverage/coverage/deployment/RuleWhitelist.sol.func-sort-c.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelist.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleWhitelist.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (<a href="RuleWhitelist.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (<a href="RuleWhitelist.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntry">20</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">5</td>
             <td class="headerCovTableEntry">7</td>
-            <td class="headerCovTableEntryLo">71.4 %</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,32 +69,32 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#131">RuleWhitelist.isVerified</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#54">RuleWhitelist._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#141">RuleWhitelist.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#64">RuleWhitelist._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#116">RuleWhitelist.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">2</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#40">RuleWhitelist.supportsInterface</a></td>
+              <td class="coverFnHi">40</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#73">RuleWhitelist.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">7</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#58">RuleWhitelist._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">263</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#100">RuleWhitelist.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#56">RuleWhitelist._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">348</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#54">RuleWhitelist.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">20</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#60">RuleWhitelist._msgSender</a></td>
+              <td class="coverFnHi">772</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#31">RuleWhitelist.constructor</a></td>
-              <td class="coverFnHi">102</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#68">RuleWhitelist._contextSuffixLength</a></td>
+              <td class="coverFnHi">773</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/RuleWhitelist.sol.func.html b/doc/coverage/coverage/deployment/RuleWhitelist.sol.func.html
similarity index 73%
rename from doc/coverage/coverage/validation/RuleWhitelist.sol.func.html
rename to doc/coverage/coverage/deployment/RuleWhitelist.sol.func.html
index e3f8fe0..b216e14 100644
--- a/doc/coverage/coverage/validation/RuleWhitelist.sol.func.html
+++ b/doc/coverage/coverage/deployment/RuleWhitelist.sol.func.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelist.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleWhitelist.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (<a href="RuleWhitelist.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (<a href="RuleWhitelist.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntry">20</td>
-            <td class="headerCovTableEntryMed">80.0 %</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">5</td>
             <td class="headerCovTableEntry">7</td>
-            <td class="headerCovTableEntryLo">71.4 %</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntry">5</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,32 +69,32 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelist.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#31">RuleWhitelist.constructor</a></td>
-              <td class="coverFnHi">102</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#56">RuleWhitelist._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">348</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#54">RuleWhitelist.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">20</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#58">RuleWhitelist._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">263</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#73">RuleWhitelist.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">7</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#54">RuleWhitelist._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#100">RuleWhitelist.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#68">RuleWhitelist._contextSuffixLength</a></td>
+              <td class="coverFnHi">773</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#116">RuleWhitelist.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">2</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#64">RuleWhitelist._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#131">RuleWhitelist.isVerified</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#60">RuleWhitelist._msgSender</a></td>
+              <td class="coverFnHi">772</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#141">RuleWhitelist.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelist.sol.gcov.html#40">RuleWhitelist.supportsInterface</a></td>
+              <td class="coverFnHi">40</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelist.sol.gcov.html b/doc/coverage/coverage/deployment/RuleWhitelist.sol.gcov.html
new file mode 100644
index 0000000..ca176dc
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelist.sol.gcov.html
@@ -0,0 +1,158 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelist.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelist.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelist.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleWhitelistBase} from &quot;../abstract/base/RuleWhitelistBase.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleAddressSet} from &quot;../abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /* ==== CMTAT === */</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : </a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /**</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @title Rule Whitelist</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @notice Manages a whitelist of authorized addresses and enforces whitelist-based transfer restrictions.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  * @dev</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  * - Inherits core address management logic from {RuleAddressSet}.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  * - Integrates restriction code logic from {RuleWhitelistShared}.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  * - Implements {IERC1404} to return specific restriction codes for non-whitelisted transfers.</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :  */</a>
+<a name="20"><span class="lineNum">      20 </span>                :            : contract RuleWhitelist is RuleWhitelistBase, AccessControlModuleStandalone {</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :                               CONSTRUCTOR</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     /**</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :      */</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :     constructor(address admin, address forwarderIrrevocable, bool checkSpender_)</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         RuleWhitelistBase(forwarderIrrevocable, checkSpender_)</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :     {</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :         // no-op</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     }</a>
+<a name="34"><span class="lineNum">      34 </span>                :            : </a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     /* ============  View Functions ============ */</a>
+<a name="36"><span class="lineNum">      36 </span>                :            : </a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     /**</a>
+<a name="38"><span class="lineNum">      38 </span>                :            :      * @notice Indicates whether this contract supports a given interface.</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :      * @param interfaceId The interface identifier, as specified in ERC-165.</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :      * @return supported True if the interface is supported.</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :      */</a>
+<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">         40 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         public</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :         view</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :         virtual</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :         override(AccessControlEnumerable, RuleWhitelistBase)</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         returns (bool)</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :     {</a>
+<a name="49"><span class="lineNum">      49 </span>                :<span class="lineCov">         40 :         return AccessControlEnumerable.supportsInterface(interfaceId) || RuleWhitelistBase.supportsInterface(interfaceId);</span></a>
+<a name="50"><span class="lineNum">      50 </span>                :            :     }</a>
+<a name="51"><span class="lineNum">      51 </span>                :            : </a>
+<a name="52"><span class="lineNum">      52 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :                             ACCESS CONTROL</a>
+<a name="54"><span class="lineNum">      54 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="55"><span class="lineNum">      55 </span>                :            : </a>
+<a name="56"><span class="lineNum">      56 </span>                :<span class="lineCov">          1 :     function _authorizeCheckSpenderManager() internal view virtual override onlyRole(DEFAULT_ADMIN_ROLE) {}</span></a>
+<a name="57"><span class="lineNum">      57 </span>                :            : </a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">        348 :     function _authorizeAddressListAdd() internal view virtual override onlyRole(ADDRESS_LIST_ADD_ROLE) {}</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :            : </a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">        263 :     function _authorizeAddressListRemove() internal view virtual override onlyRole(ADDRESS_LIST_REMOVE_ROLE) {}</span></a>
+<a name="61"><span class="lineNum">      61 </span>                :            : </a>
+<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">        772 :     function _msgSender() internal view virtual override(Context, RuleAddressSet) returns (address sender) {</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">        772 :         return super._msgSender();</span></a>
+<a name="64"><span class="lineNum">      64 </span>                :            :     }</a>
+<a name="65"><span class="lineNum">      65 </span>                :            : </a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleAddressSet) returns (bytes calldata) {</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :            :     }</a>
+<a name="69"><span class="lineNum">      69 </span>                :            : </a>
+<a name="70"><span class="lineNum">      70 </span>                :<span class="lineCov">        773 :     function _contextSuffixLength() internal view virtual override(Context, RuleAddressSet) returns (uint256) {</span></a>
+<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">        773 :         return super._contextSuffixLength();</span></a>
+<a name="72"><span class="lineNum">      72 </span>                :            :     }</a>
+<a name="73"><span class="lineNum">      73 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..1d0cde2
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,105 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#28">RuleWhitelistOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#18">RuleWhitelistOwnable2Step._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#20">RuleWhitelistOwnable2Step._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#22">RuleWhitelistOwnable2Step._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#24">RuleWhitelistOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#32">RuleWhitelistOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func.html
new file mode 100644
index 0000000..aaac14d
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.func.html
@@ -0,0 +1,105 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#18">RuleWhitelistOwnable2Step._authorizeAddressListAdd</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#20">RuleWhitelistOwnable2Step._authorizeAddressListRemove</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#22">RuleWhitelistOwnable2Step._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#32">RuleWhitelistOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">16</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#28">RuleWhitelistOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistOwnable2Step.sol.gcov.html#24">RuleWhitelistOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">15</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..e0f2605
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistOwnable2Step.sol.gcov.html
@@ -0,0 +1,122 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleWhitelistBase} from &quot;../abstract/base/RuleWhitelistBase.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {RuleAddressSet} from &quot;../abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : </a>
+<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :  * @title RuleWhitelistOwnable2Step</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @notice Ownable2Step variant of RuleWhitelist with owner-based authorization hooks.</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  */</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : contract RuleWhitelistOwnable2Step is RuleWhitelistBase, Ownable2Step {</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :     constructor(address owner, address forwarderIrrevocable, bool checkSpender_)</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :         RuleWhitelistBase(forwarderIrrevocable, checkSpender_)</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :         Ownable(owner)</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     {}</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : </a>
+<a name="20"><span class="lineNum">      20 </span>                :<span class="lineCov">          2 :     function _authorizeAddressListAdd() internal view virtual override onlyOwner {}</span></a>
+<a name="21"><span class="lineNum">      21 </span>                :            : </a>
+<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">          2 :     function _authorizeAddressListRemove() internal view virtual override onlyOwner {}</span></a>
+<a name="23"><span class="lineNum">      23 </span>                :            : </a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">          2 :     function _authorizeCheckSpenderManager() internal view virtual override onlyOwner {}</span></a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">         15 :     function _msgSender() internal view virtual override(Context, RuleAddressSet) returns (address sender) {</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">         15 :         return super._msgSender();</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :            :     }</a>
+<a name="29"><span class="lineNum">      29 </span>                :            : </a>
+<a name="30"><span class="lineNum">      30 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(Context, RuleAddressSet) returns (bytes calldata) {</span></a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">          1 :         return super._msgData();</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     }</a>
+<a name="33"><span class="lineNum">      33 </span>                :            : </a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         16 :     function _contextSuffixLength() internal view virtual override(Context, RuleAddressSet) returns (uint256) {</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">         16 :         return super._contextSuffixLength();</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     }</a>
+<a name="37"><span class="lineNum">      37 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func-sort-c.html
similarity index 64%
rename from doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func-sort-c.html
rename to doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func-sort-c.html
index 19a2bf6..b118fa8 100644
--- a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func-sort-c.html
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func-sort-c.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelistWrapper.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapper.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapper.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapper.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">57</td>
-            <td class="headerCovTableEntryMed">87.7 %</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntryMed">78.6 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,48 +69,40 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#188">RuleWhitelistWrapper._msgData</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#60">RuleWhitelistWrapper._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#170">RuleWhitelistWrapper.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#88">RuleWhitelistWrapper._revokeRole</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#114">RuleWhitelistWrapper.detectTransferRestrictionFrom.1</a></td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#45">RuleWhitelistWrapper._authorizeCheckSpenderManager</a></td>
               <td class="coverFnHi">2</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#72">RuleWhitelistWrapper.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#82">RuleWhitelistWrapper.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">10</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#129">RuleWhitelistWrapper.hasRole</a></td>
-              <td class="coverFnHi">20</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#79">RuleWhitelistWrapper._grantRole</a></td>
+              <td class="coverFnHi">38</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#51">RuleWhitelistWrapper.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">21</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#35">RuleWhitelistWrapper.hasRole</a></td>
+              <td class="coverFnHi">38</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#36">RuleWhitelistWrapper.constructor</a></td>
-              <td class="coverFnHi">22</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#68">RuleWhitelistWrapper.supportsInterface</a></td>
+              <td class="coverFnHi">46</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#143">RuleWhitelistWrapper._detectTransferRestriction</a></td>
-              <td class="coverFnHi">37</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#50">RuleWhitelistWrapper._onlyRulesManager</a></td>
+              <td class="coverFnHi">90</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#195">RuleWhitelistWrapper._contextSuffixLength</a></td>
-              <td class="coverFnHi">80</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#56">RuleWhitelistWrapper._msgSender</a></td>
+              <td class="coverFnHi">133</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#181">RuleWhitelistWrapper._msgSender</a></td>
-              <td class="coverFnHi">80</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#64">RuleWhitelistWrapper._contextSuffixLength</a></td>
+              <td class="coverFnHi">134</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func.html
similarity index 64%
rename from doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func.html
rename to doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func.html
index 4994cad..c7034ec 100644
--- a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.func.html
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.func.html
@@ -4,7 +4,7 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelistWrapper.sol - functions</title>
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapper.sol - functions</title>
   <link rel="stylesheet" type="text/css" href="../gcov.css">
 </head>
 
@@ -19,7 +19,7 @@
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapper.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapper.sol.gcov.html">source</a> / functions)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">57</td>
-            <td class="headerCovTableEntryMed">87.7 %</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntryMed">78.6 %</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
           </tr>
           <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -69,48 +69,40 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistWrapper.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#195">RuleWhitelistWrapper._contextSuffixLength</a></td>
-              <td class="coverFnHi">80</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#143">RuleWhitelistWrapper._detectTransferRestriction</a></td>
-              <td class="coverFnHi">37</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#188">RuleWhitelistWrapper._msgData</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#45">RuleWhitelistWrapper._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">2</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#181">RuleWhitelistWrapper._msgSender</a></td>
-              <td class="coverFnHi">80</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#64">RuleWhitelistWrapper._contextSuffixLength</a></td>
+              <td class="coverFnHi">134</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#36">RuleWhitelistWrapper.constructor</a></td>
-              <td class="coverFnHi">22</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#79">RuleWhitelistWrapper._grantRole</a></td>
+              <td class="coverFnHi">38</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#51">RuleWhitelistWrapper.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">21</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#60">RuleWhitelistWrapper._msgData</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#72">RuleWhitelistWrapper.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">4</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#56">RuleWhitelistWrapper._msgSender</a></td>
+              <td class="coverFnHi">133</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#82">RuleWhitelistWrapper.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">10</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#50">RuleWhitelistWrapper._onlyRulesManager</a></td>
+              <td class="coverFnHi">90</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#114">RuleWhitelistWrapper.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">2</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#88">RuleWhitelistWrapper._revokeRole</a></td>
+              <td class="coverFnHi">1</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#129">RuleWhitelistWrapper.hasRole</a></td>
-              <td class="coverFnHi">20</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#35">RuleWhitelistWrapper.hasRole</a></td>
+              <td class="coverFnHi">38</td>
             </tr>
     <tr>
-              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#170">RuleWhitelistWrapper.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
+              <td class="coverFn"><a href="RuleWhitelistWrapper.sol.gcov.html#68">RuleWhitelistWrapper.supportsInterface</a></td>
+              <td class="coverFnHi">46</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.gcov.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.gcov.html
new file mode 100644
index 0000000..fee07c5
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapper.sol.gcov.html
@@ -0,0 +1,183 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapper.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistWrapper.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntry">17</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : </a>
+<a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="4"><span class="lineNum">       4 </span>                :            : </a>
+<a name="5"><span class="lineNum">       5 </span>                :            : /* ==== OpenZeppelin === */</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {RuleWhitelistWrapperBase} from &quot;../abstract/base/RuleWhitelistWrapperBase.sol&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : </a>
+<a name="13"><span class="lineNum">      13 </span>                :            : /**</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @title Wrapper to call several different whitelist rules</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  */</a>
+<a name="16"><span class="lineNum">      16 </span>                :            : contract RuleWhitelistWrapper is</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     RuleWhitelistWrapperBase,</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     AccessControlModuleStandalone</a>
+<a name="19"><span class="lineNum">      19 </span>                :            : {</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :                               CONSTRUCTOR</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     /**</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :      */</a>
+<a name="27"><span class="lineNum">      27 </span>                :            :     constructor(address admin, address forwarderIrrevocable, bool checkSpender_)</a>
+<a name="28"><span class="lineNum">      28 </span>                :            :         RuleWhitelistWrapperBase(forwarderIrrevocable, checkSpender_)</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         AccessControlModuleStandalone(admin)</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     {}</a>
+<a name="31"><span class="lineNum">      31 </span>                :            : </a>
+<a name="32"><span class="lineNum">      32 </span>                :            :     /* ============  Access control ============ */</a>
+<a name="33"><span class="lineNum">      33 </span>                :            : </a>
+<a name="34"><span class="lineNum">      34 </span>                :            :     /**</a>
+<a name="35"><span class="lineNum">      35 </span>                :            :      * @dev Returns `true` if `account` has been granted `role`.</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :      */</a>
+<a name="37"><span class="lineNum">      37 </span>                :<span class="lineCov">         38 :     function hasRole(bytes32 role, address account)</span></a>
+<a name="38"><span class="lineNum">      38 </span>                :            :         public</a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         view</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         virtual</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :         override(AccessControl, AccessControlModuleStandalone)</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :         returns (bool)</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :     {</a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">        134 :         return AccessControlModuleStandalone.hasRole(role, account);</span></a>
+<a name="45"><span class="lineNum">      45 </span>                :            :     }</a>
+<a name="46"><span class="lineNum">      46 </span>                :            : </a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">          2 :     function _authorizeCheckSpenderManager() internal virtual override onlyRole(DEFAULT_ADMIN_ROLE) {}</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :            : </a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     /**</a>
+<a name="50"><span class="lineNum">      50 </span>                :            :      * @dev Restrict rules management to the dedicated role.</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :      */</a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">         90 :     function _onlyRulesManager() internal virtual override onlyRole(RULES_MANAGEMENT_ROLE) {}</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :            : </a>
+<a name="54"><span class="lineNum">      54 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="55"><span class="lineNum">      55 </span>                :            :                            ERC-2771</a>
+<a name="56"><span class="lineNum">      56 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="57"><span class="lineNum">      57 </span>                :            : </a>
+<a name="58"><span class="lineNum">      58 </span>                :<span class="lineCov">        133 :     function _msgSender() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (address sender) {</span></a>
+<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">        133 :         return RuleWhitelistWrapperBase._msgSender();</span></a>
+<a name="60"><span class="lineNum">      60 </span>                :            :     }</a>
+<a name="61"><span class="lineNum">      61 </span>                :            : </a>
+<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (bytes calldata) {</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :<span class="lineCov">          1 :         return RuleWhitelistWrapperBase._msgData();</span></a>
+<a name="64"><span class="lineNum">      64 </span>                :            :     }</a>
+<a name="65"><span class="lineNum">      65 </span>                :            : </a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">        134 :     function _contextSuffixLength() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (uint256) {</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">        134 :         return RuleWhitelistWrapperBase._contextSuffixLength();</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :            :     }</a>
+<a name="69"><span class="lineNum">      69 </span>                :            : </a>
+<a name="70"><span class="lineNum">      70 </span>                :<span class="lineCov">         46 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="71"><span class="lineNum">      71 </span>                :            :         public</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         view</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :         virtual</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :         override(AccessControlEnumerable, RuleWhitelistWrapperBase)</a>
+<a name="75"><span class="lineNum">      75 </span>                :            :         returns (bool)</a>
+<a name="76"><span class="lineNum">      76 </span>                :            :     {</a>
+<a name="77"><span class="lineNum">      77 </span>                :<span class="lineCov">         46 :         return RuleWhitelistWrapperBase.supportsInterface(interfaceId)</span></a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">         16 :             || AccessControlEnumerable.supportsInterface(interfaceId);</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :     }</a>
+<a name="80"><span class="lineNum">      80 </span>                :            : </a>
+<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">         38 :     function _grantRole(bytes32 role, address account)</span></a>
+<a name="82"><span class="lineNum">      82 </span>                :            :         internal</a>
+<a name="83"><span class="lineNum">      83 </span>                :            :         virtual</a>
+<a name="84"><span class="lineNum">      84 </span>                :            :         override(AccessControl, AccessControlEnumerable)</a>
+<a name="85"><span class="lineNum">      85 </span>                :            :         returns (bool)</a>
+<a name="86"><span class="lineNum">      86 </span>                :            :     {</a>
+<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">         38 :         return AccessControlEnumerable._grantRole(role, account);</span></a>
+<a name="88"><span class="lineNum">      88 </span>                :            :     }</a>
+<a name="89"><span class="lineNum">      89 </span>                :            : </a>
+<a name="90"><span class="lineNum">      90 </span>                :<span class="lineCov">          1 :     function _revokeRole(bytes32 role, address account)</span></a>
+<a name="91"><span class="lineNum">      91 </span>                :            :         internal</a>
+<a name="92"><span class="lineNum">      92 </span>                :            :         virtual</a>
+<a name="93"><span class="lineNum">      93 </span>                :            :         override(AccessControl, AccessControlEnumerable)</a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         returns (bool)</a>
+<a name="95"><span class="lineNum">      95 </span>                :            :     {</a>
+<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">          1 :         return AccessControlEnumerable._revokeRole(role, account);</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :            :     }</a>
+<a name="98"><span class="lineNum">      98 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..b67a8e6
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapperOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapperOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleWhitelistWrapperOwnable2Step.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#41">RuleWhitelistWrapperOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#26">RuleWhitelistWrapperOwnable2Step._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#31">RuleWhitelistWrapperOwnable2Step._onlyRulesManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#37">RuleWhitelistWrapperOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#45">RuleWhitelistWrapperOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func.html
new file mode 100644
index 0000000..b704ccc
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.func.html
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapperOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapperOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#26">RuleWhitelistWrapperOwnable2Step._authorizeCheckSpenderManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#45">RuleWhitelistWrapperOwnable2Step._contextSuffixLength</a></td>
+              <td class="coverFnHi">13</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#41">RuleWhitelistWrapperOwnable2Step._msgData</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#37">RuleWhitelistWrapperOwnable2Step._msgSender</a></td>
+              <td class="coverFnHi">12</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html#31">RuleWhitelistWrapperOwnable2Step._onlyRulesManager</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.gcov.html b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..211abff
--- /dev/null
+++ b/doc/coverage/coverage/deployment/RuleWhitelistWrapperOwnable2Step.sol.gcov.html
@@ -0,0 +1,136 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment/RuleWhitelistWrapperOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">deployment</a> - RuleWhitelistWrapperOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistWrapperOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : </a>
+<a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="4"><span class="lineNum">       4 </span>                :            : </a>
+<a name="5"><span class="lineNum">       5 </span>                :            : /* ==== OpenZeppelin === */</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {Context} from &quot;OZ/utils/Context.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : /* ==== Abstract contracts === */</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleWhitelistWrapperBase} from &quot;../abstract/base/RuleWhitelistWrapperBase.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : </a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /**</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @title Wrapper to call several different whitelist rules (Ownable2Step)</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  */</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : contract RuleWhitelistWrapperOwnable2Step is RuleWhitelistWrapperBase, Ownable2Step {</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :                               CONSTRUCTOR</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     /**</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :      * @param owner Address of the contract owner</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :      */</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     constructor(address owner, address forwarderIrrevocable, bool checkSpender_)</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :         RuleWhitelistWrapperBase(forwarderIrrevocable, checkSpender_)</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :         Ownable(owner)</a>
+<a name="26"><span class="lineNum">      26 </span>                :            :     {}</a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">          2 :     function _authorizeCheckSpenderManager() internal view virtual override onlyOwner {}</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            : </a>
+<a name="30"><span class="lineNum">      30 </span>                :            :     /**</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :      * @dev Restrict rules management to the owner.</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :      */</a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          2 :     function _onlyRulesManager() internal view virtual override onlyOwner {}</span></a>
+<a name="34"><span class="lineNum">      34 </span>                :            : </a>
+<a name="35"><span class="lineNum">      35 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="36"><span class="lineNum">      36 </span>                :            :                            ERC-2771</a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="38"><span class="lineNum">      38 </span>                :            : </a>
+<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">         12 :     function _msgSender() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (address sender) {</span></a>
+<a name="40"><span class="lineNum">      40 </span>                :<span class="lineCov">         12 :         return RuleWhitelistWrapperBase._msgSender();</span></a>
+<a name="41"><span class="lineNum">      41 </span>                :            :     }</a>
+<a name="42"><span class="lineNum">      42 </span>                :            : </a>
+<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">          1 :     function _msgData() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (bytes calldata) {</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :<span class="lineCov">          1 :         return RuleWhitelistWrapperBase._msgData();</span></a>
+<a name="45"><span class="lineNum">      45 </span>                :            :     }</a>
+<a name="46"><span class="lineNum">      46 </span>                :            : </a>
+<a name="47"><span class="lineNum">      47 </span>                :<span class="lineCov">         13 :     function _contextSuffixLength() internal view virtual override(RuleWhitelistWrapperBase, Context) returns (uint256) {</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">         13 :         return RuleWhitelistWrapperBase._contextSuffixLength();</span></a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     }</a>
+<a name="50"><span class="lineNum">      50 </span>                :            : </a>
+<a name="51"><span class="lineNum">      51 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/index-sort-b.html b/doc/coverage/coverage/deployment/index-sort-b.html
new file mode 100644
index 0000000..ebfc836
--- /dev/null
+++ b/doc/coverage/coverage/deployment/index-sort-b.html
@@ -0,0 +1,263 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - deployment</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html">RuleSanctionsListOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupply.sol.gcov.html">RuleMaxTotalSupply.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistOwnable2Step.sol.gcov.html">RuleBlacklistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">RuleMaxTotalSupplyOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">17 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">RuleWhitelistWrapperOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Ownable2Step.sol.gcov.html">RuleERC2980Ownable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980.sol.gcov.html">RuleERC2980.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistry.sol.gcov.html">RuleIdentityRegistry.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistOwnable2Step.sol.gcov.html">RuleWhitelistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">RuleIdentityRegistryOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/index-sort-f.html b/doc/coverage/coverage/deployment/index-sort-f.html
new file mode 100644
index 0000000..a3d26c0
--- /dev/null
+++ b/doc/coverage/coverage/deployment/index-sort-f.html
@@ -0,0 +1,263 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - deployment</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">RuleMaxTotalSupplyOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">RuleIdentityRegistryOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupply.sol.gcov.html">RuleMaxTotalSupply.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistry.sol.gcov.html">RuleIdentityRegistry.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html">RuleSanctionsListOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistOwnable2Step.sol.gcov.html">RuleBlacklistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">RuleWhitelistWrapperOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistOwnable2Step.sol.gcov.html">RuleWhitelistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Ownable2Step.sol.gcov.html">RuleERC2980Ownable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980.sol.gcov.html">RuleERC2980.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">17 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/index-sort-l.html b/doc/coverage/coverage/deployment/index-sort-l.html
new file mode 100644
index 0000000..6ace07a
--- /dev/null
+++ b/doc/coverage/coverage/deployment/index-sort-l.html
@@ -0,0 +1,263 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - deployment</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">RuleMaxTotalSupplyOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">RuleIdentityRegistryOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupply.sol.gcov.html">RuleMaxTotalSupply.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistry.sol.gcov.html">RuleIdentityRegistry.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html">RuleSanctionsListOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistOwnable2Step.sol.gcov.html">RuleBlacklistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">RuleWhitelistWrapperOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistOwnable2Step.sol.gcov.html">RuleWhitelistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Ownable2Step.sol.gcov.html">RuleERC2980Ownable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980.sol.gcov.html">RuleERC2980.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">17 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/deployment/index.html b/doc/coverage/coverage/deployment/index.html
new file mode 100644
index 0000000..e2cc395
--- /dev/null
+++ b/doc/coverage/coverage/deployment/index.html
@@ -0,0 +1,263 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - deployment</title>
+  <link rel="stylesheet" type="text/css" href="../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - deployment</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntry">112</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntry">68</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleBlacklistOwnable2Step.sol.gcov.html">RuleBlacklistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980.sol.gcov.html">RuleERC2980.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleERC2980Ownable2Step.sol.gcov.html">RuleERC2980Ownable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistry.sol.gcov.html">RuleIdentityRegistry.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleIdentityRegistryOwnable2Step.sol.gcov.html">RuleIdentityRegistryOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupply.sol.gcov.html">RuleMaxTotalSupply.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleMaxTotalSupplyOwnable2Step.sol.gcov.html">RuleMaxTotalSupplyOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">10 / 10</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleSanctionsListOwnable2Step.sol.gcov.html">RuleSanctionsListOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistOwnable2Step.sol.gcov.html">RuleWhitelistOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">17 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleWhitelistWrapperOwnable2Step.sol.gcov.html">RuleWhitelistWrapperOwnable2Step.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func-sort-c.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func-sort-c.html
index 5ee975a..6e237b7 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func-sort-c.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func-sort-c.html
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">2</td>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -69,12 +69,12 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../../../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#20">AccessControlModuleStandalone.constructor</a></td>
-              <td class="coverFnHi">161</td>
+              <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#22">AccessControlModuleStandalone.constructor</a></td>
+              <td class="coverFnHi">396</td>
             </tr>
     <tr>
               <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#36">AccessControlModuleStandalone.hasRole</a></td>
-              <td class="coverFnHi">228</td>
+              <td class="coverFnHi">507</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func.html
index 5e3e889..ce374e8 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.func.html
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">2</td>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -69,12 +69,12 @@
       <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="AccessControlModuleStandalone.sol.func-sort-c.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
     </tr>
     <tr>
-              <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#20">AccessControlModuleStandalone.constructor</a></td>
-              <td class="coverFnHi">161</td>
+              <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#22">AccessControlModuleStandalone.constructor</a></td>
+              <td class="coverFnHi">396</td>
             </tr>
     <tr>
               <td class="coverFn"><a href="AccessControlModuleStandalone.sol.gcov.html#36">AccessControlModuleStandalone.hasRole</a></td>
-              <td class="coverFnHi">228</td>
+              <td class="coverFnHi">507</td>
             </tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.gcov.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.gcov.html
index 001fd5e..0ff4430 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.gcov.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/AccessControlModuleStandalone.sol.gcov.html
@@ -31,13 +31,13 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">7</td>
+            <td class="headerCovTableEntry">7</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
             <td class="headerCovTableEntry">2</td>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -75,29 +75,29 @@
 <a name="4"><span class="lineNum">       4 </span>                :            : </a>
 <a name="5"><span class="lineNum">       5 </span>                :            : /* ==== OpenZeppelin === */</a>
 <a name="6"><span class="lineNum">       6 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : </a>
-<a name="8"><span class="lineNum">       8 </span>                :            : abstract contract AccessControlModuleStandalone is AccessControl {</a>
-<a name="9"><span class="lineNum">       9 </span>                :            :     error AccessControlModuleStandalone_AddressZeroNotAllowed();</a>
-<a name="10"><span class="lineNum">      10 </span>                :            :     /* ============ Constructor ============ */</a>
-<a name="11"><span class="lineNum">      11 </span>                :            :     /**</a>
-<a name="12"><span class="lineNum">      12 </span>                :            :      * @notice Assigns the provided address as the default admin.</a>
-<a name="13"><span class="lineNum">      13 </span>                :            :      * @dev</a>
-<a name="14"><span class="lineNum">      14 </span>                :            :      *  - Reverts if `admin` is the zero address.</a>
-<a name="15"><span class="lineNum">      15 </span>                :            :      *  - Grants `DEFAULT_ADMIN_ROLE` to `admin`.</a>
-<a name="16"><span class="lineNum">      16 </span>                :            :      *    The return value of `_grantRole` is intentionally ignored, as it returns `false`</a>
-<a name="17"><span class="lineNum">      17 </span>                :            :      *    only when the role was already granted.</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :      *</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :      * @param admin The address that will receive the `DEFAULT_ADMIN_ROLE`.</a>
-<a name="20"><span class="lineNum">      20 </span>                :            :      */</a>
-<a name="21"><span class="lineNum">      21 </span>                :            : </a>
-<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">        161 :     constructor(address admin) {</span></a>
-<a name="23"><span class="lineNum">      23 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">        161 :         if (admin == address(0)) {</span></a>
-<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">          4 :             revert AccessControlModuleStandalone_AddressZeroNotAllowed();</span></a>
-<a name="25"><span class="lineNum">      25 </span>                :            :         }</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {IAccessControl} from &quot;OZ/access/IAccessControl.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : </a>
+<a name="10"><span class="lineNum">      10 </span>                :            : abstract contract AccessControlModuleStandalone is AccessControlEnumerable {</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :     error AccessControlModuleStandalone_AddressZeroNotAllowed();</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :     /* ============ Constructor ============ */</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :     /**</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :      * @notice Assigns the provided address as the default admin.</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :      * @dev</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :      *  - Reverts if `admin` is the zero address.</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :      *  - Grants `DEFAULT_ADMIN_ROLE` to `admin`.</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :      *    The return value of `_grantRole` is intentionally ignored, as it returns `false`</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :      *    only when the role was already granted.</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :      *</a>
+<a name="21"><span class="lineNum">      21 </span>                :            :      * @param admin The address that will receive the `DEFAULT_ADMIN_ROLE`.</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :      */</a>
+<a name="23"><span class="lineNum">      23 </span>                :            : </a>
+<a name="24"><span class="lineNum">      24 </span>                :<span class="lineCov">        396 :     constructor(address admin) {</span></a>
+<a name="25"><span class="lineNum">      25 </span>        [<span class="branchCov" title="Branch 0 was taken 5 times"> + </span><span class="branchCov" title="Branch 1 was taken 391 times"> + </span>]:<span class="lineCov">        396 :         require(admin != address(0), AccessControlModuleStandalone_AddressZeroNotAllowed());</span></a>
 <a name="26"><span class="lineNum">      26 </span>                :            :         // we don't check the return value</a>
 <a name="27"><span class="lineNum">      27 </span>                :            :         // _grantRole attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.</a>
 <a name="28"><span class="lineNum">      28 </span>                :            :         // return false only if the admin has already the role</a>
-<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">        157 :         _grantRole(DEFAULT_ADMIN_ROLE, admin);</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :<span class="lineCov">        391 :         _grantRole(DEFAULT_ADMIN_ROLE, admin);</span></a>
 <a name="30"><span class="lineNum">      30 </span>                :            :     }</a>
 <a name="31"><span class="lineNum">      31 </span>                :            : </a>
 <a name="32"><span class="lineNum">      32 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
@@ -106,15 +106,22 @@
 <a name="35"><span class="lineNum">      35 </span>                :            :     /**</a>
 <a name="36"><span class="lineNum">      36 </span>                :            :      * @dev Returns `true` if `account` has been granted `role`.</a>
 <a name="37"><span class="lineNum">      37 </span>                :            :      */</a>
-<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">        228 :     function hasRole(bytes32 role, address account) public view virtual override(AccessControl) returns (bool) {</span></a>
-<a name="39"><span class="lineNum">      39 </span>                :            :         // The Default Admin has all roles</a>
-<a name="40"><span class="lineNum">      40 </span>        [<span class="branchCov" title="Branch 0 was taken 152 times"> + </span><span class="branchCov" title="Branch 1 was taken 176 times"> + </span>]:<span class="lineCov">        328 :         if (AccessControl.hasRole(DEFAULT_ADMIN_ROLE, account)) {</span></a>
-<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">        152 :             return true;</span></a>
-<a name="42"><span class="lineNum">      42 </span>                :            :         } else {</a>
-<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">        176 :             return AccessControl.hasRole(role, account);</span></a>
-<a name="44"><span class="lineNum">      44 </span>                :            :         }</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :     }</a>
-<a name="46"><span class="lineNum">      46 </span>                :            : }</a>
+<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">        507 :     function hasRole(bytes32 role, address account)</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :            :         public</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :         view</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :         virtual</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :         override(AccessControl, IAccessControl)</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :         returns (bool)</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     {</a>
+<a name="45"><span class="lineNum">      45 </span>                :            :         // Dev note: default admin is treated as having all roles but may not appear in enumerable role members.</a>
+<a name="46"><span class="lineNum">      46 </span>                :            :         // The Default Admin has all roles</a>
+<a name="47"><span class="lineNum">      47 </span>        [<span class="branchCov" title="Branch 0 was taken 3110 times"> + </span><span class="branchCov" title="Branch 1 was taken 487 times"> + </span>]:<span class="lineCov">       3597 :         if (AccessControl.hasRole(DEFAULT_ADMIN_ROLE, account)) {</span></a>
+<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">       3110 :             return true;</span></a>
+<a name="49"><span class="lineNum">      49 </span>                :            :         } else {</a>
+<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">        487 :             return AccessControl.hasRole(role, account);</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :            :         }</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :     }</a>
+<a name="53"><span class="lineNum">      53 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func-sort-c.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func-sort-c.html
new file mode 100644
index 0000000..9a3a841
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func-sort-c.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/modules</a> - VersionModule.sol<span style="font-size: 80%;"> (<a href="VersionModule.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="VersionModule.sol.func.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../../../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="VersionModule.sol.gcov.html#12">VersionModule.version</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func.html
new file mode 100644
index 0000000..ba069d3
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.func.html
@@ -0,0 +1,85 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/modules</a> - VersionModule.sol<span style="font-size: 80%;"> (<a href="VersionModule.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../../../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="VersionModule.sol.func-sort-c.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="VersionModule.sol.gcov.html#12">VersionModule.version</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.gcov.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.gcov.html
new file mode 100644
index 0000000..21cb955
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol.gcov.html
@@ -0,0 +1,102 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/modules/VersionModule.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/modules</a> - VersionModule.sol<span style="font-size: 80%;"> (source / <a href="VersionModule.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntry">1</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {IERC3643Version} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : </a>
+<a name="6"><span class="lineNum">       6 </span>                :            : /**</a>
+<a name="7"><span class="lineNum">       7 </span>                :            :  * @title VersionModule</a>
+<a name="8"><span class="lineNum">       8 </span>                :            :  * @notice Exposes the contract version as required by ERC-3643.</a>
+<a name="9"><span class="lineNum">       9 </span>                :            :  */</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : abstract contract VersionModule is IERC3643Version {</a>
+<a name="11"><span class="lineNum">      11 </span>                :            :     string private constant VERSION = &quot;0.2.0&quot;;</a>
+<a name="12"><span class="lineNum">      12 </span>                :            : </a>
+<a name="13"><span class="lineNum">      13 </span>                :            :     /// @inheritdoc IERC3643Version</a>
+<a name="14"><span class="lineNum">      14 </span>                :<span class="lineCov">          7 :     function version() public view virtual override returns (string memory version_) {</span></a>
+<a name="15"><span class="lineNum">      15 </span>                :<span class="lineCov">          7 :         return VERSION;</span></a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     }</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-b.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-b.html
index 6514966..1c2b511 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-b.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-b.html
@@ -31,17 +31,17 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -81,17 +81,29 @@
       <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../../../../../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
     </tr>
+    <tr>
+      <td class="coverFile"><a href="VersionModule.sol.gcov.html">VersionModule.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
     <tr>
       <td class="coverFile"><a href="AccessControlModuleStandalone.sol.gcov.html">AccessControlModuleStandalone.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">8 / 8</td>
+      <td class="coverNumHi">7 / 7</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-f.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-f.html
index d593422..250be9c 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-f.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-f.html
@@ -31,17 +31,17 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -81,17 +81,29 @@
       <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../../../../../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
+    <tr>
+      <td class="coverFile"><a href="VersionModule.sol.gcov.html">VersionModule.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
     <tr>
       <td class="coverFile"><a href="AccessControlModuleStandalone.sol.gcov.html">AccessControlModuleStandalone.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">8 / 8</td>
+      <td class="coverNumHi">7 / 7</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-l.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-l.html
index 42bb733..38d71c7 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-l.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index-sort-l.html
@@ -31,17 +31,17 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -81,17 +81,29 @@
       <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
+    <tr>
+      <td class="coverFile"><a href="VersionModule.sol.gcov.html">VersionModule.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
     <tr>
       <td class="coverFile"><a href="AccessControlModuleStandalone.sol.gcov.html">AccessControlModuleStandalone.sol</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">8 / 8</td>
+      <td class="coverNumHi">7 / 7</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index.html
index 7bed3a1..e1ab118 100644
--- a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/modules/index.html
@@ -31,17 +31,17 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">8</td>
-            <td class="headerCovTableEntry">8</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">2</td>
-            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
@@ -49,8 +49,8 @@
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">3</td>
-            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">4</td>
+            <td class="headerCovTableEntry">4</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
@@ -87,11 +87,23 @@
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">8 / 8</td>
+      <td class="coverNumHi">7 / 7</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="VersionModule.sol.gcov.html">VersionModule.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">1 / 1</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func-sort-c.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func-sort-c.html
new file mode 100644
index 0000000..79562b0
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func-sort-c.html
@@ -0,0 +1,105 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLight.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLight.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleConditionalTransferLight.sol.func.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#36">RuleConditionalTransferLight.created</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#40">RuleConditionalTransferLight.destroyed</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#25">RuleConditionalTransferLight.supportsInterface</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#53">RuleConditionalTransferLight._onlyComplianceManager</a></td>
+              <td class="coverFnHi">19</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#46">RuleConditionalTransferLight._authorizeTransferExecution</a></td>
+              <td class="coverFnHi">857</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#44">RuleConditionalTransferLight._authorizeTransferApproval</a></td>
+              <td class="coverFnHi">1947</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func.html
new file mode 100644
index 0000000..a785d77
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.func.html
@@ -0,0 +1,105 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLight.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLight.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleConditionalTransferLight.sol.func-sort-c.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#44">RuleConditionalTransferLight._authorizeTransferApproval</a></td>
+              <td class="coverFnHi">1947</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#46">RuleConditionalTransferLight._authorizeTransferExecution</a></td>
+              <td class="coverFnHi">857</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#53">RuleConditionalTransferLight._onlyComplianceManager</a></td>
+              <td class="coverFnHi">19</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#36">RuleConditionalTransferLight.created</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#40">RuleConditionalTransferLight.destroyed</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLight.sol.gcov.html#25">RuleConditionalTransferLight.supportsInterface</a></td>
+              <td class="coverFnHi">18</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.gcov.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.gcov.html
new file mode 100644
index 0000000..c7dd5c5
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol.gcov.html
@@ -0,0 +1,141 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLight.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLight.sol<span style="font-size: 80%;"> (source / <a href="RuleConditionalTransferLight.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntry">11</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntry">6</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntry">2</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {AccessControlEnumerable} from &quot;OZ/access/extensions/AccessControlEnumerable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {IERC165} from &quot;OZ/utils/introspection/IERC165.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleInterfaceId} from &quot;RuleEngine/modules/library/RuleInterfaceId.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../modules/AccessControlModuleStandalone.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {ERC3643ComplianceModule} from &quot;RuleEngine/modules/ERC3643ComplianceModule.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleConditionalTransferLightBase} from &quot;./abstract/RuleConditionalTransferLightBase.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : </a>
+<a name="12"><span class="lineNum">      12 </span>                :            : /**</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @title ConditionalTransferLight</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  * @dev Requires operator approval for each transfer. Same transfer (from, to, value)</a>
+<a name="15"><span class="lineNum">      15 </span>                :            :  *      can be approved multiple times to allow repeated transfers.</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :  */</a>
+<a name="17"><span class="lineNum">      17 </span>                :            : contract RuleConditionalTransferLight is</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :     AccessControlModuleStandalone,</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     ERC3643ComplianceModule,</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :     RuleConditionalTransferLightBase</a>
+<a name="21"><span class="lineNum">      21 </span>                :            : {</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     /**</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :      * @param admin Address of the contract admin.</a>
+<a name="24"><span class="lineNum">      24 </span>                :            :      */</a>
+<a name="25"><span class="lineNum">      25 </span>                :            :     constructor(address admin) AccessControlModuleStandalone(admin) {}</a>
+<a name="26"><span class="lineNum">      26 </span>                :            : </a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">         18 :     function supportsInterface(bytes4 interfaceId)</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :            :         public</a>
+<a name="29"><span class="lineNum">      29 </span>                :            :         view</a>
+<a name="30"><span class="lineNum">      30 </span>                :            :         virtual</a>
+<a name="31"><span class="lineNum">      31 </span>                :            :         override(AccessControlEnumerable, IERC165)</a>
+<a name="32"><span class="lineNum">      32 </span>                :            :         returns (bool)</a>
+<a name="33"><span class="lineNum">      33 </span>                :            :     {</a>
+<a name="34"><span class="lineNum">      34 </span>                :<span class="lineCov">         18 :         return interfaceId == RuleInterfaceId.IRULE_INTERFACE_ID || interfaceId == type(IRule).interfaceId</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">         11 :             || AccessControlEnumerable.supportsInterface(interfaceId);</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :            :     }</a>
+<a name="37"><span class="lineNum">      37 </span>                :            : </a>
+<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">          1 :     function created(address to, uint256 value) external onlyBoundToken {</span></a>
+<a name="39"><span class="lineNum">      39 </span>                :<span class="lineCov">          1 :         _transferred(address(0), to, value);</span></a>
+<a name="40"><span class="lineNum">      40 </span>                :            :     }</a>
+<a name="41"><span class="lineNum">      41 </span>                :            : </a>
+<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">          1 :     function destroyed(address from, uint256 value) external onlyBoundToken {</span></a>
+<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">          1 :         _transferred(from, address(0), value);</span></a>
+<a name="44"><span class="lineNum">      44 </span>                :            :     }</a>
+<a name="45"><span class="lineNum">      45 </span>                :            : </a>
+<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">       1947 :     function _authorizeTransferApproval() internal view virtual override onlyRole(OPERATOR_ROLE) {}</span></a>
+<a name="47"><span class="lineNum">      47 </span>                :            : </a>
+<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">        857 :     function _authorizeTransferExecution() internal view virtual override {</span></a>
+<a name="49"><span class="lineNum">      49 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 856 times"> + </span>]:<span class="lineCov">        857 :         require(</span></a>
+<a name="50"><span class="lineNum">      50 </span>                :            :             isTokenBound(_msgSender()),</a>
+<a name="51"><span class="lineNum">      51 </span>                :            :             RuleConditionalTransferLight_TransferExecutorUnauthorized(_msgSender())</a>
+<a name="52"><span class="lineNum">      52 </span>                :            :         );</a>
+<a name="53"><span class="lineNum">      53 </span>                :            :     }</a>
+<a name="54"><span class="lineNum">      54 </span>                :            : </a>
+<a name="55"><span class="lineNum">      55 </span>                :<span class="lineCov">         19 :     function _onlyComplianceManager() internal virtual override onlyRole(COMPLIANCE_MANAGER_ROLE) {}</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html
new file mode 100644
index 0000000..b181ee1
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html
@@ -0,0 +1,93 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLightOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleConditionalTransferLightOwnable2Step.sol.func.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#26">RuleConditionalTransferLightOwnable2Step._authorizeTransferExecution</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#24">RuleConditionalTransferLightOwnable2Step._authorizeTransferApproval</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#19">RuleConditionalTransferLightOwnable2Step.supportsInterface</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func.html
new file mode 100644
index 0000000..60b99de
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.func.html
@@ -0,0 +1,93 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLightOwnable2Step.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#24">RuleConditionalTransferLightOwnable2Step._authorizeTransferApproval</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#26">RuleConditionalTransferLightOwnable2Step._authorizeTransferExecution</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html#19">RuleConditionalTransferLightOwnable2Step.supportsInterface</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.gcov.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.gcov.html
new file mode 100644
index 0000000..b0a0b09
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol.gcov.html
@@ -0,0 +1,114 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation</a> - RuleConditionalTransferLightOwnable2Step.sol<span style="font-size: 80%;"> (source / <a href="RuleConditionalTransferLightOwnable2Step.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntry">5</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntry">3</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntry">0</td>
+            <td class="headerCovTableEntryHi">-</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <table cellpadding=0 cellspacing=0 border=0>
+    <tr>
+      <td><br></td>
+    </tr>
+    <tr>
+      <td>
+<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
+<pre class="source">
+<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {Ownable} from &quot;OZ/access/Ownable.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {Ownable2Step} from &quot;OZ/access/Ownable2Step.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleInterfaceId} from &quot;RuleEngine/modules/library/RuleInterfaceId.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IERC165} from &quot;OZ/utils/introspection/IERC165.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleConditionalTransferLightBase} from &quot;./abstract/RuleConditionalTransferLightBase.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : </a>
+<a name="11"><span class="lineNum">      11 </span>                :            : /**</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :  * @title RuleConditionalTransferLightOwnable2Step</a>
+<a name="13"><span class="lineNum">      13 </span>                :            :  * @notice Ownable2Step variant of RuleConditionalTransferLight.</a>
+<a name="14"><span class="lineNum">      14 </span>                :            :  */</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : contract RuleConditionalTransferLightOwnable2Step is</a>
+<a name="16"><span class="lineNum">      16 </span>                :            :     RuleConditionalTransferLightBase,</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :     Ownable2Step</a>
+<a name="18"><span class="lineNum">      18 </span>                :            : {</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :     constructor(address owner) Ownable(owner) {}</a>
+<a name="20"><span class="lineNum">      20 </span>                :            : </a>
+<a name="21"><span class="lineNum">      21 </span>                :<span class="lineCov">          4 :     function supportsInterface(bytes4 interfaceId) public view override returns (bool) {</span></a>
+<a name="22"><span class="lineNum">      22 </span>                :<span class="lineCov">          4 :         return interfaceId == type(IERC165).interfaceId || interfaceId == RuleInterfaceId.IRULE_INTERFACE_ID</span></a>
+<a name="23"><span class="lineNum">      23 </span>                :<span class="lineCov">          2 :             || interfaceId == type(IRule).interfaceId;</span></a>
+<a name="24"><span class="lineNum">      24 </span>                :            :     }</a>
+<a name="25"><span class="lineNum">      25 </span>                :            : </a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">          4 :     function _authorizeTransferApproval() internal view virtual override onlyOwner {}</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :            : </a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">          3 :     function _authorizeTransferExecution() internal view virtual override onlyOwner {}</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            : }</a>
+</pre>
+      </td>
+    </tr>
+  </table>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func-sort-c.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func-sort-c.html
new file mode 100644
index 0000000..d8df2c5
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func-sort-c.html
@@ -0,0 +1,153 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a> - RuleConditionalTransferLightBase.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLightBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleConditionalTransferLightBase.sol.func.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#128">RuleConditionalTransferLightBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#118">RuleConditionalTransferLightBase.canTransferFrom</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#100">RuleConditionalTransferLightBase.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#76">RuleConditionalTransferLightBase.transferred.1</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#132">RuleConditionalTransferLightBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#148">RuleConditionalTransferLightBase._transferredFromContext</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#178">RuleConditionalTransferLightBase.onlyTransferExecutor</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#144">RuleConditionalTransferLightBase.transferred.2</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#43">RuleConditionalTransferLightBase.approveAndTransferIfAllowed</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#109">RuleConditionalTransferLightBase.canTransfer</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#29">RuleConditionalTransferLightBase.cancelTransferApproval</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#173">RuleConditionalTransferLightBase.onlyTransferApprover</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#84">RuleConditionalTransferLightBase.detectTransferRestriction</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#63">RuleConditionalTransferLightBase.approvedCount</a></td>
+              <td class="coverFnHi">264</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#68">RuleConditionalTransferLightBase.transferred.0</a></td>
+              <td class="coverFnHi">856</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#152">RuleConditionalTransferLightBase._transferred</a></td>
+              <td class="coverFnHi">860</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#23">RuleConditionalTransferLightBase.approveTransfer</a></td>
+              <td class="coverFnHi">1940</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#165">RuleConditionalTransferLightBase._transferHash</a></td>
+              <td class="coverFnHi">3063</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func.html
new file mode 100644
index 0000000..bd1a0a3
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.func.html
@@ -0,0 +1,153 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol - functions</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a> - RuleConditionalTransferLightBase.sol<span style="font-size: 80%;"> (<a href="RuleConditionalTransferLightBase.sol.gcov.html">source</a> / functions)</span></td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="60%" cellpadding=1 cellspacing=1 border=0>
+    <tr><td><br></td></tr>
+    <tr>
+      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
+      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleConditionalTransferLightBase.sol.func-sort-c.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
+    </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#165">RuleConditionalTransferLightBase._transferHash</a></td>
+              <td class="coverFnHi">3063</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#152">RuleConditionalTransferLightBase._transferred</a></td>
+              <td class="coverFnHi">860</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#148">RuleConditionalTransferLightBase._transferredFromContext</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#43">RuleConditionalTransferLightBase.approveAndTransferIfAllowed</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#23">RuleConditionalTransferLightBase.approveTransfer</a></td>
+              <td class="coverFnHi">1940</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#63">RuleConditionalTransferLightBase.approvedCount</a></td>
+              <td class="coverFnHi">264</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#128">RuleConditionalTransferLightBase.canReturnTransferRestrictionCode</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#109">RuleConditionalTransferLightBase.canTransfer</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#118">RuleConditionalTransferLightBase.canTransferFrom</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#29">RuleConditionalTransferLightBase.cancelTransferApproval</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#84">RuleConditionalTransferLightBase.detectTransferRestriction</a></td>
+              <td class="coverFnHi">7</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#100">RuleConditionalTransferLightBase.detectTransferRestrictionFrom</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#132">RuleConditionalTransferLightBase.messageForTransferRestriction</a></td>
+              <td class="coverFnHi">2</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#173">RuleConditionalTransferLightBase.onlyTransferApprover</a></td>
+              <td class="coverFnHi">4</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#178">RuleConditionalTransferLightBase.onlyTransferExecutor</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#68">RuleConditionalTransferLightBase.transferred.0</a></td>
+              <td class="coverFnHi">856</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#76">RuleConditionalTransferLightBase.transferred.1</a></td>
+              <td class="coverFnHi">1</td>
+            </tr>
+    <tr>
+              <td class="coverFn"><a href="RuleConditionalTransferLightBase.sol.gcov.html#144">RuleConditionalTransferLightBase.transferred.2</a></td>
+              <td class="coverFnHi">3</td>
+            </tr>
+  </table>
+  <br>
+  </center>
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/RuleBlacklist.sol.gcov.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.gcov.html
similarity index 50%
rename from doc/coverage/coverage/validation/RuleBlacklist.sol.gcov.html
rename to doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.gcov.html
index 9ee3de4..4dc44fd 100644
--- a/doc/coverage/coverage/validation/RuleBlacklist.sol.gcov.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol.gcov.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleBlacklist.sol</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/RuleConditionalTransferLightBase.sol</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleBlacklist.sol<span style="font-size: 80%;"> (source / <a href="RuleBlacklist.sol.func-sort-c.html">functions</a>)</span></td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - <a href="index.html">home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a> - RuleConditionalTransferLightBase.sol<span style="font-size: 80%;"> (source / <a href="RuleConditionalTransferLightBase.sol.func-sort-c.html">functions</a>)</span></td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,34 +31,34 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">35</td>
-            <td class="headerCovTableEntry">37</td>
-            <td class="headerCovTableEntryHi">94.6 %</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">10</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">16</td>
-            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <table cellpadding=0 cellspacing=0 border=0>
@@ -70,192 +70,193 @@
 <pre class="sourceHeading">           Branch data     Line data    Source code</pre>
 <pre class="source">
 <a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
-<a name="2"><span class="lineNum">       2 </span>                :            : </a>
-<a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
-<a name="4"><span class="lineNum">       4 </span>                :            : </a>
-<a name="5"><span class="lineNum">       5 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : /* ==== Abtract contracts === */</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : import {RuleBlacklistInvariantStorage} from</a>
-<a name="8"><span class="lineNum">       8 </span>                :            :     &quot;./abstract/RuleAddressSet/invariantStorage/RuleBlacklistInvariantStorage.sol&quot;;</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {RuleAddressSet} from &quot;./abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleValidateTransfer, RuleValidateTransfer} from &quot;./abstract/RuleValidateTransfer.sol&quot;;</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : /* ==== Interfaces === */</a>
-<a name="12"><span class="lineNum">      12 </span>                :            : import {IERC7943NonFungibleComplianceExtend} from &quot;../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
-<a name="13"><span class="lineNum">      13 </span>                :            : /* ==== CMTAT === */</a>
-<a name="14"><span class="lineNum">      14 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
-<a name="15"><span class="lineNum">      15 </span>                :            : import {IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
-<a name="16"><span class="lineNum">      16 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
-<a name="17"><span class="lineNum">      17 </span>                :            : /* ==== IRuleEngine === */</a>
-<a name="18"><span class="lineNum">      18 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
-<a name="19"><span class="lineNum">      19 </span>                :            : </a>
-<a name="20"><span class="lineNum">      20 </span>                :            : /**</a>
-<a name="21"><span class="lineNum">      21 </span>                :            :  * @title a blacklist manager</a>
-<a name="22"><span class="lineNum">      22 </span>                :            :  */</a>
-<a name="23"><span class="lineNum">      23 </span>                :            : contract RuleBlacklist is RuleValidateTransfer, RuleAddressSet, RuleBlacklistInvariantStorage {</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="25"><span class="lineNum">      25 </span>                :            :                               CONSTRUCTOR</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="27"><span class="lineNum">      27 </span>                :            :     /**</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
-<a name="30"><span class="lineNum">      30 </span>                :            :      */</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :     constructor(address admin, address forwarderIrrevocable) RuleAddressSet(admin, forwarderIrrevocable) {}</a>
-<a name="32"><span class="lineNum">      32 </span>                :            : </a>
-<a name="33"><span class="lineNum">      33 </span>                :            :     /* ============  View Functions ============ */</a>
-<a name="34"><span class="lineNum">      34 </span>                :            :     /**</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :      * @notice Check if an addres is in the whitelist or not</a>
-<a name="36"><span class="lineNum">      36 </span>                :            :      * @param from the origin address</a>
-<a name="37"><span class="lineNum">      37 </span>                :            :      * @param to the destination address</a>
-<a name="38"><span class="lineNum">      38 </span>                :            :      * @return The restricion code or REJECTED_CODE_BASE.TRANSFER_OK</a>
-<a name="39"><span class="lineNum">      39 </span>                :            :      *</a>
-<a name="40"><span class="lineNum">      40 </span>                :            :      */</a>
-<a name="41"><span class="lineNum">      41 </span>                :<span class="lineCov">         22 :     function detectTransferRestriction(address from, address to, uint256 /* value */ )</span></a>
-<a name="42"><span class="lineNum">      42 </span>                :            :         public</a>
-<a name="43"><span class="lineNum">      43 </span>                :            :         view</a>
-<a name="44"><span class="lineNum">      44 </span>                :            :         override(IERC1404)</a>
-<a name="45"><span class="lineNum">      45 </span>                :            :         returns (uint8)</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :     {</a>
-<a name="47"><span class="lineNum">      47 </span>        [<span class="branchCov" title="Branch 0 was taken 14 times"> + </span><span class="branchCov" title="Branch 1 was taken 16 times"> + </span>]:<span class="lineCov">         43 :         if (isAddressListed(from)) {</span></a>
-<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">         14 :             return CODE_ADDRESS_FROM_IS_BLACKLISTED;</span></a>
-<a name="49"><span class="lineNum">      49 </span>        [<span class="branchCov" title="Branch 0 was taken 13 times"> + </span><span class="branchCov" title="Branch 1 was taken 16 times"> + </span>]:<span class="lineCov">         29 :         } else if (isAddressListed(to)) {</span></a>
-<a name="50"><span class="lineNum">      50 </span>                :<span class="lineCov">         13 :             return CODE_ADDRESS_TO_IS_BLACKLISTED;</span></a>
-<a name="51"><span class="lineNum">      51 </span>                :            :         } else {</a>
-<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">         16 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="53"><span class="lineNum">      53 </span>                :            :         }</a>
-<a name="54"><span class="lineNum">      54 </span>                :            :     }</a>
-<a name="55"><span class="lineNum">      55 </span>                :            : </a>
-<a name="56"><span class="lineNum">      56 </span>                :            :     /*</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :     * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="58"><span class="lineNum">      58 </span>                :            :     */</a>
-<a name="59"><span class="lineNum">      59 </span>                :<span class="lineCov">          7 :     function detectTransferRestriction(address from, address to, uint256, /* tokenId */ uint256 value)</span></a>
-<a name="60"><span class="lineNum">      60 </span>                :            :         public</a>
-<a name="61"><span class="lineNum">      61 </span>                :            :         view</a>
-<a name="62"><span class="lineNum">      62 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="63"><span class="lineNum">      63 </span>                :            :         returns (uint8)</a>
-<a name="64"><span class="lineNum">      64 </span>                :            :     {</a>
-<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">          7 :         return detectTransferRestriction(from, to, value);</span></a>
-<a name="66"><span class="lineNum">      66 </span>                :            :     }</a>
-<a name="67"><span class="lineNum">      67 </span>                :            : </a>
-<a name="68"><span class="lineNum">      68 </span>                :            :     /*</a>
-<a name="69"><span class="lineNum">      69 </span>                :            :     * @inheritdoc IERC1404Extend</a>
-<a name="70"><span class="lineNum">      70 </span>                :            :     */</a>
-<a name="71"><span class="lineNum">      71 </span>                :<span class="lineCov">         16 :     function detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
-<a name="72"><span class="lineNum">      72 </span>                :            :         public</a>
-<a name="73"><span class="lineNum">      73 </span>                :            :         view</a>
-<a name="74"><span class="lineNum">      74 </span>                :            :         override(IERC1404Extend)</a>
-<a name="75"><span class="lineNum">      75 </span>                :            :         returns (uint8)</a>
-<a name="76"><span class="lineNum">      76 </span>                :            :     {</a>
-<a name="77"><span class="lineNum">      77 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 14 times"> + </span>]:<span class="lineCov">         20 :         if (isAddressListed(spender)) {</span></a>
-<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">          6 :             return CODE_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
-<a name="79"><span class="lineNum">      79 </span>                :            :         } else {</a>
-<a name="80"><span class="lineNum">      80 </span>                :<span class="lineCov">         14 :             return detectTransferRestriction(from, to, value);</span></a>
-<a name="81"><span class="lineNum">      81 </span>                :            :         }</a>
-<a name="82"><span class="lineNum">      82 </span>                :            :     }</a>
-<a name="83"><span class="lineNum">      83 </span>                :            : </a>
-<a name="84"><span class="lineNum">      84 </span>                :            :     /**</a>
-<a name="85"><span class="lineNum">      85 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="86"><span class="lineNum">      86 </span>                :            :      */</a>
-<a name="87"><span class="lineNum">      87 </span>                :<span class="lineCov">          4 :     function detectTransferRestrictionFrom(</span></a>
-<a name="88"><span class="lineNum">      88 </span>                :            :         address spender,</a>
-<a name="89"><span class="lineNum">      89 </span>                :            :         address from,</a>
-<a name="90"><span class="lineNum">      90 </span>                :            :         address to,</a>
-<a name="91"><span class="lineNum">      91 </span>                :            :         uint256, /* tokenId */</a>
-<a name="92"><span class="lineNum">      92 </span>                :            :         uint256 value</a>
-<a name="93"><span class="lineNum">      93 </span>                :            :     ) public view override(IERC7943NonFungibleComplianceExtend) returns (uint8) {</a>
-<a name="94"><span class="lineNum">      94 </span>                :<span class="lineCov">          4 :         return detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="95"><span class="lineNum">      95 </span>                :            :     }</a>
-<a name="96"><span class="lineNum">      96 </span>                :            : </a>
-<a name="97"><span class="lineNum">      97 </span>                :            :     /**</a>
-<a name="98"><span class="lineNum">      98 </span>                :            :      * @notice To know if the restriction code is valid for this rule or not.</a>
-<a name="99"><span class="lineNum">      99 </span>                :            :      * @param _restrictionCode The target restriction code</a>
-<a name="100"><span class="lineNum">     100 </span>                :            :      * @return true if the restriction code is known, false otherwise</a>
-<a name="101"><span class="lineNum">     101 </span>                :            :      *</a>
-<a name="102"><span class="lineNum">     102 </span>                :            :      */</a>
-<a name="103"><span class="lineNum">     103 </span>                :<span class="lineCov">          4 :     function canReturnTransferRestrictionCode(uint8 _restrictionCode)</span></a>
-<a name="104"><span class="lineNum">     104 </span>                :            :         public</a>
-<a name="105"><span class="lineNum">     105 </span>                :            :         pure</a>
-<a name="106"><span class="lineNum">     106 </span>                :            :         virtual</a>
-<a name="107"><span class="lineNum">     107 </span>                :            :         override(IRule)</a>
-<a name="108"><span class="lineNum">     108 </span>                :            :         returns (bool)</a>
-<a name="109"><span class="lineNum">     109 </span>                :            :     {</a>
-<a name="110"><span class="lineNum">     110 </span>                :<span class="lineCov">          4 :         return _restrictionCode == CODE_ADDRESS_FROM_IS_BLACKLISTED</span></a>
-<a name="111"><span class="lineNum">     111 </span>                :<span class="lineCov">          2 :             || _restrictionCode == CODE_ADDRESS_TO_IS_BLACKLISTED || _restrictionCode == CODE_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
-<a name="112"><span class="lineNum">     112 </span>                :            :     }</a>
-<a name="113"><span class="lineNum">     113 </span>                :            : </a>
-<a name="114"><span class="lineNum">     114 </span>                :            :     /**</a>
-<a name="115"><span class="lineNum">     115 </span>                :            :      * @notice Return the corresponding message</a>
-<a name="116"><span class="lineNum">     116 </span>                :            :      * @param _restrictionCode The target restriction code</a>
-<a name="117"><span class="lineNum">     117 </span>                :            :      * @return true if the transfer is valid, false otherwise</a>
-<a name="118"><span class="lineNum">     118 </span>                :            :      *</a>
-<a name="119"><span class="lineNum">     119 </span>                :            :      */</a>
-<a name="120"><span class="lineNum">     120 </span>                :<span class="lineCov">          8 :     function messageForTransferRestriction(uint8 _restrictionCode)</span></a>
+<a name="2"><span class="lineNum">       2 </span>                :            : pragma solidity ^0.8.20;</a>
+<a name="3"><span class="lineNum">       3 </span>                :            : </a>
+<a name="4"><span class="lineNum">       4 </span>                :            : import {IRuleEngine} from &quot;CMTAT/interfaces/engine/IRuleEngine.sol&quot;;</a>
+<a name="5"><span class="lineNum">       5 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
+<a name="6"><span class="lineNum">       6 </span>                :            : import {IERC3643ComplianceRead, IERC3643IComplianceContract} from &quot;CMTAT/interfaces/tokenization/IERC3643Partial.sol&quot;;</a>
+<a name="7"><span class="lineNum">       7 </span>                :            : import {IERC7551Compliance} from &quot;CMTAT/interfaces/tokenization/draft-IERC7551.sol&quot;;</a>
+<a name="8"><span class="lineNum">       8 </span>                :            : import {IRule} from &quot;RuleEngine/interfaces/IRule.sol&quot;;</a>
+<a name="9"><span class="lineNum">       9 </span>                :            : import {ITransferContext} from &quot;../../interfaces/ITransferContext.sol&quot;;</a>
+<a name="10"><span class="lineNum">      10 </span>                :            : import {IERC20} from &quot;OZ/token/ERC20/IERC20.sol&quot;;</a>
+<a name="11"><span class="lineNum">      11 </span>                :            : import {</a>
+<a name="12"><span class="lineNum">      12 </span>                :            :     RuleConditionalTransferLightInvariantStorage</a>
+<a name="13"><span class="lineNum">      13 </span>                :            : } from &quot;./RuleConditionalTransferLightInvariantStorage.sol&quot;;</a>
+<a name="14"><span class="lineNum">      14 </span>                :            : import {VersionModule} from &quot;../../../modules/VersionModule.sol&quot;;</a>
+<a name="15"><span class="lineNum">      15 </span>                :            : </a>
+<a name="16"><span class="lineNum">      16 </span>                :            : /**</a>
+<a name="17"><span class="lineNum">      17 </span>                :            :  * @title RuleConditionalTransferLightBase</a>
+<a name="18"><span class="lineNum">      18 </span>                :            :  * @dev Requires operator approval for each transfer. Same transfer (from, to, value)</a>
+<a name="19"><span class="lineNum">      19 </span>                :            :  *      can be approved multiple times to allow repeated transfers.</a>
+<a name="20"><span class="lineNum">      20 </span>                :            :  */</a>
+<a name="21"><span class="lineNum">      21 </span>                :            : abstract contract RuleConditionalTransferLightBase is VersionModule, RuleConditionalTransferLightInvariantStorage, IRule {</a>
+<a name="22"><span class="lineNum">      22 </span>                :            :     // Mapping from transfer hash to approval count</a>
+<a name="23"><span class="lineNum">      23 </span>                :            :     mapping(bytes32 =&gt; uint256) public approvalCounts;</a>
+<a name="24"><span class="lineNum">      24 </span>                :            : </a>
+<a name="25"><span class="lineNum">      25 </span>                :<span class="lineCov">       1940 :     function approveTransfer(address from, address to, uint256 value) public onlyTransferApprover {</span></a>
+<a name="26"><span class="lineNum">      26 </span>                :<span class="lineCov">       1941 :         bytes32 transferHash = _transferHash(from, to, value);</span></a>
+<a name="27"><span class="lineNum">      27 </span>                :<span class="lineCov">       1941 :         approvalCounts[transferHash] += 1;</span></a>
+<a name="28"><span class="lineNum">      28 </span>                :<span class="lineCov">       1941 :         emit TransferApproved(from, to, value, approvalCounts[transferHash]);</span></a>
+<a name="29"><span class="lineNum">      29 </span>                :            :     }</a>
+<a name="30"><span class="lineNum">      30 </span>                :            : </a>
+<a name="31"><span class="lineNum">      31 </span>                :<span class="lineCov">          4 :     function cancelTransferApproval(address from, address to, uint256 value) public onlyTransferApprover {</span></a>
+<a name="32"><span class="lineNum">      32 </span>                :<span class="lineCov">          3 :         bytes32 transferHash = _transferHash(from, to, value);</span></a>
+<a name="33"><span class="lineNum">      33 </span>                :<span class="lineCov">          3 :         uint256 count = approvalCounts[transferHash];</span></a>
+<a name="34"><span class="lineNum">      34 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          3 :         require(count != 0, TransferApprovalNotFound());</span></a>
+<a name="35"><span class="lineNum">      35 </span>                :<span class="lineCov">          2 :         approvalCounts[transferHash] = count - 1;</span></a>
+<a name="36"><span class="lineNum">      36 </span>                :<span class="lineCov">          2 :         emit TransferApprovalCancelled(from, to, value, approvalCounts[transferHash]);</span></a>
+<a name="37"><span class="lineNum">      37 </span>                :            :     }</a>
+<a name="38"><span class="lineNum">      38 </span>                :            : </a>
+<a name="39"><span class="lineNum">      39 </span>                :            :     /**</a>
+<a name="40"><span class="lineNum">      40 </span>                :            :      * @notice Approves and performs a transferFrom using this rule as spender.</a>
+<a name="41"><span class="lineNum">      41 </span>                :            :      * @dev Requires `from` to have approved this contract on the token.</a>
+<a name="42"><span class="lineNum">      42 </span>                :            :      * @dev This function is only safe for tokens that call back `transferred()` during transfer.</a>
+<a name="43"><span class="lineNum">      43 </span>                :            :      * @dev CEI is intentionally inverted so the approval exists for the callback.</a>
+<a name="44"><span class="lineNum">      44 </span>                :            :      */</a>
+<a name="45"><span class="lineNum">      45 </span>                :<span class="lineCov">          4 :     function approveAndTransferIfAllowed(address token, address from, address to, uint256 value)</span></a>
+<a name="46"><span class="lineNum">      46 </span>                :            :         public</a>
+<a name="47"><span class="lineNum">      47 </span>                :            :         onlyTransferApprover</a>
+<a name="48"><span class="lineNum">      48 </span>                :            :         returns (bool)</a>
+<a name="49"><span class="lineNum">      49 </span>                :            :     {</a>
+<a name="50"><span class="lineNum">      50 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 3 times"> + </span>]:<span class="lineCov">          4 :         require(token != address(0), RuleConditionalTransferLight_TokenAddressZeroNotAllowed());</span></a>
+<a name="51"><span class="lineNum">      51 </span>                :            : </a>
+<a name="52"><span class="lineNum">      52 </span>                :<span class="lineCov">          3 :         approveTransfer(from, to, value);</span></a>
+<a name="53"><span class="lineNum">      53 </span>                :            : </a>
+<a name="54"><span class="lineNum">      54 </span>                :<span class="lineCov">          3 :         uint256 allowed = IERC20(token).allowance(from, address(this));</span></a>
+<a name="55"><span class="lineNum">      55 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          3 :         require(</span></a>
+<a name="56"><span class="lineNum">      56 </span>                :            :             allowed &gt;= value,</a>
+<a name="57"><span class="lineNum">      57 </span>                :            :             RuleConditionalTransferLight_InsufficientAllowance(token, from, allowed, value)</a>
+<a name="58"><span class="lineNum">      58 </span>                :            :         );</a>
+<a name="59"><span class="lineNum">      59 </span>                :            : </a>
+<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">          2 :         bool success = IERC20(token).transferFrom(from, to, value);</span></a>
+<a name="61"><span class="lineNum">      61 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         require(success, RuleConditionalTransferLight_TransferFailed());</span></a>
+<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">          1 :         return true;</span></a>
+<a name="63"><span class="lineNum">      63 </span>                :            :     }</a>
+<a name="64"><span class="lineNum">      64 </span>                :            : </a>
+<a name="65"><span class="lineNum">      65 </span>                :<span class="lineCov">        264 :     function approvedCount(address from, address to, uint256 value) public view returns (uint256) {</span></a>
+<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">        264 :         bytes32 transferHash = _transferHash(from, to, value);</span></a>
+<a name="67"><span class="lineNum">      67 </span>                :<span class="lineCov">        264 :         return approvalCounts[transferHash];</span></a>
+<a name="68"><span class="lineNum">      68 </span>                :            :     }</a>
+<a name="69"><span class="lineNum">      69 </span>                :            : </a>
+<a name="70"><span class="lineNum">      70 </span>                :<span class="lineCov">        856 :     function transferred(address from, address to, uint256 value)</span></a>
+<a name="71"><span class="lineNum">      71 </span>                :            :         public</a>
+<a name="72"><span class="lineNum">      72 </span>                :            :         override(IERC3643IComplianceContract)</a>
+<a name="73"><span class="lineNum">      73 </span>                :            :         onlyTransferExecutor</a>
+<a name="74"><span class="lineNum">      74 </span>                :            :     {</a>
+<a name="75"><span class="lineNum">      75 </span>                :<span class="lineCov">        854 :         _transferred(from, to, value);</span></a>
+<a name="76"><span class="lineNum">      76 </span>                :            :     }</a>
+<a name="77"><span class="lineNum">      77 </span>                :            : </a>
+<a name="78"><span class="lineNum">      78 </span>                :<span class="lineCov">          1 :     function transferred(address /* spender */, address from, address to, uint256 value)</span></a>
+<a name="79"><span class="lineNum">      79 </span>                :            :         public</a>
+<a name="80"><span class="lineNum">      80 </span>                :            :         override(IRuleEngine)</a>
+<a name="81"><span class="lineNum">      81 </span>                :            :         onlyTransferExecutor</a>
+<a name="82"><span class="lineNum">      82 </span>                :            :     {</a>
+<a name="83"><span class="lineNum">      83 </span>                :<span class="lineCov">          1 :         _transferred(from, to, value);</span></a>
+<a name="84"><span class="lineNum">      84 </span>                :            :     }</a>
+<a name="85"><span class="lineNum">      85 </span>                :            : </a>
+<a name="86"><span class="lineNum">      86 </span>                :<span class="lineCov">          7 :     function detectTransferRestriction(address from, address to, uint256 value)</span></a>
+<a name="87"><span class="lineNum">      87 </span>                :            :         public</a>
+<a name="88"><span class="lineNum">      88 </span>                :            :         view</a>
+<a name="89"><span class="lineNum">      89 </span>                :            :         override(IERC1404)</a>
+<a name="90"><span class="lineNum">      90 </span>                :            :         returns (uint8)</a>
+<a name="91"><span class="lineNum">      91 </span>                :            :     {</a>
+<a name="92"><span class="lineNum">      92 </span>           [<span class="branchCov" title="Branch 0 was taken 4 times"> + </span>]:<span class="lineCov">         13 :         if (from == address(0) || to == address(0)) {</span></a>
+<a name="93"><span class="lineNum">      93 </span>                :<span class="lineCov">          4 :             return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="94"><span class="lineNum">      94 </span>                :            :         }</a>
+<a name="95"><span class="lineNum">      95 </span>                :<span class="lineCov">          9 :         bytes32 transferHash = _transferHash(from, to, value);</span></a>
+<a name="96"><span class="lineNum">      96 </span>           [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span>]:<span class="lineCov">          9 :         if (approvalCounts[transferHash] == 0) {</span></a>
+<a name="97"><span class="lineNum">      97 </span>                :<span class="lineCov">          6 :             return CODE_TRANSFER_REQUEST_NOT_APPROVED;</span></a>
+<a name="98"><span class="lineNum">      98 </span>                :            :         }</a>
+<a name="99"><span class="lineNum">      99 </span>                :<span class="lineCov">          3 :         return uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="100"><span class="lineNum">     100 </span>                :            :     }</a>
+<a name="101"><span class="lineNum">     101 </span>                :            : </a>
+<a name="102"><span class="lineNum">     102 </span>                :<span class="lineCov">          1 :     function detectTransferRestrictionFrom(address /* spender */, address from, address to, uint256 value)</span></a>
+<a name="103"><span class="lineNum">     103 </span>                :            :         public</a>
+<a name="104"><span class="lineNum">     104 </span>                :            :         view</a>
+<a name="105"><span class="lineNum">     105 </span>                :            :         override(IERC1404Extend)</a>
+<a name="106"><span class="lineNum">     106 </span>                :            :         returns (uint8)</a>
+<a name="107"><span class="lineNum">     107 </span>                :            :     {</a>
+<a name="108"><span class="lineNum">     108 </span>                :<span class="lineCov">          2 :         return detectTransferRestriction(from, to, value);</span></a>
+<a name="109"><span class="lineNum">     109 </span>                :            :     }</a>
+<a name="110"><span class="lineNum">     110 </span>                :            : </a>
+<a name="111"><span class="lineNum">     111 </span>                :<span class="lineCov">          4 :     function canTransfer(address from, address to, uint256 value)</span></a>
+<a name="112"><span class="lineNum">     112 </span>                :            :         public</a>
+<a name="113"><span class="lineNum">     113 </span>                :            :         view</a>
+<a name="114"><span class="lineNum">     114 </span>                :            :         override(IERC3643ComplianceRead)</a>
+<a name="115"><span class="lineNum">     115 </span>                :            :         returns (bool)</a>
+<a name="116"><span class="lineNum">     116 </span>                :            :     {</a>
+<a name="117"><span class="lineNum">     117 </span>                :<span class="lineCov">          4 :         return detectTransferRestriction(from, to, value) == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
+<a name="118"><span class="lineNum">     118 </span>                :            :     }</a>
+<a name="119"><span class="lineNum">     119 </span>                :            : </a>
+<a name="120"><span class="lineNum">     120 </span>                :<span class="lineCov">          1 :     function canTransferFrom(address spender, address from, address to, uint256 value)</span></a>
 <a name="121"><span class="lineNum">     121 </span>                :            :         public</a>
-<a name="122"><span class="lineNum">     122 </span>                :            :         pure</a>
-<a name="123"><span class="lineNum">     123 </span>                :            :         virtual</a>
-<a name="124"><span class="lineNum">     124 </span>                :            :         override(IERC1404)</a>
-<a name="125"><span class="lineNum">     125 </span>                :            :         returns (string memory)</a>
-<a name="126"><span class="lineNum">     126 </span>                :            :     {</a>
-<a name="127"><span class="lineNum">     127 </span>        [<span class="branchCov" title="Branch 0 was taken 3 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          8 :         if (_restrictionCode == CODE_ADDRESS_FROM_IS_BLACKLISTED) {</span></a>
-<a name="128"><span class="lineNum">     128 </span>                :<span class="lineCov">          3 :             return TEXT_ADDRESS_FROM_IS_BLACKLISTED;</span></a>
-<a name="129"><span class="lineNum">     129 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          5 :         } else if (_restrictionCode == CODE_ADDRESS_TO_IS_BLACKLISTED) {</span></a>
-<a name="130"><span class="lineNum">     130 </span>                :<span class="lineCov">          2 :             return TEXT_ADDRESS_TO_IS_BLACKLISTED;</span></a>
-<a name="131"><span class="lineNum">     131 </span>        [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          3 :         } else if (_restrictionCode == CODE_ADDRESS_SPENDER_IS_BLACKLISTED) {</span></a>
-<a name="132"><span class="lineNum">     132 </span>                :<span class="lineCov">          1 :             return TEXT_ADDRESS_SPENDER_IS_BLACKLISTED;</span></a>
-<a name="133"><span class="lineNum">     133 </span>                :            :         } else {</a>
-<a name="134"><span class="lineNum">     134 </span>                :<span class="lineCov">          2 :             return TEXT_CODE_NOT_FOUND;</span></a>
-<a name="135"><span class="lineNum">     135 </span>                :            :         }</a>
-<a name="136"><span class="lineNum">     136 </span>                :            :     }</a>
-<a name="137"><span class="lineNum">     137 </span>                :            : </a>
-<a name="138"><span class="lineNum">     138 </span>                :<span class="lineNoCov">          0 :     function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControl, RuleValidateTransfer) returns (bool) {</span></a>
-<a name="139"><span class="lineNum">     139 </span>                :<span class="lineNoCov">          0 :         return AccessControl.supportsInterface(interfaceId) || RuleValidateTransfer.supportsInterface(interfaceId);</span></a>
-<a name="140"><span class="lineNum">     140 </span>                :            :     }</a>
-<a name="141"><span class="lineNum">     141 </span>                :            : </a>
-<a name="142"><span class="lineNum">     142 </span>                :            :     /* ============  State Functions ============ */</a>
-<a name="143"><span class="lineNum">     143 </span>                :            : </a>
-<a name="144"><span class="lineNum">     144 </span>                :<span class="lineCov">          9 :     function transferred(address from, address to, uint256 value)</span></a>
-<a name="145"><span class="lineNum">     145 </span>                :            :         public</a>
-<a name="146"><span class="lineNum">     146 </span>                :            :         view</a>
-<a name="147"><span class="lineNum">     147 </span>                :            :         virtual</a>
-<a name="148"><span class="lineNum">     148 </span>                :            :         override(IERC3643IComplianceContract)</a>
-<a name="149"><span class="lineNum">     149 </span>                :            :     {</a>
-<a name="150"><span class="lineNum">     150 </span>                :<span class="lineCov">         12 :         uint8 code = this.detectTransferRestriction(from, to, value);</span></a>
-<a name="151"><span class="lineNum">     151 </span>        [<span class="branchCov" title="Branch 0 was taken 8 times"> + </span><span class="branchCov" title="Branch 1 was taken 4 times"> + </span>]:<span class="lineCov">         12 :         require(</span></a>
-<a name="152"><span class="lineNum">     152 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="153"><span class="lineNum">     153 </span>                :            :             RuleBlacklist_InvalidTransfer(address(this), from, to, value, code)</a>
-<a name="154"><span class="lineNum">     154 </span>                :            :         );</a>
-<a name="155"><span class="lineNum">     155 </span>                :            :     }</a>
-<a name="156"><span class="lineNum">     156 </span>                :            : </a>
-<a name="157"><span class="lineNum">     157 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 value)</span></a>
-<a name="158"><span class="lineNum">     158 </span>                :            :         public</a>
-<a name="159"><span class="lineNum">     159 </span>                :            :         view</a>
-<a name="160"><span class="lineNum">     160 </span>                :            :         virtual</a>
-<a name="161"><span class="lineNum">     161 </span>                :            :         override(IRuleEngine)</a>
-<a name="162"><span class="lineNum">     162 </span>                :            :     {</a>
-<a name="163"><span class="lineNum">     163 </span>                :<span class="lineCov">          4 :         uint8 code = this.detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="164"><span class="lineNum">     164 </span>        [<span class="branchCov" title="Branch 0 was taken 2 times"> + </span><span class="branchCov" title="Branch 1 was taken 2 times"> + </span>]:<span class="lineCov">          4 :         require(</span></a>
-<a name="165"><span class="lineNum">     165 </span>                :            :             code == uint8(REJECTED_CODE_BASE.TRANSFER_OK),</a>
-<a name="166"><span class="lineNum">     166 </span>                :            :             RuleBlacklist_InvalidTransferFrom(address(this), spender, from, to, value, code)</a>
-<a name="167"><span class="lineNum">     167 </span>                :            :         );</a>
-<a name="168"><span class="lineNum">     168 </span>                :            :     }</a>
-<a name="169"><span class="lineNum">     169 </span>                :            : </a>
-<a name="170"><span class="lineNum">     170 </span>                :<span class="lineCov">          2 :     function transferred(address spender, address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="171"><span class="lineNum">     171 </span>                :            :         public</a>
-<a name="172"><span class="lineNum">     172 </span>                :            :         view</a>
-<a name="173"><span class="lineNum">     173 </span>                :            :         virtual</a>
-<a name="174"><span class="lineNum">     174 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="175"><span class="lineNum">     175 </span>                :            :     {</a>
-<a name="176"><span class="lineNum">     176 </span>                :<span class="lineCov">          2 :         transferred(spender, from, to, value);</span></a>
-<a name="177"><span class="lineNum">     177 </span>                :            :     }</a>
-<a name="178"><span class="lineNum">     178 </span>                :            : </a>
-<a name="179"><span class="lineNum">     179 </span>                :<span class="lineCov">          3 :     function transferred(address from, address to, uint256 /* tokenId */,uint256 value)</span></a>
-<a name="180"><span class="lineNum">     180 </span>                :            :         public</a>
-<a name="181"><span class="lineNum">     181 </span>                :            :         view</a>
-<a name="182"><span class="lineNum">     182 </span>                :            :         virtual</a>
-<a name="183"><span class="lineNum">     183 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="184"><span class="lineNum">     184 </span>                :            :     {</a>
-<a name="185"><span class="lineNum">     185 </span>                :<span class="lineCov">          3 :         transferred(from, to, value);</span></a>
-<a name="186"><span class="lineNum">     186 </span>                :            :     }</a>
-<a name="187"><span class="lineNum">     187 </span>                :            : }</a>
+<a name="122"><span class="lineNum">     122 </span>                :            :         view</a>
+<a name="123"><span class="lineNum">     123 </span>                :            :         override(IERC7551Compliance)</a>
+<a name="124"><span class="lineNum">     124 </span>                :            :         returns (bool)</a>
+<a name="125"><span class="lineNum">     125 </span>                :            :     {</a>
+<a name="126"><span class="lineNum">     126 </span>                :<span class="lineCov">          1 :         return detectTransferRestrictionFrom(spender, from, to, value)</span></a>
+<a name="127"><span class="lineNum">     127 </span>                :            :             == uint8(IERC1404Extend.REJECTED_CODE_BASE.TRANSFER_OK);</a>
+<a name="128"><span class="lineNum">     128 </span>                :            :     }</a>
+<a name="129"><span class="lineNum">     129 </span>                :            : </a>
+<a name="130"><span class="lineNum">     130 </span>                :<span class="lineCov">          1 :     function canReturnTransferRestrictionCode(uint8 restrictionCode) external pure override(IRule) returns (bool) {</span></a>
+<a name="131"><span class="lineNum">     131 </span>                :<span class="lineCov">          1 :         return restrictionCode == CODE_TRANSFER_REQUEST_NOT_APPROVED;</span></a>
+<a name="132"><span class="lineNum">     132 </span>                :            :     }</a>
+<a name="133"><span class="lineNum">     133 </span>                :            : </a>
+<a name="134"><span class="lineNum">     134 </span>                :<span class="lineCov">          2 :     function messageForTransferRestriction(uint8 restrictionCode)</span></a>
+<a name="135"><span class="lineNum">     135 </span>                :            :         external</a>
+<a name="136"><span class="lineNum">     136 </span>                :            :         pure</a>
+<a name="137"><span class="lineNum">     137 </span>                :            :         override(IERC1404)</a>
+<a name="138"><span class="lineNum">     138 </span>                :            :         returns (string memory)</a>
+<a name="139"><span class="lineNum">     139 </span>                :            :     {</a>
+<a name="140"><span class="lineNum">     140 </span>           [<span class="branchCov" title="Branch 0 was taken 1 time"> + </span>]:<span class="lineCov">          2 :         if (restrictionCode == CODE_TRANSFER_REQUEST_NOT_APPROVED) {</span></a>
+<a name="141"><span class="lineNum">     141 </span>                :<span class="lineCov">          1 :             return TEXT_TRANSFER_REQUEST_NOT_APPROVED;</span></a>
+<a name="142"><span class="lineNum">     142 </span>                :            :         }</a>
+<a name="143"><span class="lineNum">     143 </span>                :<span class="lineCov">          1 :         return TEXT_CODE_NOT_FOUND;</span></a>
+<a name="144"><span class="lineNum">     144 </span>                :            :     }</a>
+<a name="145"><span class="lineNum">     145 </span>                :            : </a>
+<a name="146"><span class="lineNum">     146 </span>                :<span class="lineCov">          3 :     function transferred(ITransferContext.FungibleTransferContext calldata ctx) external onlyTransferExecutor {</span></a>
+<a name="147"><span class="lineNum">     147 </span>                :<span class="lineCov">          3 :         _transferredFromContext(ctx);</span></a>
+<a name="148"><span class="lineNum">     148 </span>                :            :     }</a>
+<a name="149"><span class="lineNum">     149 </span>                :            : </a>
+<a name="150"><span class="lineNum">     150 </span>                :<span class="lineCov">          3 :     function _transferredFromContext(ITransferContext.FungibleTransferContext calldata ctx) internal virtual {</span></a>
+<a name="151"><span class="lineNum">     151 </span>                :<span class="lineCov">          3 :         _transferred(ctx.from, ctx.to, ctx.value);</span></a>
+<a name="152"><span class="lineNum">     152 </span>                :            :     }</a>
+<a name="153"><span class="lineNum">     153 </span>                :            : </a>
+<a name="154"><span class="lineNum">     154 </span>                :<span class="lineCov">        860 :     function _transferred(address from, address to, uint256 value) internal virtual {</span></a>
+<a name="155"><span class="lineNum">     155 </span>           [<span class="branchCov" title="Branch 0 was taken 860 times"> + </span>]:<span class="lineCov">        860 :         if (from == address(0) || to == address(0)) {</span></a>
+<a name="156"><span class="lineNum">     156 </span>                :<span class="lineCov">        860 :             return;</span></a>
+<a name="157"><span class="lineNum">     157 </span>                :            :         }</a>
+<a name="158"><span class="lineNum">     158 </span>                :<span class="lineCov">        846 :         bytes32 transferHash = _transferHash(from, to, value);</span></a>
+<a name="159"><span class="lineNum">     159 </span>                :<span class="lineCov">        846 :         uint256 count = approvalCounts[transferHash];</span></a>
+<a name="160"><span class="lineNum">     160 </span>                :            : </a>
+<a name="161"><span class="lineNum">     161 </span>        [<span class="branchCov" title="Branch 0 was taken 3 times"> + </span><span class="branchCov" title="Branch 1 was taken 843 times"> + </span>]:<span class="lineCov">        846 :         require(count != 0, TransferNotApproved());</span></a>
+<a name="162"><span class="lineNum">     162 </span>                :            : </a>
+<a name="163"><span class="lineNum">     163 </span>                :<span class="lineCov">        843 :         approvalCounts[transferHash] = count - 1;</span></a>
+<a name="164"><span class="lineNum">     164 </span>                :<span class="lineCov">        843 :         emit TransferExecuted(from, to, value, approvalCounts[transferHash]);</span></a>
+<a name="165"><span class="lineNum">     165 </span>                :            :     }</a>
+<a name="166"><span class="lineNum">     166 </span>                :            : </a>
+<a name="167"><span class="lineNum">     167 </span>                :<span class="lineCov">       3063 :     function _transferHash(address from, address to, uint256 value) internal pure virtual returns (bytes32 hash) {</span></a>
+<a name="168"><span class="lineNum">     168 </span>                :<span class="lineCov">       3063 :         return keccak256(abi.encodePacked(from, to, value));</span></a>
+<a name="169"><span class="lineNum">     169 </span>                :            :     }</a>
+<a name="170"><span class="lineNum">     170 </span>                :            : </a>
+<a name="171"><span class="lineNum">     171 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
+<a name="172"><span class="lineNum">     172 </span>                :            :                             ACCESS CONTROL</a>
+<a name="173"><span class="lineNum">     173 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
+<a name="174"><span class="lineNum">     174 </span>                :            : </a>
+<a name="175"><span class="lineNum">     175 </span>                :<span class="lineCov">          4 :     modifier onlyTransferApprover() {</span></a>
+<a name="176"><span class="lineNum">     176 </span>                :<span class="lineCov">          4 :         _authorizeTransferApproval();</span></a>
+<a name="177"><span class="lineNum">     177 </span>                :            :         _;</a>
+<a name="178"><span class="lineNum">     178 </span>                :            :     }</a>
+<a name="179"><span class="lineNum">     179 </span>                :            : </a>
+<a name="180"><span class="lineNum">     180 </span>                :<span class="lineCov">          3 :     modifier onlyTransferExecutor() {</span></a>
+<a name="181"><span class="lineNum">     181 </span>                :<span class="lineCov">          3 :         _authorizeTransferExecution();</span></a>
+<a name="182"><span class="lineNum">     182 </span>                :            :         _;</a>
+<a name="183"><span class="lineNum">     183 </span>                :            :     }</a>
+<a name="184"><span class="lineNum">     184 </span>                :            : </a>
+<a name="185"><span class="lineNum">     185 </span>                :            :     function _authorizeTransferApproval() internal view virtual;</a>
+<a name="186"><span class="lineNum">     186 </span>                :            : </a>
+<a name="187"><span class="lineNum">     187 </span>                :            :     function _authorizeTransferExecution() internal view virtual;</a>
+<a name="188"><span class="lineNum">     188 </span>                :            : }</a>
 </pre>
       </td>
     </tr>
@@ -263,7 +264,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-b.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-b.html
new file mode 100644
index 0000000..1481813
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-b.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleConditionalTransferLightBase.sol.gcov.html">RuleConditionalTransferLightBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-f.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-f.html
new file mode 100644
index 0000000..3d54907
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-f.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleConditionalTransferLightBase.sol.gcov.html">RuleConditionalTransferLightBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-l.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-l.html
new file mode 100644
index 0000000..90e3217
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index-sort-l.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleConditionalTransferLightBase.sol.gcov.html">RuleConditionalTransferLightBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html
new file mode 100644
index 0000000..1a454a5
--- /dev/null
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html
@@ -0,0 +1,107 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html lang="en">
+
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../../gcov.css">
+</head>
+
+<body>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="title">LCOV - code coverage report</td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+
+    <tr>
+      <td width="100%">
+        <table cellpadding=1 border=0 width="100%">
+          <tr>
+            <td width="10%" class="headerItem">Current view:</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</td>
+            <td width="5%"></td>
+            <td width="15%"></td>
+            <td width="10%" class="headerCovTableHead">Hit</td>
+            <td width="10%" class="headerCovTableHead">Total</td>
+            <td width="15%" class="headerCovTableHead">Coverage</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Test:</td>
+            <td class="headerValue">lcov.info</td>
+            <td></td>
+            <td class="headerItem">Lines:</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntry">62</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td class="headerItem">Date:</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
+            <td></td>
+            <td class="headerItem">Functions:</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntry">18</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr>
+            <td></td>
+            <td></td>
+            <td></td>
+            <td class="headerItem">Branches:</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntry">14</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
+          </tr>
+          <tr><td><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+        </table>
+      </td>
+    </tr>
+
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+  </table>
+
+  <center>
+  <table width="80%" cellpadding=1 cellspacing=1 border=0>
+
+    <tr>
+      <td width="44%"><br></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+      <td width="8%"></td>
+    </tr>
+
+    <tr>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../../../../../../../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="RuleConditionalTransferLightBase.sol.gcov.html">RuleConditionalTransferLightBase.sol</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+  </table>
+  </center>
+  <br>
+
+  <table width="100%" border=0 cellspacing=0 cellpadding=0>
+    <tr><td class="ruler"><img src="../../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
+  </table>
+  <br>
+
+</body>
+</html>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-b.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-b.html
similarity index 54%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-b.html
rename to doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-b.html
index fe9d655..4c73cf0 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-b.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-b.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - validation/abstract/RuleAddressSet</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">42</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryHi">91.3 %</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -53,12 +53,12 @@
             <td class="headerCovTableEntry">2</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
@@ -76,32 +76,32 @@
     </tr>
 
     <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">RuleConditionalTransferLightOwnable2Step.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">14 / 14</td>
+      <td class="coverNumHi">5 / 5</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">6 / 6</td>
+      <td class="coverNumHi">3 / 3</td>
       <td class="coverPerHi">-</td>
       <td class="coverNumHi">0 / 0</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLight.sol.gcov.html">RuleConditionalTransferLight.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../amber.png" width=88 height=10 alt="87.5%"><img src="../../../snow.png" width=12 height=10 alt="87.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">87.5&nbsp;%</td>
-      <td class="coverNumMed">28 / 32</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
     </tr>
@@ -110,7 +110,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-f.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-f.html
similarity index 54%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-f.html
rename to doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-f.html
index b79046b..eba8d47 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-f.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-f.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - validation/abstract/RuleAddressSet</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">42</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryHi">91.3 %</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -53,12 +53,12 @@
             <td class="headerCovTableEntry">2</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
@@ -76,41 +76,41 @@
     </tr>
 
     <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">RuleConditionalTransferLightOwnable2Step.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../amber.png" width=88 height=10 alt="87.5%"><img src="../../../snow.png" width=12 height=10 alt="87.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">87.5&nbsp;%</td>
-      <td class="coverNumMed">28 / 32</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLight.sol.gcov.html">RuleConditionalTransferLight.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">14 / 14</td>
+      <td class="coverNumHi">11 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">6 / 6</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
     </tr>
   </table>
   </center>
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-l.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-l.html
similarity index 54%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-l.html
rename to doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-l.html
index 7506cec..90bdb37 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index-sort-l.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index-sort-l.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - validation/abstract/RuleAddressSet</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">42</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryHi">91.3 %</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -53,12 +53,12 @@
             <td class="headerCovTableEntry">2</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
@@ -76,41 +76,41 @@
     </tr>
 
     <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">RuleConditionalTransferLightOwnable2Step.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../amber.png" width=88 height=10 alt="87.5%"><img src="../../../snow.png" width=12 height=10 alt="87.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">87.5&nbsp;%</td>
-      <td class="coverNumMed">28 / 32</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">5 / 5</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLight.sol.gcov.html">RuleConditionalTransferLight.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">14 / 14</td>
+      <td class="coverNumHi">11 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">6 / 6</td>
-      <td class="coverPerHi">-</td>
-      <td class="coverNumHi">0 / 0</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">2 / 2</td>
     </tr>
   </table>
   </center>
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index.html b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index.html
similarity index 54%
rename from doc/coverage/coverage/validation/abstract/RuleAddressSet/index.html
rename to doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index.html
index 4c0f604..8abcc29 100644
--- a/doc/coverage/coverage/validation/abstract/RuleAddressSet/index.html
+++ b/doc/coverage/coverage/home/ryan/Pictures/dev/Rules/src/rules/operation/index.html
@@ -4,22 +4,22 @@
 
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/abstract/RuleAddressSet</title>
-  <link rel="stylesheet" type="text/css" href="../../../gcov.css">
+  <title>LCOV - lcov.info - /home/ryan/Pictures/dev/Rules/src/rules/operation</title>
+  <link rel="stylesheet" type="text/css" href="../../../../../../../../gcov.css">
 </head>
 
 <body>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
     <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
 
     <tr>
       <td width="100%">
         <table cellpadding=1 border=0 width="100%">
           <tr>
             <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - validation/abstract/RuleAddressSet</td>
+            <td width="35%" class="headerValue"><a href="../../../../../../../../index.html">top level</a> - /home/ryan/Pictures/dev/Rules/src/rules/operation</td>
             <td width="5%"></td>
             <td width="15%"></td>
             <td width="10%" class="headerCovTableHead">Hit</td>
@@ -31,18 +31,18 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">42</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryHi">91.3 %</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntry">16</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntry">9</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
@@ -53,12 +53,12 @@
             <td class="headerCovTableEntry">2</td>
             <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
-          <tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+          <tr><td><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
         </table>
       </td>
     </tr>
 
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
   </table>
 
   <center>
@@ -76,32 +76,32 @@
     </tr>
 
     <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
+      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../../../../../../../../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
+      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
+      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../../../../../../../../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSet.sol.gcov.html">RuleAddressSet.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLight.sol.gcov.html">RuleConditionalTransferLight.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../amber.png" width=88 height=10 alt="87.5%"><img src="../../../snow.png" width=12 height=10 alt="87.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">87.5&nbsp;%</td>
-      <td class="coverNumMed">28 / 32</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">11 / 11</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">6 / 6</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="RuleAddressSetInternal.sol.gcov.html">RuleAddressSetInternal.sol</a></td>
+      <td class="coverFile"><a href="RuleConditionalTransferLightOwnable2Step.sol.gcov.html">RuleConditionalTransferLightOwnable2Step.sol</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../../../../../../../../emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">14 / 14</td>
+      <td class="coverNumHi">5 / 5</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">6 / 6</td>
+      <td class="coverNumHi">3 / 3</td>
       <td class="coverPerHi">-</td>
       <td class="coverNumHi">0 / 0</td>
     </tr>
@@ -110,7 +110,7 @@
   <br>
 
   <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
+    <tr><td class="ruler"><img src="../../../../../../../../glass.png" width=3 height=3 alt=""></td></tr>
     <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
   </table>
   <br>
diff --git a/doc/coverage/coverage/index-sort-b.html b/doc/coverage/coverage/index-sort-b.html
index 2c38638..c0fea9e 100644
--- a/doc/coverage/coverage/index-sort-b.html
+++ b/doc/coverage/coverage/index-sort-b.html
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">230</td>
-            <td class="headerCovTableEntry">253</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">66</td>
-            <td class="headerCovTableEntry">76</td>
-            <td class="headerCovTableEntryMed">86.8 %</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">65</td>
-            <td class="headerCovTableEntry">68</td>
-            <td class="headerCovTableEntryHi">95.6 %</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -82,26 +82,26 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/index.html">validation</a></td>
+      <td class="coverFile"><a href="deployment/index.html">deployment</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="amber.png" width=90 height=10 alt="89.9%"><img src="snow.png" width=10 height=10 alt="89.9%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">89.9&nbsp;%</td>
-      <td class="coverNumMed">151 / 168</td>
-      <td class="coverPerMed">84.8&nbsp;%</td>
-      <td class="coverNumMed">39 / 46</td>
-      <td class="coverPerHi">94.3&nbsp;%</td>
-      <td class="coverNumHi">50 / 53</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">112 / 112</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">68 / 68</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/RuleAddressSet/index.html">validation/abstract/RuleAddressSet</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=91 height=10 alt="91.3%"><img src="snow.png" width=9 height=10 alt="91.3%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">91.3&nbsp;%</td>
-      <td class="coverNumHi">42 / 46</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">16 / 16</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
     </tr>
@@ -111,23 +111,71 @@
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/RuleERC2980/index.html">abstract/RuleERC2980</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/RuleAddressSet/index.html">abstract/RuleAddressSet</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">52 / 52</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/core/index.html">abstract/core</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/index.html">validation/abstract</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=94 height=10 alt="93.5%"><img src="snow.png" width=6 height=10 alt="93.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">93.5&nbsp;%</td>
-      <td class="coverNumHi">29 / 31</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/base/index.html">abstract/base</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">360 / 360</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">101 / 101</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">105 / 105</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/index-sort-f.html b/doc/coverage/coverage/index-sort-f.html
index ddafc17..4733fa7 100644
--- a/doc/coverage/coverage/index-sort-f.html
+++ b/doc/coverage/coverage/index-sort-f.html
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">230</td>
-            <td class="headerCovTableEntry">253</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">66</td>
-            <td class="headerCovTableEntry">76</td>
-            <td class="headerCovTableEntryMed">86.8 %</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">65</td>
-            <td class="headerCovTableEntry">68</td>
-            <td class="headerCovTableEntryHi">95.6 %</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -82,52 +82,100 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/index.html">validation</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/modules/index.html">/home/ryan/Pictures/dev/Rules/src/modules</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="amber.png" width=90 height=10 alt="89.9%"><img src="snow.png" width=10 height=10 alt="89.9%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">89.9&nbsp;%</td>
-      <td class="coverNumMed">151 / 168</td>
-      <td class="coverPerMed">84.8&nbsp;%</td>
-      <td class="coverNumMed">39 / 46</td>
-      <td class="coverPerHi">94.3&nbsp;%</td>
-      <td class="coverNumHi">50 / 53</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/RuleAddressSet/index.html">validation/abstract/RuleAddressSet</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=91 height=10 alt="91.3%"><img src="snow.png" width=9 height=10 alt="91.3%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">91.3&nbsp;%</td>
-      <td class="coverNumHi">42 / 46</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">16 / 16</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/index.html">validation/abstract</a></td>
+      <td class="coverFile"><a href="abstract/RuleERC2980/index.html">abstract/RuleERC2980</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=94 height=10 alt="93.5%"><img src="snow.png" width=6 height=10 alt="93.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">93.5&nbsp;%</td>
-      <td class="coverNumHi">29 / 31</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/modules/index.html">/home/ryan/Pictures/dev/Rules/src/modules</a></td>
+      <td class="coverFile"><a href="abstract/core/index.html">abstract/core</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/RuleAddressSet/index.html">abstract/RuleAddressSet</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">52 / 52</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="deployment/index.html">deployment</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">112 / 112</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">68 / 68</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/base/index.html">abstract/base</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">360 / 360</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">101 / 101</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">105 / 105</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/index-sort-l.html b/doc/coverage/coverage/index-sort-l.html
index 53eb3c2..73dd95c 100644
--- a/doc/coverage/coverage/index-sort-l.html
+++ b/doc/coverage/coverage/index-sort-l.html
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">230</td>
-            <td class="headerCovTableEntry">253</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">66</td>
-            <td class="headerCovTableEntry">76</td>
-            <td class="headerCovTableEntryMed">86.8 %</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">65</td>
-            <td class="headerCovTableEntry">68</td>
-            <td class="headerCovTableEntryHi">95.6 %</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -82,52 +82,100 @@
       <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/index.html">validation</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/modules/index.html">/home/ryan/Pictures/dev/Rules/src/modules</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="amber.png" width=90 height=10 alt="89.9%"><img src="snow.png" width=10 height=10 alt="89.9%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">89.9&nbsp;%</td>
-      <td class="coverNumMed">151 / 168</td>
-      <td class="coverPerMed">84.8&nbsp;%</td>
-      <td class="coverNumMed">39 / 46</td>
-      <td class="coverPerHi">94.3&nbsp;%</td>
-      <td class="coverNumHi">50 / 53</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/RuleAddressSet/index.html">validation/abstract/RuleAddressSet</a></td>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=91 height=10 alt="91.3%"><img src="snow.png" width=9 height=10 alt="91.3%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">91.3&nbsp;%</td>
-      <td class="coverNumHi">42 / 46</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">16 / 16</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/index.html">validation/abstract</a></td>
+      <td class="coverFile"><a href="abstract/RuleERC2980/index.html">abstract/RuleERC2980</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/core/index.html">abstract/core</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=94 height=10 alt="93.5%"><img src="snow.png" width=6 height=10 alt="93.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">93.5&nbsp;%</td>
-      <td class="coverNumHi">29 / 31</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/modules/index.html">/home/ryan/Pictures/dev/Rules/src/modules</a></td>
+      <td class="coverFile"><a href="abstract/RuleAddressSet/index.html">abstract/RuleAddressSet</a></td>
       <td class="coverBar" align="center">
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">52 / 52</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">8 / 8</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">62 / 62</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="deployment/index.html">deployment</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">112 / 112</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">68 / 68</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/base/index.html">abstract/base</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">360 / 360</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">101 / 101</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">105 / 105</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/index.html b/doc/coverage/coverage/index.html
index d70aabb..209f17b 100644
--- a/doc/coverage/coverage/index.html
+++ b/doc/coverage/coverage/index.html
@@ -31,27 +31,27 @@
             <td class="headerValue">lcov.info</td>
             <td></td>
             <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">230</td>
-            <td class="headerCovTableEntry">253</td>
-            <td class="headerCovTableEntryHi">90.9 %</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntry">698</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
+            <td class="headerValue">2026-03-10 10:55:10</td>
             <td></td>
             <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">66</td>
-            <td class="headerCovTableEntry">76</td>
-            <td class="headerCovTableEntryMed">86.8 %</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntry">249</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr>
             <td></td>
             <td></td>
             <td></td>
             <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">65</td>
-            <td class="headerCovTableEntry">68</td>
-            <td class="headerCovTableEntryHi">95.6 %</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntry">155</td>
+            <td class="headerCovTableEntryHi">100.0 %</td>
           </tr>
           <tr><td><img src="glass.png" width=3 height=3 alt=""></td></tr>
         </table>
@@ -87,47 +87,95 @@
         <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">8 / 8</td>
+      <td class="coverNumHi">9 / 9</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">3 / 3</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">4 / 4</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">16 / 16</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">9 / 9</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
       <td class="coverNumHi">2 / 2</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="home/ryan/Pictures/dev/Rules/src/rules/operation/abstract/index.html">/home/ryan/Pictures/dev/Rules/src/rules/operation/abstract</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">3 / 3</td>
+      <td class="coverNumHi">62 / 62</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">18 / 18</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/index.html">validation</a></td>
+      <td class="coverFile"><a href="abstract/RuleAddressSet/index.html">abstract/RuleAddressSet</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="amber.png" width=90 height=10 alt="89.9%"><img src="snow.png" width=10 height=10 alt="89.9%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerMed">89.9&nbsp;%</td>
-      <td class="coverNumMed">151 / 168</td>
-      <td class="coverPerMed">84.8&nbsp;%</td>
-      <td class="coverNumMed">39 / 46</td>
-      <td class="coverPerHi">94.3&nbsp;%</td>
-      <td class="coverNumHi">50 / 53</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">52 / 52</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/index.html">validation/abstract</a></td>
+      <td class="coverFile"><a href="abstract/RuleERC2980/index.html">abstract/RuleERC2980</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=94 height=10 alt="93.5%"><img src="snow.png" width=6 height=10 alt="93.5%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">93.5&nbsp;%</td>
-      <td class="coverNumHi">29 / 31</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">10 / 10</td>
+      <td class="coverNumHi">36 / 36</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">12 / 12</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">8 / 8</td>
     </tr>
     <tr>
-      <td class="coverFile"><a href="validation/abstract/RuleAddressSet/index.html">validation/abstract/RuleAddressSet</a></td>
+      <td class="coverFile"><a href="abstract/base/index.html">abstract/base</a></td>
       <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=91 height=10 alt="91.3%"><img src="snow.png" width=9 height=10 alt="91.3%"></td></tr></table>
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
       </td>
-      <td class="coverPerHi">91.3&nbsp;%</td>
-      <td class="coverNumHi">42 / 46</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
       <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">2 / 2</td>
+      <td class="coverNumHi">360 / 360</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">101 / 101</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">105 / 105</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="abstract/core/index.html">abstract/core</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">51 / 51</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">19 / 19</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">14 / 14</td>
+    </tr>
+    <tr>
+      <td class="coverFile"><a href="deployment/index.html">deployment</a></td>
+      <td class="coverBar" align="center">
+        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="emerald.png" width=100 height=10 alt="100.0%"></td></tr></table>
+      </td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">112 / 112</td>
+      <td class="coverPerHi">100.0&nbsp;%</td>
+      <td class="coverNumHi">68 / 68</td>
+      <td class="coverPerHi">-</td>
+      <td class="coverNumHi">0 / 0</td>
     </tr>
   </table>
   </center>
diff --git a/doc/coverage/coverage/validation/RuleSanctionsList.sol.func-sort-c.html b/doc/coverage/coverage/validation/RuleSanctionsList.sol.func-sort-c.html
deleted file mode 100644
index 3e4edde..0000000
--- a/doc/coverage/coverage/validation/RuleSanctionsList.sol.func-sort-c.html
+++ /dev/null
@@ -1,149 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleSanctionsList.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsList.sol.gcov.html">source</a> / functions)</span></td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">54</td>
-            <td class="headerCovTableEntryHi">92.6 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">18</td>
-            <td class="headerCovTableEntry">18</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="60%" cellpadding=1 cellspacing=1 border=0>
-    <tr><td><br></td></tr>
-    <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><a href="RuleSanctionsList.sol.func.html"><img src="../updown.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></a></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></span></td>
-    </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#252">RuleSanctionsList._msgData</a></td>
-              <td class="coverFnLo">0</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#165">RuleSanctionsList.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#212">RuleSanctionsList.transferred.2</a></td>
-              <td class="coverFnHi">1</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#199">RuleSanctionsList.transferred.1</a></td>
-              <td class="coverFnHi">2</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#136">RuleSanctionsList.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#120">RuleSanctionsList.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#182">RuleSanctionsList.transferred.0</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#147">RuleSanctionsList.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#221">RuleSanctionsList.transferred.3</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#90">RuleSanctionsList.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">9</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#103">RuleSanctionsList.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">11</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#233">RuleSanctionsList._setSanctionListOracle</a></td>
-              <td class="coverFnHi">14</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#175">RuleSanctionsList.setSanctionListOracle</a></td>
-              <td class="coverFnHi">14</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#53">RuleSanctionsList.constructor</a></td>
-              <td class="coverFnHi">17</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#71">RuleSanctionsList.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">17</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#259">RuleSanctionsList._contextSuffixLength</a></td>
-              <td class="coverFnHi">30</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#245">RuleSanctionsList._msgSender</a></td>
-              <td class="coverFnHi">30</td>
-            </tr>
-  </table>
-  <br>
-  </center>
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/RuleSanctionsList.sol.func.html b/doc/coverage/coverage/validation/RuleSanctionsList.sol.func.html
deleted file mode 100644
index 03d8771..0000000
--- a/doc/coverage/coverage/validation/RuleSanctionsList.sol.func.html
+++ /dev/null
@@ -1,149 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleSanctionsList.sol - functions</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleSanctionsList.sol<span style="font-size: 80%;"> (<a href="RuleSanctionsList.sol.gcov.html">source</a> / functions)</span></td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">54</td>
-            <td class="headerCovTableEntryHi">92.6 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">15</td>
-            <td class="headerCovTableEntry">17</td>
-            <td class="headerCovTableEntryMed">88.2 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">18</td>
-            <td class="headerCovTableEntry">18</td>
-            <td class="headerCovTableEntryHi">100.0 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="60%" cellpadding=1 cellspacing=1 border=0>
-    <tr><td><br></td></tr>
-    <tr>
-      <td width="80%" class="tableHead">Function Name <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function name" title="Sort by function name" border=0></span></td>
-      <td width="20%" class="tableHead">Hit count <span class="tableHeadSort"><a href="RuleSanctionsList.sol.func-sort-c.html"><img src="../updown.png" width=10 height=14 alt="Sort by hit count" title="Sort by hit count" border=0></a></span></td>
-    </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#259">RuleSanctionsList._contextSuffixLength</a></td>
-              <td class="coverFnHi">30</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#252">RuleSanctionsList._msgData</a></td>
-              <td class="coverFnLo">0</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#245">RuleSanctionsList._msgSender</a></td>
-              <td class="coverFnHi">30</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#233">RuleSanctionsList._setSanctionListOracle</a></td>
-              <td class="coverFnHi">14</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#136">RuleSanctionsList.canReturnTransferRestrictionCode</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#53">RuleSanctionsList.constructor</a></td>
-              <td class="coverFnHi">17</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#71">RuleSanctionsList.detectTransferRestriction.0</a></td>
-              <td class="coverFnHi">17</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#90">RuleSanctionsList.detectTransferRestriction.1</a></td>
-              <td class="coverFnHi">9</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#103">RuleSanctionsList.detectTransferRestrictionFrom.0</a></td>
-              <td class="coverFnHi">11</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#120">RuleSanctionsList.detectTransferRestrictionFrom.1</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#147">RuleSanctionsList.messageForTransferRestriction</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#175">RuleSanctionsList.setSanctionListOracle</a></td>
-              <td class="coverFnHi">14</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#165">RuleSanctionsList.supportsInterface</a></td>
-              <td class="coverFnLo">0</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#182">RuleSanctionsList.transferred.0</a></td>
-              <td class="coverFnHi">3</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#199">RuleSanctionsList.transferred.1</a></td>
-              <td class="coverFnHi">2</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#212">RuleSanctionsList.transferred.2</a></td>
-              <td class="coverFnHi">1</td>
-            </tr>
-    <tr>
-              <td class="coverFn"><a href="RuleSanctionsList.sol.gcov.html#221">RuleSanctionsList.transferred.3</a></td>
-              <td class="coverFnHi">4</td>
-            </tr>
-  </table>
-  <br>
-  </center>
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.gcov.html b/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.gcov.html
deleted file mode 100644
index 325f5a0..0000000
--- a/doc/coverage/coverage/validation/RuleWhitelistWrapper.sol.gcov.html
+++ /dev/null
@@ -1,285 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation/RuleWhitelistWrapper.sol</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">validation</a> - RuleWhitelistWrapper.sol<span style="font-size: 80%;"> (source / <a href="RuleWhitelistWrapper.sol.func-sort-c.html">functions</a>)</span></td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">57</td>
-            <td class="headerCovTableEntryMed">87.7 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">9</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntryMed">81.8 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">11</td>
-            <td class="headerCovTableEntry">14</td>
-            <td class="headerCovTableEntryMed">78.6 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <table cellpadding=0 cellspacing=0 border=0>
-    <tr>
-      <td><br></td>
-    </tr>
-    <tr>
-      <td>
-<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
-<pre class="source">
-<a name="1"><span class="lineNum">       1 </span>                :            : // SPDX-License-Identifier: MPL-2.0</a>
-<a name="2"><span class="lineNum">       2 </span>                :            : </a>
-<a name="3"><span class="lineNum">       3 </span>                :            : pragma solidity ^0.8.20;</a>
-<a name="4"><span class="lineNum">       4 </span>                :            : </a>
-<a name="5"><span class="lineNum">       5 </span>                :            : /* ==== OpenZeppelin === */</a>
-<a name="6"><span class="lineNum">       6 </span>                :            : import {AccessControl} from &quot;OZ/access/AccessControl.sol&quot;;</a>
-<a name="7"><span class="lineNum">       7 </span>                :            : /* ==== Abtract contracts === */</a>
-<a name="8"><span class="lineNum">       8 </span>                :            : import {AccessControlModuleStandalone} from &quot;../../modules/AccessControlModuleStandalone.sol&quot;;</a>
-<a name="9"><span class="lineNum">       9 </span>                :            : import {MetaTxModuleStandalone, ERC2771Context, Context} from &quot;../../modules/MetaTxModuleStandalone.sol&quot;;</a>
-<a name="10"><span class="lineNum">      10 </span>                :            : import {RuleAddressSet} from &quot;./abstract/RuleAddressSet/RuleAddressSet.sol&quot;;</a>
-<a name="11"><span class="lineNum">      11 </span>                :            : import {RuleWhitelistCommon, RuleValidateTransfer} from &quot;./abstract/RuleWhitelistCommon.sol&quot;;</a>
-<a name="12"><span class="lineNum">      12 </span>                :            : /* ==== RuleEngine === */</a>
-<a name="13"><span class="lineNum">      13 </span>                :            : import {RulesManagementModule} from &quot;RuleEngine/modules/RulesManagementModule.sol&quot;;</a>
-<a name="14"><span class="lineNum">      14 </span>                :            : /* ==== CMTAT === */</a>
-<a name="15"><span class="lineNum">      15 </span>                :            : import {IERC1404, IERC1404Extend} from &quot;CMTAT/interfaces/tokenization/draft-IERC1404.sol&quot;;</a>
-<a name="16"><span class="lineNum">      16 </span>                :            : /* ==== Interfaces === */</a>
-<a name="17"><span class="lineNum">      17 </span>                :            : import {</a>
-<a name="18"><span class="lineNum">      18 </span>                :            :     IERC7943NonFungibleCompliance,</a>
-<a name="19"><span class="lineNum">      19 </span>                :            :     IERC7943NonFungibleComplianceExtend</a>
-<a name="20"><span class="lineNum">      20 </span>                :            : } from &quot;../interfaces/IERC7943NonFungibleCompliance.sol&quot;;</a>
-<a name="21"><span class="lineNum">      21 </span>                :            : </a>
-<a name="22"><span class="lineNum">      22 </span>                :            : /**</a>
-<a name="23"><span class="lineNum">      23 </span>                :            :  * @title Wrapper to call several different whitelist rules</a>
-<a name="24"><span class="lineNum">      24 </span>                :            :  */</a>
-<a name="25"><span class="lineNum">      25 </span>                :            : contract RuleWhitelistWrapper is</a>
-<a name="26"><span class="lineNum">      26 </span>                :            :     RulesManagementModule,</a>
-<a name="27"><span class="lineNum">      27 </span>                :            :     AccessControlModuleStandalone,</a>
-<a name="28"><span class="lineNum">      28 </span>                :            :     MetaTxModuleStandalone,</a>
-<a name="29"><span class="lineNum">      29 </span>                :            :     RuleWhitelistCommon</a>
-<a name="30"><span class="lineNum">      30 </span>                :            : {</a>
-<a name="31"><span class="lineNum">      31 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="32"><span class="lineNum">      32 </span>                :            :                               CONSTRUCTOR</a>
-<a name="33"><span class="lineNum">      33 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="34"><span class="lineNum">      34 </span>                :            :     /**</a>
-<a name="35"><span class="lineNum">      35 </span>                :            :      * @param admin Address of the contract (Access Control)</a>
-<a name="36"><span class="lineNum">      36 </span>                :            :      * @param forwarderIrrevocable Address of the forwarder, required for the gasless support</a>
-<a name="37"><span class="lineNum">      37 </span>                :            :      */</a>
-<a name="38"><span class="lineNum">      38 </span>                :<span class="lineCov">         22 :     constructor(address admin, address forwarderIrrevocable, bool checkSpender_)</span></a>
-<a name="39"><span class="lineNum">      39 </span>                :            :         MetaTxModuleStandalone(forwarderIrrevocable)</a>
-<a name="40"><span class="lineNum">      40 </span>                :            :         AccessControlModuleStandalone(admin)</a>
-<a name="41"><span class="lineNum">      41 </span>                :            :     {</a>
-<a name="42"><span class="lineNum">      42 </span>                :<span class="lineCov">         20 :         checkSpender = checkSpender_;</span></a>
-<a name="43"><span class="lineNum">      43 </span>                :            :     }</a>
-<a name="44"><span class="lineNum">      44 </span>                :            : </a>
-<a name="45"><span class="lineNum">      45 </span>                :            :     /* ============  View Functions ============ */</a>
-<a name="46"><span class="lineNum">      46 </span>                :            :     /**</a>
-<a name="47"><span class="lineNum">      47 </span>                :            :      * @notice Go through all the whitelist rules to know if a restriction exists on the transfer</a>
-<a name="48"><span class="lineNum">      48 </span>                :            :      * @param from the origin address</a>
-<a name="49"><span class="lineNum">      49 </span>                :            :      * @param to the destination address</a>
-<a name="50"><span class="lineNum">      50 </span>                :            :      * @return The restricion code or REJECTED_CODE_BASE.TRANSFER_OK</a>
-<a name="51"><span class="lineNum">      51 </span>                :            :      *</a>
-<a name="52"><span class="lineNum">      52 </span>                :            :      */</a>
-<a name="53"><span class="lineNum">      53 </span>                :<span class="lineCov">         21 :     function detectTransferRestriction(address from, address to, uint256 /*value*/ )</span></a>
-<a name="54"><span class="lineNum">      54 </span>                :            :         public</a>
-<a name="55"><span class="lineNum">      55 </span>                :            :         view</a>
-<a name="56"><span class="lineNum">      56 </span>                :            :         virtual</a>
-<a name="57"><span class="lineNum">      57 </span>                :            :         override(IERC1404)</a>
-<a name="58"><span class="lineNum">      58 </span>                :            :         returns (uint8)</a>
-<a name="59"><span class="lineNum">      59 </span>                :            :     {</a>
-<a name="60"><span class="lineNum">      60 </span>                :<span class="lineCov">         25 :         address[] memory targetAddress = new address[](2);</span></a>
-<a name="61"><span class="lineNum">      61 </span>                :<span class="lineCov">         25 :         targetAddress[0] = from;</span></a>
-<a name="62"><span class="lineNum">      62 </span>                :<span class="lineCov">         25 :         targetAddress[1] = to;</span></a>
-<a name="63"><span class="lineNum">      63 </span>                :            : </a>
-<a name="64"><span class="lineNum">      64 </span>                :<span class="lineCov">         25 :         bool[] memory result = _detectTransferRestriction(targetAddress);</span></a>
-<a name="65"><span class="lineNum">      65 </span>        [<span class="branchCov" title="Branch 0 was taken 9 times"> + </span><span class="branchCov" title="Branch 1 was taken 10 times"> + </span>]:<span class="lineCov">         25 :         if (!result[0]) {</span></a>
-<a name="66"><span class="lineNum">      66 </span>                :<span class="lineCov">          9 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
-<a name="67"><span class="lineNum">      67 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 10 times"> + </span>]:<span class="lineCov">         16 :         } else if (!result[1]) {</span></a>
-<a name="68"><span class="lineNum">      68 </span>                :<span class="lineCov">          6 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
-<a name="69"><span class="lineNum">      69 </span>                :            :         } else {</a>
-<a name="70"><span class="lineNum">      70 </span>                :<span class="lineCov">         10 :             return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="71"><span class="lineNum">      71 </span>                :            :         }</a>
-<a name="72"><span class="lineNum">      72 </span>                :            :     }</a>
-<a name="73"><span class="lineNum">      73 </span>                :            : </a>
-<a name="74"><span class="lineNum">      74 </span>                :<span class="lineCov">          4 :     function detectTransferRestriction(address from, address to, uint256, /* tokenId */ uint256 value)</span></a>
-<a name="75"><span class="lineNum">      75 </span>                :            :         public</a>
-<a name="76"><span class="lineNum">      76 </span>                :            :         view</a>
-<a name="77"><span class="lineNum">      77 </span>                :            :         virtual</a>
-<a name="78"><span class="lineNum">      78 </span>                :            :         override(IERC7943NonFungibleComplianceExtend)</a>
-<a name="79"><span class="lineNum">      79 </span>                :            :         returns (uint8)</a>
-<a name="80"><span class="lineNum">      80 </span>                :            :     {</a>
-<a name="81"><span class="lineNum">      81 </span>                :<span class="lineCov">          4 :         return detectTransferRestriction(from, to, value);</span></a>
-<a name="82"><span class="lineNum">      82 </span>                :            :     }</a>
-<a name="83"><span class="lineNum">      83 </span>                :            : </a>
-<a name="84"><span class="lineNum">      84 </span>                :<span class="lineCov">         10 :     function detectTransferRestrictionFrom(address spender, address from, address to, uint256 value)</span></a>
-<a name="85"><span class="lineNum">      85 </span>                :            :         public</a>
-<a name="86"><span class="lineNum">      86 </span>                :            :         view</a>
-<a name="87"><span class="lineNum">      87 </span>                :            :         virtual</a>
-<a name="88"><span class="lineNum">      88 </span>                :            :         override(IERC1404Extend)</a>
-<a name="89"><span class="lineNum">      89 </span>                :            :         returns (uint8)</a>
-<a name="90"><span class="lineNum">      90 </span>                :            :     {</a>
-<a name="91"><span class="lineNum">      91 </span>           [<span class="branchNoExec" title="Branch 0 was not executed"> # </span>]:<span class="lineCov">         12 :         if (!checkSpender) {</span></a>
-<a name="92"><span class="lineNum">      92 </span>                :<span class="lineNoCov">          0 :             return detectTransferRestriction(from, to, value);</span></a>
-<a name="93"><span class="lineNum">      93 </span>                :            :         }</a>
-<a name="94"><span class="lineNum">      94 </span>                :            : </a>
-<a name="95"><span class="lineNum">      95 </span>                :<span class="lineCov">         12 :         address[] memory targetAddress = new address[](3);</span></a>
-<a name="96"><span class="lineNum">      96 </span>                :<span class="lineCov">         12 :         targetAddress[0] = from;</span></a>
-<a name="97"><span class="lineNum">      97 </span>                :<span class="lineCov">         12 :         targetAddress[1] = to;</span></a>
-<a name="98"><span class="lineNum">      98 </span>                :<span class="lineCov">         12 :         targetAddress[2] = spender;</span></a>
-<a name="99"><span class="lineNum">      99 </span>                :            : </a>
-<a name="100"><span class="lineNum">     100 </span>                :<span class="lineCov">         12 :         bool[] memory result = _detectTransferRestriction(targetAddress);</span></a>
-<a name="101"><span class="lineNum">     101 </span>                :            : </a>
-<a name="102"><span class="lineNum">     102 </span>        [<span class="branchNoExec" title="Branch 0 was not executed"> # </span><span class="branchCov" title="Branch 1 was taken 6 times"> + </span>]:<span class="lineCov">         12 :         if (!result[0]) {</span></a>
-<a name="103"><span class="lineNum">     103 </span>                :<span class="lineNoCov">          0 :             return CODE_ADDRESS_FROM_NOT_WHITELISTED;</span></a>
-<a name="104"><span class="lineNum">     104 </span>        [<span class="branchNoExec" title="Branch 0 was not executed"> # </span><span class="branchCov" title="Branch 1 was taken 6 times"> + </span>]:<span class="lineCov">         12 :         } else if (!result[1]) {</span></a>
-<a name="105"><span class="lineNum">     105 </span>                :<span class="lineNoCov">          0 :             return CODE_ADDRESS_TO_NOT_WHITELISTED;</span></a>
-<a name="106"><span class="lineNum">     106 </span>        [<span class="branchCov" title="Branch 0 was taken 6 times"> + </span><span class="branchCov" title="Branch 1 was taken 6 times"> + </span>]:<span class="lineCov">         12 :         } else if (!result[2]) {</span></a>
-<a name="107"><span class="lineNum">     107 </span>                :<span class="lineCov">          6 :             return CODE_ADDRESS_SPENDER_NOT_WHITELISTED;</span></a>
-<a name="108"><span class="lineNum">     108 </span>                :            :         } else {</a>
-<a name="109"><span class="lineNum">     109 </span>                :<span class="lineCov">          6 :             return uint8(REJECTED_CODE_BASE.TRANSFER_OK);</span></a>
-<a name="110"><span class="lineNum">     110 </span>                :            :         }</a>
-<a name="111"><span class="lineNum">     111 </span>                :            :     }</a>
-<a name="112"><span class="lineNum">     112 </span>                :            : </a>
-<a name="113"><span class="lineNum">     113 </span>                :            :     /**</a>
-<a name="114"><span class="lineNum">     114 </span>                :            :      * @inheritdoc IERC7943NonFungibleComplianceExtend</a>
-<a name="115"><span class="lineNum">     115 </span>                :            :      */</a>
-<a name="116"><span class="lineNum">     116 </span>                :<span class="lineCov">          2 :     function detectTransferRestrictionFrom(</span></a>
-<a name="117"><span class="lineNum">     117 </span>                :            :         address spender,</a>
-<a name="118"><span class="lineNum">     118 </span>                :            :         address from,</a>
-<a name="119"><span class="lineNum">     119 </span>                :            :         address to,</a>
-<a name="120"><span class="lineNum">     120 </span>                :            :         uint256, /* tokenId */</a>
-<a name="121"><span class="lineNum">     121 </span>                :            :         uint256 value</a>
-<a name="122"><span class="lineNum">     122 </span>                :            :     ) public view virtual override(IERC7943NonFungibleComplianceExtend) returns (uint8) {</a>
-<a name="123"><span class="lineNum">     123 </span>                :<span class="lineCov">          2 :         return detectTransferRestrictionFrom(spender, from, to, value);</span></a>
-<a name="124"><span class="lineNum">     124 </span>                :            :     }</a>
-<a name="125"><span class="lineNum">     125 </span>                :            : </a>
-<a name="126"><span class="lineNum">     126 </span>                :            :     /* ============  Access control ============ */</a>
-<a name="127"><span class="lineNum">     127 </span>                :            : </a>
-<a name="128"><span class="lineNum">     128 </span>                :            :     /**</a>
-<a name="129"><span class="lineNum">     129 </span>                :            :      * @dev Returns `true` if `account` has been granted `role`.</a>
-<a name="130"><span class="lineNum">     130 </span>                :            :      */</a>
-<a name="131"><span class="lineNum">     131 </span>                :<span class="lineCov">         20 :     function hasRole(bytes32 role, address account)</span></a>
-<a name="132"><span class="lineNum">     132 </span>                :            :         public</a>
-<a name="133"><span class="lineNum">     133 </span>                :            :         view</a>
-<a name="134"><span class="lineNum">     134 </span>                :            :         virtual</a>
-<a name="135"><span class="lineNum">     135 </span>                :            :         override(AccessControl, AccessControlModuleStandalone)</a>
-<a name="136"><span class="lineNum">     136 </span>                :            :         returns (bool)</a>
-<a name="137"><span class="lineNum">     137 </span>                :            :     {</a>
-<a name="138"><span class="lineNum">     138 </span>                :<span class="lineCov">         80 :         return AccessControlModuleStandalone.hasRole(role, account);</span></a>
-<a name="139"><span class="lineNum">     139 </span>                :            :     }</a>
-<a name="140"><span class="lineNum">     140 </span>                :            : </a>
-<a name="141"><span class="lineNum">     141 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="142"><span class="lineNum">     142 </span>                :            :                             INTERNAL/PRIVATE FUNCTIONS</a>
-<a name="143"><span class="lineNum">     143 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="144"><span class="lineNum">     144 </span>                :            : </a>
-<a name="145"><span class="lineNum">     145 </span>                :<span class="lineCov">         37 :     function _detectTransferRestriction(address[] memory targetAddress) internal view returns (bool[] memory) {</span></a>
-<a name="146"><span class="lineNum">     146 </span>                :<span class="lineCov">         37 :         uint256 rulesLength = rulesCount();</span></a>
-<a name="147"><span class="lineNum">     147 </span>                :<span class="lineCov">         37 :         bool[] memory result = new bool[](targetAddress.length);</span></a>
-<a name="148"><span class="lineNum">     148 </span>                :<span class="lineCov">         37 :         for (uint256 i = 0; i &lt; rulesLength; ++i) {</span></a>
-<a name="149"><span class="lineNum">     149 </span>                :            :             // Call the whitelist rules</a>
-<a name="150"><span class="lineNum">     150 </span>                :<span class="lineCov">         81 :             bool[] memory isListed = RuleAddressSet(rule(i)).areAddressesListed(targetAddress);</span></a>
-<a name="151"><span class="lineNum">     151 </span>                :<span class="lineCov">         81 :             for (uint256 j = 0; j &lt; targetAddress.length; ++j) {</span></a>
-<a name="152"><span class="lineNum">     152 </span>           [<span class="branchCov" title="Branch 0 was taken 58 times"> + </span>]:<span class="lineCov">         58 :                 if (isListed[j]) {</span></a>
-<a name="153"><span class="lineNum">     153 </span>                :<span class="lineCov">         58 :                     result[j] = true;</span></a>
-<a name="154"><span class="lineNum">     154 </span>                :            :                 }</a>
-<a name="155"><span class="lineNum">     155 </span>                :            :             }</a>
-<a name="156"><span class="lineNum">     156 </span>                :            : </a>
-<a name="157"><span class="lineNum">     157 </span>                :            :             // Break early if all listed</a>
-<a name="158"><span class="lineNum">     158 </span>                :<span class="lineCov">         81 :             bool allListed = true;</span></a>
-<a name="159"><span class="lineNum">     159 </span>                :<span class="lineCov">         81 :             for (uint256 k = 0; k &lt; result.length; ++k) {</span></a>
-<a name="160"><span class="lineNum">     160 </span>           [<span class="branchCov" title="Branch 0 was taken 65 times"> + </span>]:<span class="lineCov">        159 :                 if (!result[k]) {</span></a>
-<a name="161"><span class="lineNum">     161 </span>                :<span class="lineCov">         65 :                     allListed = false;</span></a>
-<a name="162"><span class="lineNum">     162 </span>                :<span class="lineCov">         65 :                     break;</span></a>
-<a name="163"><span class="lineNum">     163 </span>                :            :                 }</a>
-<a name="164"><span class="lineNum">     164 </span>                :            :             }</a>
-<a name="165"><span class="lineNum">     165 </span>           [<span class="branchCov" title="Branch 0 was taken 16 times"> + </span>]:<span class="lineCov">         16 :             if (allListed) {</span></a>
-<a name="166"><span class="lineNum">     166 </span>                :<span class="lineCov">         16 :                 break;</span></a>
-<a name="167"><span class="lineNum">     167 </span>                :            :             }</a>
-<a name="168"><span class="lineNum">     168 </span>                :            :         }</a>
-<a name="169"><span class="lineNum">     169 </span>                :<span class="lineCov">         37 :         return result;</span></a>
-<a name="170"><span class="lineNum">     170 </span>                :            :     }</a>
-<a name="171"><span class="lineNum">     171 </span>                :            : </a>
-<a name="172"><span class="lineNum">     172 </span>                :<span class="lineNoCov">          0 :     function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControl, RuleValidateTransfer) returns (bool) {</span></a>
-<a name="173"><span class="lineNum">     173 </span>                :<span class="lineNoCov">          0 :         return AccessControl.supportsInterface(interfaceId) || RuleValidateTransfer.supportsInterface(interfaceId);</span></a>
-<a name="174"><span class="lineNum">     174 </span>                :            :     }</a>
-<a name="175"><span class="lineNum">     175 </span>                :            : </a>
-<a name="176"><span class="lineNum">     176 </span>                :            :     /*//////////////////////////////////////////////////////////////</a>
-<a name="177"><span class="lineNum">     177 </span>                :            :                            ERC-2771</a>
-<a name="178"><span class="lineNum">     178 </span>                :            :     //////////////////////////////////////////////////////////////*/</a>
-<a name="179"><span class="lineNum">     179 </span>                :            : </a>
-<a name="180"><span class="lineNum">     180 </span>                :            :     /**</a>
-<a name="181"><span class="lineNum">     181 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="182"><span class="lineNum">     182 </span>                :            :      */</a>
-<a name="183"><span class="lineNum">     183 </span>                :<span class="lineCov">         80 :     function _msgSender() internal view override(ERC2771Context, Context) returns (address sender) {</span></a>
-<a name="184"><span class="lineNum">     184 </span>                :<span class="lineCov">         80 :         return ERC2771Context._msgSender();</span></a>
-<a name="185"><span class="lineNum">     185 </span>                :            :     }</a>
-<a name="186"><span class="lineNum">     186 </span>                :            : </a>
-<a name="187"><span class="lineNum">     187 </span>                :            :     /**</a>
-<a name="188"><span class="lineNum">     188 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="189"><span class="lineNum">     189 </span>                :            :      */</a>
-<a name="190"><span class="lineNum">     190 </span>                :<span class="lineNoCov">          0 :     function _msgData() internal view override(ERC2771Context, Context) returns (bytes calldata) {</span></a>
-<a name="191"><span class="lineNum">     191 </span>                :<span class="lineNoCov">          0 :         return ERC2771Context._msgData();</span></a>
-<a name="192"><span class="lineNum">     192 </span>                :            :     }</a>
-<a name="193"><span class="lineNum">     193 </span>                :            : </a>
-<a name="194"><span class="lineNum">     194 </span>                :            :     /**</a>
-<a name="195"><span class="lineNum">     195 </span>                :            :      * @dev This surcharge is not necessary if you do not use the MetaTxModule</a>
-<a name="196"><span class="lineNum">     196 </span>                :            :      */</a>
-<a name="197"><span class="lineNum">     197 </span>                :<span class="lineCov">         80 :     function _contextSuffixLength() internal view override(ERC2771Context, Context) returns (uint256) {</span></a>
-<a name="198"><span class="lineNum">     198 </span>                :<span class="lineCov">         80 :         return ERC2771Context._contextSuffixLength();</span></a>
-<a name="199"><span class="lineNum">     199 </span>                :            :     }</a>
-<a name="200"><span class="lineNum">     200 </span>                :            : }</a>
-</pre>
-      </td>
-    </tr>
-  </table>
-  <br>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov" target="_parent">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/index-sort-b.html b/doc/coverage/coverage/validation/index-sort-b.html
deleted file mode 100644
index 944c1e9..0000000
--- a/doc/coverage/coverage/validation/index-sort-b.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - validation</td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">151</td>
-            <td class="headerCovTableEntry">168</td>
-            <td class="headerCovTableEntryMed">89.9 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">39</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryMed">84.8 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">53</td>
-            <td class="headerCovTableEntryHi">94.3 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="80%" cellpadding=1 cellspacing=1 border=0>
-
-    <tr>
-      <td width="44%"><br></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-    </tr>
-
-    <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></span></td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=88 height=10 alt="87.7%"><img src="../snow.png" width=12 height=10 alt="87.7%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">87.7&nbsp;%</td>
-      <td class="coverNumMed">50 / 57</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
-      <td class="coverPerMed">78.6&nbsp;%</td>
-      <td class="coverNumMed">11 / 14</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=80 height=10 alt="80.0%"><img src="../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">16 / 20</td>
-      <td class="coverPerLo">71.4&nbsp;%</td>
-      <td class="coverNumLo">5 / 7</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">5 / 5</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=95 height=10 alt="94.6%"><img src="../snow.png" width=5 height=10 alt="94.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">94.6&nbsp;%</td>
-      <td class="coverNumHi">35 / 37</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">16 / 16</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=93 height=10 alt="92.6%"><img src="../snow.png" width=7 height=10 alt="92.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">92.6&nbsp;%</td>
-      <td class="coverNumHi">50 / 54</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">18 / 18</td>
-    </tr>
-  </table>
-  </center>
-  <br>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/index-sort-f.html b/doc/coverage/coverage/validation/index-sort-f.html
deleted file mode 100644
index 803ea1c..0000000
--- a/doc/coverage/coverage/validation/index-sort-f.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - validation</td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">151</td>
-            <td class="headerCovTableEntry">168</td>
-            <td class="headerCovTableEntryMed">89.9 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">39</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryMed">84.8 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">53</td>
-            <td class="headerCovTableEntryHi">94.3 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="80%" cellpadding=1 cellspacing=1 border=0>
-
-    <tr>
-      <td width="44%"><br></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-    </tr>
-
-    <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=80 height=10 alt="80.0%"><img src="../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">16 / 20</td>
-      <td class="coverPerLo">71.4&nbsp;%</td>
-      <td class="coverNumLo">5 / 7</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">5 / 5</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=88 height=10 alt="87.7%"><img src="../snow.png" width=12 height=10 alt="87.7%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">87.7&nbsp;%</td>
-      <td class="coverNumMed">50 / 57</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
-      <td class="coverPerMed">78.6&nbsp;%</td>
-      <td class="coverNumMed">11 / 14</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=93 height=10 alt="92.6%"><img src="../snow.png" width=7 height=10 alt="92.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">92.6&nbsp;%</td>
-      <td class="coverNumHi">50 / 54</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">18 / 18</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=95 height=10 alt="94.6%"><img src="../snow.png" width=5 height=10 alt="94.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">94.6&nbsp;%</td>
-      <td class="coverNumHi">35 / 37</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">16 / 16</td>
-    </tr>
-  </table>
-  </center>
-  <br>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/index-sort-l.html b/doc/coverage/coverage/validation/index-sort-l.html
deleted file mode 100644
index b4d9395..0000000
--- a/doc/coverage/coverage/validation/index-sort-l.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - validation</td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">151</td>
-            <td class="headerCovTableEntry">168</td>
-            <td class="headerCovTableEntryMed">89.9 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">39</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryMed">84.8 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">53</td>
-            <td class="headerCovTableEntryHi">94.3 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="80%" cellpadding=1 cellspacing=1 border=0>
-
-    <tr>
-      <td width="44%"><br></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-    </tr>
-
-    <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><a href="index.html"><img src="../updown.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></a></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=80 height=10 alt="80.0%"><img src="../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">16 / 20</td>
-      <td class="coverPerLo">71.4&nbsp;%</td>
-      <td class="coverNumLo">5 / 7</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">5 / 5</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=88 height=10 alt="87.7%"><img src="../snow.png" width=12 height=10 alt="87.7%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">87.7&nbsp;%</td>
-      <td class="coverNumMed">50 / 57</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
-      <td class="coverPerMed">78.6&nbsp;%</td>
-      <td class="coverNumMed">11 / 14</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=93 height=10 alt="92.6%"><img src="../snow.png" width=7 height=10 alt="92.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">92.6&nbsp;%</td>
-      <td class="coverNumHi">50 / 54</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">18 / 18</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=95 height=10 alt="94.6%"><img src="../snow.png" width=5 height=10 alt="94.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">94.6&nbsp;%</td>
-      <td class="coverNumHi">35 / 37</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">16 / 16</td>
-    </tr>
-  </table>
-  </center>
-  <br>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/coverage/validation/index.html b/doc/coverage/coverage/validation/index.html
deleted file mode 100644
index bffbd19..0000000
--- a/doc/coverage/coverage/validation/index.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html lang="en">
-
-<head>
-  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-  <title>LCOV - lcov.info - validation</title>
-  <link rel="stylesheet" type="text/css" href="../gcov.css">
-</head>
-
-<body>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="title">LCOV - code coverage report</td></tr>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-
-    <tr>
-      <td width="100%">
-        <table cellpadding=1 border=0 width="100%">
-          <tr>
-            <td width="10%" class="headerItem">Current view:</td>
-            <td width="35%" class="headerValue"><a href="../index.html">top level</a> - validation</td>
-            <td width="5%"></td>
-            <td width="15%"></td>
-            <td width="10%" class="headerCovTableHead">Hit</td>
-            <td width="10%" class="headerCovTableHead">Total</td>
-            <td width="15%" class="headerCovTableHead">Coverage</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Test:</td>
-            <td class="headerValue">lcov.info</td>
-            <td></td>
-            <td class="headerItem">Lines:</td>
-            <td class="headerCovTableEntry">151</td>
-            <td class="headerCovTableEntry">168</td>
-            <td class="headerCovTableEntryMed">89.9 %</td>
-          </tr>
-          <tr>
-            <td class="headerItem">Date:</td>
-            <td class="headerValue">2025-12-03 15:05:37</td>
-            <td></td>
-            <td class="headerItem">Functions:</td>
-            <td class="headerCovTableEntry">39</td>
-            <td class="headerCovTableEntry">46</td>
-            <td class="headerCovTableEntryMed">84.8 %</td>
-          </tr>
-          <tr>
-            <td></td>
-            <td></td>
-            <td></td>
-            <td class="headerItem">Branches:</td>
-            <td class="headerCovTableEntry">50</td>
-            <td class="headerCovTableEntry">53</td>
-            <td class="headerCovTableEntryHi">94.3 %</td>
-          </tr>
-          <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-        </table>
-      </td>
-    </tr>
-
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-  </table>
-
-  <center>
-  <table width="80%" cellpadding=1 cellspacing=1 border=0>
-
-    <tr>
-      <td width="44%"><br></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-      <td width="8%"></td>
-    </tr>
-
-    <tr>
-      <td class="tableHead">Filename <span class="tableHeadSort"><img src="../glass.png" width=10 height=14 alt="Sort by name" title="Sort by name" border=0></span></td>
-      <td class="tableHead" colspan=3>Line Coverage <span class="tableHeadSort"><a href="index-sort-l.html"><img src="../updown.png" width=10 height=14 alt="Sort by line coverage" title="Sort by line coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Functions <span class="tableHeadSort"><a href="index-sort-f.html"><img src="../updown.png" width=10 height=14 alt="Sort by function coverage" title="Sort by function coverage" border=0></a></span></td>
-      <td class="tableHead" colspan=2>Branches <span class="tableHeadSort"><a href="index-sort-b.html"><img src="../updown.png" width=10 height=14 alt="Sort by branch coverage" title="Sort by branch coverage" border=0></a></span></td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleBlacklist.sol.gcov.html">RuleBlacklist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=95 height=10 alt="94.6%"><img src="../snow.png" width=5 height=10 alt="94.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">94.6&nbsp;%</td>
-      <td class="coverNumHi">35 / 37</td>
-      <td class="coverPerHi">90.9&nbsp;%</td>
-      <td class="coverNumHi">10 / 11</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">16 / 16</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleSanctionsList.sol.gcov.html">RuleSanctionsList.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../emerald.png" width=93 height=10 alt="92.6%"><img src="../snow.png" width=7 height=10 alt="92.6%"></td></tr></table>
-      </td>
-      <td class="coverPerHi">92.6&nbsp;%</td>
-      <td class="coverNumHi">50 / 54</td>
-      <td class="coverPerMed">88.2&nbsp;%</td>
-      <td class="coverNumMed">15 / 17</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">18 / 18</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelist.sol.gcov.html">RuleWhitelist.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=80 height=10 alt="80.0%"><img src="../snow.png" width=20 height=10 alt="80.0%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">80.0&nbsp;%</td>
-      <td class="coverNumMed">16 / 20</td>
-      <td class="coverPerLo">71.4&nbsp;%</td>
-      <td class="coverNumLo">5 / 7</td>
-      <td class="coverPerHi">100.0&nbsp;%</td>
-      <td class="coverNumHi">5 / 5</td>
-    </tr>
-    <tr>
-      <td class="coverFile"><a href="RuleWhitelistWrapper.sol.gcov.html">RuleWhitelistWrapper.sol</a></td>
-      <td class="coverBar" align="center">
-        <table border=0 cellspacing=0 cellpadding=1><tr><td class="coverBarOutline"><img src="../amber.png" width=88 height=10 alt="87.7%"><img src="../snow.png" width=12 height=10 alt="87.7%"></td></tr></table>
-      </td>
-      <td class="coverPerMed">87.7&nbsp;%</td>
-      <td class="coverNumMed">50 / 57</td>
-      <td class="coverPerMed">81.8&nbsp;%</td>
-      <td class="coverNumMed">9 / 11</td>
-      <td class="coverPerMed">78.6&nbsp;%</td>
-      <td class="coverNumMed">11 / 14</td>
-    </tr>
-  </table>
-  </center>
-  <br>
-
-  <table width="100%" border=0 cellspacing=0 cellpadding=0>
-    <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
-    <tr><td class="versionInfo">Generated by: <a href="https://github.com/linux-test-project/lcov">LCOV version 1.16</a></td></tr>
-  </table>
-  <br>
-
-</body>
-</html>
diff --git a/doc/coverage/lcov.info b/doc/coverage/lcov.info
index 3c88298..f8b64c2 100644
--- a/doc/coverage/lcov.info
+++ b/doc/coverage/lcov.info
@@ -1,550 +1,1261 @@
 TN:
 SF:src/modules/AccessControlModuleStandalone.sol
-DA:22,161
-FN:22,AccessControlModuleStandalone.constructor
-FNDA:161,AccessControlModuleStandalone.constructor
-DA:23,161
-BRDA:23,0,0,4
-DA:24,4
-DA:29,157
-DA:38,228
+DA:24,396
+FN:24,AccessControlModuleStandalone.constructor
+FNDA:396,AccessControlModuleStandalone.constructor
+DA:25,396
+BRDA:25,0,0,5
+BRDA:25,0,1,391
+DA:29,391
+DA:38,507
 FN:38,AccessControlModuleStandalone.hasRole
-FNDA:228,AccessControlModuleStandalone.hasRole
-DA:40,328
-BRDA:40,1,0,152
-BRDA:40,1,1,176
-DA:41,152
-DA:43,176
+FNDA:507,AccessControlModuleStandalone.hasRole
+DA:47,3597
+BRDA:47,1,0,3110
+BRDA:47,1,1,487
+DA:48,3110
+DA:50,487
 FNF:2
 FNH:2
-LF:8
-LH:8
-BRF:3
-BRH:3
-end_of_record
-TN:
-SF:src/rules/validation/RuleBlacklist.sol
-DA:41,22
-FN:41,RuleBlacklist.detectTransferRestriction.0
-FNDA:22,RuleBlacklist.detectTransferRestriction.0
-DA:47,43
-BRDA:47,0,0,14
-BRDA:47,0,1,16
-DA:48,14
-DA:49,29
-BRDA:49,1,0,13
-BRDA:49,1,1,16
-DA:50,13
-DA:52,16
-DA:59,7
-FN:59,RuleBlacklist.detectTransferRestriction.1
-FNDA:7,RuleBlacklist.detectTransferRestriction.1
-DA:65,7
-DA:71,16
-FN:71,RuleBlacklist.detectTransferRestrictionFrom.0
-FNDA:16,RuleBlacklist.detectTransferRestrictionFrom.0
-DA:77,20
-BRDA:77,2,0,6
-BRDA:77,2,1,14
-DA:78,6
-DA:80,14
-DA:87,4
-FN:87,RuleBlacklist.detectTransferRestrictionFrom.1
-FNDA:4,RuleBlacklist.detectTransferRestrictionFrom.1
-DA:94,4
-DA:103,4
-FN:103,RuleBlacklist.canReturnTransferRestrictionCode
-FNDA:4,RuleBlacklist.canReturnTransferRestrictionCode
-DA:110,4
-DA:111,2
-DA:120,8
-FN:120,RuleBlacklist.messageForTransferRestriction
-FNDA:8,RuleBlacklist.messageForTransferRestriction
-DA:127,8
-BRDA:127,3,0,3
-BRDA:127,3,1,2
-DA:128,3
-DA:129,5
-BRDA:129,4,0,2
-BRDA:129,4,1,2
-DA:130,2
-DA:131,3
-BRDA:131,5,0,1
-BRDA:131,5,1,2
-DA:132,1
+LF:7
+LH:7
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/modules/VersionModule.sol
+DA:14,7
+FN:14,VersionModule.version
+FNDA:7,VersionModule.version
+DA:15,7
+FNF:1
+FNH:1
+LF:2
+LH:2
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/operation/RuleConditionalTransferLight.sol
+DA:27,18
+FN:27,RuleConditionalTransferLight.supportsInterface
+FNDA:18,RuleConditionalTransferLight.supportsInterface
+DA:34,18
+DA:35,11
+DA:38,1
+FN:38,RuleConditionalTransferLight.created
+FNDA:1,RuleConditionalTransferLight.created
+DA:39,1
+DA:42,1
+FN:42,RuleConditionalTransferLight.destroyed
+FNDA:1,RuleConditionalTransferLight.destroyed
+DA:43,1
+DA:46,1947
+FN:46,RuleConditionalTransferLight._authorizeTransferApproval
+FNDA:1947,RuleConditionalTransferLight._authorizeTransferApproval
+DA:48,857
+FN:48,RuleConditionalTransferLight._authorizeTransferExecution
+FNDA:857,RuleConditionalTransferLight._authorizeTransferExecution
+DA:49,857
+BRDA:49,0,0,1
+BRDA:49,0,1,856
+DA:55,19
+FN:55,RuleConditionalTransferLight._onlyComplianceManager
+FNDA:19,RuleConditionalTransferLight._onlyComplianceManager
+FNF:6
+FNH:6
+LF:11
+LH:11
+BRF:2
+BRH:2
+end_of_record
+TN:
+SF:src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol
+DA:21,4
+FN:21,RuleConditionalTransferLightOwnable2Step.supportsInterface
+FNDA:4,RuleConditionalTransferLightOwnable2Step.supportsInterface
+DA:22,4
+DA:23,2
+DA:26,4
+FN:26,RuleConditionalTransferLightOwnable2Step._authorizeTransferApproval
+FNDA:4,RuleConditionalTransferLightOwnable2Step._authorizeTransferApproval
+DA:28,3
+FN:28,RuleConditionalTransferLightOwnable2Step._authorizeTransferExecution
+FNDA:3,RuleConditionalTransferLightOwnable2Step._authorizeTransferExecution
+FNF:3
+FNH:3
+LF:5
+LH:5
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/operation/abstract/RuleConditionalTransferLightBase.sol
+DA:25,1940
+FN:25,RuleConditionalTransferLightBase.approveTransfer
+FNDA:1940,RuleConditionalTransferLightBase.approveTransfer
+DA:26,1941
+DA:27,1941
+DA:28,1941
+DA:31,4
+FN:31,RuleConditionalTransferLightBase.cancelTransferApproval
+FNDA:4,RuleConditionalTransferLightBase.cancelTransferApproval
+DA:32,3
+DA:33,3
+DA:34,3
+BRDA:34,0,0,1
+BRDA:34,0,1,2
+DA:35,2
+DA:36,2
+DA:45,4
+FN:45,RuleConditionalTransferLightBase.approveAndTransferIfAllowed
+FNDA:4,RuleConditionalTransferLightBase.approveAndTransferIfAllowed
+DA:50,4
+BRDA:50,1,0,1
+BRDA:50,1,1,3
+DA:52,3
+DA:54,3
+DA:55,3
+BRDA:55,2,0,1
+BRDA:55,2,1,2
+DA:60,2
+DA:61,2
+BRDA:61,3,0,1
+BRDA:61,3,1,1
+DA:62,1
+DA:65,264
+FN:65,RuleConditionalTransferLightBase.approvedCount
+FNDA:264,RuleConditionalTransferLightBase.approvedCount
+DA:66,264
+DA:67,264
+DA:70,856
+FN:70,RuleConditionalTransferLightBase.transferred.0
+FNDA:856,RuleConditionalTransferLightBase.transferred.0
+DA:75,854
+DA:78,1
+FN:78,RuleConditionalTransferLightBase.transferred.1
+FNDA:1,RuleConditionalTransferLightBase.transferred.1
+DA:83,1
+DA:86,7
+FN:86,RuleConditionalTransferLightBase.detectTransferRestriction
+FNDA:7,RuleConditionalTransferLightBase.detectTransferRestriction
+DA:92,13
+BRDA:92,4,0,4
+DA:93,4
+DA:95,9
+DA:96,9
+BRDA:96,5,0,6
+DA:97,6
+DA:99,3
+DA:102,1
+FN:102,RuleConditionalTransferLightBase.detectTransferRestrictionFrom
+FNDA:1,RuleConditionalTransferLightBase.detectTransferRestrictionFrom
+DA:108,2
+DA:111,4
+FN:111,RuleConditionalTransferLightBase.canTransfer
+FNDA:4,RuleConditionalTransferLightBase.canTransfer
+DA:117,4
+DA:120,1
+FN:120,RuleConditionalTransferLightBase.canTransferFrom
+FNDA:1,RuleConditionalTransferLightBase.canTransferFrom
+DA:126,1
+DA:130,1
+FN:130,RuleConditionalTransferLightBase.canReturnTransferRestrictionCode
+FNDA:1,RuleConditionalTransferLightBase.canReturnTransferRestrictionCode
+DA:131,1
 DA:134,2
-DA:138,0
-FN:138,RuleBlacklist.supportsInterface
-FNDA:0,RuleBlacklist.supportsInterface
-DA:139,0
-DA:144,9
-FN:144,RuleBlacklist.transferred.0
-FNDA:9,RuleBlacklist.transferred.0
-DA:150,12
-DA:151,12
-BRDA:151,6,0,8
-BRDA:151,6,1,4
-DA:157,2
-FN:157,RuleBlacklist.transferred.1
-FNDA:2,RuleBlacklist.transferred.1
-DA:163,4
-DA:164,4
-BRDA:164,7,0,2
-BRDA:164,7,1,2
-DA:170,2
-FN:170,RuleBlacklist.transferred.2
-FNDA:2,RuleBlacklist.transferred.2
-DA:176,2
-DA:179,3
-FN:179,RuleBlacklist.transferred.3
-FNDA:3,RuleBlacklist.transferred.3
-DA:185,3
-FNF:11
-FNH:10
-LF:37
-LH:35
-BRF:16
-BRH:16
-end_of_record
-TN:
-SF:src/rules/validation/RuleSanctionsList.sol
-DA:55,17
-FN:55,RuleSanctionsList.constructor
-FNDA:17,RuleSanctionsList.constructor
-DA:59,16
-BRDA:59,0,0,1
-DA:60,1
-DA:73,17
-FN:73,RuleSanctionsList.detectTransferRestriction.0
-FNDA:17,RuleSanctionsList.detectTransferRestriction.0
-DA:79,35
-BRDA:79,1,0,30
-DA:80,30
-BRDA:80,2,0,6
-BRDA:80,2,1,14
-DA:81,6
-DA:82,24
-BRDA:82,3,0,10
-DA:83,10
-DA:86,19
-DA:92,9
-FN:92,RuleSanctionsList.detectTransferRestriction.1
-FNDA:9,RuleSanctionsList.detectTransferRestriction.1
-DA:99,9
-DA:105,11
-FN:105,RuleSanctionsList.detectTransferRestrictionFrom.0
-FNDA:11,RuleSanctionsList.detectTransferRestrictionFrom.0
-DA:112,14
-BRDA:112,4,0,13
-DA:113,13
-BRDA:113,5,0,4
-BRDA:113,5,1,9
-DA:114,4
-DA:116,9
-DA:119,1
-DA:122,3
-FN:122,RuleSanctionsList.detectTransferRestrictionFrom.1
-FNDA:3,RuleSanctionsList.detectTransferRestrictionFrom.1
-DA:129,3
-DA:138,3
-FN:138,RuleSanctionsList.canReturnTransferRestrictionCode
-FNDA:3,RuleSanctionsList.canReturnTransferRestrictionCode
-DA:139,3
-DA:140,1
-DA:149,4
-FN:149,RuleSanctionsList.messageForTransferRestriction
-FNDA:4,RuleSanctionsList.messageForTransferRestriction
-DA:156,4
-BRDA:156,6,0,1
-BRDA:156,6,1,1
-DA:157,1
-DA:158,3
-BRDA:158,7,0,1
-BRDA:158,7,1,1
-DA:159,1
-DA:160,2
-BRDA:160,8,0,1
-BRDA:160,8,1,1
-DA:161,1
-DA:163,1
-DA:167,0
-FN:167,RuleSanctionsList.supportsInterface
-FNDA:0,RuleSanctionsList.supportsInterface
-DA:168,0
-DA:177,14
-FN:177,RuleSanctionsList.setSanctionListOracle
-FNDA:14,RuleSanctionsList.setSanctionListOracle
-DA:178,13
-DA:184,3
-FN:184,RuleSanctionsList.transferred.0
-FNDA:3,RuleSanctionsList.transferred.0
-DA:190,7
-DA:191,7
-BRDA:191,9,0,4
-BRDA:191,9,1,3
-DA:201,2
-FN:201,RuleSanctionsList.transferred.1
-FNDA:2,RuleSanctionsList.transferred.1
-DA:207,3
-DA:208,3
-BRDA:208,10,0,2
-BRDA:208,10,1,1
-DA:214,1
-FN:214,RuleSanctionsList.transferred.2
-FNDA:1,RuleSanctionsList.transferred.2
-DA:220,1
-DA:223,4
-FN:223,RuleSanctionsList.transferred.3
-FNDA:4,RuleSanctionsList.transferred.3
-DA:229,4
-DA:235,14
-FN:235,RuleSanctionsList._setSanctionListOracle
-FNDA:14,RuleSanctionsList._setSanctionListOracle
-DA:236,14
-DA:237,14
-DA:247,30
-FN:247,RuleSanctionsList._msgSender
-FNDA:30,RuleSanctionsList._msgSender
-DA:248,30
-DA:254,0
-FN:254,RuleSanctionsList._msgData
-FNDA:0,RuleSanctionsList._msgData
-DA:255,0
-DA:261,30
-FN:261,RuleSanctionsList._contextSuffixLength
-FNDA:30,RuleSanctionsList._contextSuffixLength
-DA:262,30
-FNF:17
-FNH:15
-LF:54
-LH:50
-BRF:18
-BRH:18
+FN:134,RuleConditionalTransferLightBase.messageForTransferRestriction
+FNDA:2,RuleConditionalTransferLightBase.messageForTransferRestriction
+DA:140,2
+BRDA:140,6,0,1
+DA:141,1
+DA:143,1
+DA:146,3
+FN:146,RuleConditionalTransferLightBase.transferred.2
+FNDA:3,RuleConditionalTransferLightBase.transferred.2
+DA:147,3
+DA:150,3
+FN:150,RuleConditionalTransferLightBase._transferredFromContext
+FNDA:3,RuleConditionalTransferLightBase._transferredFromContext
+DA:151,3
+DA:154,860
+FN:154,RuleConditionalTransferLightBase._transferred
+FNDA:860,RuleConditionalTransferLightBase._transferred
+DA:155,860
+BRDA:155,7,0,860
+DA:156,860
+DA:158,846
+DA:159,846
+DA:161,846
+BRDA:161,8,0,3
+BRDA:161,8,1,843
+DA:163,843
+DA:164,843
+DA:167,3063
+FN:167,RuleConditionalTransferLightBase._transferHash
+FNDA:3063,RuleConditionalTransferLightBase._transferHash
+DA:168,3063
+DA:175,4
+FN:175,RuleConditionalTransferLightBase.onlyTransferApprover
+FNDA:4,RuleConditionalTransferLightBase.onlyTransferApprover
+DA:176,4
+DA:180,3
+FN:180,RuleConditionalTransferLightBase.onlyTransferExecutor
+FNDA:3,RuleConditionalTransferLightBase.onlyTransferExecutor
+DA:181,3
+FNF:18
+FNH:18
+LF:62
+LH:62
+BRF:14
+BRH:14
 end_of_record
 TN:
-SF:src/rules/validation/RuleWhitelist.sol
-DA:33,102
-FN:33,RuleWhitelist.constructor
-FNDA:102,RuleWhitelist.constructor
-DA:36,101
-DA:56,20
-FN:56,RuleWhitelist.detectTransferRestriction.0
-FNDA:20,RuleWhitelist.detectTransferRestriction.0
-DA:63,33
-BRDA:63,0,0,11
-BRDA:63,0,1,16
-DA:64,11
-DA:65,22
-BRDA:65,1,0,6
-BRDA:65,1,1,16
-DA:66,6
-DA:68,16
-DA:75,7
-FN:75,RuleWhitelist.detectTransferRestriction.1
-FNDA:7,RuleWhitelist.detectTransferRestriction.1
-DA:82,7
-DA:102,10
-FN:102,RuleWhitelist.detectTransferRestrictionFrom.0
-FNDA:10,RuleWhitelist.detectTransferRestrictionFrom.0
-DA:109,12
-BRDA:109,2,0,6
-DA:110,6
-DA:112,6
-DA:118,2
-FN:118,RuleWhitelist.detectTransferRestrictionFrom.1
-FNDA:2,RuleWhitelist.detectTransferRestrictionFrom.1
+SF:src/rules/validation/abstract/RuleAddressSet/RuleAddressSet.sol
+DA:51,275
+FN:51,RuleAddressSet.addAddresses
+FNDA:275,RuleAddressSet.addAddresses
+DA:52,274
+DA:53,274
+DA:63,260
+FN:63,RuleAddressSet.removeAddresses
+FNDA:260,RuleAddressSet.removeAddresses
+DA:64,259
+DA:65,259
+DA:75,105
+FN:75,RuleAddressSet.addAddress
+FNDA:105,RuleAddressSet.addAddress
+DA:76,102
+BRDA:76,0,0,1
+BRDA:76,0,1,101
+DA:77,101
+DA:78,101
+DA:88,8
+FN:88,RuleAddressSet.removeAddress
+FNDA:8,RuleAddressSet.removeAddress
+DA:89,5
+BRDA:89,1,0,1
+BRDA:89,1,1,4
+DA:90,4
+DA:91,4
+DA:98,275
+FN:98,RuleAddressSet.onlyAddressListAdd
+FNDA:275,RuleAddressSet.onlyAddressListAdd
+DA:99,275
+DA:103,8
+FN:103,RuleAddressSet.onlyAddressListRemove
+FNDA:8,RuleAddressSet.onlyAddressListRemove
+DA:104,8
+DA:116,536
+FN:116,RuleAddressSet.listedAddressCount
+FNDA:536,RuleAddressSet.listedAddressCount
+DA:117,536
 DA:125,2
-DA:133,0
-FN:133,RuleWhitelist.isVerified
-FNDA:0,RuleWhitelist.isVerified
-DA:140,0
-DA:143,0
-FN:143,RuleWhitelist.supportsInterface
-FNDA:0,RuleWhitelist.supportsInterface
-DA:144,0
-FNF:7
-FNH:5
-LF:20
-LH:16
-BRF:5
-BRH:5
-end_of_record
-TN:
-SF:src/rules/validation/RuleWhitelistWrapper.sol
-DA:38,22
-FN:38,RuleWhitelistWrapper.constructor
-FNDA:22,RuleWhitelistWrapper.constructor
-DA:42,20
-DA:53,21
-FN:53,RuleWhitelistWrapper.detectTransferRestriction.0
-FNDA:21,RuleWhitelistWrapper.detectTransferRestriction.0
-DA:60,25
-DA:61,25
-DA:62,25
-DA:64,25
-DA:65,25
-BRDA:65,0,0,9
-BRDA:65,0,1,10
-DA:66,9
-DA:67,16
-BRDA:67,1,0,6
-BRDA:67,1,1,10
-DA:68,6
-DA:70,10
-DA:74,4
-FN:74,RuleWhitelistWrapper.detectTransferRestriction.1
-FNDA:4,RuleWhitelistWrapper.detectTransferRestriction.1
-DA:81,4
-DA:84,10
-FN:84,RuleWhitelistWrapper.detectTransferRestrictionFrom.0
-FNDA:10,RuleWhitelistWrapper.detectTransferRestrictionFrom.0
-DA:91,12
-BRDA:91,2,0,-
-DA:92,0
-DA:95,12
-DA:96,12
-DA:97,12
-DA:98,12
-DA:100,12
-DA:102,12
-BRDA:102,3,0,-
-BRDA:102,3,1,6
-DA:103,0
-DA:104,12
-BRDA:104,4,0,-
-BRDA:104,4,1,6
-DA:105,0
-DA:106,12
-BRDA:106,5,0,6
-BRDA:106,5,1,6
-DA:107,6
-DA:109,6
-DA:116,2
-FN:116,RuleWhitelistWrapper.detectTransferRestrictionFrom.1
-FNDA:2,RuleWhitelistWrapper.detectTransferRestrictionFrom.1
-DA:123,2
-DA:131,20
-FN:131,RuleWhitelistWrapper.hasRole
-FNDA:20,RuleWhitelistWrapper.hasRole
-DA:138,80
-DA:145,37
-FN:145,RuleWhitelistWrapper._detectTransferRestriction
-FNDA:37,RuleWhitelistWrapper._detectTransferRestriction
-DA:146,37
-DA:147,37
-DA:148,37
-DA:150,81
-DA:151,81
-DA:152,58
-BRDA:152,6,0,58
-DA:153,58
-DA:158,81
-DA:159,81
-DA:160,159
-BRDA:160,7,0,65
-DA:161,65
-DA:162,65
-DA:165,16
-BRDA:165,8,0,16
-DA:166,16
-DA:169,37
-DA:172,0
-FN:172,RuleWhitelistWrapper.supportsInterface
-FNDA:0,RuleWhitelistWrapper.supportsInterface
-DA:173,0
-DA:183,80
-FN:183,RuleWhitelistWrapper._msgSender
-FNDA:80,RuleWhitelistWrapper._msgSender
-DA:184,80
-DA:190,0
-FN:190,RuleWhitelistWrapper._msgData
-FNDA:0,RuleWhitelistWrapper._msgData
-DA:191,0
-DA:197,80
-FN:197,RuleWhitelistWrapper._contextSuffixLength
-FNDA:80,RuleWhitelistWrapper._contextSuffixLength
-DA:198,80
-FNF:11
+FN:125,RuleAddressSet.contains
+FNDA:2,RuleAddressSet.contains
+DA:126,2
+DA:134,67
+FN:134,RuleAddressSet.isAddressListed
+FNDA:67,RuleAddressSet.isAddressListed
+DA:135,383
+DA:143,108
+FN:143,RuleAddressSet.areAddressesListed
+FNDA:108,RuleAddressSet.areAddressesListed
+DA:144,108
+DA:145,108
+DA:146,244
+DA:154,882
+FN:154,RuleAddressSet._msgSender
+FNDA:882,RuleAddressSet._msgSender
+DA:155,882
+DA:159,4
+FN:159,RuleAddressSet._msgData
+FNDA:4,RuleAddressSet._msgData
+DA:160,4
+DA:164,886
+FN:164,RuleAddressSet._contextSuffixLength
+FNDA:886,RuleAddressSet._contextSuffixLength
+DA:165,886
+FNF:13
+FNH:13
+LF:34
+LH:34
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/rules/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol
+DA:38,274
+FN:38,RuleAddressSetInternal._addAddresses
+FNDA:274,RuleAddressSetInternal._addAddresses
+DA:42,274
+DA:43,806
+BRDA:43,0,0,548
+BRDA:43,0,1,258
+DA:44,548
+DA:46,258
+DA:60,259
+FN:60,RuleAddressSetInternal._removeAddresses
+FNDA:259,RuleAddressSetInternal._removeAddresses
+DA:64,259
+DA:65,775
+BRDA:65,1,0,518
+BRDA:65,1,1,257
+DA:66,518
+DA:68,257
+DA:77,101
+FN:77,RuleAddressSetInternal._addAddress
+FNDA:101,RuleAddressSetInternal._addAddress
+DA:78,101
+DA:85,4
+FN:85,RuleAddressSetInternal._removeAddress
+FNDA:4,RuleAddressSetInternal._removeAddress
+DA:86,4
+DA:93,536
+FN:93,RuleAddressSetInternal._listedAddressCount
+FNDA:536,RuleAddressSetInternal._listedAddressCount
+DA:94,536
+DA:102,738
+FN:102,RuleAddressSetInternal._isAddressListed
+FNDA:738,RuleAddressSetInternal._isAddressListed
+DA:103,738
+FNF:6
+FNH:6
+LF:18
+LH:18
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/rules/validation/abstract/RuleERC2980/RuleERC2980Internal.sol
+DA:33,4
+FN:33,RuleERC2980Internal._addWhitelistAddresses
+FNDA:4,RuleERC2980Internal._addWhitelistAddresses
+DA:37,4
+DA:38,6
+BRDA:38,0,0,5
+BRDA:38,0,1,1
+DA:39,5
+DA:41,1
+DA:46,3
+FN:46,RuleERC2980Internal._removeWhitelistAddresses
+FNDA:3,RuleERC2980Internal._removeWhitelistAddresses
+DA:50,3
+DA:51,3
+BRDA:51,1,0,2
+BRDA:51,1,1,1
+DA:52,2
+DA:54,1
+DA:59,39
+FN:59,RuleERC2980Internal._addWhitelistAddress
+FNDA:39,RuleERC2980Internal._addWhitelistAddress
+DA:60,39
+DA:63,4
+FN:63,RuleERC2980Internal._removeWhitelistAddress
+FNDA:4,RuleERC2980Internal._removeWhitelistAddress
+DA:64,4
+DA:67,82
+FN:67,RuleERC2980Internal._isWhitelisted
+FNDA:82,RuleERC2980Internal._isWhitelisted
+DA:68,82
+DA:71,5
+FN:71,RuleERC2980Internal._whitelistCount
+FNDA:5,RuleERC2980Internal._whitelistCount
+DA:72,5
+DA:79,4
+FN:79,RuleERC2980Internal._addFrozenlistAddresses
+FNDA:4,RuleERC2980Internal._addFrozenlistAddresses
+DA:83,4
+DA:84,6
+BRDA:84,2,0,5
+BRDA:84,2,1,1
+DA:85,5
+DA:87,1
+DA:92,2
+FN:92,RuleERC2980Internal._removeFrozenlistAddresses
+FNDA:2,RuleERC2980Internal._removeFrozenlistAddresses
+DA:96,2
+DA:97,2
+BRDA:97,3,0,1
+BRDA:97,3,1,1
+DA:98,1
+DA:100,1
+DA:105,18
+FN:105,RuleERC2980Internal._addFrozenlistAddress
+FNDA:18,RuleERC2980Internal._addFrozenlistAddress
+DA:106,18
+DA:109,4
+FN:109,RuleERC2980Internal._removeFrozenlistAddress
+FNDA:4,RuleERC2980Internal._removeFrozenlistAddress
+DA:110,4
+DA:113,90
+FN:113,RuleERC2980Internal._isFrozen
+FNDA:90,RuleERC2980Internal._isFrozen
+DA:114,90
+DA:117,4
+FN:117,RuleERC2980Internal._frozenlistCount
+FNDA:4,RuleERC2980Internal._frozenlistCount
+DA:118,4
+FNF:12
+FNH:12
+LF:36
+LH:36
+BRF:8
+BRH:8
+end_of_record
+TN:
+SF:src/rules/validation/abstract/base/RuleBlacklistBase.sol
+DA:20,106
+FN:20,RuleBlacklistBase._detectTransferRestriction
+FNDA:106,RuleBlacklistBase._detectTransferRestriction
+DA:26,106
+BRDA:26,0,0,23
+BRDA:26,0,1,64
+DA:27,23
+DA:28,83
+BRDA:28,1,0,19
+DA:29,19
+DA:31,64
+DA:34,22
+FN:34,RuleBlacklistBase._detectTransferRestrictionFrom
+FNDA:22,RuleBlacklistBase._detectTransferRestrictionFrom
+DA:40,22
+BRDA:40,2,0,8
+DA:41,8
+DA:43,14
+DA:46,4
+FN:46,RuleBlacklistBase.canReturnTransferRestrictionCode
+FNDA:4,RuleBlacklistBase.canReturnTransferRestrictionCode
+DA:53,4
+DA:54,1
+DA:57,12
+FN:57,RuleBlacklistBase.messageForTransferRestriction
+FNDA:12,RuleBlacklistBase.messageForTransferRestriction
+DA:64,12
+BRDA:64,3,0,5
+BRDA:64,3,1,3
+DA:65,5
+DA:66,7
+BRDA:66,4,0,3
+BRDA:66,4,1,3
+DA:67,3
+DA:68,4
+BRDA:68,5,0,1
+BRDA:68,5,1,3
+DA:69,1
+DA:71,3
+DA:75,61
+FN:75,RuleBlacklistBase.supportsInterface
+FNDA:61,RuleBlacklistBase.supportsInterface
+DA:76,61
+DA:83,58
+FN:83,RuleBlacklistBase.transferred.0
+FNDA:58,RuleBlacklistBase.transferred.0
+DA:89,58
+DA:96,2
+FN:96,RuleBlacklistBase.transferred.1
+FNDA:2,RuleBlacklistBase.transferred.1
+DA:102,2
+DA:105,61
+FN:105,RuleBlacklistBase._transferred
+FNDA:61,RuleBlacklistBase._transferred
+DA:106,61
+DA:107,61
+BRDA:107,6,0,15
+BRDA:107,6,1,46
+DA:113,4
+FN:113,RuleBlacklistBase._transferredFrom
+FNDA:4,RuleBlacklistBase._transferredFrom
+DA:119,4
+DA:120,4
+BRDA:120,7,0,2
+BRDA:120,7,1,2
+FNF:9
 FNH:9
-LF:57
-LH:50
+LF:33
+LH:33
 BRF:14
-BRH:11
+BRH:14
 end_of_record
 TN:
-SF:src/rules/validation/abstract/RuleAddressSet/RuleAddressSet.sol
-DA:63,17
-FN:63,RuleAddressSet.addAddresses
-FNDA:17,RuleAddressSet.addAddresses
-DA:64,16
-DA:65,16
+SF:src/rules/validation/abstract/base/RuleERC2980Base.sol
+DA:47,22
+FN:47,RuleERC2980Base._detectTransferRestriction
+FNDA:22,RuleERC2980Base._detectTransferRestriction
+DA:55,22
+BRDA:55,0,0,4
+BRDA:55,0,1,14
+DA:56,4
+DA:57,18
+BRDA:57,1,0,4
+DA:58,4
+DA:61,14
+BRDA:61,2,0,4
+DA:62,4
+DA:64,10
+DA:67,8
+FN:67,RuleERC2980Base._detectTransferRestrictionFrom
+FNDA:8,RuleERC2980Base._detectTransferRestrictionFrom
+DA:74,8
+BRDA:74,3,0,4
 DA:75,4
-FN:75,RuleAddressSet.removeAddresses
-FNDA:4,RuleAddressSet.removeAddresses
-DA:76,3
-DA:77,3
-DA:87,52
-FN:87,RuleAddressSet.addAddress
-FNDA:52,RuleAddressSet.addAddress
-DA:88,51
-BRDA:88,0,0,1
-DA:89,1
-DA:91,50
-DA:92,50
-DA:102,3
-FN:102,RuleAddressSet.removeAddress
-FNDA:3,RuleAddressSet.removeAddress
+DA:77,4
+DA:84,4
+FN:84,RuleERC2980Base.transferred.0
+FNDA:4,RuleERC2980Base.transferred.0
+DA:90,4
+DA:93,2
+FN:93,RuleERC2980Base.transferred.1
+FNDA:2,RuleERC2980Base.transferred.1
+DA:99,2
+DA:102,5
+FN:102,RuleERC2980Base._transferred
+FNDA:5,RuleERC2980Base._transferred
+DA:103,5
+DA:104,5
+BRDA:104,4,0,3
+BRDA:104,4,1,2
+DA:110,3
+FN:110,RuleERC2980Base._transferredFrom
+FNDA:3,RuleERC2980Base._transferredFrom
+DA:116,3
+DA:117,3
+BRDA:117,5,0,1
+BRDA:117,5,1,2
+DA:127,5
+FN:127,RuleERC2980Base.canReturnTransferRestrictionCode
+FNDA:5,RuleERC2980Base.canReturnTransferRestrictionCode
+DA:134,5
+DA:135,3
+DA:136,2
+DA:139,5
+FN:139,RuleERC2980Base.messageForTransferRestriction
+FNDA:5,RuleERC2980Base.messageForTransferRestriction
+DA:146,5
+BRDA:146,6,0,1
+BRDA:146,6,1,1
+DA:147,1
+DA:148,4
+BRDA:148,7,0,1
+BRDA:148,7,1,1
+DA:149,1
+DA:150,3
+BRDA:150,8,0,1
+BRDA:150,8,1,1
+DA:151,1
+DA:152,2
+BRDA:152,9,0,1
+BRDA:152,9,1,1
+DA:153,1
+DA:155,1
+DA:167,6
+FN:167,RuleERC2980Base.addWhitelistAddresses
+FNDA:6,RuleERC2980Base.addWhitelistAddresses
+DA:168,4
+DA:169,4
+DA:176,4
+FN:176,RuleERC2980Base.removeWhitelistAddresses
+FNDA:4,RuleERC2980Base.removeWhitelistAddresses
+DA:177,3
+DA:178,3
+DA:189,43
+FN:189,RuleERC2980Base.addWhitelistAddress
+FNDA:43,RuleERC2980Base.addWhitelistAddress
+DA:190,40
+BRDA:190,10,0,1
+BRDA:190,10,1,39
+DA:191,39
+DA:192,39
+DA:203,7
+FN:203,RuleERC2980Base.removeWhitelistAddress
+FNDA:7,RuleERC2980Base.removeWhitelistAddress
+DA:204,5
+BRDA:204,11,0,1
+BRDA:204,11,1,4
+DA:205,4
+DA:206,4
+DA:212,5
+FN:212,RuleERC2980Base.whitelistAddressCount
+FNDA:5,RuleERC2980Base.whitelistAddressCount
+DA:213,5
+DA:219,13
+FN:219,RuleERC2980Base.isWhitelisted
+FNDA:13,RuleERC2980Base.isWhitelisted
+DA:220,13
+DA:226,5
+FN:226,RuleERC2980Base.whitelist
+FNDA:5,RuleERC2980Base.whitelist
+DA:227,5
+DA:235,3
+FN:235,RuleERC2980Base.isVerified
+FNDA:3,RuleERC2980Base.isVerified
+DA:242,3
+DA:248,1
+FN:248,RuleERC2980Base.areWhitelisted
+FNDA:1,RuleERC2980Base.areWhitelisted
+DA:249,1
+DA:250,1
+DA:251,2
+DA:263,6
+FN:263,RuleERC2980Base.addFrozenlistAddresses
+FNDA:6,RuleERC2980Base.addFrozenlistAddresses
+DA:264,4
+DA:265,4
+DA:272,2
+FN:272,RuleERC2980Base.removeFrozenlistAddresses
+FNDA:2,RuleERC2980Base.removeFrozenlistAddresses
+DA:273,2
+DA:274,2
+DA:285,22
+FN:285,RuleERC2980Base.addFrozenlistAddress
+FNDA:22,RuleERC2980Base.addFrozenlistAddress
+DA:286,19
+BRDA:286,12,0,1
+BRDA:286,12,1,18
+DA:287,18
+DA:288,18
+DA:299,7
+FN:299,RuleERC2980Base.removeFrozenlistAddress
+FNDA:7,RuleERC2980Base.removeFrozenlistAddress
+DA:300,5
+BRDA:300,13,0,1
+BRDA:300,13,1,4
+DA:301,4
+DA:302,4
+DA:308,4
+FN:308,RuleERC2980Base.frozenlistAddressCount
+FNDA:4,RuleERC2980Base.frozenlistAddressCount
+DA:309,4
+DA:315,12
+FN:315,RuleERC2980Base.isFrozen
+FNDA:12,RuleERC2980Base.isFrozen
+DA:316,12
+DA:322,4
+FN:322,RuleERC2980Base.frozenlist
+FNDA:4,RuleERC2980Base.frozenlist
+DA:323,4
+DA:329,1
+FN:329,RuleERC2980Base.areFrozen
+FNDA:1,RuleERC2980Base.areFrozen
+DA:330,1
+DA:331,1
+DA:332,2
+DA:340,1
+FN:340,RuleERC2980Base.supportsInterface
+FNDA:1,RuleERC2980Base.supportsInterface
+DA:341,1
+DA:348,6
+FN:348,RuleERC2980Base.onlyWhitelistAdd
+FNDA:6,RuleERC2980Base.onlyWhitelistAdd
+DA:349,6
+DA:353,7
+FN:353,RuleERC2980Base.onlyWhitelistRemove
+FNDA:7,RuleERC2980Base.onlyWhitelistRemove
+DA:354,7
+DA:358,6
+FN:358,RuleERC2980Base.onlyFrozenlistAdd
+FNDA:6,RuleERC2980Base.onlyFrozenlistAdd
+DA:359,6
+DA:363,2
+FN:363,RuleERC2980Base.onlyFrozenlistRemove
+FNDA:2,RuleERC2980Base.onlyFrozenlistRemove
+DA:364,2
+DA:377,267
+FN:377,RuleERC2980Base._msgSender
+FNDA:267,RuleERC2980Base._msgSender
+DA:378,267
+DA:381,2
+FN:381,RuleERC2980Base._msgData
+FNDA:2,RuleERC2980Base._msgData
+DA:382,2
+DA:385,269
+FN:385,RuleERC2980Base._contextSuffixLength
+FNDA:269,RuleERC2980Base._contextSuffixLength
+DA:386,269
+FNF:33
+FNH:33
+LF:102
+LH:102
+BRF:25
+BRH:25
+end_of_record
+TN:
+SF:src/rules/validation/abstract/base/RuleIdentityRegistryBase.sol
+DA:19,26
+FN:19,RuleIdentityRegistryBase.constructor
+FNDA:26,RuleIdentityRegistryBase.constructor
+DA:20,26
+BRDA:20,0,0,25
+DA:21,25
+DA:25,4
+FN:25,RuleIdentityRegistryBase.setIdentityRegistry
+FNDA:4,RuleIdentityRegistryBase.setIdentityRegistry
+DA:26,2
+BRDA:26,1,0,1
+BRDA:26,1,1,1
+DA:27,1
+DA:28,1
+DA:31,5
+FN:31,RuleIdentityRegistryBase.clearIdentityRegistry
+FNDA:5,RuleIdentityRegistryBase.clearIdentityRegistry
+DA:32,3
+DA:33,3
+DA:36,16
+FN:36,RuleIdentityRegistryBase._detectTransferRestriction
+FNDA:16,RuleIdentityRegistryBase._detectTransferRestriction
+DA:42,16
+BRDA:42,2,0,3
+DA:43,3
+DA:45,13
+BRDA:45,3,0,2
+DA:46,2
+DA:49,11
+BRDA:49,4,0,4
+DA:50,4
+DA:52,7
+BRDA:52,5,0,1
+DA:53,1
+DA:55,6
+DA:58,9
+FN:58,RuleIdentityRegistryBase._detectTransferRestrictionFrom
+FNDA:9,RuleIdentityRegistryBase._detectTransferRestrictionFrom
+DA:64,9
+BRDA:64,6,0,1
+DA:65,1
+DA:67,8
+BRDA:67,7,0,1
+DA:68,1
+DA:70,7
+BRDA:70,8,0,4
+DA:71,4
+DA:73,3
+DA:76,2
+FN:76,RuleIdentityRegistryBase.transferred.0
+FNDA:2,RuleIdentityRegistryBase.transferred.0
+DA:81,2
+DA:84,2
+FN:84,RuleIdentityRegistryBase.transferred.1
+FNDA:2,RuleIdentityRegistryBase.transferred.1
+DA:89,2
+DA:92,2
+FN:92,RuleIdentityRegistryBase._transferred
+FNDA:2,RuleIdentityRegistryBase._transferred
+DA:93,2
+DA:94,2
+BRDA:94,9,0,1
+BRDA:94,9,1,1
+DA:100,2
+FN:100,RuleIdentityRegistryBase._transferredFrom
+FNDA:2,RuleIdentityRegistryBase._transferredFrom
+DA:106,2
+DA:107,2
+BRDA:107,10,0,1
+BRDA:107,10,1,1
+DA:113,4
+FN:113,RuleIdentityRegistryBase.canReturnTransferRestrictionCode
+FNDA:4,RuleIdentityRegistryBase.canReturnTransferRestrictionCode
+DA:114,4
+DA:115,2
+DA:118,4
+FN:118,RuleIdentityRegistryBase.messageForTransferRestriction
+FNDA:4,RuleIdentityRegistryBase.messageForTransferRestriction
+DA:124,4
+BRDA:124,11,0,1
+BRDA:124,11,1,1
+DA:125,1
+DA:126,3
+BRDA:126,12,0,1
+BRDA:126,12,1,1
+DA:127,1
+DA:128,2
+BRDA:128,13,0,1
+DA:129,1
+DA:131,1
+DA:138,5
+FN:138,RuleIdentityRegistryBase.onlyIdentityRegistryManager
+FNDA:5,RuleIdentityRegistryBase.onlyIdentityRegistryManager
+DA:139,5
+FNF:12
+FNH:12
+LF:51
+LH:51
+BRF:19
+BRH:19
+end_of_record
+TN:
+SF:src/rules/validation/abstract/base/RuleMaxTotalSupplyBase.sol
+DA:20,25
+FN:20,RuleMaxTotalSupplyBase.constructor
+FNDA:25,RuleMaxTotalSupplyBase.constructor
+DA:21,25
+BRDA:21,0,0,1
+BRDA:21,0,1,24
+DA:22,24
+DA:23,24
+DA:26,260
+FN:26,RuleMaxTotalSupplyBase.setMaxTotalSupply
+FNDA:260,RuleMaxTotalSupplyBase.setMaxTotalSupply
+DA:27,258
+DA:28,258
+DA:31,4
+FN:31,RuleMaxTotalSupplyBase.setTokenContract
+FNDA:4,RuleMaxTotalSupplyBase.setTokenContract
+DA:32,2
+BRDA:32,1,0,1
+BRDA:32,1,1,1
+DA:33,1
+DA:34,1
+DA:37,271
+FN:37,RuleMaxTotalSupplyBase._detectTransferRestriction
+FNDA:271,RuleMaxTotalSupplyBase._detectTransferRestriction
+DA:43,271
+BRDA:43,2,0,268
+DA:44,268
+DA:45,268
+BRDA:45,3,0,179
+DA:46,179
+DA:49,92
+DA:52,2
+FN:52,RuleMaxTotalSupplyBase._detectTransferRestrictionFrom
+FNDA:2,RuleMaxTotalSupplyBase._detectTransferRestrictionFrom
+DA:58,2
+DA:61,2
+FN:61,RuleMaxTotalSupplyBase.transferred.0
+FNDA:2,RuleMaxTotalSupplyBase.transferred.0
+DA:66,2
+DA:69,2
+FN:69,RuleMaxTotalSupplyBase.transferred.1
+FNDA:2,RuleMaxTotalSupplyBase.transferred.1
+DA:74,2
+DA:77,2
+FN:77,RuleMaxTotalSupplyBase._transferred
+FNDA:2,RuleMaxTotalSupplyBase._transferred
+DA:78,2
+DA:79,2
+BRDA:79,4,0,1
+BRDA:79,4,1,1
+DA:85,2
+FN:85,RuleMaxTotalSupplyBase._transferredFrom
+FNDA:2,RuleMaxTotalSupplyBase._transferredFrom
+DA:86,2
+DA:87,2
+BRDA:87,5,0,1
+BRDA:87,5,1,1
+DA:93,2
+FN:93,RuleMaxTotalSupplyBase.canReturnTransferRestrictionCode
+FNDA:2,RuleMaxTotalSupplyBase.canReturnTransferRestrictionCode
+DA:94,2
+DA:97,2
+FN:97,RuleMaxTotalSupplyBase.messageForTransferRestriction
+FNDA:2,RuleMaxTotalSupplyBase.messageForTransferRestriction
 DA:103,2
-BRDA:103,1,0,1
+BRDA:103,6,0,1
 DA:104,1
 DA:106,1
-DA:107,1
-DA:114,24
-FN:114,RuleAddressSet.listedAddressCount
-FNDA:24,RuleAddressSet.listedAddressCount
-DA:115,24
-DA:123,0
-FN:123,RuleAddressSet.contains
-FNDA:0,RuleAddressSet.contains
-DA:124,0
-DA:132,60
-FN:132,RuleAddressSet.isAddressListed
-FNDA:60,RuleAddressSet.isAddressListed
-DA:133,219
-DA:141,84
-FN:141,RuleAddressSet.areAddressesListed
-FNDA:84,RuleAddressSet.areAddressesListed
-DA:142,84
-DA:143,84
-DA:144,191
-DA:152,207
-FN:152,RuleAddressSet._msgSender
-FNDA:207,RuleAddressSet._msgSender
-DA:153,207
-DA:157,0
-FN:157,RuleAddressSet._msgData
-FNDA:0,RuleAddressSet._msgData
-DA:158,0
-DA:162,207
-FN:162,RuleAddressSet._contextSuffixLength
-FNDA:207,RuleAddressSet._contextSuffixLength
-DA:163,207
-FNF:11
-FNH:9
-LF:32
-LH:28
-BRF:2
-BRH:2
+DA:113,260
+FN:113,RuleMaxTotalSupplyBase.onlyMaxTotalSupplyManager
+FNDA:260,RuleMaxTotalSupplyBase.onlyMaxTotalSupplyManager
+DA:114,260
+FNF:12
+FNH:12
+LF:37
+LH:37
+BRF:11
+BRH:11
 end_of_record
 TN:
-SF:src/rules/validation/abstract/RuleAddressSet/RuleAddressSetInternal.sol
-DA:36,16
-FN:36,RuleAddressSetInternal._addAddresses
-FNDA:16,RuleAddressSetInternal._addAddresses
-DA:37,16
-DA:38,34
-DA:49,3
-FN:49,RuleAddressSetInternal._removeAddresses
-FNDA:3,RuleAddressSetInternal._removeAddresses
-DA:50,3
-DA:51,7
-DA:59,50
-FN:59,RuleAddressSetInternal._addAddress
-FNDA:50,RuleAddressSetInternal._addAddress
-DA:60,50
-DA:67,1
-FN:67,RuleAddressSetInternal._removeAddress
-FNDA:1,RuleAddressSetInternal._removeAddress
-DA:68,1
-DA:75,24
-FN:75,RuleAddressSetInternal._listedAddressCount
-FNDA:24,RuleAddressSetInternal._listedAddressCount
-DA:76,24
-DA:84,463
-FN:84,RuleAddressSetInternal._isAddressListed
-FNDA:463,RuleAddressSetInternal._isAddressListed
-DA:85,463
-FNF:6
-FNH:6
-LF:14
-LH:14
-BRF:0
-BRH:0
+SF:src/rules/validation/abstract/base/RuleSanctionsListBase.sol
+DA:20,46
+FN:20,RuleSanctionsListBase.constructor
+FNDA:46,RuleSanctionsListBase.constructor
+DA:23,45
+BRDA:23,0,0,20
+DA:24,20
+DA:28,84
+FN:28,RuleSanctionsListBase._detectTransferRestriction
+FNDA:84,RuleSanctionsListBase._detectTransferRestriction
+DA:34,84
+BRDA:34,1,0,77
+DA:35,77
+BRDA:35,2,0,10
+BRDA:35,2,1,55
+DA:36,10
+DA:37,67
+BRDA:37,3,0,12
+DA:38,12
+DA:41,62
+DA:44,16
+FN:44,RuleSanctionsListBase._detectTransferRestrictionFrom
+FNDA:16,RuleSanctionsListBase._detectTransferRestrictionFrom
+DA:51,16
+BRDA:51,4,0,15
+DA:52,15
+BRDA:52,5,0,6
+DA:53,6
+DA:55,9
+DA:57,1
+DA:60,3
+FN:60,RuleSanctionsListBase.canReturnTransferRestrictionCode
+FNDA:3,RuleSanctionsListBase.canReturnTransferRestrictionCode
+DA:61,3
+DA:62,1
+DA:65,4
+FN:65,RuleSanctionsListBase.messageForTransferRestriction
+FNDA:4,RuleSanctionsListBase.messageForTransferRestriction
+DA:71,4
+BRDA:71,6,0,1
+BRDA:71,6,1,1
+DA:72,1
+DA:73,3
+BRDA:73,7,0,1
+BRDA:73,7,1,1
+DA:74,1
+DA:75,2
+BRDA:75,8,0,1
+DA:76,1
+DA:78,1
+DA:81,17
+FN:81,RuleSanctionsListBase.setSanctionListOracle
+FNDA:17,RuleSanctionsListBase.setSanctionListOracle
+DA:82,15
+BRDA:82,9,0,1
+BRDA:82,9,1,14
+DA:83,14
+DA:86,3
+FN:86,RuleSanctionsListBase.clearSanctionListOracle
+FNDA:3,RuleSanctionsListBase.clearSanctionListOracle
+DA:87,3
+DA:90,43
+FN:90,RuleSanctionsListBase.transferred.0
+FNDA:43,RuleSanctionsListBase.transferred.0
+DA:95,43
+DA:98,2
+FN:98,RuleSanctionsListBase.transferred.1
+FNDA:2,RuleSanctionsListBase.transferred.1
+DA:103,2
+DA:106,47
+FN:106,RuleSanctionsListBase._transferred
+FNDA:47,RuleSanctionsListBase._transferred
+DA:107,47
+DA:108,47
+BRDA:108,10,0,6
+BRDA:108,10,1,41
+DA:114,3
+FN:114,RuleSanctionsListBase._transferredFrom
+FNDA:3,RuleSanctionsListBase._transferredFrom
+DA:120,3
+DA:121,3
+BRDA:121,11,0,2
+BRDA:121,11,1,1
+DA:127,37
+FN:127,RuleSanctionsListBase._setSanctionListOracle
+FNDA:37,RuleSanctionsListBase._setSanctionListOracle
+DA:128,37
+DA:129,37
+DA:136,3
+FN:136,RuleSanctionsListBase.onlySanctionListManager
+FNDA:3,RuleSanctionsListBase.onlySanctionListManager
+DA:137,3
+FNF:13
+FNH:13
+LF:47
+LH:47
+BRF:18
+BRH:18
 end_of_record
 TN:
-SF:src/rules/validation/abstract/RuleValidateTransfer.sol
-DA:26,14
-FN:26,RuleValidateTransfer.canTransfer.0
-FNDA:14,RuleValidateTransfer.canTransfer.0
-DA:33,14
-DA:45,14
-FN:45,RuleValidateTransfer.canTransfer.1
-FNDA:14,RuleValidateTransfer.canTransfer.1
-DA:52,14
-DA:58,10
-FN:58,RuleValidateTransfer.canTransferFrom.0
-FNDA:10,RuleValidateTransfer.canTransferFrom.0
-DA:65,20
-DA:72,10
-FN:72,RuleValidateTransfer.canTransferFrom.1
-FNDA:10,RuleValidateTransfer.canTransferFrom.1
-DA:79,10
-DA:82,0
-FN:82,RuleValidateTransfer.supportsInterface
-FNDA:0,RuleValidateTransfer.supportsInterface
-DA:83,0
+SF:src/rules/validation/abstract/base/RuleWhitelistBase.sol
+DA:15,157
+FN:15,RuleWhitelistBase.constructor
+FNDA:157,RuleWhitelistBase.constructor
+DA:16,157
+DA:19,51
+FN:19,RuleWhitelistBase._detectTransferRestriction
+FNDA:51,RuleWhitelistBase._detectTransferRestriction
+DA:26,51
+BRDA:26,0,0,13
+BRDA:26,0,1,28
+DA:27,13
+DA:28,38
+BRDA:28,1,0,10
+DA:29,10
+DA:31,28
+DA:34,18
+FN:34,RuleWhitelistBase._detectTransferRestrictionFrom
+FNDA:18,RuleWhitelistBase._detectTransferRestrictionFrom
+DA:41,18
+BRDA:41,2,0,8
+DA:42,8
+DA:44,10
+DA:48,2
+FN:48,RuleWhitelistBase.isVerified
+FNDA:2,RuleWhitelistBase.isVerified
+DA:55,2
+DA:58,3
+FN:58,RuleWhitelistBase.setCheckSpender
+FNDA:3,RuleWhitelistBase.setCheckSpender
+DA:59,2
+DA:60,2
+DA:63,2
+FN:63,RuleWhitelistBase._setCheckSpender
+FNDA:2,RuleWhitelistBase._setCheckSpender
+DA:64,2
+DA:67,27
+FN:67,RuleWhitelistBase.supportsInterface
+FNDA:27,RuleWhitelistBase.supportsInterface
+DA:68,27
+DA:75,3
+FN:75,RuleWhitelistBase.onlyCheckSpenderManager
+FNDA:3,RuleWhitelistBase.onlyCheckSpenderManager
+DA:76,3
+FNF:8
+FNH:8
+LF:23
+LH:23
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/rules/validation/abstract/base/RuleWhitelistWrapperBase.sol
+DA:36,44
+FN:36,RuleWhitelistWrapperBase.constructor
+FNDA:44,RuleWhitelistWrapperBase.constructor
+DA:39,44
+DA:50,34
+FN:50,RuleWhitelistWrapperBase._detectTransferRestriction
+FNDA:34,RuleWhitelistWrapperBase._detectTransferRestriction
+DA:57,34
+DA:58,34
+DA:59,34
+DA:61,34
+DA:62,34
+BRDA:62,0,0,13
+BRDA:62,0,1,13
+DA:63,13
+DA:64,21
+BRDA:64,1,0,8
+BRDA:64,1,1,13
+DA:65,8
+DA:67,13
+DA:71,20
+FN:71,RuleWhitelistWrapperBase._detectTransferRestrictionFrom
+FNDA:20,RuleWhitelistWrapperBase._detectTransferRestrictionFrom
+DA:78,20
+BRDA:78,2,0,1
+DA:79,1
+DA:82,19
+DA:83,19
+DA:84,19
+DA:85,19
+DA:87,19
+DA:89,19
+BRDA:89,3,0,1
+BRDA:89,3,1,9
+DA:90,1
+DA:91,18
+BRDA:91,4,0,1
+BRDA:91,4,1,9
+DA:92,1
+DA:93,17
+BRDA:93,5,0,8
+BRDA:93,5,1,9
+DA:94,8
+DA:96,9
+DA:102,62
+FN:102,RuleWhitelistWrapperBase.supportsInterface
+FNDA:62,RuleWhitelistWrapperBase.supportsInterface
+DA:109,62
+DA:116,4
+FN:116,RuleWhitelistWrapperBase.isVerified
+FNDA:4,RuleWhitelistWrapperBase.isVerified
+DA:123,4
+DA:124,4
+DA:125,4
+DA:126,4
+DA:139,4
+FN:139,RuleWhitelistWrapperBase.setCheckSpender
+FNDA:4,RuleWhitelistWrapperBase.setCheckSpender
+DA:140,3
+DA:141,3
+DA:144,13
+FN:144,RuleWhitelistWrapperBase._transferred.0
+FNDA:13,RuleWhitelistWrapperBase._transferred.0
+DA:150,13
+DA:153,1
+FN:153,RuleWhitelistWrapperBase._transferred.1
+FNDA:1,RuleWhitelistWrapperBase._transferred.1
+DA:159,1
+DA:171,57
+FN:171,RuleWhitelistWrapperBase._detectTransferRestrictionForTargets
+FNDA:57,RuleWhitelistWrapperBase._detectTransferRestrictionForTargets
+DA:177,57
+DA:178,57
+DA:179,57
+DA:182,105
+DA:183,105
+DA:184,85
+BRDA:184,6,0,85
+DA:185,85
+DA:190,105
+DA:191,105
+DA:192,201
+BRDA:192,7,0,81
+DA:193,81
+DA:194,81
+DA:197,24
+BRDA:197,8,0,24
+DA:198,24
+DA:201,57
+DA:208,3
+FN:208,RuleWhitelistWrapperBase._setCheckSpender
+FNDA:3,RuleWhitelistWrapperBase._setCheckSpender
+DA:209,3
+DA:216,4
+FN:216,RuleWhitelistWrapperBase.onlyCheckSpenderManager
+FNDA:4,RuleWhitelistWrapperBase.onlyCheckSpenderManager
+DA:217,4
+DA:230,145
+FN:230,RuleWhitelistWrapperBase._msgSender
+FNDA:145,RuleWhitelistWrapperBase._msgSender
+DA:231,145
+DA:237,2
+FN:237,RuleWhitelistWrapperBase._msgData
+FNDA:2,RuleWhitelistWrapperBase._msgData
+DA:238,2
+DA:244,147
+FN:244,RuleWhitelistWrapperBase._contextSuffixLength
+FNDA:147,RuleWhitelistWrapperBase._contextSuffixLength
+DA:245,147
+FNF:14
+FNH:14
+LF:67
+LH:67
+BRF:14
+BRH:14
+end_of_record
+TN:
+SF:src/rules/validation/abstract/core/RuleNFTAdapter.sol
+DA:40,16
+FN:40,RuleNFTAdapter.detectTransferRestriction
+FNDA:16,RuleNFTAdapter.detectTransferRestriction
+DA:47,16
+DA:53,12
+FN:53,RuleNFTAdapter.detectTransferRestrictionFrom
+FNDA:12,RuleNFTAdapter.detectTransferRestrictionFrom
+DA:60,12
+DA:66,14
+FN:66,RuleNFTAdapter.canTransfer
+FNDA:14,RuleNFTAdapter.canTransfer
+DA:72,14
+DA:78,10
+FN:78,RuleNFTAdapter.canTransferFrom
+FNDA:10,RuleNFTAdapter.canTransferFrom
+DA:85,10
+DA:92,13
+FN:92,RuleNFTAdapter.transferred.0
+FNDA:13,RuleNFTAdapter.transferred.0
+DA:97,13
+DA:103,8
+FN:103,RuleNFTAdapter.transferred.1
+FNDA:8,RuleNFTAdapter.transferred.1
+DA:108,8
+DA:114,2
+FN:114,RuleNFTAdapter.transferred.2
+FNDA:2,RuleNFTAdapter.transferred.2
+DA:115,2
+BRDA:115,0,0,1
+BRDA:115,0,1,1
+DA:116,1
+DA:118,1
+DA:125,2
+FN:125,RuleNFTAdapter.transferred.3
+FNDA:2,RuleNFTAdapter.transferred.3
+DA:126,2
+BRDA:126,1,0,1
+BRDA:126,1,1,1
+DA:127,1
+DA:129,1
+FNF:8
+FNH:8
+LF:20
+LH:20
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/rules/validation/abstract/core/RuleTransferValidation.sol
+DA:46,348
+FN:46,RuleTransferValidation.detectTransferRestriction
+FNDA:348,RuleTransferValidation.detectTransferRestriction
+DA:53,348
+DA:59,36
+FN:59,RuleTransferValidation.detectTransferRestrictionFrom
+FNDA:36,RuleTransferValidation.detectTransferRestrictionFrom
+DA:66,36
+DA:77,20
+FN:77,RuleTransferValidation.canTransfer
+FNDA:20,RuleTransferValidation.canTransfer
+DA:83,20
+DA:89,12
+FN:89,RuleTransferValidation.canTransferFrom
+FNDA:12,RuleTransferValidation.canTransferFrom
+DA:96,12
+DA:100,195
+FN:100,RuleTransferValidation.supportsInterface
+FNDA:195,RuleTransferValidation.supportsInterface
+DA:101,195
 FNF:5
-FNH:4
+FNH:5
 LF:10
-LH:8
+LH:10
 BRF:0
 BRH:0
 end_of_record
 TN:
-SF:src/rules/validation/abstract/RuleWhitelistCommon.sol
-DA:38,10
-FN:38,RuleWhitelistCommon.canReturnTransferRestrictionCode
-FNDA:10,RuleWhitelistCommon.canReturnTransferRestrictionCode
-DA:39,10
-DA:40,5
-DA:50,14
-FN:50,RuleWhitelistCommon.messageForTransferRestriction
-FNDA:14,RuleWhitelistCommon.messageForTransferRestriction
-DA:56,14
-BRDA:56,0,0,6
-BRDA:56,0,1,2
-DA:57,6
-DA:58,8
-BRDA:58,1,0,4
-BRDA:58,1,1,2
-DA:59,4
-DA:60,4
-BRDA:60,2,0,2
-BRDA:60,2,1,2
-DA:61,2
-DA:63,2
-DA:79,17
-FN:79,RuleWhitelistCommon.transferred.0
-FNDA:17,RuleWhitelistCommon.transferred.0
-DA:80,22
-DA:81,22
-BRDA:81,3,0,14
-BRDA:81,3,1,8
-DA:97,4
-FN:97,RuleWhitelistCommon.transferred.1
-FNDA:4,RuleWhitelistCommon.transferred.1
-DA:98,8
-DA:99,8
-BRDA:99,4,0,4
-BRDA:99,4,1,4
-DA:106,4
-FN:106,RuleWhitelistCommon.transferred.2
-FNDA:4,RuleWhitelistCommon.transferred.2
-DA:112,4
-DA:115,5
-FN:115,RuleWhitelistCommon.transferred.3
-FNDA:5,RuleWhitelistCommon.transferred.3
-DA:121,5
+SF:src/rules/validation/abstract/core/RuleWhitelistShared.sol
+DA:33,10
+FN:33,RuleWhitelistShared.canReturnTransferRestrictionCode
+FNDA:10,RuleWhitelistShared.canReturnTransferRestrictionCode
+DA:34,10
+DA:35,5
+DA:45,14
+FN:45,RuleWhitelistShared.messageForTransferRestriction
+FNDA:14,RuleWhitelistShared.messageForTransferRestriction
+DA:51,14
+BRDA:51,0,0,6
+BRDA:51,0,1,2
+DA:52,6
+DA:53,8
+BRDA:53,1,0,4
+BRDA:53,1,1,2
+DA:54,4
+DA:55,4
+BRDA:55,2,0,2
+BRDA:55,2,1,2
+DA:56,2
+DA:58,2
+DA:75,19
+FN:75,RuleWhitelistShared.transferred.0
+FNDA:19,RuleWhitelistShared.transferred.0
+DA:76,19
+DA:90,4
+FN:90,RuleWhitelistShared.transferred.1
+FNDA:4,RuleWhitelistShared.transferred.1
+DA:91,4
+DA:94,26
+FN:94,RuleWhitelistShared._transferred
+FNDA:26,RuleWhitelistShared._transferred
+DA:95,26
+DA:96,26
+BRDA:96,3,0,14
+BRDA:96,3,1,12
+DA:102,11
+FN:102,RuleWhitelistShared._transferredFrom
+FNDA:11,RuleWhitelistShared._transferredFrom
+DA:108,11
+DA:109,11
+BRDA:109,4,0,4
+BRDA:109,4,1,7
 FNF:6
 FNH:6
 LF:21
@@ -552,3 +1263,377 @@ LH:21
 BRF:10
 BRH:10
 end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleBlacklist.sol
+DA:28,91
+FN:28,RuleBlacklist.supportsInterface
+FNDA:91,RuleBlacklist.supportsInterface
+DA:35,91
+DA:38,28
+FN:38,RuleBlacklist._authorizeAddressListAdd
+FNDA:28,RuleBlacklist._authorizeAddressListAdd
+DA:40,1
+FN:40,RuleBlacklist._authorizeAddressListRemove
+FNDA:1,RuleBlacklist._authorizeAddressListRemove
+DA:42,83
+FN:42,RuleBlacklist._msgSender
+FNDA:83,RuleBlacklist._msgSender
+DA:43,83
+DA:46,1
+FN:46,RuleBlacklist._msgData
+FNDA:1,RuleBlacklist._msgData
+DA:47,1
+DA:50,84
+FN:50,RuleBlacklist._contextSuffixLength
+FNDA:84,RuleBlacklist._contextSuffixLength
+DA:51,84
+FNF:6
+FNH:6
+LF:10
+LH:10
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleBlacklistOwnable2Step.sol
+DA:20,2
+FN:20,RuleBlacklistOwnable2Step._authorizeAddressListAdd
+FNDA:2,RuleBlacklistOwnable2Step._authorizeAddressListAdd
+DA:22,2
+FN:22,RuleBlacklistOwnable2Step._authorizeAddressListRemove
+FNDA:2,RuleBlacklistOwnable2Step._authorizeAddressListRemove
+DA:24,12
+FN:24,RuleBlacklistOwnable2Step._msgSender
+FNDA:12,RuleBlacklistOwnable2Step._msgSender
+DA:25,12
+DA:28,1
+FN:28,RuleBlacklistOwnable2Step._msgData
+FNDA:1,RuleBlacklistOwnable2Step._msgData
+DA:29,1
+DA:32,13
+FN:32,RuleBlacklistOwnable2Step._contextSuffixLength
+FNDA:13,RuleBlacklistOwnable2Step._contextSuffixLength
+DA:33,13
+FNF:5
+FNH:5
+LF:8
+LH:8
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleERC2980.sol
+DA:50,1
+FN:50,RuleERC2980.supportsInterface
+FNDA:1,RuleERC2980.supportsInterface
+DA:57,1
+DA:64,42
+FN:64,RuleERC2980._authorizeWhitelistAdd
+FNDA:42,RuleERC2980._authorizeWhitelistAdd
+DA:66,8
+FN:66,RuleERC2980._authorizeWhitelistRemove
+FNDA:8,RuleERC2980._authorizeWhitelistRemove
+DA:68,22
+FN:68,RuleERC2980._authorizeFrozenlistAdd
+FNDA:22,RuleERC2980._authorizeFrozenlistAdd
+DA:70,7
+FN:70,RuleERC2980._authorizeFrozenlistRemove
+FNDA:7,RuleERC2980._authorizeFrozenlistRemove
+DA:72,237
+FN:72,RuleERC2980._msgSender
+FNDA:237,RuleERC2980._msgSender
+DA:73,237
+DA:76,1
+FN:76,RuleERC2980._msgData
+FNDA:1,RuleERC2980._msgData
+DA:77,1
+DA:80,238
+FN:80,RuleERC2980._contextSuffixLength
+FNDA:238,RuleERC2980._contextSuffixLength
+DA:81,238
+FNF:8
+FNH:8
+LF:12
+LH:12
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleERC2980Ownable2Step.sol
+DA:20,7
+FN:20,RuleERC2980Ownable2Step._authorizeWhitelistAdd
+FNDA:7,RuleERC2980Ownable2Step._authorizeWhitelistAdd
+DA:22,3
+FN:22,RuleERC2980Ownable2Step._authorizeWhitelistRemove
+FNDA:3,RuleERC2980Ownable2Step._authorizeWhitelistRemove
+DA:24,6
+FN:24,RuleERC2980Ownable2Step._authorizeFrozenlistAdd
+FNDA:6,RuleERC2980Ownable2Step._authorizeFrozenlistAdd
+DA:26,2
+FN:26,RuleERC2980Ownable2Step._authorizeFrozenlistRemove
+FNDA:2,RuleERC2980Ownable2Step._authorizeFrozenlistRemove
+DA:28,30
+FN:28,RuleERC2980Ownable2Step._msgSender
+FNDA:30,RuleERC2980Ownable2Step._msgSender
+DA:29,30
+DA:32,1
+FN:32,RuleERC2980Ownable2Step._msgData
+FNDA:1,RuleERC2980Ownable2Step._msgData
+DA:33,1
+DA:36,31
+FN:36,RuleERC2980Ownable2Step._contextSuffixLength
+FNDA:31,RuleERC2980Ownable2Step._contextSuffixLength
+DA:37,31
+FNF:7
+FNH:7
+LF:10
+LH:10
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleIdentityRegistry.sol
+DA:20,15
+FN:20,RuleIdentityRegistry.supportsInterface
+FNDA:15,RuleIdentityRegistry.supportsInterface
+DA:27,15
+DA:28,10
+DA:35,5
+FN:35,RuleIdentityRegistry._authorizeIdentityRegistryManager
+FNDA:5,RuleIdentityRegistry._authorizeIdentityRegistryManager
+FNF:2
+FNH:2
+LF:4
+LH:4
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleIdentityRegistryOwnable2Step.sol
+DA:15,4
+FN:15,RuleIdentityRegistryOwnable2Step._authorizeIdentityRegistryManager
+FNDA:4,RuleIdentityRegistryOwnable2Step._authorizeIdentityRegistryManager
+FNF:1
+FNH:1
+LF:1
+LH:1
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleMaxTotalSupply.sol
+DA:24,15
+FN:24,RuleMaxTotalSupply.supportsInterface
+FNDA:15,RuleMaxTotalSupply.supportsInterface
+DA:31,15
+DA:32,10
+DA:39,260
+FN:39,RuleMaxTotalSupply._authorizeMaxTotalSupplyManager
+FNDA:260,RuleMaxTotalSupply._authorizeMaxTotalSupplyManager
+FNF:2
+FNH:2
+LF:4
+LH:4
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleMaxTotalSupplyOwnable2Step.sol
+DA:18,4
+FN:18,RuleMaxTotalSupplyOwnable2Step._authorizeMaxTotalSupplyManager
+FNDA:4,RuleMaxTotalSupplyOwnable2Step._authorizeMaxTotalSupplyManager
+FNF:1
+FNH:1
+LF:1
+LH:1
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleSanctionsList.sol
+DA:26,58
+FN:26,RuleSanctionsList.supportsInterface
+FNDA:58,RuleSanctionsList.supportsInterface
+DA:33,58
+DA:34,39
+DA:41,17
+FN:41,RuleSanctionsList._authorizeSanctionListManager
+FNDA:17,RuleSanctionsList._authorizeSanctionListManager
+DA:47,57
+FN:47,RuleSanctionsList._msgSender
+FNDA:57,RuleSanctionsList._msgSender
+DA:48,57
+DA:51,1
+FN:51,RuleSanctionsList._msgData
+FNDA:1,RuleSanctionsList._msgData
+DA:52,1
+DA:55,58
+FN:55,RuleSanctionsList._contextSuffixLength
+FNDA:58,RuleSanctionsList._contextSuffixLength
+DA:56,58
+FNF:5
+FNH:5
+LF:10
+LH:10
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleSanctionsListOwnable2Step.sol
+DA:21,3
+FN:21,RuleSanctionsListOwnable2Step._authorizeSanctionListManager
+FNDA:3,RuleSanctionsListOwnable2Step._authorizeSanctionListManager
+DA:23,11
+FN:23,RuleSanctionsListOwnable2Step._msgSender
+FNDA:11,RuleSanctionsListOwnable2Step._msgSender
+DA:24,11
+DA:27,1
+FN:27,RuleSanctionsListOwnable2Step._msgData
+FNDA:1,RuleSanctionsListOwnable2Step._msgData
+DA:28,1
+DA:31,13
+FN:31,RuleSanctionsListOwnable2Step._contextSuffixLength
+FNDA:13,RuleSanctionsListOwnable2Step._contextSuffixLength
+DA:32,13
+FNF:4
+FNH:4
+LF:7
+LH:7
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleWhitelist.sol
+DA:42,40
+FN:42,RuleWhitelist.supportsInterface
+FNDA:40,RuleWhitelist.supportsInterface
+DA:49,40
+DA:56,1
+FN:56,RuleWhitelist._authorizeCheckSpenderManager
+FNDA:1,RuleWhitelist._authorizeCheckSpenderManager
+DA:58,348
+FN:58,RuleWhitelist._authorizeAddressListAdd
+FNDA:348,RuleWhitelist._authorizeAddressListAdd
+DA:60,263
+FN:60,RuleWhitelist._authorizeAddressListRemove
+FNDA:263,RuleWhitelist._authorizeAddressListRemove
+DA:62,772
+FN:62,RuleWhitelist._msgSender
+FNDA:772,RuleWhitelist._msgSender
+DA:63,772
+DA:66,1
+FN:66,RuleWhitelist._msgData
+FNDA:1,RuleWhitelist._msgData
+DA:67,1
+DA:70,773
+FN:70,RuleWhitelist._contextSuffixLength
+FNDA:773,RuleWhitelist._contextSuffixLength
+DA:71,773
+FNF:7
+FNH:7
+LF:11
+LH:11
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleWhitelistOwnable2Step.sol
+DA:20,2
+FN:20,RuleWhitelistOwnable2Step._authorizeAddressListAdd
+FNDA:2,RuleWhitelistOwnable2Step._authorizeAddressListAdd
+DA:22,2
+FN:22,RuleWhitelistOwnable2Step._authorizeAddressListRemove
+FNDA:2,RuleWhitelistOwnable2Step._authorizeAddressListRemove
+DA:24,2
+FN:24,RuleWhitelistOwnable2Step._authorizeCheckSpenderManager
+FNDA:2,RuleWhitelistOwnable2Step._authorizeCheckSpenderManager
+DA:26,15
+FN:26,RuleWhitelistOwnable2Step._msgSender
+FNDA:15,RuleWhitelistOwnable2Step._msgSender
+DA:27,15
+DA:30,1
+FN:30,RuleWhitelistOwnable2Step._msgData
+FNDA:1,RuleWhitelistOwnable2Step._msgData
+DA:31,1
+DA:34,16
+FN:34,RuleWhitelistOwnable2Step._contextSuffixLength
+FNDA:16,RuleWhitelistOwnable2Step._contextSuffixLength
+DA:35,16
+FNF:6
+FNH:6
+LF:9
+LH:9
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleWhitelistWrapper.sol
+DA:37,38
+FN:37,RuleWhitelistWrapper.hasRole
+FNDA:38,RuleWhitelistWrapper.hasRole
+DA:44,134
+DA:47,2
+FN:47,RuleWhitelistWrapper._authorizeCheckSpenderManager
+FNDA:2,RuleWhitelistWrapper._authorizeCheckSpenderManager
+DA:52,90
+FN:52,RuleWhitelistWrapper._onlyRulesManager
+FNDA:90,RuleWhitelistWrapper._onlyRulesManager
+DA:58,133
+FN:58,RuleWhitelistWrapper._msgSender
+FNDA:133,RuleWhitelistWrapper._msgSender
+DA:59,133
+DA:62,1
+FN:62,RuleWhitelistWrapper._msgData
+FNDA:1,RuleWhitelistWrapper._msgData
+DA:63,1
+DA:66,134
+FN:66,RuleWhitelistWrapper._contextSuffixLength
+FNDA:134,RuleWhitelistWrapper._contextSuffixLength
+DA:67,134
+DA:70,46
+FN:70,RuleWhitelistWrapper.supportsInterface
+FNDA:46,RuleWhitelistWrapper.supportsInterface
+DA:77,46
+DA:78,16
+DA:81,38
+FN:81,RuleWhitelistWrapper._grantRole
+FNDA:38,RuleWhitelistWrapper._grantRole
+DA:87,38
+DA:90,1
+FN:90,RuleWhitelistWrapper._revokeRole
+FNDA:1,RuleWhitelistWrapper._revokeRole
+DA:96,1
+FNF:9
+FNH:9
+LF:17
+LH:17
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/rules/validation/deployment/RuleWhitelistWrapperOwnable2Step.sol
+DA:28,2
+FN:28,RuleWhitelistWrapperOwnable2Step._authorizeCheckSpenderManager
+FNDA:2,RuleWhitelistWrapperOwnable2Step._authorizeCheckSpenderManager
+DA:33,2
+FN:33,RuleWhitelistWrapperOwnable2Step._onlyRulesManager
+FNDA:2,RuleWhitelistWrapperOwnable2Step._onlyRulesManager
+DA:39,12
+FN:39,RuleWhitelistWrapperOwnable2Step._msgSender
+FNDA:12,RuleWhitelistWrapperOwnable2Step._msgSender
+DA:40,12
+DA:43,1
+FN:43,RuleWhitelistWrapperOwnable2Step._msgData
+FNDA:1,RuleWhitelistWrapperOwnable2Step._msgData
+DA:44,1
+DA:47,13
+FN:47,RuleWhitelistWrapperOwnable2Step._contextSuffixLength
+FNDA:13,RuleWhitelistWrapperOwnable2Step._contextSuffixLength
+DA:48,13
+FNF:5
+FNH:5
+LF:8
+LH:8
+BRF:0
+BRH:0
+end_of_record
diff --git a/doc/schema/RuleEngine b/doc/schema/RuleEngine.drawio
similarity index 100%
rename from doc/schema/RuleEngine
rename to doc/schema/RuleEngine.drawio
diff --git a/doc/schema/rule/IncomeVault-claimDividend.drawio.png b/doc/schema/rule/IncomeVault-claimDividend.drawio.png
deleted file mode 100644
index 3056bfe4aa200c30a237a45cadcbc8974e60fc2c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 100066
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
avPDm9iYQbss7?WyqtnwmN`9zeAMsx`uF;?X

diff --git a/doc/schema/rule/conditionalTransfer-Storage.drawio.png b/doc/schema/rule/conditionalTransfer-Storage.drawio.png
deleted file mode 100644
index 6fa3d10732f85082dad8f67d8c3bb32325cf9610..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 89794
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

diff --git a/doc/schema/rule/conditionalTransfer-automaticTransfer.drawio.png b/doc/schema/rule/conditionalTransfer-automaticTransfer.drawio.png
deleted file mode 100644
index 2a97df822f05d812eba97ca0d4c45429703d4bdd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 83764
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

diff --git a/doc/schema/rule/conditionalTransfer-state machine.drawio.png b/doc/schema/rule/conditionalTransfer-state machine.drawio.png
deleted file mode 100644
index ff4388e435ec06c4c1c3976e94682563dff49b48..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 53914
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

diff --git a/doc/schema/rule/conditionalTransfer.drawio b/doc/schema/rule/conditionalTransfer.drawio
deleted file mode 100644
index 9f632cc..0000000
--- a/doc/schema/rule/conditionalTransfer.drawio
+++ /dev/null
@@ -1 +0,0 @@
-<mxfile host="Electron" modified="2024-12-20T15:34:32.965Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.6.2 Chrome/106.0.5249.199 Electron/21.3.3 Safari/537.36" etag="UE2jRP0CAxyC1qTDPbeS" version="20.6.2" type="device" pages="6"><diagram id="RMev6u8X31zlaa3eMq0A" name="WithStorage">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</diagram><diagram name="CMTAT" id="hyP_GePwtFDzV7Mnq2Vm">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</diagram><diagram name="automaticTransfer" id="-ZNkVo-wu91Cdr4hWdzM">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</diagram><diagram id="hkqa1wpraYgbvzofkrop" name="state machine">3Vpbc9o6EP41PCZjWbYxjxDoZaYnzcnlNHk6o2ABbo1FhQjQX18ZyxdJBgwxttuZTMZaryV599tPu4s78Ga++UjRYvYP8XDQMQ1v04HDjmkCyzQ70Z/hbWOJ7bqxYEp9Tyhlggf/FxZCQ0hXvoeXkiIjJGD+QhaOSRjiMZNkiFKyltUmJJBXXaAp1gQPYxTo0m++x2ax1ITQyW58wv50lizt2FZ8Z44SbfEqyxnyyDongqMOvKGEsPhqvrnBQWS9xDDxcx/23E13RnHIyjzw6RaN+1NGB4sNotPp0+I7fbkSs7yhYCXe+Fv/86PYMNsmZuAzcYvzwWA98xl+WKBxdGfNnc5lMzYP+AjwS31TyQqYMrzJicQmP2Iyx4xuuYq4axnCYAIywBbjdeYAkBh1lrO9K2RI+HyaTp1ZhV8Iw5xgJFszElosKHnDHpe+RlsnC0wRI1Q3XOj1Ixjy0ThAy6U/lu1FySr0cLS4wUd447NncSe6fonk17YYDTc5teFWDPZafElWdIyP+x57UgjofsnZ3S4weyKjOEDMf5MDp8gXYoU74vMdp263u7LbUwpIpojfRzyVx7kykeMq+OkpEzFuAsy0iXbQSF/7fLQ4Glr6d3f3X/8bDRsNK8dpW1h1NUM1ED7coHT7nB/knoqG2WO70fvDTuAjRuEBPbdV4QktGT5QhUXZ8HS7zYZnT0MdoyhcTjDd0Tne4PGKZczOyA8cRiblmQMu4HfunS/olWc9Ei5R4E/DCLQcHfwpOIji1OdpRV/cmPueF80xoHjp/0Kvu/kiXC2i995Zwh507GEh0g5Gk0oIaW4kFpGyjyKiuDKuoeSh5KB4L4KAPCtUZiCTyRJfxOWu5vLR8+jm6bFhRu7ZbWPk5MitkJIL6RUcIddK86CjROu0imjNnkK0wD6PaC2FaFMGr4logV5beD7lRBRExhxTjGKaReHuf+mMujWMm0ZLFZQLelZP5kfrfXC6PK0CvS46xBbco+Eu0r0PfpC4jY9E0Q/MMqldxgIveRKoJ7U7yiRnVFTAqYg2urYc7caZ+RlU6gSzZH7G3Yy2OTURVvs3rJRpUG1fHNFP8sYM1PEOKoW4CTWIx8TFZY8ibeSX9/jnCi9Zm7kqidVKuMo2e60nJ70Mr5mcQElyyvioTGq0l5yO1p1uSRI7o+6sisRcqHBPVUUmhDXnPqf1NipBH2juYCzbajx+gDYIPlsBH1Dz5XMbkE7N2NM7HB4O/T8rta6sm2FcW9CyZDJo/dmlNyyGo9vPTTeQlQ5g490KU+9W3JIQN2qk9FcLJatt0EpWjUdRltR0bVc+XHq2c6zrE43uMPX5i0c8U39bp6qjBBgKDEw1/yjdxDHqqca0HUNwuBzr2uCQ/oXKMb3j8He1lNJgreDcg4bTlVx0ZVYCbuU0TU+ry5+LZuM1Xdm8Wq7pjCPEt5fjKqvpGmxMuXvShlOZEBjG4YkuxYTWMSI8Sd1yDqlfiDb1avTP7GKlBFDJj5zAkTvu76THGvhPrwsuxn97OakJDlFLDzUJKsshWnZesjQ/ubcNCvdbdlugDlJIMtIcmO5xAtyWhn+C/yqyI1POYtoU/P7Xf//Hs6enB2v0vftK3NvZzy8FX2peLPYnJGSJopXPa0Cnpn5h2W+kkkq6DaSkkUnpZrVRDyt1zeJ1qqKZQtiaGmwpnvOqLK3PUNAE46gQ16F6MAgrICBD+b22Of7hw+wr9Fg9+5gfjn4D</diagram><diagram id="aDVc8EfWFfUY6GKgifOD" name="Page-4">zVdLj9owEP41OVIlcRLocXl0e9iqaEFtOa3cZCAuTswah0d/fW3ihDiGLkVlBeLgeXic+ebz2HbQINs9crxKv7AEqOO7yc5BQ8f3vcD3HfV3k32p8f1AaxacJNrrqJiQ36CVrtYWJIG14SgYo4KsTGXM8hxiYegw52xrus0ZNVdd4QVYikmMqa39ThKR6jQQio6Gz0AWabV0FAalJcOVt05lneKEbRsqNHLQgDMmylG2GwBV8FXAlPM+nbHWX8YhF5dMYC9k+Dr4VWyG7tNr2psul0Gno6NsMC10xkMswFGhIpytHNSnMnj/YHKnJIMnkhExZVOO8/UcuE5N7CvAeMqyn4VEvb9NiYDJCsfKspX8kLpUZFRKnhzOWS50vb1QLWGlU30bcAG7hkqn9wgsA8H30kVbg0BDrdnmIS1vG6WrfNJG1eoaYU2XRR37CKgcaEz/AV/fwncisJD4yBWleID1YTx+/vptNLwvLLuhgWXH82wwve4JML3wVmAiC0wLMsiTB7XtpRRTvF6T2ESKsyJPQC3insBNwsX3P5TxQy3OtO9BGO4MaV9JOyIa06Q00+up8XGSEqo5Z2u0ZgWP4S8w9HQfxHwB4m3uQWK0OLvijYKGJ+pZ6ThQLMjGbIynaqxXGDMiM6sJFUZui1BBiydl4npas5G1I3ntSKgVqYTGinQgXZ349TwMLB7O5Bn1n6n4rpTyL6SUd1eUilr9vnsloaKPZpz2aXBjOoU3b2tXcOnaVng9B6vr3VscjO6Lg6HJnaBNnou7Wqs/Bu1j9MYsjCwWPoMoeK5KwqXKupwYlHv/C0rongG+eT/xTxQ+utX1pHfBPqZUvlzABEc+DFbKLje5uhwq65xQOmCU8cM05B5+ylVwtoSGZT7XllsgHLSvgD0bYnQC4fZxfAHCUjy+hEpKH1+UaPQH</diagram><diagram id="-F_VF-Kfj4-Zbea-uXU7" name="vesting rule">zVhZc9owEP41nmkfwtiSLx7J1XammR40SfPUEbbAmtiWR5YD9NdXsmV8CBpgIM4Dg7Ta1fHtt7uSDXiVrD4xlEV3NMSxAcxwZcBrAwALOkD8Scm6kji+XwkWjIRKqRFMyV+shKaSFiTEeUeRUxpzknWFAU1THPCODDFGl121OY27q2ZogTXBNECxLn0kIY8qKYDQbQY+Y7KI6qVdx65GElRrq6PkEQrpsiWCNwa8YpTyqpWsrnAs0auBqexud4xudsZwyvcxKH78eXjMp/j+FpFJ9pCy2Ty7ULO8oLhQJ54WiRDQuQSwtC/HcnkATkpBTINnHKpD8XUNFaNFGmK5mGXAy2VEOJ5mKJCjS0EOIYt4EqthtSxmHK92nsfaoCT4hWmCOVsLFWUAXQVsTS3VXTZ+ssZKFrVdVHMLKW4sNlM36ImGAvAAMIEGpgYSTsOJpKXoBTHKcxJ0cWlANEVPIMHWv2Vn5NTdp/bY9arTW9e9FeEtM9F7UvPLdmMkO7VNtVUcavHQ84c4Di1YgF8nFUdsgfl/9Ozt/m050Nniv1rGcIw4eelud5tP1QrfKREH2dDHGXfpA0GPFtUxlVU7rnoTuU53IuD1Jqpw0CYqKbY59vGsgxrrfmJesFR6gAnR0HFq9YC2/T0D1TlXnNoaYpcoRqmAAJgX4jdJBETSwwZwUSIRWXCJhVQ1p/d3Hy6rFPhRxzaiyazI3yb/wR7vLB3XrQFk+ecC1jl5AqwTWSuNNUnt7InM3jORwSETmd2rg3B8ZCID/o5AfSWRCX+idUstkwr57g0D3+lu2OxcXESjmvGkWdI9FzWtA6h5bD0fgNLekJR2QY+JR9dmrxcbe9bmQyntmgNQ2ttd+Ocozoev/I713ir/WIPsi3zo/GrX+rip9TNZ50ecJDjn5eBEaJXjMyZa5a0gL99LBlAmqLw7fBV2XMNfvAAz2cwYDXC+xy1hhoLnRem1bwWPSYpP5xvP7vrG2uIbYG7xjXsu39RkGTZFnzDV7vsMsnZ46o1ybS9ILXhkrvXM7kT9a8iZn0GW/injljKj/oox2cTl+w7LXuVzvJGjx6W9hQ5j51xxqT+XThSXh3yeeAdXJ2vfgB4PGc++tyOxHxrPfu/dbplg1OPY0SEtus2Hz0q9+X4Mb/4B</diagram></mxfile>
\ No newline at end of file
diff --git a/doc/schema/rule/conditionalTransferCMTAT.drawio.png b/doc/schema/rule/conditionalTransferCMTAT.drawio.png
deleted file mode 100644
index 83cf65889f028dc201c25ea81ac742ed430337ab..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 84882
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%0DGO>BM
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
A`Tzg`

diff --git a/doc/schema/rule/conditionalTransferTime.png b/doc/schema/rule/conditionalTransferTime.png
deleted file mode 100644
index 52eefdc978079f395f9b343229a2957d3ad92278..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 29921
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
MC~7E_BP>Jz7vt_aIRF3v

diff --git a/doc/script/convert_links_for_pdf.sh b/doc/script/convert_links_for_pdf.sh
new file mode 100755
index 0000000..2f4d392
--- /dev/null
+++ b/doc/script/convert_links_for_pdf.sh
@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Script to replace relative markdown links with GitHub links for PDF generation
+# Preserves image links (they render in PDF) and external links
+
+set -e
+
+if [ -z "$1" ]; then
+    echo "Usage: $0 <github-release-link> [input-file] [output-file]"
+    echo ""
+    echo "Example:"
+    echo "  $0 https://github.com/CMTA/CMTAT/blob/v3.0.0"
+    echo "  $0 https://github.com/CMTA/CMTAT/blob/v3.0.0 README.md README_UPDATE.md"
+    exit 1
+fi
+
+GITHUB_LINK="${1%/}"  # Remove trailing slash if present
+INPUT_FILE="${2:-../../README.md}"
+OUTPUT_FILE="${3:-README_UPDATE.md}"
+
+if [ ! -f "$INPUT_FILE" ]; then
+    echo "Error: Input file '$INPUT_FILE' not found"
+    exit 1
+fi
+
+# Create a temporary file
+TMP_FILE=$(mktemp)
+cp "$INPUT_FILE" "$TMP_FILE"
+
+# Use a placeholder to avoid sed escaping issues
+PLACEHOLDER="__GITHUB_LINK__"
+
+# Step 1: Convert ALL relative links [text](./...) to placeholder
+sed -i -E "s|\[([^]]+)\]\(\./([^)]+)\)|[\1]($PLACEHOLDER/\2)|g" "$TMP_FILE"
+
+# Step 2: Restore image links back to relative (images render inline in PDF)
+for ext in png jpg jpeg gif svg ico webp bmp tiff; do
+    sed -i -E "s|\[([^]]+)\]\($PLACEHOLDER/([^)]+\.$ext)\)|[\1](./\2)|gi" "$TMP_FILE"
+done
+
+# Step 3: Replace placeholder with actual GitHub link
+sed -i "s|$PLACEHOLDER|$GITHUB_LINK|g" "$TMP_FILE"
+
+mv "$TMP_FILE" "$OUTPUT_FILE"
+
+echo "Created '$OUTPUT_FILE' with GitHub links pointing to:"
+echo "  $GITHUB_LINK"
diff --git a/doc/security/accessControl/access-control-RuleEngine.png b/doc/security/accessControl/access-control-RuleEngine.png
deleted file mode 100644
index a7113974a111e7ca79da98024774bdd908f70f4e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 30462
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
C^0jRM

diff --git a/doc/technical/RuleBlacklist.md b/doc/technical/RuleBlacklist.md
index 9ebe1aa..bace50e 100644
--- a/doc/technical/RuleBlacklist.md
+++ b/doc/technical/RuleBlacklist.md
@@ -69,4 +69,4 @@ Single-item operations (`addAddress`, `removeAddress`) revert on duplicate/missi
 
 ### Usage scenario
 
-The operator deploys `RuleBlacklist`, grants `ADDRESS_LIST_ADD_ROLE` to a compliance manager, and registers the rule in the `RuleEngine`. The compliance manager calls `addAddresses([badActor])`. Any transfer from, to, or by the blacklisted address is rejected with codes 36, 37, or 38.
+The operator deploys `RuleBlacklist`, grants `ADDRESS_LIST_ADD_ROLE` to a compliance manager, and registers the rule in the `RuleEngine`. The compliance manager calls `addAddresses([badActor])`. Any transfer from, to, or by the blacklisted address is rejected with codes 36, 37, or 38.rea
diff --git a/src/rules/operation/RuleConditionalTransferLight.sol b/src/rules/operation/RuleConditionalTransferLight.sol
index d32774d..e58a736 100644
--- a/src/rules/operation/RuleConditionalTransferLight.sol
+++ b/src/rules/operation/RuleConditionalTransferLight.sol
@@ -22,10 +22,7 @@ contract RuleConditionalTransferLight is
     /**
      * @param admin Address of the contract admin.
      */
-    constructor(address admin) AccessControlModuleStandalone(admin) {
-        require(admin != address(0), RuleConditionalTransferLight_AdminAddressZeroNotAllowed());
-
-    }
+    constructor(address admin) AccessControlModuleStandalone(admin) {}
 
     function supportsInterface(bytes4 interfaceId)
         public
diff --git a/test/Coverage/DeploymentOperationCoverage.t.sol b/test/Coverage/DeploymentOperationCoverage.t.sol
new file mode 100644
index 0000000..f71291a
--- /dev/null
+++ b/test/Coverage/DeploymentOperationCoverage.t.sol
@@ -0,0 +1,195 @@
+// SPDX-License-Identifier: MPL-2.0
+pragma solidity ^0.8.20;
+
+import {Test} from "forge-std/Test.sol";
+import {HelperContract} from "../HelperContract.sol";
+import {IERC165} from "OZ/utils/introspection/IERC165.sol";
+import {IRule} from "RuleEngine/interfaces/IRule.sol";
+import {RuleInterfaceId} from "RuleEngine/modules/library/RuleInterfaceId.sol";
+import {ISanctionsList} from "src/rules/interfaces/ISanctionsList.sol";
+import {RuleConditionalTransferLight} from "src/rules/operation/RuleConditionalTransferLight.sol";
+import {RuleConditionalTransferLightOwnable2Step} from "src/rules/operation/RuleConditionalTransferLightOwnable2Step.sol";
+import {RuleBlacklist} from "src/rules/validation/deployment/RuleBlacklist.sol";
+import {RuleWhitelist} from "src/rules/validation/deployment/RuleWhitelist.sol";
+import {RuleWhitelistWrapper} from "src/rules/validation/deployment/RuleWhitelistWrapper.sol";
+import {RuleERC2980} from "src/rules/validation/deployment/RuleERC2980.sol";
+import {RuleSanctionsList} from "src/rules/validation/deployment/RuleSanctionsList.sol";
+import {RuleBlacklistOwnable2Step} from "src/rules/validation/deployment/RuleBlacklistOwnable2Step.sol";
+import {RuleWhitelistOwnable2Step} from "src/rules/validation/deployment/RuleWhitelistOwnable2Step.sol";
+import {RuleWhitelistWrapperOwnable2Step} from "src/rules/validation/deployment/RuleWhitelistWrapperOwnable2Step.sol";
+import {RuleERC2980Ownable2Step} from "src/rules/validation/deployment/RuleERC2980Ownable2Step.sol";
+
+contract RuleBlacklistHarness is RuleBlacklist {
+    constructor(address admin, address forwarderIrrevocable) RuleBlacklist(admin, forwarderIrrevocable) {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleWhitelistHarness is RuleWhitelist {
+    constructor(address admin, address forwarderIrrevocable, bool checkSpender_)
+        RuleWhitelist(admin, forwarderIrrevocable, checkSpender_)
+    {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleWhitelistWrapperHarness is RuleWhitelistWrapper {
+    constructor(address admin, address forwarderIrrevocable, bool checkSpender_)
+        RuleWhitelistWrapper(admin, forwarderIrrevocable, checkSpender_)
+    {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleERC2980Harness is RuleERC2980 {
+    constructor(address admin, address forwarderIrrevocable) RuleERC2980(admin, forwarderIrrevocable) {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleSanctionsListHarness is RuleSanctionsList {
+    constructor(address admin, address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)
+        RuleSanctionsList(admin, forwarderIrrevocable, sanctionContractOracle_)
+    {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleBlacklistOwnable2StepHarness is RuleBlacklistOwnable2Step {
+    constructor(address owner, address forwarderIrrevocable) RuleBlacklistOwnable2Step(owner, forwarderIrrevocable) {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleWhitelistOwnable2StepHarness is RuleWhitelistOwnable2Step {
+    constructor(address owner, address forwarderIrrevocable, bool checkSpender_)
+        RuleWhitelistOwnable2Step(owner, forwarderIrrevocable, checkSpender_)
+    {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleWhitelistWrapperOwnable2StepHarness is RuleWhitelistWrapperOwnable2Step {
+    constructor(address owner, address forwarderIrrevocable, bool checkSpender_)
+        RuleWhitelistWrapperOwnable2Step(owner, forwarderIrrevocable, checkSpender_)
+    {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract RuleERC2980Ownable2StepHarness is RuleERC2980Ownable2Step {
+    constructor(address owner, address forwarderIrrevocable) RuleERC2980Ownable2Step(owner, forwarderIrrevocable) {}
+
+    function exposedMsgDataLength() external view returns (uint256) {
+        return _msgData().length;
+    }
+}
+
+contract DeploymentCoverageExtraTest is Test, HelperContract {
+    function testDeploymentWrappersAndHooksCoverage() public {
+        RuleBlacklistHarness blacklist = new RuleBlacklistHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS);
+        RuleWhitelistHarness whitelist = new RuleWhitelistHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS, true);
+        RuleWhitelistWrapperHarness wrapper = new RuleWhitelistWrapperHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS, true);
+        RuleERC2980Harness erc2980 = new RuleERC2980Harness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS);
+        RuleSanctionsListHarness sanctions =
+            new RuleSanctionsListHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS, ISanctionsList(ZERO_ADDRESS));
+
+        RuleBlacklistOwnable2StepHarness blacklistOwnable =
+            new RuleBlacklistOwnable2StepHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS);
+        RuleWhitelistOwnable2StepHarness whitelistOwnable =
+            new RuleWhitelistOwnable2StepHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS, true);
+        RuleWhitelistWrapperOwnable2StepHarness wrapperOwnable =
+            new RuleWhitelistWrapperOwnable2StepHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS, true);
+        RuleERC2980Ownable2StepHarness erc2980Ownable =
+            new RuleERC2980Ownable2StepHarness(DEFAULT_ADMIN_ADDRESS, ZERO_ADDRESS);
+
+        assertGe(blacklist.exposedMsgDataLength(), 4);
+        assertGe(whitelist.exposedMsgDataLength(), 4);
+        assertGe(wrapper.exposedMsgDataLength(), 4);
+        assertGe(erc2980.exposedMsgDataLength(), 4);
+        assertGe(sanctions.exposedMsgDataLength(), 4);
+        assertGe(blacklistOwnable.exposedMsgDataLength(), 4);
+        assertGe(whitelistOwnable.exposedMsgDataLength(), 4);
+        assertGe(wrapperOwnable.exposedMsgDataLength(), 4);
+        assertGe(erc2980Ownable.exposedMsgDataLength(), 4);
+
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        blacklist.addAddress(ADDRESS1);
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        blacklist.removeAddress(ADDRESS1);
+
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        whitelist.setCheckSpender(false);
+
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        wrapper.setCheckSpender(false);
+
+        bytes32 rulesManagerRole = wrapper.RULES_MANAGEMENT_ROLE();
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        wrapper.grantRole(rulesManagerRole, ADDRESS1);
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        wrapper.revokeRole(rulesManagerRole, ADDRESS1);
+
+        assertFalse(blacklist.supportsInterface(bytes4(0xdeadbeef)));
+        assertFalse(whitelist.supportsInterface(bytes4(0xdeadbeef)));
+        assertFalse(wrapper.supportsInterface(bytes4(0xdeadbeef)));
+        assertFalse(erc2980.supportsInterface(bytes4(0xdeadbeef)));
+        assertFalse(sanctions.supportsInterface(bytes4(0xdeadbeef)));
+    }
+}
+
+contract OperationCoverageExtraTest is Test, HelperContract {
+    function testConditionalTransferLightCreatedDestroyedAndInterfaces() public {
+        RuleConditionalTransferLight rule = new RuleConditionalTransferLight(DEFAULT_ADMIN_ADDRESS);
+
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        rule.bindToken(address(this));
+
+        rule.created(ADDRESS1, 1);
+        rule.destroyed(ADDRESS1, 1);
+
+        assertTrue(rule.supportsInterface(type(IRule).interfaceId));
+        assertTrue(rule.supportsInterface(RuleInterfaceId.IRULE_INTERFACE_ID));
+        assertFalse(rule.supportsInterface(bytes4(0xdeadbeef)));
+    }
+
+    function testConditionalTransferLightOwnableViewAndOverloads() public {
+        RuleConditionalTransferLightOwnable2Step rule =
+            new RuleConditionalTransferLightOwnable2Step(CONDITIONAL_TRANSFER_OPERATOR_ADDRESS);
+
+        vm.prank(CONDITIONAL_TRANSFER_OPERATOR_ADDRESS);
+        rule.approveTransfer(ADDRESS1, ADDRESS2, 77);
+
+        vm.prank(CONDITIONAL_TRANSFER_OPERATOR_ADDRESS);
+        rule.transferred(ADDRESS3, ADDRESS1, ADDRESS2, 77);
+
+        assertEq(rule.approvedCount(ADDRESS1, ADDRESS2, 77), 0);
+        assertEq(rule.detectTransferRestrictionFrom(ADDRESS3, ADDRESS1, ADDRESS2, 77), CODE_TRANSFER_REQUEST_NOT_APPROVED);
+        assertFalse(rule.canTransfer(ADDRESS1, ADDRESS2, 77));
+        assertFalse(rule.canTransferFrom(ADDRESS3, ADDRESS1, ADDRESS2, 77));
+        assertTrue(rule.canReturnTransferRestrictionCode(CODE_TRANSFER_REQUEST_NOT_APPROVED));
+        assertEq(rule.messageForTransferRestriction(CODE_TRANSFER_REQUEST_NOT_APPROVED), TEXT_TRANSFER_REQUEST_NOT_APPROVED);
+        assertEq(rule.messageForTransferRestriction(CODE_NONEXISTENT), TEXT_CODE_NOT_FOUND);
+
+        assertTrue(rule.supportsInterface(type(IERC165).interfaceId));
+        assertTrue(rule.supportsInterface(type(IRule).interfaceId));
+        assertTrue(rule.supportsInterface(RuleInterfaceId.IRULE_INTERFACE_ID));
+        assertFalse(rule.supportsInterface(bytes4(0xdeadbeef)));
+    }
+}
diff --git a/test/RuleConditionalTransferLight/RuleConditionalTransferLightApproveAndTransfer.t.sol b/test/RuleConditionalTransferLight/RuleConditionalTransferLightApproveAndTransfer.t.sol
index ddb2087..24a2891 100644
--- a/test/RuleConditionalTransferLight/RuleConditionalTransferLightApproveAndTransfer.t.sol
+++ b/test/RuleConditionalTransferLight/RuleConditionalTransferLightApproveAndTransfer.t.sol
@@ -6,6 +6,22 @@ import {HelperContract} from "../HelperContract.sol";
 import {RuleConditionalTransferLight} from "src/rules/operation/RuleConditionalTransferLight.sol";
 import {MockERC20WithTransferContext} from "../utils/MockERC20WithTransferContext.sol";
 
+contract MockERC20TransferFromFalse {
+    mapping(address => mapping(address => uint256)) private _allowances;
+
+    function setAllowance(address owner, address spender, uint256 value) external {
+        _allowances[owner][spender] = value;
+    }
+
+    function allowance(address owner, address spender) external view returns (uint256) {
+        return _allowances[owner][spender];
+    }
+
+    function transferFrom(address, address, uint256) external pure returns (bool) {
+        return false;
+    }
+}
+
 contract RuleConditionalTransferLightApproveAndTransfer is Test, HelperContract {
     RuleConditionalTransferLight private rule;
     MockERC20WithTransferContext private token;
@@ -33,4 +49,29 @@ contract RuleConditionalTransferLightApproveAndTransfer is Test, HelperContract
         assertEq(token.balanceOf(ADDRESS2), 10);
         assertEq(rule.approvedCount(ADDRESS1, ADDRESS2, 10), 0);
     }
+
+    function testApproveAndTransferIfAllowedRevertsOnZeroToken() public {
+        vm.expectRevert(RuleConditionalTransferLight_TokenAddressZeroNotAllowed.selector);
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        rule.approveAndTransferIfAllowed(ZERO_ADDRESS, ADDRESS1, ADDRESS2, 10);
+    }
+
+    function testApproveAndTransferIfAllowedRevertsOnInsufficientAllowance() public {
+        vm.expectRevert(
+            abi.encodeWithSelector(
+                RuleConditionalTransferLight_InsufficientAllowance.selector, address(token), ADDRESS1, 0, 10
+            )
+        );
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        rule.approveAndTransferIfAllowed(address(token), ADDRESS1, ADDRESS2, 10);
+    }
+
+    function testApproveAndTransferIfAllowedRevertsOnTransferFailure() public {
+        MockERC20TransferFromFalse failingToken = new MockERC20TransferFromFalse();
+        failingToken.setAllowance(ADDRESS1, address(rule), 10);
+
+        vm.expectRevert(RuleConditionalTransferLight_TransferFailed.selector);
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        rule.approveAndTransferIfAllowed(address(failingToken), ADDRESS1, ADDRESS2, 10);
+    }
 }
diff --git a/test/RuleConditionalTransferLight/RuleConditionalTransferLightRuleEngineIntegration.t.sol b/test/RuleConditionalTransferLight/RuleConditionalTransferLightRuleEngineIntegration.t.sol
index b6f599b..b93b76c 100644
--- a/test/RuleConditionalTransferLight/RuleConditionalTransferLightRuleEngineIntegration.t.sol
+++ b/test/RuleConditionalTransferLight/RuleConditionalTransferLightRuleEngineIntegration.t.sol
@@ -90,6 +90,7 @@ contract RuleConditionalTransferLightRuleEngineIntegration is Test, HelperContra
     function testFuzz_ApproveAndConsume(address from, address to, uint96 value, uint8 approvals, uint8 consumes) public {
         approvals = uint8(bound(approvals, 0, 20));
         consumes = uint8(bound(consumes, 0, approvals));
+        bool isMintOrBurnPath = from == address(0) || to == address(0);
 
         for (uint256 i = 0; i < approvals; ++i) {
             vm.prank(CONDITIONAL_TRANSFER_OPERATOR_ADDRESS);
@@ -102,6 +103,7 @@ contract RuleConditionalTransferLightRuleEngineIntegration is Test, HelperContra
         }
 
         resUint256 = ruleConditionalTransferLight.approvedCount(from, to, value);
-        assertEq(resUint256, approvals - consumes);
+        uint256 expectedCount = isMintOrBurnPath ? approvals : approvals - consumes;
+        assertEq(resUint256, expectedCount);
     }
 }
diff --git a/test/RuleConditionalTransferLight/RuleConditionalTransferLightUnit.t.sol b/test/RuleConditionalTransferLight/RuleConditionalTransferLightUnit.t.sol
index 4d730ee..d19f79b 100644
--- a/test/RuleConditionalTransferLight/RuleConditionalTransferLightUnit.t.sol
+++ b/test/RuleConditionalTransferLight/RuleConditionalTransferLightUnit.t.sol
@@ -14,6 +14,11 @@ contract RuleConditionalTransferLightUnit is Test, HelperContract {
         rule.bindToken(ADDRESS3);
     }
 
+    function testConstructorRevertsOnZeroAdmin() public {
+        vm.expectRevert();
+        new RuleConditionalTransferLight(address(0));
+    }
+
     function testApproveTransfer_OnlyOperator() public {
         vm.expectRevert();
         vm.prank(ADDRESS1);
@@ -60,4 +65,18 @@ contract RuleConditionalTransferLightUnit is Test, HelperContract {
         resBool = rule.canTransfer(ADDRESS1, ADDRESS2, 10);
         assertEq(resBool, true);
     }
+
+    function testDetectRestrictionMintOrBurnPathReturnsTransferOk() public {
+        resUint8 = rule.detectTransferRestriction(address(0), ADDRESS2, 10);
+        assertEq(resUint8, TRANSFER_OK);
+
+        resUint8 = rule.detectTransferRestriction(ADDRESS1, address(0), 10);
+        assertEq(resUint8, TRANSFER_OK);
+
+        resBool = rule.canTransfer(address(0), ADDRESS2, 10);
+        assertTrue(resBool);
+
+        resBool = rule.canTransfer(ADDRESS1, address(0), 10);
+        assertTrue(resBool);
+    }
 }
diff --git a/test/RuleERC2980/RuleERC2980.t.sol b/test/RuleERC2980/RuleERC2980.t.sol
index 71fb707..bfebdfb 100644
--- a/test/RuleERC2980/RuleERC2980.t.sol
+++ b/test/RuleERC2980/RuleERC2980.t.sol
@@ -401,4 +401,36 @@ contract RuleERC2980Test is Test, HelperContract {
         assertTrue(results[0]);
         assertFalse(results[1]);
     }
+
+    function testBatchOperationsSkipDuplicatesAndMissingEntries() public {
+        // Whitelist: duplicate entry should be skipped in batch add path.
+        address[] memory whitelistToAdd = new address[](1);
+        whitelistToAdd[0] = ADDRESS2; // already whitelisted in setUp
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        ruleERC2980.addWhitelistAddresses(whitelistToAdd);
+        assertEq(ruleERC2980.whitelistAddressCount(), 1);
+
+        // Whitelist: removing a missing address should be skipped in batch remove path.
+        address[] memory whitelistToRemove = new address[](1);
+        whitelistToRemove[0] = ADDRESS3; // not whitelisted
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        ruleERC2980.removeWhitelistAddresses(whitelistToRemove);
+        assertEq(ruleERC2980.whitelistAddressCount(), 1);
+
+        // Frozenlist: duplicate entry should be skipped in batch add path.
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        ruleERC2980.addFrozenlistAddress(ADDRESS1);
+        address[] memory frozenToAdd = new address[](1);
+        frozenToAdd[0] = ADDRESS1; // already frozen
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        ruleERC2980.addFrozenlistAddresses(frozenToAdd);
+        assertEq(ruleERC2980.frozenlistAddressCount(), 1);
+
+        // Frozenlist: removing a missing address should be skipped in batch remove path.
+        address[] memory frozenToRemove = new address[](1);
+        frozenToRemove[0] = ADDRESS3; // not frozen
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        ruleERC2980.removeFrozenlistAddresses(frozenToRemove);
+        assertEq(ruleERC2980.frozenlistAddressCount(), 1);
+    }
 }
diff --git a/test/RuleIdentityRegistry/Ownable/RuleIdentityRegistryOwnable2Step.t.sol b/test/RuleIdentityRegistry/Ownable/RuleIdentityRegistryOwnable2Step.t.sol
new file mode 100644
index 0000000..4f8b069
--- /dev/null
+++ b/test/RuleIdentityRegistry/Ownable/RuleIdentityRegistryOwnable2Step.t.sol
@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: MPL-2.0
+pragma solidity ^0.8.20;
+
+import {Test} from "forge-std/Test.sol";
+import {HelperContract} from "../../HelperContract.sol";
+import {Ownable2StepTestBase, IOwnable2StepLike} from "../../utils/Ownable2StepTestBase.sol";
+import {IdentityRegistryMock} from "../../utils/IdentityRegistryMock.sol";
+import {RuleIdentityRegistryOwnable2Step} from
+    "src/rules/validation/deployment/RuleIdentityRegistryOwnable2Step.sol";
+
+contract RuleIdentityRegistryOwnable2StepTest is Ownable2StepTestBase {
+    function _deployOwnable2Step() internal override returns (IOwnable2StepLike, address) {
+        address ownerAddr = WHITELIST_OPERATOR_ADDRESS;
+        IdentityRegistryMock registry = new IdentityRegistryMock();
+        RuleIdentityRegistryOwnable2Step rule = new RuleIdentityRegistryOwnable2Step(ownerAddr, address(registry));
+        return (IOwnable2StepLike(address(rule)), ownerAddr);
+    }
+}
+
+contract RuleIdentityRegistryOwnable2StepAccessControl is Test, HelperContract {
+    error OwnableUnauthorizedAccount(address account);
+
+    RuleIdentityRegistryOwnable2Step private rule;
+    IdentityRegistryMock private registry;
+
+    function setUp() public {
+        registry = new IdentityRegistryMock();
+        rule = new RuleIdentityRegistryOwnable2Step(WHITELIST_OPERATOR_ADDRESS, address(registry));
+    }
+
+    function testOwnerCanSetAndClearIdentityRegistry() public {
+        IdentityRegistryMock newRegistry = new IdentityRegistryMock();
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        rule.setIdentityRegistry(address(newRegistry));
+        assertEq(address(rule.identityRegistry()), address(newRegistry));
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        rule.clearIdentityRegistry();
+        assertEq(address(rule.identityRegistry()), ZERO_ADDRESS);
+    }
+
+    function testNonOwnerCannotManageIdentityRegistry() public {
+        vm.expectRevert(abi.encodeWithSelector(OwnableUnauthorizedAccount.selector, ATTACKER));
+        vm.prank(ATTACKER);
+        rule.setIdentityRegistry(address(registry));
+
+        vm.expectRevert(abi.encodeWithSelector(OwnableUnauthorizedAccount.selector, ATTACKER));
+        vm.prank(ATTACKER);
+        rule.clearIdentityRegistry();
+    }
+}
diff --git a/test/RuleIdentityRegistry/RuleIdentityRegistryUnit.t.sol b/test/RuleIdentityRegistry/RuleIdentityRegistryUnit.t.sol
index 3a886e1..f59db86 100644
--- a/test/RuleIdentityRegistry/RuleIdentityRegistryUnit.t.sol
+++ b/test/RuleIdentityRegistry/RuleIdentityRegistryUnit.t.sol
@@ -51,6 +51,14 @@ contract RuleIdentityRegistryUnit is Test, HelperContract {
         assertEq(resUint8, CODE_ADDRESS_SPENDER_NOT_VERIFIED);
     }
 
+    function testDetectRestrictionFrom_NoRegistry_ReturnsOk() public {
+        vm.prank(DEFAULT_ADMIN_ADDRESS);
+        rule.clearIdentityRegistry();
+
+        resUint8 = rule.detectTransferRestrictionFrom(ADDRESS3, ADDRESS1, ADDRESS2, 1);
+        assertEq(resUint8, TRANSFER_OK);
+    }
+
     function testSetIdentityRegistry_RevertsOnZeroAddress() public {
         vm.expectRevert(RuleIdentityRegistry_RegistryAddressZeroNotAllowed.selector);
         vm.prank(DEFAULT_ADMIN_ADDRESS);
@@ -102,4 +110,35 @@ contract RuleIdentityRegistryUnit is Test, HelperContract {
         );
         rule.transferred(ADDRESS3, ADDRESS1, ADDRESS2, 10);
     }
+
+    function testTransferred_DoesNotRevertWhenValid() public {
+        registry.setVerified(ADDRESS1, true);
+        registry.setVerified(ADDRESS2, true);
+
+        rule.transferred(ADDRESS1, ADDRESS2, 10);
+    }
+
+    function testTransferredFrom_DoesNotRevertWhenValid() public {
+        registry.setVerified(ADDRESS1, true);
+        registry.setVerified(ADDRESS2, true);
+        registry.setVerified(ADDRESS3, true);
+
+        rule.transferred(ADDRESS3, ADDRESS1, ADDRESS2, 10);
+    }
+
+    function testCanReturnTransferRestrictionCode() public view {
+        assertTrue(rule.canReturnTransferRestrictionCode(CODE_ADDRESS_FROM_NOT_VERIFIED));
+        assertTrue(rule.canReturnTransferRestrictionCode(CODE_ADDRESS_TO_NOT_VERIFIED));
+        assertTrue(rule.canReturnTransferRestrictionCode(CODE_ADDRESS_SPENDER_NOT_VERIFIED));
+        assertFalse(rule.canReturnTransferRestrictionCode(CODE_NONEXISTENT));
+    }
+
+    function testMessageForTransferRestriction() public view {
+        assertEq(rule.messageForTransferRestriction(CODE_ADDRESS_FROM_NOT_VERIFIED), TEXT_ADDRESS_FROM_NOT_VERIFIED);
+        assertEq(rule.messageForTransferRestriction(CODE_ADDRESS_TO_NOT_VERIFIED), TEXT_ADDRESS_TO_NOT_VERIFIED);
+        assertEq(
+            rule.messageForTransferRestriction(CODE_ADDRESS_SPENDER_NOT_VERIFIED), TEXT_ADDRESS_SPENDER_NOT_VERIFIED
+        );
+        assertEq(rule.messageForTransferRestriction(CODE_NONEXISTENT), TEXT_CODE_NOT_FOUND);
+    }
 }
diff --git a/test/RuleMaxTotalSupply/Ownable/RuleMaxTotalSupplyOwnable2Step.t.sol b/test/RuleMaxTotalSupply/Ownable/RuleMaxTotalSupplyOwnable2Step.t.sol
new file mode 100644
index 0000000..b1028df
--- /dev/null
+++ b/test/RuleMaxTotalSupply/Ownable/RuleMaxTotalSupplyOwnable2Step.t.sol
@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: MPL-2.0
+pragma solidity ^0.8.20;
+
+import {Test} from "forge-std/Test.sol";
+import {HelperContract} from "../../HelperContract.sol";
+import {Ownable2StepTestBase, IOwnable2StepLike} from "../../utils/Ownable2StepTestBase.sol";
+import {TotalSupplyMock} from "../../utils/TotalSupplyMock.sol";
+import {RuleMaxTotalSupplyOwnable2Step} from "src/rules/validation/deployment/RuleMaxTotalSupplyOwnable2Step.sol";
+
+contract RuleMaxTotalSupplyOwnable2StepTest is Ownable2StepTestBase {
+    function _deployOwnable2Step() internal override returns (IOwnable2StepLike, address) {
+        address ownerAddr = WHITELIST_OPERATOR_ADDRESS;
+        TotalSupplyMock token = new TotalSupplyMock();
+        RuleMaxTotalSupplyOwnable2Step rule = new RuleMaxTotalSupplyOwnable2Step(ownerAddr, address(token), 100);
+        return (IOwnable2StepLike(address(rule)), ownerAddr);
+    }
+}
+
+contract RuleMaxTotalSupplyOwnable2StepAccessControl is Test, HelperContract {
+    error OwnableUnauthorizedAccount(address account);
+
+    RuleMaxTotalSupplyOwnable2Step private rule;
+    TotalSupplyMock private token;
+
+    function setUp() public {
+        token = new TotalSupplyMock();
+        rule = new RuleMaxTotalSupplyOwnable2Step(WHITELIST_OPERATOR_ADDRESS, address(token), 100);
+    }
+
+    function testOwnerCanManageMaxTotalSupply() public {
+        TotalSupplyMock newToken = new TotalSupplyMock();
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        rule.setMaxTotalSupply(150);
+        assertEq(rule.maxTotalSupply(), 150);
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        rule.setTokenContract(address(newToken));
+        assertEq(address(rule.tokenContract()), address(newToken));
+    }
+
+    function testNonOwnerCannotManageMaxTotalSupply() public {
+        vm.expectRevert(abi.encodeWithSelector(OwnableUnauthorizedAccount.selector, ATTACKER));
+        vm.prank(ATTACKER);
+        rule.setMaxTotalSupply(200);
+
+        vm.expectRevert(abi.encodeWithSelector(OwnableUnauthorizedAccount.selector, ATTACKER));
+        vm.prank(ATTACKER);
+        rule.setTokenContract(address(token));
+    }
+}
diff --git a/test/RuleMaxTotalSupply/RuleMaxTotalSupplyUnit.t.sol b/test/RuleMaxTotalSupply/RuleMaxTotalSupplyUnit.t.sol
index 62277c8..d4de2cc 100644
--- a/test/RuleMaxTotalSupply/RuleMaxTotalSupplyUnit.t.sol
+++ b/test/RuleMaxTotalSupply/RuleMaxTotalSupplyUnit.t.sol
@@ -87,4 +87,24 @@ contract RuleMaxTotalSupplyUnit is Test, HelperContract {
         );
         rule.transferred(ADDRESS3, ZERO_ADDRESS, ADDRESS1, 1);
     }
+
+    function testTransferred_DoesNotRevertWhenValid() public {
+        token.setTotalSupply(90);
+        rule.transferred(ZERO_ADDRESS, ADDRESS1, 10);
+    }
+
+    function testTransferredFrom_DoesNotRevertWhenValid() public {
+        token.setTotalSupply(90);
+        rule.transferred(ADDRESS3, ZERO_ADDRESS, ADDRESS1, 10);
+    }
+
+    function testCanReturnTransferRestrictionCode() public view {
+        assertTrue(rule.canReturnTransferRestrictionCode(CODE_MAX_TOTAL_SUPPLY_EXCEEDED));
+        assertFalse(rule.canReturnTransferRestrictionCode(CODE_NONEXISTENT));
+    }
+
+    function testMessageForTransferRestriction() public view {
+        assertEq(rule.messageForTransferRestriction(CODE_MAX_TOTAL_SUPPLY_EXCEEDED), TEXT_MAX_TOTAL_SUPPLY_EXCEEDED);
+        assertEq(rule.messageForTransferRestriction(CODE_NONEXISTENT), TEXT_CODE_NOT_FOUND);
+    }
 }
diff --git a/test/RuleSanctionList/Ownable/RuleSanctionsListOwnable2Step.t.sol b/test/RuleSanctionList/Ownable/RuleSanctionsListOwnable2Step.t.sol
new file mode 100644
index 0000000..090f0f3
--- /dev/null
+++ b/test/RuleSanctionList/Ownable/RuleSanctionsListOwnable2Step.t.sol
@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: MPL-2.0
+pragma solidity ^0.8.20;
+
+import {Test} from "forge-std/Test.sol";
+import {HelperContract} from "../../HelperContract.sol";
+import {Ownable2StepTestBase, IOwnable2StepLike} from "../../utils/Ownable2StepTestBase.sol";
+import {SanctionListOracle} from "../../utils/SanctionListOracle.sol";
+import {ISanctionsList} from "src/rules/interfaces/ISanctionsList.sol";
+import {RuleSanctionsListOwnable2Step} from "src/rules/validation/deployment/RuleSanctionsListOwnable2Step.sol";
+
+contract RuleSanctionsListOwnable2StepHarness is RuleSanctionsListOwnable2Step {
+    constructor(address owner, address forwarderIrrevocable, ISanctionsList sanctionContractOracle_)
+        RuleSanctionsListOwnable2Step(owner, forwarderIrrevocable, sanctionContractOracle_)
+    {}
+
+    function exposedMsgSender() external view returns (address) {
+        return _msgSender();
+    }
+
+    function exposedMsgData() external view returns (bytes memory) {
+        return _msgData();
+    }
+
+    function exposedContextSuffixLength() external view returns (uint256) {
+        return _contextSuffixLength();
+    }
+}
+
+contract RuleSanctionsListOwnable2StepTest is Ownable2StepTestBase {
+    function _deployOwnable2Step() internal override returns (IOwnable2StepLike, address) {
+        address ownerAddr = SANCTIONLIST_OPERATOR_ADDRESS;
+        RuleSanctionsListOwnable2Step rule =
+            new RuleSanctionsListOwnable2Step(ownerAddr, ZERO_ADDRESS, ISanctionsList(ZERO_ADDRESS));
+        return (IOwnable2StepLike(address(rule)), ownerAddr);
+    }
+}
+
+contract RuleSanctionsListOwnable2StepAccessControl is Test, HelperContract {
+    error OwnableUnauthorizedAccount(address account);
+
+    RuleSanctionsListOwnable2StepHarness private rule;
+    SanctionListOracle private oracle;
+
+    function setUp() public {
+        oracle = new SanctionListOracle();
+        rule = new RuleSanctionsListOwnable2StepHarness(
+            SANCTIONLIST_OPERATOR_ADDRESS, ZERO_ADDRESS, ISanctionsList(ZERO_ADDRESS)
+        );
+    }
+
+    function testOwnerCanSetAndClearOracle() public {
+        vm.prank(SANCTIONLIST_OPERATOR_ADDRESS);
+        rule.setSanctionListOracle(oracle);
+        assertEq(address(rule.sanctionsList()), address(oracle));
+
+        vm.prank(SANCTIONLIST_OPERATOR_ADDRESS);
+        rule.clearSanctionListOracle();
+        assertEq(address(rule.sanctionsList()), ZERO_ADDRESS);
+    }
+
+    function testNonOwnerCannotSetOracle() public {
+        vm.expectRevert(abi.encodeWithSelector(OwnableUnauthorizedAccount.selector, ATTACKER));
+        vm.prank(ATTACKER);
+        rule.setSanctionListOracle(oracle);
+    }
+
+    function testMetaTxOverridesAreReachable() public view {
+        assertEq(rule.exposedMsgSender(), address(this));
+        assertEq(rule.exposedContextSuffixLength(), 20);
+        assertGe(rule.exposedMsgData().length, 4);
+    }
+}
diff --git a/test/RuleWhitelist/RuleWhitelist.t.sol b/test/RuleWhitelist/RuleWhitelist.t.sol
index 35b0fa4..7ac30a0 100644
--- a/test/RuleWhitelist/RuleWhitelist.t.sol
+++ b/test/RuleWhitelist/RuleWhitelist.t.sol
@@ -64,6 +64,27 @@ contract RuleWhitelistTest is Test, HelperContract {
         assertEq(resBool, true);
     }
 
+    function testContainsReflectsListingStatus() public {
+        // Act - Assert
+        assertFalse(ruleWhitelist.contains(ADDRESS1));
+
+        // Arrange
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS1);
+
+        // Act - Assert
+        assertTrue(ruleWhitelist.contains(ADDRESS1));
+    }
+
+    function testIsVerifiedReflectsListingStatus() public {
+        assertFalse(ruleWhitelist.isVerified(ADDRESS1));
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS1);
+
+        assertTrue(ruleWhitelist.isVerified(ADDRESS1));
+    }
+
     function testAddressesIsIndicatedAsWhitelisted() public {
         // Arrange
         _addAddresses();
diff --git a/test/RuleWhitelist/WhitelistWrapper.t.sol b/test/RuleWhitelist/WhitelistWrapper.t.sol
index 27d6271..cfc1f4a 100644
--- a/test/RuleWhitelist/WhitelistWrapper.t.sol
+++ b/test/RuleWhitelist/WhitelistWrapper.t.sol
@@ -10,6 +10,16 @@ import {RuleWhitelistWrapper} from "src/rules/validation/deployment/RuleWhitelis
  * @title Integration test with the CMTAT
  */
 
+contract RuleWhitelistWrapperHarnessInternal is RuleWhitelistWrapper {
+    constructor(address admin, address forwarderIrrevocable, bool checkSpender_)
+        RuleWhitelistWrapper(admin, forwarderIrrevocable, checkSpender_)
+    {}
+
+    function exposedTransferredSpenderInternal(address spender, address from, address to, uint256 value) external view {
+        _transferred(spender, from, to, value);
+    }
+}
+
 contract CMTATIntegrationWhitelistWrapper is Test, HelperContract {
     uint256 constant ADDRESS1_BALANCE_INIT = 31;
     uint256 constant ADDRESS2_BALANCE_INIT = 32;
@@ -221,6 +231,38 @@ contract CMTATIntegrationWhitelistWrapper is Test, HelperContract {
         ruleWhitelistWrapper.transferred(ADDRESS3, ADDRESS1, ADDRESS2, 0, 20);
     }
 
+    function testDetectTransferRestrictionWithSpenderFromNotWhitelisted() public {
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS2);
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS3);
+
+        resUint8 = ruleWhitelistWrapper.detectTransferRestrictionFrom(ADDRESS3, ADDRESS1, ADDRESS2, 20);
+        assertEq(resUint8, CODE_ADDRESS_FROM_NOT_WHITELISTED);
+    }
+
+    function testDetectTransferRestrictionWithSpenderToNotWhitelisted() public {
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS1);
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS3);
+
+        resUint8 = ruleWhitelistWrapper.detectTransferRestrictionFrom(ADDRESS3, ADDRESS1, ADDRESS2, 20);
+        assertEq(resUint8, CODE_ADDRESS_TO_NOT_WHITELISTED);
+    }
+
+    function testDetectTransferRestrictionFromIgnoresSpenderWhenCheckDisabled() public {
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelistWrapper.setCheckSpender(false);
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS1);
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        ruleWhitelist.addAddress(ADDRESS2);
+
+        resUint8 = ruleWhitelistWrapper.detectTransferRestrictionFrom(ADDRESS3, ADDRESS1, ADDRESS2, 20);
+        assertEq(resUint8, NO_ERROR);
+    }
+
     function testDetectTransferRestrictionOk() public {
         // Arrange
         vm.prank(WHITELIST_OPERATOR_ADDRESS);
@@ -310,4 +352,21 @@ contract CMTATIntegrationWhitelistWrapper is Test, HelperContract {
             new RuleWhitelistWrapper(WHITELIST_OPERATOR_ADDRESS, ZERO_ADDRESS, true);
         assertFalse(emptyWrapper.isVerified(ADDRESS1));
     }
+
+    function testInternalTransferredSpenderOverload() public {
+        RuleWhitelistWrapperHarnessInternal wrapperHarness =
+            new RuleWhitelistWrapperHarnessInternal(WHITELIST_OPERATOR_ADDRESS, ZERO_ADDRESS, true);
+        RuleWhitelist child = new RuleWhitelist(WHITELIST_OPERATOR_ADDRESS, ZERO_ADDRESS, true);
+
+        vm.prank(WHITELIST_OPERATOR_ADDRESS);
+        wrapperHarness.addRule(child);
+
+        vm.startPrank(WHITELIST_OPERATOR_ADDRESS);
+        child.addAddress(ADDRESS1);
+        child.addAddress(ADDRESS2);
+        child.addAddress(ADDRESS3);
+        vm.stopPrank();
+
+        wrapperHarness.exposedTransferredSpenderInternal(ADDRESS3, ADDRESS1, ADDRESS2, 20);
+    }
 }
diff --git a/test/TransferContext/TransferContext.t.sol b/test/TransferContext/TransferContext.t.sol
index 3c55783..e05510b 100644
--- a/test/TransferContext/TransferContext.t.sol
+++ b/test/TransferContext/TransferContext.t.sol
@@ -72,4 +72,28 @@ contract TransferContextTest is Test, HelperContract {
         vm.prank(ADDRESS3);
         token.transferFromWithContext(ADDRESS1, ADDRESS2, 10, true, 0);
     }
+
+    function testTransferFromContextFungibleWhitelist() public {
+        RuleWhitelist rule = _deployWhitelistRule();
+        token.setRule(address(rule));
+        token.mint(ADDRESS1, 100);
+
+        vm.prank(ADDRESS1);
+        token.approve(ADDRESS3, 10);
+
+        vm.prank(ADDRESS3);
+        token.transferFromWithContext(ADDRESS1, ADDRESS2, 10, true, 0);
+    }
+
+    function testTransferFromContextWithTokenIdWhitelist() public {
+        RuleWhitelist rule = _deployWhitelistRule();
+        token.setRule(address(rule));
+        token.mint(ADDRESS1, 100);
+
+        vm.prank(ADDRESS1);
+        token.approve(ADDRESS3, 10);
+
+        vm.prank(ADDRESS3);
+        token.transferFromWithContext(ADDRESS1, ADDRESS2, 10, false, 1);
+    }
 }

From 19fb08d9d57ec23f63d9c26655045187fa03e6d8 Mon Sep 17 00:00:00 2001
From: Ryan Sauge <71391932+rya-sge@users.noreply.github.com>
Date: Tue, 10 Mar 2026 12:49:53 +0100
Subject: [PATCH 2/2] Update documentation

---
 .gitignore                            |   4 ++++
 README.md                             |  10 ++++++++++
 doc/schema/Rule-Rule.drawio.png       | Bin 0 -> 34623 bytes
 doc/schema/Rule-RuleEngine.drawio.png | Bin 0 -> 49704 bytes
 doc/schema/Rule.drawio                |   1 +
 doc/schema/RuleEngine.drawio          |   1 -
 6 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 doc/schema/Rule-Rule.drawio.png
 create mode 100644 doc/schema/Rule-RuleEngine.drawio.png
 create mode 100644 doc/schema/Rule.drawio
 delete mode 100644 doc/schema/RuleEngine.drawio

diff --git a/.gitignore b/.gitignore
index 7b3c91f..ac3da17 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,3 +21,7 @@ node_modules/
 /ERCSpecification
 *.dbg.json
 /skills
+
+#drawio
+*.bkp
+*.dtmp
diff --git a/README.md b/README.md
index ace16e8..5122c55 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,16 @@ Each rule can be used **standalone**, directly plugged into a CMTAT token, **or*
 
 Latest update: completed 100% coverage across `src/` contracts, including direct coverage for `RuleAddressSet.contains(address)`, mint/burn-path coverage for `RuleConditionalTransferLightBase.detectTransferRestriction(...)`, and removal of an unreachable duplicate admin-zero check in `RuleConditionalTransferLight` constructor.
 
+## Schema
+
+- Using rules with CMTAT and ERC-3643 tokens through a [RuleEngine](ttps://github.com/CMTA/RuleEngine)
+
+![Rule-RuleEngine.drawio](./doc/schema/Rule-RuleEngine.drawio.png)
+
+- Using a rule directly with CMTAT and ERC-3643 tokens
+
+![Rule-Rule.drawio](./doc/schema/Rule-Rule.drawio.png)
+
 ## Table of Contents
 
 [TOC]
diff --git a/doc/schema/Rule-Rule.drawio.png b/doc/schema/Rule-Rule.drawio.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2f9799e4373c6ca40847ef0920c809a64cdb6cc
GIT binary patch
literal 34623
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

literal 0
HcmV?d00001

diff --git a/doc/schema/Rule-RuleEngine.drawio.png b/doc/schema/Rule-RuleEngine.drawio.png
new file mode 100644
index 0000000000000000000000000000000000000000..0498e669ce4b52396a75ff62bf551a46ec473c46
GIT binary patch
literal 49704
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
DZkb8C

literal 0
HcmV?d00001

diff --git a/doc/schema/Rule.drawio b/doc/schema/Rule.drawio
new file mode 100644
index 0000000..40d0165
--- /dev/null
+++ b/doc/schema/Rule.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2026-03-10T11:45:30.933Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.6.2 Chrome/106.0.5249.199 Electron/21.3.3 Safari/537.36" etag="YH0ZkrO08l99KGhlxKHm" version="20.6.2" type="device" pages="3"><diagram id="NT6XaUAKe-6zpoMFsSYq" name="RuleEngine">3Vpdc9o4FP01zHQfYCzJH/iRkGz3YTtJ2+wm2TeDBWhqLFYWBfrrV7JlbFkKUIqJs7xgXYsr+9yjc3Ulemi83H5k0WrxicY46UEn3vbQbQ9CgDwovqRlV1hCHxSGOSOx6lQZvpIfWBkdZV2TGGdaR05pwslKN05pmuIp12wRY3Sjd5vRRB91Fc2xYfg6jRLT+kRiviisECG/uvEHJvNFObTvucWdZVT2Vq+SLaKYbmomdNdDY0YpL66W2zFOJHolMMXvfn/l7v7JGE75KT9wH9lLwPwIP+3uX75tho9//f1PX3n5HiVr9cbjT4+jR/XEfFfisFkQjr+uoqlsb0Sse+hmwZeJaAFxGWWrAv0Z2WIx3s2MplxFE3iibT5sOTJmHG9rJvXwHzFdYs52oou6C91wENY/QeFBMQsECudNFSeAlG1RD1FpjBQ35vuhKvTEhQLwJ8BEBpiP9BtO5fiCd5gZqApKrOTlepmMppwyAZTEgwj+/RlNcPJAM8IJTUWXCeWcLmsdRgmZyxucNmJB1zwhKR7vZ4TTTjx8R8MfOp6Bvw1+vy30XQN9A2+cxiMpCqI1TaIsI1MdOkbXaSz5m2OGt4Q/yzsDxxmq9ou8N/BQ2b7d1jrf7mqNB8yIeDERdXsEBPBs91z+QDaU77JZuc5bpe9XI5fRNZvi43OdR2yO+YF+Ko441qTR5EEt0J4l0KWN4STi5LsuqLboqxEeKBFvVtEMCfyhTrXA070Ur65+WJfAhi8vaHDWbZCxwMZwlPNx/+bnU9Q3KAoHnEVpNsOMCd5B58OMiVkOx3meK77z3r+ZXBbhyUWiocRKFqaCHphZ9GJJ4lj6uGE4Iz+iSe5PEmsl3zrHwbvpebcnicbBidhUkn2WVoNqedCmMM4ADQOkR+winOoj3WsfDHUXdDbLcCsU8AwKfFkn+C6dC8nuYtb1HX3KAM+U+X3q1dJs0JbQhwaEKNKn0a/J/pnCvE8X9VRxME2cHK6j0u6dKO3lsror2h4Y5BK5tvo0HJ4q80PYkHl4XZkvUW5McmEpS4GKmzr3jkz4FuZ32MAqtKyi4TWXcQC+Bh7oPHi2NfCV0TNrEDQZSGl4c308Gf/jKgY7pWLBsVXlyboFGo68K+vWz5VQKU3lOjKOskVODqCzRtofIi5WoWlugQ4S1owzUROXeynw1aJL8enKeRScnEi7RcEQuhpzkHdmhRQ2q3q/4ahtCtrXx8KSdl79kfvm6h9YJrCfiGFvJhp2/r9rue2Yo9LPclhGMsN6q22OTXlfXM3lNx7MZRJ5khgnJJOEYXlYCufiYSdlVyNMAk2ux6LQgDFN5I5XKSMzkiQN0+m1rC34Oj1aiD9w3OHRtZNriX9rlRG0ZP/pdbI/PKc8AleS9ZNVvVtbX8HQWA9cojwK3eZ65WDVdTnFn002z/dLCj5na+/z/WYULm4XlhOIlhh6sfXpUbqhU+nWKbYBaG60ojOXESAwfIFhaysJK6/MMhLUlVBcfngPO6wH58wv77D2nYEL/FAP+kXYBD3N6b4wvegOqxUcMwfefRn3ke8iGX55IJcZoe7ARuuR403kWxYXrR1vWoG9/AHbNXcSDnGlIwocNvLyueoLQ1PJ3euqr1nGwf+N+l7sfKsF9VVe3DbOs6xg2CrONxEF6/HLfhPpghXGISF5Z2frrpiVjlfLOXrSzlMSqt12z9MjLwgHCFYFRlOawMAfvj5Ky0o1tCjVuz6TPzhNO3wmD/UFT/8CEiaa1f/riu7V3xTR3X8=</diagram><diagram name="Rule" id="EF7FSRUVWhQEC0yLBviE">7Vlbj9o4GP01SLsPRLGdCzxymbbSttJoZraXp1UgBqyamHVMgf76tRM7xHFaBjqBVl1eiD87n/E5x99xQg9N1vvXPNms3rEU0x70030PTXsQAhRC+aUihzIyjEAZWHKS6kHHwCP5inXQ19EtSXFuDRSMUUE2dnDOsgzPhRVLOGc7e9iCUXvWTbLETuBxnlA3+oGkYlVGIULRseMNJsuVmToKg7JnnZjRein5KknZrhZCdz004YyJ8mq9n2Cq0DPARMHd+7/fZn/R1+N/HrJHQN5Hr/plslfn3FKtgeNMvGxqze6XhG41YJN3T6MnvWBxMDDuVkTgx00yV+2dlEoPjVdiTWULyMsk35TkLcgey/nGC5YJLQYQyraeBnOB9w1iTiwKVEhLjWK2xoIf5H06CwyG3rD+icu0Wq0g1tztjtwDpGOrOu0mmGi9LaupjpDKC43qGQgjB+En9hlnan6pZcwdqKXMNupyu6ajuWBcoqdwI1LTb5MZpvcsJ4KwTA6ZMSHYujZgRMlSdQjWIIhtBSUZnlS7zL8iSaFvkQJbSGnjJOqKksChxCEBZ+lIVR/ZmtMkz8ncxpOzbZYqpRdA4j0RH1WP5/sD3f6k+rwQmfZ0Xxs8PdQa95gTuTAphXZaJPT88NHcoBo6t2keUxctk7tcFE6dAvkcMiUabMvn+HTtEAlf4u/li9rFUWM/bGHfxDimiSBf7DW0SULPcM+IXF2lvQhJUmBDf6GdpVypvrFeQRu5wrgh5KCh0BIKJ1Eh0mrll+s2dHQLPcGTLF9gzqUYof/Hgst6ACeFy5bfxeg/XYFLWRTlpFHIdQGZS4lg3lJZ1iRNVY4xxzn5msyKfEptG7XqAodw3Aun55QX7f062dFwTyo1+G7Z8T00iJHN2Itoqo/srH0wsFOwxSLHnUggciTwsJWo/Sp2HfmNHQRb/Dlu8+e4KzMArkH3YETlvOOZBWr071ad9Aqs+nkB1kgOAOFmXyBm+uXVUn1jb+nJ/g+KCkpypR9ecFUmlz92ZoY6/EnYhU1ZLrg8NkwYVQeCacYytQcXhNJG6PkbuE0jtq1dTRUgtE9toEUVQYsquhOFW2p/9IhwoYm3c9CdqaNnmjq8pakD6Jo6utDUQezkAoNGro59HbhVHajSYbxdGfvvYOflrvtmmej7XgCiYQeGDu36U3lC934OYof6u4dJH0UBKs5w8kkx/2Xc/cTDOIpu/jBuDmo/X103j5D6zuMD5NmPjz/oECcrv5Hs86zkVhYxbBw0L7UHOHStJriyPQwd0cLf0h4G17YHnSW42uOdweL29al6pXVGNbr2WdVUop/7DVQgd6sf1lzRPmwUpolq3cFlhSqMhx6CfvVp1izgRYNvz9JxCTOo/f/qyt7pN3h3Be1DWf8FaptsHv8FK4cf/0xEd/8B</diagram><diagram id="4PueutqssDsIYPR9Y2Mz" name="Page-2">dZHBDoIwDIafZndYlcQzol48cfC8sMqWDErGDOjTC9kQF/S07vv/rmvLIG/GsxWdupJEw3giRwZHxnkKez4dM3l6cshSD2qrZTCtoNQvDDAJ9KEl9pHRERmnuxhW1LZYuYgJa2mIbXcycdVO1LgBZSXMlt60dMpTDpCtwgV1rZbS2X7nlUYs7tBKr4Sk4QtBwSC3RM5HzZijmae3DMbnnf6on59ZbN2PhClY354u0YqgeAM=</diagram></mxfile>
\ No newline at end of file
diff --git a/doc/schema/RuleEngine.drawio b/doc/schema/RuleEngine.drawio
deleted file mode 100644
index e908186..0000000
--- a/doc/schema/RuleEngine.drawio
+++ /dev/null
@@ -1 +0,0 @@
-<mxfile host="Electron" modified="2024-07-08T11:13:01.570Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.6.2 Chrome/106.0.5249.199 Electron/21.3.3 Safari/537.36" etag="1DqoXVM6f3_kqLpATKRN" version="20.6.2" type="device"><diagram id="NT6XaUAKe-6zpoMFsSYq" name="RuleEngine">1VpLc+I4EP41VO0e4rIkP/AxkMzMYac2NWEnm70JW4AqxqJkMcD8+pWxbCzJBEIwIblEar3s7q+/7hbuoeF8/ZXjxew7S0jag26y7qG7HoQA+VD+KySbUuL3+6VgymmiJu0Ej/Q3UUJXSZc0Ibk2UTCWCrrQhTHLMhILTYY5Zyt92oSl+qkLPCWW4DHGqS19oomYlVKIULAb+EbodFYdHfheOTLH1Wz1KvkMJ2zVEKH7HhpyxkTZmq+HJC20VymmXPdlz2j9ZJxk4pgF3og/hzzA5Gnz9/PLqj/65+d/N2qXXzhdqjcefh/djtQTi02lh9WMCvK4wHHRX0lb99BgJuap7AHZxPmi1P6Erok8b2A/XHUS4YKsGyL1sF8JmxPBN3KKGoWhUpyCDvD9sr/aGQJUc2ZNG1RCrIw/rffeqUc2lIbeoC1oaQs4guMsnxD+h2A9OKxG/7Q0SLLktgCk7MUpznMa6yrkbJklhe7uXNmTauObf2XnxnVcACvJczHseCisBHfr5oK7TbP3QDiV7024Eu61icB8SsRhlJBEcxbbcg3L+C2GqWScpFjQX7qLtRlLnfDAqHziGhgA6sCAyLB3zpY8JmpV0yOMjWBgICwyNioVY220xU792qfDCVlwGrEXkhVakzwl7WZiSFLIomgu5+ltLJg07KDwJyr56i88JukDy6mgLJNTxkwINm9MuE3ptBgQzPBdthQpzciwZtBXsXK8//qGlSpKb4AEtYAk6Mp5PUvb5/JRV3dP/4Bz7tVtidvDfnjQX/2r8tcA6UhA7on+GkQGpEysdOyvgYUg6MgOTbAgIxUGbExJI2yd04iYyh1jCQLCW/x0TpOk2GPASU5/4/F2vwI+i+L1ti/sD3r+XSugXnUA04Pr7EkdouUnbZ7tOqgfIt0UZ0HKDQy1XW/6+g5sMslJJ6b1LdP+WKbkPptKZrRM+gHJkN+/umQo7IxPgc6n4cmE+skSG9PIsI9OJErP3OiyRNm3oCG4bEFXpiyyCMNpbjvV9fBkBewz8KQXeUBnNPA+pHTPhJFlO4SdRJYRsahi3A+SC07jbab5MSkUWVNRM4VsPzfkuyVF5/1Jl38sl7hXRSaBb0UMx238GRseSy1916AWeFlqqbRsRGopqa5ZdljUsXYgap8hSEeGbiK74qlr14uUPMC+sFDKAlenLOi2ZDSX1ZZdj3sXp77uUh14VfQUmtcD3olFYWgWhf6FCelt9woZy4pkJcH5bAsFoGOkkD9gIVOdbCuBLpJSiTn2Ul9AQxtLKhyqwNlxQARHR8TrglzkehpSUFVDvRVykZleB8ZGXUOuvVqVEpuUPprWkffhtN5WqAapPHYwlo1p0SDO1JFTngr1pDQvbM23Gi3nyXPrqZaGpWKErsbSXYcsLW5oK4+f0DQ1RMfXNm120y17BtMBFxzOX7wW03X3e4sdkf3LFyPwlGoEdES+R3Pvdd0Bh4EVpc9RjUTmT0Heq0VOx7wM7VTAGzt8B9AhS1ouPi5zSVbnCM0MQS3rIkmARwL1unEKgrNUzZHBrMD8yXIPMiUw8KYxTd1p7X18qzoPtW8CZKPc8bywtwOs3xnsm0h/brrBG2DfFTcfnRhfF+YtEg3Ows0W5UfQOS5P3o/6szO2fVONxl0RtuMCXydt4KEuWPttX38chrX7OWENPg2s95A5NGPRu8hcdncfm5XTd9/sofv/AQ==</diagram></mxfile>
\ No newline at end of file