@hyperlane-xyz/sdk 42.0.0 → 43.0.0

package/dist/hook/HyperlaneHookDeployer.hardhat-test.js

@@ -0,0 +1,322 @@
+import chai, { expect } from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import hre from 'hardhat';
+import { DomainRoutingHook__factory, FallbackDomainRoutingHook__factory, PausableHook__factory, StaticAggregationHook__factory, } from '@hyperlane-xyz/core';
+import { eqAddress } from '@hyperlane-xyz/utils';
+import { TestChainName } from '../consts/testChains.js';
+import { TestCoreDeployer } from '../core/TestCoreDeployer.js';
+import { HyperlaneProxyFactoryDeployer } from '../deploy/HyperlaneProxyFactoryDeployer.js';
+import { HyperlaneIsmFactory } from '../ism/HyperlaneIsmFactory.js';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { HyperlaneHookDeployer } from './HyperlaneHookDeployer.js';
+import { HookType, } from './types.js';
+chai.use(chaiAsPromised);
+describe('HyperlaneHookDeployer recovered hooks', () => {
+    const chain = TestChainName.test1;
+    const remote = TestChainName.test2;
+    const newRemote = TestChainName.test3;
+    async function deployFixture(pausablePaused = false, transferPausableOwnership = false) {
+        const [signer, newOwner, overrideOwner] = await hre.ethers.getSigners();
+        const multiProvider = MultiProvider.createTestMultiProvider({ signer });
+        const proxyFactoryContracts = await new HyperlaneProxyFactoryDeployer(multiProvider).deploy(multiProvider.mapKnownChains(() => ({})));
+        const ismFactory = new HyperlaneIsmFactory(proxyFactoryContracts, multiProvider);
+        const coreApp = await new TestCoreDeployer(multiProvider, ismFactory).deployApp();
+        const core = coreApp.getContracts(chain);
+        const coreAddresses = {
+            mailbox: core.mailbox.address,
+            proxyAdmin: core.proxyAdmin.address,
+        };
+        const hookDeployer = new HyperlaneHookDeployer(multiProvider, { [chain]: coreAddresses }, ismFactory);
+        const owner = await signer.getAddress();
+        const pausableOwner = transferPausableOwnership
+            ? await newOwner.getAddress()
+            : owner;
+        const initialConfig = {
+            type: HookType.FALLBACK_ROUTING,
+            owner,
+            fallback: { type: HookType.MERKLE_TREE },
+            domains: {
+                [remote]: {
+                    type: HookType.AGGREGATION,
+                    hooks: [
+                        {
+                            type: HookType.PAUSABLE,
+                            owner: pausableOwner,
+                            paused: pausablePaused,
+                        },
+                        { type: HookType.MERKLE_TREE },
+                    ],
+                },
+            },
+        };
+        const deployed = await hookDeployer.deployContracts(chain, initialConfig, coreAddresses);
+        const fallbackRoutingHook = FallbackDomainRoutingHook__factory.connect(deployed.fallbackRoutingHook.address, signer);
+        const aggregationAddress = await fallbackRoutingHook.hooks(multiProvider.getDomainId(remote));
+        const pausableAddress = hookDeployer.deployedContracts[chain].pausableHook.address;
+        const merkleTreeAddress = hookDeployer.deployedContracts[chain].merkleTreeHook.address;
+        const aggregation = StaticAggregationHook__factory.connect(aggregationAddress, signer);
+        const childrenBefore = await aggregation.hooks(hre.ethers.constants.AddressZero);
+        return {
+            signer,
+            newOwner,
+            overrideOwner,
+            multiProvider,
+            coreApp,
+            coreAddresses,
+            hookDeployer,
+            owner,
+            pausableOwner,
+            fallbackRoutingHook,
+            aggregationAddress,
+            pausableAddress,
+            merkleTreeAddress,
+            aggregation,
+            childrenBefore,
+        };
+    }
+    it('applies pausable hook state before transferring ownership', async () => {
+        const { signer, pausableAddress, pausableOwner } = await deployFixture(true, true);
+        const pausable = PausableHook__factory.connect(pausableAddress, signer);
+        expect(await pausable.paused()).to.be.true;
+        expect(eqAddress(await pausable.owner(), pausableOwner)).to.be.true;
+    });
+    it('reconciles a nested recovered pausable hook without replacing the tree', async () => {
+        const { signer, newOwner, overrideOwner, multiProvider, coreAddresses, hookDeployer, owner, fallbackRoutingHook, aggregationAddress, pausableAddress, merkleTreeAddress, aggregation, childrenBefore, } = await deployFixture();
+        const recoveredPausable = {
+            type: HookType.PAUSABLE,
+            address: pausableAddress,
+            owner: await newOwner.getAddress(),
+            ownerOverrides: {
+                [HookType.PAUSABLE]: await overrideOwner.getAddress(),
+            },
+            paused: false,
+        };
+        const recoveredAggregation = {
+            type: HookType.AGGREGATION,
+            address: aggregationAddress,
+            hooks: [recoveredPausable, merkleTreeAddress],
+        };
+        const mismatchedAggregation = {
+            ...recoveredAggregation,
+            hooks: [recoveredPausable, owner],
+        };
+        const mismatchedConfig = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: { [remote]: mismatchedAggregation },
+        };
+        const nonceBeforeMismatch = await signer.getTransactionCount();
+        await expect(hookDeployer.deployContracts(chain, mismatchedConfig, coreAddresses)).to.be.rejectedWith('does not contain the configured children');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeMismatch);
+        const unchangedPausable = PausableHook__factory.connect(pausableAddress, signer);
+        expect(await unchangedPausable.paused()).to.be.false;
+        expect(eqAddress(await unchangedPausable.owner(), owner)).to.be.true;
+        const pauseMismatch = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: {
+                    ...recoveredAggregation,
+                    hooks: [{ ...recoveredPausable, paused: true }, merkleTreeAddress],
+                },
+            },
+        };
+        await expect(hookDeployer.deployContracts(chain, pauseMismatch, coreAddresses)).to.be.rejectedWith('but config expects paused');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeMismatch);
+        const invalidLaterChild = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: recoveredAggregation,
+                [newRemote]: {
+                    type: HookType.AGGREGATION,
+                    address: merkleTreeAddress,
+                    hooks: [],
+                },
+            },
+        };
+        await expect(hookDeployer.deployContracts(chain, invalidLaterChild, coreAddresses)).to.be.rejectedWith('has type');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeMismatch);
+        expect(eqAddress(await unchangedPausable.owner(), owner)).to.be.true;
+        const conflictingAggregation = {
+            ...recoveredAggregation,
+            hooks: [
+                { ...recoveredPausable, owner: await overrideOwner.getAddress() },
+                merkleTreeAddress,
+            ],
+        };
+        const conflictingAliases = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: recoveredAggregation,
+                [newRemote]: conflictingAggregation,
+            },
+        };
+        await expect(hookDeployer.deployContracts(chain, conflictingAliases, coreAddresses)).to.be.rejectedWith('has conflicting configs');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeMismatch);
+        const recoveredConfig = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: recoveredAggregation,
+                [newRemote]: recoveredAggregation,
+            },
+        };
+        const nonceBefore = await signer.getTransactionCount();
+        const recovered = await hookDeployer.deployContracts(chain, recoveredConfig, coreAddresses);
+        const nonceAfter = await signer.getTransactionCount();
+        expect(recovered.fallbackRoutingHook.address).to.equal(fallbackRoutingHook.address);
+        // transferOwnership on the recovered pausable, then one setHooks call to
+        // enroll newRemote with the existing aggregation.
+        expect(nonceAfter - nonceBefore).to.equal(2);
+        expect(eqAddress(await fallbackRoutingHook.hooks(multiProvider.getDomainId(remote)), aggregationAddress)).to.be.true;
+        expect(eqAddress(await fallbackRoutingHook.hooks(multiProvider.getDomainId(newRemote)), aggregationAddress)).to.be.true;
+        const childrenAfter = await aggregation.hooks(hre.ethers.constants.AddressZero);
+        expect(childrenAfter).to.deep.equal(childrenBefore);
+        const pausable = PausableHook__factory.connect(pausableAddress, signer);
+        expect(await pausable.paused()).to.be.false;
+        expect(eqAddress(await pausable.owner(), await overrideOwner.getAddress()))
+            .to.be.true;
+    });
+    it('rejects recovery when the signer does not own a mutable hook', async () => {
+        const { signer, newOwner, overrideOwner, multiProvider, coreAddresses, hookDeployer, owner, fallbackRoutingHook, aggregationAddress, pausableAddress, merkleTreeAddress, } = await deployFixture();
+        multiProvider.setSharedSigner(overrideOwner);
+        const pausable = PausableHook__factory.connect(pausableAddress, signer);
+        const pausableOwnerBefore = await pausable.owner();
+        const pausablePausedBefore = await pausable.paused();
+        const nonceBeforePausable = await overrideOwner.getTransactionCount();
+        const recoveredPausable = {
+            type: HookType.PAUSABLE,
+            address: pausableAddress,
+            owner: await newOwner.getAddress(),
+            paused: false,
+        };
+        await expect(hookDeployer.deployContracts(chain, recoveredPausable, coreAddresses)).to.be.rejectedWith('is not owner');
+        expect(await overrideOwner.getTransactionCount()).to.equal(nonceBeforePausable);
+        expect(await pausable.owner()).to.equal(pausableOwnerBefore);
+        expect(await pausable.paused()).to.equal(pausablePausedBefore);
+        const routingOwnerBefore = await fallbackRoutingHook.owner();
+        const remoteHookBefore = await fallbackRoutingHook.hooks(multiProvider.getDomainId(remote));
+        const nonceBeforeRouting = await overrideOwner.getTransactionCount();
+        const recoveredRouting = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner: await newOwner.getAddress(),
+            fallback: merkleTreeAddress,
+            domains: { [remote]: aggregationAddress },
+        };
+        await expect(hookDeployer.deployContracts(chain, recoveredRouting, coreAddresses)).to.be.rejectedWith('is not owner');
+        expect(await overrideOwner.getTransactionCount()).to.equal(nonceBeforeRouting);
+        expect(await fallbackRoutingHook.owner()).to.equal(routingOwnerBefore);
+        expect(await fallbackRoutingHook.hooks(multiProvider.getDomainId(remote))).to.equal(remoteHookBefore);
+        expect(eqAddress(routingOwnerBefore, owner)).to.be.true;
+    });
+    it('validates recovered hook mailboxes, including nested hooks', async () => {
+        const { signer, newOwner, multiProvider, coreApp, coreAddresses, hookDeployer, owner, fallbackRoutingHook, aggregationAddress, merkleTreeAddress, } = await deployFixture();
+        const wrongCoreAddresses = {
+            ...coreAddresses,
+            mailbox: await newOwner.getAddress(),
+        };
+        const nonceBefore = await signer.getTransactionCount();
+        const recoveredMerkleTree = {
+            type: HookType.MERKLE_TREE,
+            address: merkleTreeAddress,
+        };
+        await expect(hookDeployer.deployContracts(chain, recoveredMerkleTree, wrongCoreAddresses)).to.be.rejectedWith('has mailbox');
+        const recoveredFallback = {
+            type: HookType.FALLBACK_ROUTING,
+            address: fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: { [remote]: aggregationAddress },
+        };
+        await expect(hookDeployer.deployContracts(chain, recoveredFallback, wrongCoreAddresses)).to.be.rejectedWith('has mailbox');
+        expect(await signer.getTransactionCount()).to.equal(nonceBefore);
+        const foreignCore = coreApp.getContracts(remote);
+        const foreignMerkleTreeAddress = await foreignCore.mailbox.defaultHook();
+        const foreignAggregation = await hookDeployer.deployContracts(chain, {
+            type: HookType.AGGREGATION,
+            hooks: [foreignMerkleTreeAddress],
+        }, coreAddresses);
+        const mixedFallback = await hookDeployer.deployContracts(chain, {
+            type: HookType.FALLBACK_ROUTING,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: foreignAggregation.aggregationHook.address,
+            },
+        }, coreAddresses);
+        const recoveredMixedFallback = {
+            type: HookType.FALLBACK_ROUTING,
+            address: mixedFallback.fallbackRoutingHook.address,
+            owner,
+            fallback: merkleTreeAddress,
+            domains: {
+                [remote]: {
+                    type: HookType.AGGREGATION,
+                    address: foreignAggregation.aggregationHook.address,
+                    hooks: [
+                        {
+                            type: HookType.MERKLE_TREE,
+                            address: foreignMerkleTreeAddress,
+                        },
+                    ],
+                },
+            },
+        };
+        const mixedFallbackHook = FallbackDomainRoutingHook__factory.connect(mixedFallback.fallbackRoutingHook.address, signer);
+        const mixedFallbackOwnerBefore = await mixedFallbackHook.owner();
+        const mixedFallbackRouteBefore = await mixedFallbackHook.hooks(multiProvider.getDomainId(remote));
+        const nonceBeforeNestedRecovery = await signer.getTransactionCount();
+        await expect(hookDeployer.deployContracts(chain, recoveredMixedFallback, coreAddresses)).to.be.rejectedWith('has mailbox');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeNestedRecovery);
+        expect(await mixedFallbackHook.owner()).to.equal(mixedFallbackOwnerBefore);
+        expect(await mixedFallbackHook.hooks(multiProvider.getDomainId(remote))).to.equal(mixedFallbackRouteBefore);
+    });
+    it('reconciles a recovered routing hook without redeployment', async () => {
+        const { signer, newOwner, multiProvider, coreAddresses, hookDeployer, owner, merkleTreeAddress, } = await deployFixture();
+        const initialConfig = {
+            type: HookType.ROUTING,
+            owner,
+            domains: { [remote]: merkleTreeAddress },
+        };
+        const deployed = await hookDeployer.deployContracts(chain, initialConfig, coreAddresses);
+        const routingHook = DomainRoutingHook__factory.connect(deployed.domainRoutingHook.address, signer);
+        const recoveredConfig = {
+            ...initialConfig,
+            address: routingHook.address,
+            owner: await newOwner.getAddress(),
+            domains: {
+                [remote]: merkleTreeAddress,
+                [newRemote]: merkleTreeAddress,
+            },
+        };
+        const nonceBeforeMailboxMismatch = await signer.getTransactionCount();
+        await expect(hookDeployer.deployContracts(chain, recoveredConfig, {
+            ...coreAddresses,
+            mailbox: await newOwner.getAddress(),
+        })).to.be.rejectedWith('has mailbox');
+        expect(await signer.getTransactionCount()).to.equal(nonceBeforeMailboxMismatch);
+        expect(await routingHook.owner()).to.equal(owner);
+        expect(await routingHook.hooks(multiProvider.getDomainId(newRemote))).to.equal(hre.ethers.constants.AddressZero);
+        const nonceBefore = await signer.getTransactionCount();
+        const recovered = await hookDeployer.deployContracts(chain, recoveredConfig, coreAddresses);
+        expect((await signer.getTransactionCount()) - nonceBefore).to.equal(2);
+        expect(recovered.domainRoutingHook.address).to.equal(routingHook.address);
+        expect(await routingHook.hooks(multiProvider.getDomainId(remote))).to.equal(merkleTreeAddress);
+        expect(await routingHook.hooks(multiProvider.getDomainId(newRemote))).to.equal(merkleTreeAddress);
+        expect(await routingHook.owner()).to.equal(await newOwner.getAddress());
+    });
+});
+//# sourceMappingURL=HyperlaneHookDeployer.hardhat-test.js.map

