@hyperlane-xyz/sdk 4.1.0 → 4.2.0-beta.2

package/dist/hook/EvmHookModule.d.ts

@@ -22,29 +22,55 @@ type HookModuleAddresses = {
 };
 export declare class EvmHookModule extends HyperlaneModule<ProtocolType.Ethereum, HookConfig, HyperlaneAddresses<ProxyFactoryFactories> & HookModuleAddresses> {
     protected readonly multiProvider: MultiProvider;
+    protected readonly contractVerifier?: ContractVerifier | undefined;
     protected readonly logger: import("pino").default.Logger<never>;
     protected readonly reader: EvmHookReader;
     protected readonly deployer: EvmModuleDeployer<HookFactories & IgpFactories>;
     readonly chain: string;
     readonly domainId: number;
     protected readonly txOverrides: Partial<ethers.providers.TransactionRequest>;
-    protected constructor(multiProvider: MultiProvider, args: HyperlaneModuleParams<HookConfig, HyperlaneAddresses<ProxyFactoryFactories> & HookModuleAddresses>, contractVerifier?: ContractVerifier);
+    protected constructor(multiProvider: MultiProvider, params: HyperlaneModuleParams<HookConfig, HyperlaneAddresses<ProxyFactoryFactories> & HookModuleAddresses>, contractVerifier?: ContractVerifier | undefined);
     read(): Promise<HookConfig>;
-    update(_config: HookConfig): Promise<AnnotatedEV5Transaction[]>;
-    static create({ chain, config, proxyFactoryFactories, coreAddresses, multiProvider, }: {
+    update(targetConfig: HookConfig): Promise<AnnotatedEV5Transaction[]>;
+    static create({ chain, config, proxyFactoryFactories, coreAddresses, multiProvider, contractVerifier, }: {
         chain: ChainNameOrId;
         config: HookConfig;
         proxyFactoryFactories: HyperlaneAddresses<ProxyFactoryFactories>;
         coreAddresses: CoreAddresses;
         multiProvider: MultiProvider;
+        contractVerifier?: ContractVerifier;
     }): Promise<EvmHookModule>;
     protected computeRoutingHooksToSet({ currentDomains, targetDomains, }: {
         currentDomains: DomainRoutingHookConfig['domains'];
         targetDomains: DomainRoutingHookConfig['domains'];
     }): Promise<DomainRoutingHook.HookConfigStruct[]>;
-    protected updateRoutingHook({ current, target, }: {
-        current: DomainRoutingHookConfig | FallbackRoutingHookConfig;
-        target: DomainRoutingHookConfig | FallbackRoutingHookConfig;
+    protected updatePausableHook({ currentConfig, targetConfig, }: {
+        currentConfig: PausableHookConfig;
+        targetConfig: PausableHookConfig;
+    }): Promise<AnnotatedEV5Transaction[]>;
+    protected updateIgpHook({ currentConfig, targetConfig, }: {
+        currentConfig: IgpHookConfig;
+        targetConfig: IgpHookConfig;
+    }): Promise<AnnotatedEV5Transaction[]>;
+    protected updateIgpRemoteGasParams({ interchainGasPaymaster, gasOracle, currentOverheads, targetOverheads, }: {
+        interchainGasPaymaster: Address;
+        gasOracle: Address;
+        currentOverheads?: IgpConfig['overhead'];
+        targetOverheads: IgpConfig['overhead'];
+    }): Promise<AnnotatedEV5Transaction[]>;
+    protected updateStorageGasOracle({ gasOracle, currentOracleConfig, targetOracleConfig, targetOverhead, }: {
+        gasOracle: Address;
+        currentOracleConfig?: IgpConfig['oracleConfig'];
+        targetOracleConfig: IgpConfig['oracleConfig'];
+        targetOverhead: IgpConfig['overhead'];
+    }): Promise<AnnotatedEV5Transaction[]>;
+    protected updateProtocolFeeHook({ currentConfig, targetConfig, }: {
+        currentConfig: ProtocolFeeHookConfig;
+        targetConfig: ProtocolFeeHookConfig;
+    }): Promise<AnnotatedEV5Transaction[]>;
+    protected updateRoutingHook({ currentConfig, targetConfig, }: {
+        currentConfig: DomainRoutingHookConfig | FallbackRoutingHookConfig;
+        targetConfig: DomainRoutingHookConfig | FallbackRoutingHookConfig;
     }): Promise<AnnotatedEV5Transaction[]>;
     protected deploy({ config, }: {
         config: HookConfig;
@@ -74,6 +100,19 @@ export declare class EvmHookModule extends HyperlaneModule<ProtocolType.Ethereum
     protected deployStorageGasOracle({ config, }: {
         config: IgpConfig;
     }): Promise<StorageGasOracle>;
+    /**
+     * Determines if a new hook should be deployed based on the current and target configurations.
+     *
+     * @param currentConfig - The current hook configuration.
+     * @param targetConfig - The target hook configuration. Must not be a string.
+     * @returns {boolean} - Returns true if a new hook should be deployed, otherwise false.
+     *
+     * Conditions for deploying a new hook:
+     * - If updating from an address/custom config to a proper hook config.
+     * - If updating a proper hook config whose types are different.
+     * - If it is not a mutable Hook.
+     */
+    private shouldDeployNewHook;
 }
 export {};
 //# sourceMappingURL=EvmHookModule.d.ts.map

package/dist/hook/EvmHookModule.d.ts.map

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

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

@@ -1,7 +1,7 @@
 /* eslint-disable no-console */
 import { expect } from 'chai';
 import hre from 'hardhat';
-import { configDeepEquals, normalizeConfig, stringifyObject, } from '@hyperlane-xyz/utils';
+import { assert, deepEquals, eqAddress, normalizeConfig, } from '@hyperlane-xyz/utils';
 import { TestChainName, testChains } from '../consts/testChains.js';
 import { TestCoreDeployer } from '../core/TestCoreDeployer.js';
 import { HyperlaneProxyFactoryDeployer } from '../deploy/HyperlaneProxyFactoryDeployer.js';
@@ -9,7 +9,7 @@ import { HyperlaneIsmFactory } from '../ism/HyperlaneIsmFactory.js';
 import { MultiProvider } from '../providers/MultiProvider.js';
 import { randomAddress, randomInt } from '../test/testUtils.js';
 import { EvmHookModule } from './EvmHookModule.js';
-import { HookType, } from './types.js';
+import { HookType, MUTABLE_HOOK_TYPE, } from './types.js';
 const hookTypes = Object.values(HookType);
 function randomHookType() {
     // OP_STACK filtering is temporary until we have a way to deploy the required contracts
@@ -102,13 +102,16 @@ function randomHookConfig(depth = 0, maxDepth = 2, providedHookType) {
     }
 }
 describe('EvmHookModule', async () => {
+    const chain = TestChainName.test4;
     let multiProvider;
     let coreAddresses;
-    const chain = TestChainName.test4;
+    let signer;
+    let funder;
     let proxyFactoryAddresses;
     let factoryContracts;
+    let exampleRoutingConfig;
     beforeEach(async () => {
-        const [signer] = await hre.ethers.getSigners();
+        [signer, funder] = await hre.ethers.getSigners();
         multiProvider = MultiProvider.createTestMultiProvider({ signer });
         const ismFactoryDeployer = new HyperlaneProxyFactoryDeployer(multiProvider);
         const contractsMap = await ismFactoryDeployer.deploy(multiProvider.mapKnownChains(() => ({})));
@@ -130,24 +133,46 @@ describe('EvmHookModule', async () => {
             proxyAdmin: proxyAdmin.address,
             validatorAnnounce: validatorAnnounce.address,
         };
+        // reusable for routing/fallback routing specific tests
+        exampleRoutingConfig = {
+            owner: (await multiProvider.getSignerAddress(chain)).toLowerCase(),
+            domains: Object.fromEntries(testChains.map((c) => [
+                c,
+                {
+                    type: HookType.MERKLE_TREE,
+                },
+            ])),
+            type: HookType.FALLBACK_ROUTING,
+            fallback: { type: HookType.MERKLE_TREE },
+        };
     });
-    // Helper method for checking whether Hook module matches a given config
-    async function hookModuleMatchesConfig({ hook, config, }) {
-        const normalizedDerivedConfig = normalizeConfig(await hook.read());
-        const normalizedConfig = normalizeConfig(config);
-        const matches = configDeepEquals(normalizedDerivedConfig, normalizedConfig);
-        if (!matches) {
-            console.error('Derived config:\n', stringifyObject(normalizedDerivedConfig));
-            console.error('Expected config:\n', stringifyObject(normalizedConfig));
+    // Helper method for create a new multiprovider with an impersonated account
+    async function impersonateAccount(account) {
+        await hre.ethers.provider.send('hardhat_impersonateAccount', [account]);
+        await funder.sendTransaction({
+            to: account,
+            value: hre.ethers.utils.parseEther('1.0'),
+        });
+        return MultiProvider.createTestMultiProvider({
+            signer: hre.ethers.provider.getSigner(account),
+        });
+    }
+    // Helper method to expect exactly N updates to be applied
+    async function expectTxsAndUpdate(hook, config, n) {
+        const txs = await hook.update(config);
+        expect(txs.length).to.equal(n);
+        for (const tx of txs) {
+            await multiProvider.sendTransaction(chain, tx);
         }
-        return matches;
     }
     // hook module and config for testing
     let testHook;
     let testConfig;
     // expect that the hook matches the config after all tests
     afterEach(async () => {
-        expect(await hookModuleMatchesConfig({ hook: testHook, config: testConfig })).to.be.true;
+        const normalizedDerivedConfig = normalizeConfig(await testHook.read());
+        const normalizedConfig = normalizeConfig(testConfig);
+        deepEquals(normalizedDerivedConfig, normalizedConfig);
     });
     // create a new Hook and verify that it matches the config
     async function createHook(config) {
@@ -158,106 +183,36 @@ describe('EvmHookModule', async () => {
             coreAddresses,
             multiProvider,
         });
-        testConfig = config;
         testHook = hook;
+        testConfig = config;
         return { hook, initialHookAddress: hook.serialize().deployedHook };
     }
     describe('create', async () => {
+        // generate a random config for each hook type
+        const exampleHookConfigs = [
+            // include an address config
+            randomAddress(),
+            ...hookTypes
+                // need to setup deploying/mocking IL1CrossDomainMessenger before this test can be enabled
+                .filter((hookType) => hookType !== HookType.OP_STACK && hookType !== HookType.CUSTOM)
+                // generate a random config for each hook type
+                .map((hookType) => {
+                return randomHookConfig(0, 1, hookType);
+            }),
+        ];
+        // test deployment of each hookType, except OP_STACK and CUSTOM
+        // minimum depth only
+        for (const config of exampleHookConfigs) {
+            it(`deploys a hook of type ${typeof config === 'string' ? 'address' : config.type}`, async () => {
+                await createHook(config);
+            });
+        }
+        // manually include test for CUSTOM hook type
         it('deploys a hook of type CUSTOM', async () => {
             const config = randomAddress();
             await createHook(config);
         });
-        it('deploys a hook of type MERKLE_TREE', async () => {
-            const config = {
-                type: HookType.MERKLE_TREE,
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type INTERCHAIN_GAS_PAYMASTER', async () => {
-            const owner = randomAddress();
-            const config = {
-                owner,
-                type: HookType.INTERCHAIN_GAS_PAYMASTER,
-                beneficiary: randomAddress(),
-                oracleKey: owner,
-                overhead: Object.fromEntries(testChains.map((c) => [c, Math.floor(Math.random() * 100)])),
-                oracleConfig: Object.fromEntries(testChains.map((c) => [
-                    c,
-                    {
-                        tokenExchangeRate: randomInt(1234567891234).toString(),
-                        gasPrice: randomInt(1234567891234).toString(),
-                    },
-                ])),
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type PROTOCOL_FEE', async () => {
-            const { maxProtocolFee, protocolFee } = randomProtocolFee();
-            const config = {
-                owner: randomAddress(),
-                type: HookType.PROTOCOL_FEE,
-                maxProtocolFee,
-                protocolFee,
-                beneficiary: randomAddress(),
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type ROUTING', async () => {
-            const config = {
-                owner: randomAddress(),
-                type: HookType.ROUTING,
-                domains: Object.fromEntries(testChains
-                    .filter((c) => c !== TestChainName.test4)
-                    .map((c) => [
-                    c,
-                    {
-                        type: HookType.MERKLE_TREE,
-                    },
-                ])),
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type FALLBACK_ROUTING', async () => {
-            const config = {
-                owner: randomAddress(),
-                type: HookType.FALLBACK_ROUTING,
-                fallback: { type: HookType.MERKLE_TREE },
-                domains: Object.fromEntries(testChains
-                    .filter((c) => c !== TestChainName.test4)
-                    .map((c) => [
-                    c,
-                    {
-                        type: HookType.MERKLE_TREE,
-                    },
-                ])),
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type AGGREGATION', async () => {
-            const config = {
-                type: HookType.AGGREGATION,
-                hooks: [{ type: HookType.MERKLE_TREE }, { type: HookType.MERKLE_TREE }],
-            };
-            await createHook(config);
-        });
-        it('deploys a hook of type PAUSABLE', async () => {
-            const config = {
-                owner: randomAddress(),
-                type: HookType.PAUSABLE,
-                paused: false,
-            };
-            await createHook(config);
-        });
-        // it('deploys a hook of type OP_STACK', async () => {
-        // need to setup deploying/mocking IL1CrossDomainMessenger before this test can be enabled
-        //   const config: OpStackHookConfig = {
-        //     owner: randomAddress(),
-        //     type: HookType.OP_STACK,
-        //     nativeBridge: randomAddress(),
-        //     destinationChain: 'testChain',
-        //   };
-        //   await createHook(config);
-        // });
+        // random configs upto depth 2
         for (let i = 0; i < 16; i++) {
             it(`deploys a random hook config #${i}`, async () => {
                 // random config with depth 0-2
@@ -265,6 +220,7 @@ describe('EvmHookModule', async () => {
                 await createHook(config);
             });
         }
+        // manual test to catch regressions on a complex config type
         it('regression test #1', async () => {
             const config = {
                 type: HookType.AGGREGATION,
@@ -376,5 +332,277 @@ describe('EvmHookModule', async () => {
             await createHook(config);
         });
     });
+    describe('update', async () => {
+        it('should update by deploying a new aggregation hook', async () => {
+            const config = {
+                type: HookType.AGGREGATION,
+                hooks: [randomHookConfig(0, 2), randomHookConfig(0, 2)],
+            };
+            // create a new hook
+            const { hook, initialHookAddress } = await createHook(config);
+            // change the hooks
+            config.hooks = [randomHookConfig(0, 2), randomHookConfig(0, 2)];
+            // expect 0 tx to be returned, as it should deploy a new aggregation hook
+            await expectTxsAndUpdate(hook, config, 0);
+            // expect the hook address to be different
+            expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to.be
+                .false;
+        });
+        const createDeployerOwnedIgpHookConfig = async () => {
+            const owner = await multiProvider.getSignerAddress(chain);
+            return {
+                owner,
+                type: HookType.INTERCHAIN_GAS_PAYMASTER,
+                beneficiary: randomAddress(),
+                oracleKey: owner,
+                overhead: Object.fromEntries(testChains.map((c) => [c, Math.floor(Math.random() * 100)])),
+                oracleConfig: Object.fromEntries(testChains.map((c) => [
+                    c,
+                    {
+                        tokenExchangeRate: randomInt(1234567891234).toString(),
+                        gasPrice: randomInt(1234567891234).toString(),
+                    },
+                ])),
+            };
+        };
+        it('should update beneficiary in IGP', async () => {
+            const config = await createDeployerOwnedIgpHookConfig();
+            // create a new hook
+            const { hook } = await createHook(config);
+            // change the beneficiary
+            config.beneficiary = randomAddress();
+            // expect 1 tx to update the beneficiary
+            await expectTxsAndUpdate(hook, config, 1);
+        });
+        it('should update the overheads in IGP', async () => {
+            const config = await createDeployerOwnedIgpHookConfig();
+            // create a new hook
+            const { hook } = await createHook(config);
+            // change the overheads
+            config.overhead = Object.fromEntries(testChains.map((c) => [c, Math.floor(Math.random() * 100)]));
+            // expect 1 tx to update the overheads
+            await expectTxsAndUpdate(hook, config, 1);
+        });
+        it('should update the oracle config in IGP', async () => {
+            const config = await createDeployerOwnedIgpHookConfig();
+            // create a new hook
+            const { hook } = await createHook(config);
+            // change the oracle config
+            config.oracleConfig = Object.fromEntries(testChains.map((c) => [
+                c,
+                {
+                    tokenExchangeRate: randomInt(987654321).toString(),
+                    gasPrice: randomInt(987654321).toString(),
+                },
+            ]));
+            // expect 1 tx to update the oracle config
+            await expectTxsAndUpdate(hook, config, 1);
+        });
+        it('should update protocol fee in protocol fee hook', async () => {
+            const config = {
+                owner: await multiProvider.getSignerAddress(chain),
+                type: HookType.PROTOCOL_FEE,
+                maxProtocolFee: '1000',
+                protocolFee: '100',
+                beneficiary: randomAddress(),
+            };
+            // create a new hook
+            const { hook } = await createHook(config);
+            // change the protocol fee
+            config.protocolFee = '200';
+            // expect 1 tx to update the protocol fee
+            await expectTxsAndUpdate(hook, config, 1);
+        });
+        it('should update max fee in protocol fee hook', async () => {
+            const config = {
+                owner: await multiProvider.getSignerAddress(chain),
+                type: HookType.PROTOCOL_FEE,
+                maxProtocolFee: '1000',
+                protocolFee: '100',
+                beneficiary: randomAddress(),
+            };
+            // create a new hook
+            const { hook, initialHookAddress } = await createHook(config);
+            // change the protocol fee
+            config.maxProtocolFee = '2000';
+            // expect 0 tx to update the max protocol fee as it has to deploy a new hook
+            await expectTxsAndUpdate(hook, config, 0);
+            // expect the hook address to be different
+            expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to.be
+                .false;
+        });
+        it('should update paused state of pausable hook', async () => {
+            const config = {
+                owner: randomAddress(),
+                type: HookType.PAUSABLE,
+                paused: false,
+            };
+            // create a new hook
+            const { hook } = await createHook(config);
+            // change the paused state
+            config.paused = true;
+            // impersonate the hook owner
+            multiProvider = await impersonateAccount(config.owner);
+            // expect 1 tx to update the paused state
+            await expectTxsAndUpdate(hook, config, 1);
+        });
+        for (const type of [HookType.ROUTING, HookType.FALLBACK_ROUTING]) {
+            beforeEach(() => {
+                exampleRoutingConfig.type = type;
+            });
+            it(`should skip deployment with warning if no chain metadata configured ${type}`, async () => {
+                // create a new hook
+                const { hook } = await createHook(exampleRoutingConfig);
+                // add config for a domain the multiprovider doesn't have
+                const updatedConfig = {
+                    ...exampleRoutingConfig,
+                    domains: {
+                        ...exampleRoutingConfig.domains,
+                        test5: { type: HookType.MERKLE_TREE },
+                    },
+                };
+                // expect 0 txs, as adding test5 domain is no-op
+                await expectTxsAndUpdate(hook, updatedConfig, 0);
+            });
+            it(`no changes to an existing ${type} means no redeployment or updates`, async () => {
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(exampleRoutingConfig);
+                // expect 0 updates
+                await expectTxsAndUpdate(hook, exampleRoutingConfig, 0);
+                // expect the hook address to be the same
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+            it(`updates an existing ${type} with new domains`, async () => {
+                exampleRoutingConfig = {
+                    owner: (await multiProvider.getSignerAddress(chain)).toLowerCase(),
+                    domains: {
+                        test1: {
+                            type: HookType.MERKLE_TREE,
+                        },
+                    },
+                    type: HookType.FALLBACK_ROUTING,
+                    fallback: { type: HookType.MERKLE_TREE },
+                };
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(exampleRoutingConfig);
+                // add a new domain
+                exampleRoutingConfig.domains[TestChainName.test2] = {
+                    type: HookType.MERKLE_TREE,
+                };
+                // expect 1 tx to update the domains
+                await expectTxsAndUpdate(hook, exampleRoutingConfig, 1);
+                // expect the hook address to be the same
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+            it(`updates an existing ${type} with new domains`, async () => {
+                exampleRoutingConfig = {
+                    owner: (await multiProvider.getSignerAddress(chain)).toLowerCase(),
+                    domains: {
+                        test1: {
+                            type: HookType.MERKLE_TREE,
+                        },
+                    },
+                    type: HookType.FALLBACK_ROUTING,
+                    fallback: { type: HookType.MERKLE_TREE },
+                };
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(exampleRoutingConfig);
+                // add multiple new domains
+                exampleRoutingConfig.domains[TestChainName.test2] = {
+                    type: HookType.MERKLE_TREE,
+                };
+                exampleRoutingConfig.domains[TestChainName.test3] = {
+                    type: HookType.MERKLE_TREE,
+                };
+                exampleRoutingConfig.domains[TestChainName.test4] = {
+                    type: HookType.MERKLE_TREE,
+                };
+                // expect 1 tx to update the domains
+                await expectTxsAndUpdate(hook, exampleRoutingConfig, 1);
+                // expect the hook address to be the same
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+        }
+        it(`update fallback in an existing fallback routing hook`, async () => {
+            // create a new hook
+            const config = exampleRoutingConfig;
+            const { hook, initialHookAddress } = await createHook(config);
+            // change the fallback
+            config.fallback = {
+                type: HookType.PROTOCOL_FEE,
+                owner: randomAddress(),
+                maxProtocolFee: '9000',
+                protocolFee: '350',
+                beneficiary: randomAddress(),
+            };
+            // expect 0 tx as it will have to deploy a new fallback routing hook
+            await expectTxsAndUpdate(hook, config, 0);
+            // expect the hook address to be different
+            expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to.be
+                .false;
+        });
+        it(`update fallback in an existing fallback routing hook with no change`, async () => {
+            // create a new hook
+            const config = exampleRoutingConfig;
+            const { hook } = await createHook(config);
+            // expect 0 updates
+            await expectTxsAndUpdate(hook, config, 0);
+        });
+        // generate a random config for each ownable hook type
+        const ownableHooks = hookTypes
+            .filter((hookType) => MUTABLE_HOOK_TYPE.includes(hookType))
+            .map((hookType) => {
+            return randomHookConfig(0, 1, hookType);
+        });
+        for (const config of ownableHooks) {
+            assert(typeof config !== 'string', 'Address is not an ownable hook config');
+            assert('owner' in config, 'Ownable hook config must have an owner property');
+            it(`updates owner in an existing ${config.type}`, async () => {
+                // hook owned by the deployer
+                config.owner = await multiProvider.getSignerAddress(chain);
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(config);
+                // change the config owner
+                config.owner = randomAddress();
+                // expect 1 tx to transfer ownership
+                await expectTxsAndUpdate(hook, config, 1);
+                // expect the hook address to be the same
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+            it(`update owner in an existing ${config.type} not owned by deployer`, async () => {
+                // hook owner is not the deployer
+                config.owner = randomAddress();
+                const originalOwner = config.owner;
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(config);
+                // update the config owner and impersonate the original owner
+                config.owner = randomAddress();
+                multiProvider = await impersonateAccount(originalOwner);
+                // expect 1 tx to transfer ownership
+                await expectTxsAndUpdate(hook, config, 1);
+                // expect the hook address to be unchanged
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+            it(`update owner in an existing ${config.type} not owned by deployer and no change`, async () => {
+                // hook owner is not the deployer
+                config.owner = randomAddress();
+                const originalOwner = config.owner;
+                // create a new hook
+                const { hook, initialHookAddress } = await createHook(config);
+                // impersonate the original owner
+                multiProvider = await impersonateAccount(originalOwner);
+                // expect 0 updates
+                await expectTxsAndUpdate(hook, config, 0);
+                // expect the hook address to be unchanged
+                expect(eqAddress(initialHookAddress, hook.serialize().deployedHook)).to
+                    .be.true;
+            });
+        }
+    });
 });
 //# sourceMappingURL=EvmHookModule.hardhat-test.js.map