Merge pull request #228 from Lay3rLabs/poa-mirror

Add support for POA middleware mirror deployments

Author: ismellike

.gitmodules

@@ -5,4 +5,7 @@
 	path = contracts/lib/eigenlayer-middleware
 	url = https://github.com/Lay3rLabs/eigenlayer-middleware
 	# This commit hash (3ea829d52c4a8cb1d26c9a6ac4807b87c70a1f47) corresponds to wavs-1.4 branch (based on tag v1.4.0-testnet-holesky)
-	branch = 3ea829d52c4a8cb1d26c9a6ac4807b87c70a1f47 
+	branch = 3ea829d52c4a8cb1d26c9a6ac4807b87c70a1f47 
+[submodule "contracts/lib/poa-middleware"]
+	path = contracts/lib/poa-middleware
+	url = https://github.com/Lay3rLabs/poa-middleware.git

README.md

@@ -351,13 +351,23 @@ docker run --rm --network host -v ./.nodes:/root/.nodes \
    wavs-middleware -m mirror deploy
 ```
 
+For **POA (Proof of Authority)** deployments, set `IS_POA=true` and set `WAVS_SERVICE_MANAGER_ADDRESS` to the `POAStakeRegistry` address:
+
+```bash
+docker run --rm --network host -v ./.nodes:/root/.nodes \
+   -e IS_POA=true \
+   -e WAVS_SERVICE_MANAGER_ADDRESS=${POA_STAKE_REGISTRY_ADDRESS} \
+   wavs-middleware -m mirror deploy
+```
+
 | Environment Variable           | Required              | Default                       | Source       | Description                                   |
 | ------------------------------ | --------------------- | ----------------------------- | ------------ | --------------------------------------------- |
 | `DEPLOY_ENV`                   | for non-default value | `LOCAL`                       | `.env`       | Deployment environment (`LOCAL` or `TESTNET`) |
 | `WAVS_SERVICE_MANAGER_ADDRESS` | if not mounted        | From `.nodes/avs_deploy.json` | Volume       | Service manager contract address              |
 | `FUNDED_KEY`                   | if not mounted        | From `.nodes/deployer`        | Volume       | Deployer private key                          |
 | `SOURCE_RPC_URL`               | for non-default value | `http://localhost:8545`       | Command line | RPC URL for source chain                      |
 | `MIRROR_RPC_URL`               | for non-default value | `http://localhost:8546`       | Command line | RPC URL for mirror chain                      |
+| `IS_POA`                       | for POA deployments   | `false`                       | Command line | Set to `true` for POA stake registries        |
 
 ### List Mirror Operators
 
@@ -598,20 +608,17 @@ sequenceDiagram
 - `execute_transaction`: Run a transaction and handle errors
 - `stop_impersonating`: Stop impersonating an account (LOCAL only)
 
-### Instructions on getting Holesky ETH
-
-To get Holesky ETH for running on testnet:
-
-1. PoW Mining Faucet:
+### Instructions on getting Sepolia ETH
 
-   - Go to https://holesky-faucet.pk910.de/
-   - Connect your wallet
-   - Mine blocks in your browser to earn ETH
-   - Rewards based on mining time/hashrate
-   - No external requirements
+To get Sepolia ETH for running on testnet:
 
-2. Alchemy Faucet (Alternative):
-   - Visit https://www.alchemy.com/faucets/holesky
+1. Alchemy Faucet:
+   - Visit https://www.alchemy.com/faucets/ethereum-sepolia
    - Requires mainnet ETH balance to use
    - Connect wallet and verify ownership
    - Request funds (limits apply)
+
+2. Google Cloud Faucet:
+   - Visit https://cloud.google.com/application/web3/faucet/ethereum/sepolia
+   - No requirements
+   - Request funds (limits apply)

contracts/foundry.toml

@@ -11,6 +11,9 @@ optimizer = true
 optimizer_runs = 100
  # Higher number optimizes for frequent contract calls, lower number optimizes for deployment cost
 
+[profile.ci]
+via-ir = false
+
 [profile.bls]
 src = "src/eigenlayer/bls"
 test = "test/eigenlayer/bls"

contracts/lib/poa-middleware