package/dist/hook/HyperlaneHookDeployer.hardhat-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperlaneHookDeployer.hardhat-test.js","sourceRoot":"","sources":["../../src/hook/HyperlaneHookDeployer.hardhat-test.ts"],"names":[],"mappings":"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"}

package/dist/hook/HyperlaneHookDeployer.js

@@ -1,11 +1,36 @@
-import { CCIPHook__factory, IL1CrossDomainMessenger__factory, StaticAggregationHook__factory, } from '@hyperlane-xyz/core';
-import { ZERO_ADDRESS_HEX_32, addBufferToGasLimit, addressToBytes32, assert, deepEquals, rootLogger, } from '@hyperlane-xyz/utils';
+import { ethers } from 'ethers';
+import { CCIPHook__factory, DomainRoutingHook__factory, FallbackDomainRoutingHook__factory, IL1CrossDomainMessenger__factory, IPostDispatchHook__factory, MailboxClient__factory, MerkleTreeHook__factory, PausableHook__factory, StaticAggregationHook__factory, } from '@hyperlane-xyz/core';
+import { ZERO_ADDRESS_HEX_32, addBufferToGasLimit, addressToBytes32, assert, deepEquals, eqAddress, isZeroishAddress, rootLogger, } from '@hyperlane-xyz/utils';
 import { HyperlaneDeployer } from '../deploy/HyperlaneDeployer.js';
-import { submitBatched } from '../deploy/utils.js';
+import { getTxConfigBatchSize, submitBatched } from '../deploy/utils.js';
 import { HyperlaneIgpDeployer } from '../gas/HyperlaneIgpDeployer.js';
 import { IsmType } from '../ism/types.js';
 import { hookFactories } from './contracts.js';
-import { HookType, } from './types.js';
+import { HookType, OnchainHookType, } from './types.js';
+// Hook types that can be recovered without redeployment when the config carries
+// an existing address. Mutable recovered hooks are reconciled in place, and
+// recovered composites traverse only explicitly addressed children.
+const RECOVERABLE_HOOK_TYPES = [
+    HookType.MERKLE_TREE,
+    HookType.AGGREGATION,
+    HookType.PAUSABLE,
+    HookType.ROUTING,
+    HookType.FALLBACK_ROUTING,
+];
+const RECOVERABLE_ONCHAIN_HOOK_TYPES = {
+    [HookType.MERKLE_TREE]: OnchainHookType.MERKLE_TREE,
+    [HookType.AGGREGATION]: OnchainHookType.AGGREGATION,
+    [HookType.PAUSABLE]: OnchainHookType.PAUSABLE,
+    [HookType.ROUTING]: OnchainHookType.ROUTING,
+    [HookType.FALLBACK_ROUTING]: OnchainHookType.FALLBACK_ROUTING,
+};
+function configuredHookAddress(config) {
+    if (typeof config === 'string')
+        return config;
+    return 'address' in config && typeof config.address === 'string'
+        ? config.address
+        : undefined;
+}
 export class HyperlaneHookDeployer extends HyperlaneDeployer {
     core;
     ismFactory;
@@ -28,6 +53,40 @@ export class HyperlaneHookDeployer extends HyperlaneDeployer {
         if (typeof config === 'string') {
             throw new Error('Hook deployer should not receive address config');
         }
+        // Configs carrying an `address` reference an already-deployed hook:
+        // recover the existing contract instead of deploying a new one.
+        const existingHookAddress = configuredHookAddress(config);
+        if (existingHookAddress && RECOVERABLE_HOOK_TYPES.includes(config.type)) {
+            const context = {
+                expectedMailbox: coreAddresses.mailbox,
+                configs: new Map(),
+                routingHooks: new Map(),
+            };
+            await this.validateRecoveredHook(chain, config, existingHookAddress, context);
+            await this.reconcileRecoveredHook(chain, config, existingHookAddress, new Set(), context);
+            const signerOrProvider = this.multiProvider.getSignerOrProvider(chain);
+            const hook = (() => {
+                switch (config.type) {
+                    case HookType.MERKLE_TREE:
+                        return MerkleTreeHook__factory.connect(existingHookAddress, signerOrProvider);
+                    case HookType.AGGREGATION:
+                        return StaticAggregationHook__factory.connect(existingHookAddress, signerOrProvider);
+                    case HookType.PAUSABLE:
+                        return PausableHook__factory.connect(existingHookAddress, signerOrProvider);
+                    case HookType.ROUTING:
+                        return DomainRoutingHook__factory.connect(existingHookAddress, signerOrProvider);
+                    case HookType.FALLBACK_ROUTING:
+                        return FallbackDomainRoutingHook__factory.connect(existingHookAddress, signerOrProvider);
+                    default:
+                        throw new Error(`Hook type ${config.type} cannot be recovered`);
+                }
+            })();
+            // CAST: deployers return the subset of HookFactories materialized by the
+            // requested config; HyperlaneContracts currently models a complete map.
+            const deployedContracts = { [config.type]: hook }; // partial
+            this.addDeployedContracts(chain, deployedContracts);
+            return deployedContracts;
+        }
         let hook;
         if (config.type === HookType.MERKLE_TREE ||
             config.type === HookType.MAILBOX_DEFAULT) {
@@ -56,7 +115,11 @@ export class HyperlaneHookDeployer extends HyperlaneDeployer {
             hook = await this.deployRouting(chain, config, coreAddresses);
         }
         else if (config.type === HookType.PAUSABLE) {
-            hook = await this.deployContract(chain, config.type, []);
+            const pausableHook = await this.deployContract(chain, config.type, []);
+            if (config.paused) {
+                await this.multiProvider.handleTx(chain, pausableHook.pause(this.multiProvider.getTransactionOverrides(chain)));
+            }
+            hook = pausableHook;
             await this.transferOwnershipOfContracts(chain, config, {
                 [HookType.PAUSABLE]: hook,
             });
@@ -74,6 +137,200 @@ export class HyperlaneHookDeployer extends HyperlaneDeployer {
         this.addDeployedContracts(chain, deployedContracts);
         return deployedContracts;
     }
+    recoveredOwner(config) {
+        const owner = config.ownerOverrides?.[config.type] ?? config.owner;
+        assert(!isZeroishAddress(owner), `Recovered ${config.type} owner cannot be the zero address`);
+        return owner;
+    }
+    addRecoveredConfig(configs, address, config) {
+        const key = address.toLowerCase();
+        const existing = configs.get(key);
+        assert(!existing || deepEquals(existing, config), `Recovered hook ${address} has conflicting configs`);
+        if (existing)
+            return false;
+        configs.set(key, config);
+        return true;
+    }
+    async validateRecoveredHook(chain, config, address, context) {
+        if (!this.addRecoveredConfig(context.configs, address, config))
+            return;
+        const expectedType = RECOVERABLE_ONCHAIN_HOOK_TYPES[config.type];
+        assert(expectedType !== undefined, `Hook type ${config.type} cannot be recovered by address`);
+        const actualType = await IPostDispatchHook__factory.connect(address, this.multiProvider.getProvider(chain)).hookType();
+        assert(actualType === expectedType, `Recovered hook ${address} on ${chain} has type ${actualType}, expected ${expectedType}`);
+        if (config.type === HookType.MERKLE_TREE ||
+            config.type === HookType.ROUTING ||
+            config.type === HookType.FALLBACK_ROUTING) {
+            assert(context.expectedMailbox, `Mailbox address is required to recover ${config.type}`);
+            const actualMailbox = await MailboxClient__factory.connect(address, this.multiProvider.getProvider(chain)).mailbox();
+            assert(eqAddress(actualMailbox, context.expectedMailbox), `Recovered hook ${address} on ${chain} has mailbox ${actualMailbox}, expected ${context.expectedMailbox}`);
+        }
+        switch (config.type) {
+            case HookType.PAUSABLE:
+                await this.validateRecoveredPausableHook(chain, config, address);
+                break;
+            case HookType.AGGREGATION:
+                await this.validateRecoveredAggregationHook(chain, config, address, context);
+                break;
+            case HookType.ROUTING:
+            case HookType.FALLBACK_ROUTING:
+                await this.validateRecoveredRoutingHook(chain, config, address, context);
+                break;
+            case HookType.MERKLE_TREE:
+                break;
+            default:
+                assert(false, `Hook type ${config.type} cannot be recovered by address`);
+        }
+    }
+    async validateRecoveredPausableHook(chain, config, address) {
+        const hook = PausableHook__factory.connect(address, this.multiProvider.getProvider(chain));
+        const [currentOwner, currentPaused, signer] = await Promise.all([
+            hook.owner(),
+            hook.paused(),
+            this.multiProvider.getSignerAddress(chain),
+        ]);
+        assert(currentPaused === config.paused, `Recovered pausable hook ${address} on ${chain} is ${currentPaused ? '' : 'not '}paused, but config expects ${config.paused ? '' : 'not '}paused`);
+        const owner = this.recoveredOwner(config);
+        if (!eqAddress(currentOwner, owner)) {
+            assert(eqAddress(currentOwner, signer), `Cannot reconcile recovered pausable hook ${address} on ${chain}: signer ${signer} is not owner ${currentOwner}`);
+        }
+    }
+    async validateRecoveredAggregationHook(chain, config, address, context) {
+        await this.assertRecoveredAggregationChildren(chain, config, address);
+        for (const hookConfig of config.hooks) {
+            if (typeof hookConfig === 'string')
+                continue;
+            const hookAddress = configuredHookAddress(hookConfig);
+            assert(hookAddress, 'Recovered aggregation child address is required');
+            await this.validateRecoveredHook(chain, hookConfig, hookAddress, context);
+        }
+    }
+    async validateRecoveredRoutingHook(chain, config, address, context) {
+        const recoveredRoutingHook = await this.readRecoveredRoutingHook(chain, config, address);
+        context.routingHooks.set(address.toLowerCase(), recoveredRoutingHook);
+        const { routingHook, routingConfigs, childConfigs } = recoveredRoutingHook;
+        const [currentOwner, signer] = await Promise.all([
+            routingHook.owner(),
+            this.multiProvider.getSignerAddress(chain),
+        ]);
+        const owner = this.recoveredOwner(config);
+        if (routingConfigs.length > 0 || !eqAddress(currentOwner, owner)) {
+            assert(eqAddress(currentOwner, signer), `Cannot reconcile recovered routing hook ${address} on ${chain}: signer ${signer} is not owner ${currentOwner}`);
+        }
+        const batchSize = getTxConfigBatchSize(chain);
+        for (let i = 0; i < routingConfigs.length; i += batchSize) {
+            await routingHook.estimateGas.setHooks(routingConfigs.slice(i, i + batchSize));
+        }
+        for (const [childAddress, childConfig] of childConfigs) {
+            await this.validateRecoveredHook(chain, childConfig, childAddress, context);
+        }
+    }
+    async reconcileRecoveredHook(chain, config, address, reconciled, context) {
+        const key = address.toLowerCase();
+        if (reconciled.has(key))
+            return;
+        reconciled.add(key);
+        switch (config.type) {
+            case HookType.PAUSABLE:
+                await this.reconcileRecoveredPausableHook(chain, config, address);
+                break;
+            case HookType.AGGREGATION:
+                await this.reconcileRecoveredAggregationHook(chain, config, address, reconciled, context);
+                break;
+            case HookType.ROUTING:
+            case HookType.FALLBACK_ROUTING:
+                await this.reconcileRecoveredRoutingHook(chain, config, address, reconciled, context);
+                break;
+            default:
+                break;
+        }
+    }
+    async reconcileRecoveredPausableHook(chain, config, address) {
+        const hook = PausableHook__factory.connect(address, this.multiProvider.getSignerOrProvider(chain));
+        const currentOwner = await hook.owner();
+        const owner = this.recoveredOwner(config);
+        if (eqAddress(currentOwner, owner))
+            return;
+        const overrides = this.multiProvider.getTransactionOverrides(chain);
+        await this.multiProvider.handleTx(chain, hook.transferOwnership(owner, overrides));
+    }
+    async assertRecoveredAggregationChildren(chain, config, address) {
+        const expectedAddresses = config.hooks.map((hookConfig) => {
+            const hookAddress = configuredHookAddress(hookConfig);
+            assert(hookAddress, `Recovered aggregation hook ${address} on ${chain} requires addresses for every child`);
+            return hookAddress;
+        });
+        const aggregation = StaticAggregationHook__factory.connect(address, this.multiProvider.getProvider(chain));
+        const actualAddresses = await aggregation.hooks(ethers.constants.AddressZero);
+        const expectedSorted = [...expectedAddresses].sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+        const actualSorted = [...actualAddresses].sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+        assert(actualSorted.length === expectedSorted.length &&
+            actualSorted.every((hookAddress, index) => eqAddress(hookAddress, expectedSorted[index])), `Recovered aggregation hook ${address} on ${chain} does not contain the configured children`);
+    }
+    async reconcileRecoveredAggregationHook(chain, config, address, reconciled, context) {
+        for (const hookConfig of config.hooks) {
+            if (typeof hookConfig === 'string')
+                continue;
+            const hookAddress = configuredHookAddress(hookConfig);
+            assert(hookAddress, 'Recovered aggregation child address is required');
+            await this.reconcileRecoveredHook(chain, hookConfig, hookAddress, reconciled, context);
+        }
+    }
+    async readRecoveredRoutingHook(chain, config, address) {
+        let routingHook;
+        const childConfigs = new Map();
+        if (config.type === HookType.FALLBACK_ROUTING) {
+            const fallbackRoutingHook = FallbackDomainRoutingHook__factory.connect(address, this.multiProvider.getSignerOrProvider(chain));
+            routingHook = fallbackRoutingHook;
+            const fallbackAddress = configuredHookAddress(config.fallback);
+            assert(fallbackAddress, `Recovered fallback routing hook ${address} on ${chain} requires a fallback address`);
+            const actualFallback = await fallbackRoutingHook.fallbackHook();
+            assert(eqAddress(actualFallback, fallbackAddress), `Recovered fallback routing hook ${address} on ${chain} has fallback ${actualFallback}, expected ${fallbackAddress}`);
+            if (typeof config.fallback !== 'string') {
+                this.addRecoveredConfig(childConfigs, fallbackAddress, config.fallback);
+            }
+        }
+        else {
+            routingHook = DomainRoutingHook__factory.connect(address, this.multiProvider.getSignerOrProvider(chain));
+        }
+        const domainConfigs = Object.entries(config.domains).map(([destination, hookConfig]) => {
+            const hookAddress = configuredHookAddress(hookConfig);
+            assert(hookAddress, `Recovered routing hook ${address} on ${chain} requires an address for ${destination}`);
+            if (typeof hookConfig !== 'string') {
+                this.addRecoveredConfig(childConfigs, hookAddress, hookConfig);
+            }
+            return {
+                destination: this.multiProvider.getDomainId(destination),
+                hook: hookAddress,
+            };
+        });
+        const actualHooks = await Promise.all(domainConfigs.map(({ destination }) => routingHook.hooks(destination)));
+        const routingConfigs = domainConfigs.filter(({ hook }, index) => !eqAddress(actualHooks[index], hook));
+        return { routingHook, routingConfigs, childConfigs };
+    }
+    async reconcileRecoveredRoutingHook(chain, config, address, reconciled, context) {
+        const recoveredRoutingHook = context.routingHooks.get(address.toLowerCase());
+        assert(recoveredRoutingHook, `Recovered routing hook ${address} on ${chain} was not validated`);
+        const { routingHook, routingConfigs, childConfigs } = recoveredRoutingHook;
+        for (const [childAddress, childConfig] of childConfigs) {
+            await this.reconcileRecoveredHook(chain, childConfig, childAddress, reconciled, context);
+        }
+        const overrides = this.multiProvider.getTransactionOverrides(chain);
+        if (routingConfigs.length > 0) {
+            await submitBatched(chain, routingConfigs, async (batch) => {
+                const estimatedGas = await routingHook.estimateGas.setHooks(batch);
+                await this.multiProvider.handleTx(chain, routingHook.setHooks(batch, {
+                    gasLimit: addBufferToGasLimit(estimatedGas),
+                    ...overrides,
+                }));
+            }, this.logger, 'recovered routing hook configs');
+        }
+        const owner = this.recoveredOwner(config);
+        const currentOwner = await routingHook.owner();
+        if (!eqAddress(currentOwner, owner)) {
+            await this.multiProvider.handleTx(chain, routingHook.transferOwnership(owner, overrides));
+        }
+    }
     async deployCCIPHook(chain, config) {
         const hook = this.ismFactory.ccipContractCache.getHook(chain, config.destinationChain);
         if (!hook) {