@@ -4,3 +4,4 @@
 @openzeppelin/=lib/eigenlayer-middleware/lib/eigenlayer-contracts/lib/openzeppelin-contracts-v4.9.0/
 @openzeppelin-upgrades/=lib/eigenlayer-middleware/lib/eigenlayer-contracts/lib/openzeppelin-contracts-upgradeable-v4.9.0/
 forge-std/=lib/forge-std/src/
+@poa-middleware/=lib/poa-middleware/contracts/

contracts/remappings.txt

@@ -121,7 +121,7 @@ contract WavsMiddlewareDeployer is Script {
         }
         if (
             address(registryCoordinator.serviceManager())
-                != wavsMiddlewareDeployment.wavsServiceManager
+                    != wavsMiddlewareDeployment.wavsServiceManager
                 || address(registryCoordinator.stakeRegistry())
                     != wavsMiddlewareDeployment.stakeRegistry
                 || address(registryCoordinator.blsApkRegistry())
@@ -130,7 +130,8 @@ contract WavsMiddlewareDeployer is Script {
                     != wavsMiddlewareDeployment.indexRegistry
                 || address(registryCoordinator.socketRegistry())
                     != wavsMiddlewareDeployment.socketRegistry
-                || address(registryCoordinator.allocationManager()) != coreDeployment.allocationManager
+                || address(registryCoordinator.allocationManager())
+                    != coreDeployment.allocationManager
                 || address(registryCoordinator.pauserRegistry())
                     != wavsMiddlewareDeployment.pauserRegistry
         ) {

contracts/script/eigenlayer/bls/WavsMiddlewareDeployer.s.sol

@@ -2,8 +2,9 @@
 pragma solidity ^0.8.27;
 
 import {BN254} from "@eigenlayer-middleware/src/libraries/BN254.sol";
-import {ISlashingRegistryCoordinator} from
-    "@eigenlayer-middleware/src/interfaces/ISlashingRegistryCoordinator.sol";
+import {
+    ISlashingRegistryCoordinator
+} from "@eigenlayer-middleware/src/interfaces/ISlashingRegistryCoordinator.sol";
 import {IBLSApkRegistryTypes} from "@eigenlayer-middleware/src/interfaces/IBLSApkRegistry.sol";
 import {Strings} from "@openzeppelin/contracts/utils/Strings.sol";
 import {BN256G2} from "@eigenlayer-middleware/test/utils/BN256G2.sol";
@@ -55,9 +56,7 @@ library BLSKeyGenerator {
         BN254.G1Point memory signature = BN254.scalar_mul(pubkeyRegistrationMessageHash, privateKey);
 
         params = IBLSApkRegistryTypes.PubkeyRegistrationParams({
-            pubkeyRegistrationSignature: signature,
-            pubkeyG1: pubkeyG1,
-            pubkeyG2: pubkeyG2
+            pubkeyRegistrationSignature: signature, pubkeyG1: pubkeyG1, pubkeyG2: pubkeyG2
         });
     }
 }

contracts/script/eigenlayer/bls/utils/BLSKeyGenerator.sol

@@ -48,7 +48,10 @@ library UpgradeableProxyLib {
      * @param proxy The proxy address.
      * @param impl The implementation address.
      */
-    function upgrade(address proxy, address impl) internal {
+    function upgrade(
+        address proxy,
+        address impl
+    ) internal {
         ProxyAdmin admin = getProxyAdmin(proxy);
         admin.upgrade(ITransparentUpgradeableProxy(payable(proxy)), impl);
     }
@@ -59,7 +62,11 @@ library UpgradeableProxyLib {
      * @param impl The implementation address.
      * @param initData The initialization data.
      */
-    function upgradeAndCall(address proxy, address impl, bytes memory initData) internal {
+    function upgradeAndCall(
+        address proxy,
+        address impl,
+        bytes memory initData
+    ) internal {
         ProxyAdmin admin = getProxyAdmin(proxy);
         admin.upgradeAndCall(ITransparentUpgradeableProxy(payable(proxy)), impl, initData);
     }

contracts/script/eigenlayer/bls/utils/UpgradeableProxyLib.sol

@@ -10,8 +10,9 @@ import {BLSApkRegistry} from "@eigenlayer-middleware/src/BLSApkRegistry.sol";
 import {IndexRegistry} from "@eigenlayer-middleware/src/IndexRegistry.sol";
 import {SocketRegistry} from "@eigenlayer-middleware/src/SocketRegistry.sol";
 import {RegistryCoordinator} from "@eigenlayer-middleware/src/RegistryCoordinator.sol";
-import {SlashingRegistryCoordinator} from
-    "@eigenlayer-middleware/src/SlashingRegistryCoordinator.sol";
+import {
+    SlashingRegistryCoordinator
+} from "@eigenlayer-middleware/src/SlashingRegistryCoordinator.sol";
 import {InstantSlasher} from "@eigenlayer-middleware/src/slashers/InstantSlasher.sol";
 import {OperatorStateRetriever} from "@eigenlayer-middleware/src/OperatorStateRetriever.sol";
 
@@ -23,8 +24,9 @@ import {IBLSApkRegistry} from "@eigenlayer-middleware/src/interfaces/IBLSApkRegi
 import {IIndexRegistry} from "@eigenlayer-middleware/src/interfaces/IIndexRegistry.sol";
 import {ISocketRegistry} from "@eigenlayer-middleware/src/interfaces/ISocketRegistry.sol";
 import {IServiceManager} from "@eigenlayer-middleware/src/interfaces/IServiceManager.sol";
-import {IRegistryCoordinatorTypes} from
-    "@eigenlayer-middleware/src/interfaces/IRegistryCoordinator.sol";
+import {
+    IRegistryCoordinatorTypes
+} from "@eigenlayer-middleware/src/interfaces/IRegistryCoordinator.sol";
 import {
     ISlashingRegistryCoordinator,
     ISlashingRegistryCoordinatorTypes
@@ -232,9 +234,7 @@ library WavsMiddlewareDeploymentLib {
             ISlashingRegistryCoordinator(deployment.registryCoordinator);
         slashingRegistryCoordinator.createSlashableStakeQuorum(
             ISlashingRegistryCoordinatorTypes.OperatorSetParam({
-                maxOperatorCount: 10_000,
-                kickBIPsOfOperatorStake: 10_500,
-                kickBIPsOfTotalStake: 100
+                maxOperatorCount: 10_000, kickBIPsOfOperatorStake: 10_500, kickBIPsOfTotalStake: 100
             }),
             minimumWeight,
             strategyParams,
@@ -278,8 +278,7 @@ library WavsMiddlewareDeploymentLib {
             new IStakeRegistryTypes.StrategyParams[](strategyCount);
         for (uint256 i; i < strategyCount; ++i) {
             strategyParams[i] = IStakeRegistryTypes.StrategyParams({
-                strategy: IStrategy(strategies[i]),
-                multiplier: multipliers[i]
+                strategy: IStrategy(strategies[i]), multiplier: multipliers[i]
             });
         }
 

contracts/script/eigenlayer/bls/utils/WavsMiddlewareDeploymentLib.sol

@@ -80,17 +80,19 @@ library WavsRegisterOperatorLib {
             opSetIds[0] = 0;
 
             BN254.G1Point memory pubkeyRegistrationMessageHash = ISlashingRegistryCoordinator(
-                WavsServiceManager(serviceManagerAddress).getRegistryCoordinator()
-            ).pubkeyRegistrationMessageHash(operatorAddr);
+                    WavsServiceManager(serviceManagerAddress).getRegistryCoordinator()
+                ).pubkeyRegistrationMessageHash(operatorAddr);
 
             IBLSApkRegistryTypes.PubkeyRegistrationParams memory blsParams =
                 BLSKeyGenerator.generateBLSParams(pubkeyRegistrationMessageHash, operatorKey);
 
             bytes memory data = abi.encode(
                 ISlashingRegistryCoordinatorTypes.RegistrationType.NORMAL, "Mock Socket", blsParams
             );
-            IAllocationManagerTypes.RegisterParams memory params = IAllocationManagerTypes
-                .RegisterParams({avs: serviceManagerAddress, operatorSetIds: opSetIds, data: data});
+            IAllocationManagerTypes.RegisterParams memory params =
+                IAllocationManagerTypes.RegisterParams({
+                    avs: serviceManagerAddress, operatorSetIds: opSetIds, data: data
+                });
 
             allocationManager.registerForOperatorSets(operatorAddr, params);