@hyperlane-xyz/sdk 18.1.0 → 18.3.0

package/dist/ism/RadixIsmModule.js

@@ -0,0 +1,208 @@
+import { assert, deepEquals, eqAddress, intersection, rootLogger, } from '@hyperlane-xyz/utils';
+import { HyperlaneModule, } from '../core/AbstractHyperlaneModule.js';
+import { normalizeConfig } from '../utils/ism.js';
+import { RadixIsmReader } from './RadixIsmReader.js';
+import { IsmConfigSchema, IsmType, STATIC_ISM_TYPES, } from './types.js';
+import { calculateDomainRoutingDelta } from './utils.js';
+export class RadixIsmModule extends HyperlaneModule {
+    metadataManager;
+    signer;
+    logger = rootLogger.child({
+        module: 'RadixIsmModule',
+    });
+    reader;
+    mailbox;
+    // Adding these to reduce how often we need to grab from MetadataManager.
+    chain;
+    chainId;
+    domainId;
+    constructor(metadataManager, params, signer) {
+        params.config = IsmConfigSchema.parse(params.config);
+        super(params);
+        this.metadataManager = metadataManager;
+        this.signer = signer;
+        this.mailbox = params.addresses.mailbox;
+        this.chain = metadataManager.getChainName(this.args.chain);
+        this.chainId = metadataManager.getChainId(this.chain);
+        this.domainId = metadataManager.getDomainId(this.chain);
+        this.reader = new RadixIsmReader(this.metadataManager, this.signer);
+    }
+    async read() {
+        return this.reader.deriveIsmConfig(this.args.addresses.deployedIsm);
+    }
+    // whoever calls update() needs to ensure that targetConfig has a valid owner
+    async update(expectedConfig) {
+        expectedConfig = IsmConfigSchema.parse(expectedConfig);
+        // Do not support updating to a custom ISM address
+        if (typeof expectedConfig === 'string') {
+            throw new Error('Invalid targetConfig: Updating to a custom ISM address is not supported. Please provide a valid ISM configuration.');
+        }
+        // save current config for comparison
+        // normalize the config to ensure it's in a consistent format for comparison
+        const actualConfig = normalizeConfig(await this.read());
+        expectedConfig = normalizeConfig(expectedConfig);
+        assert(typeof expectedConfig === 'object', 'normalized expectedConfig should be an object');
+        // Update the config
+        this.args.config = expectedConfig;
+        // If configs match, no updates needed
+        if (deepEquals(actualConfig, expectedConfig)) {
+            return [];
+        }
+        // if the ISM is a static ISM we can not update it, instead
+        // it needs to be recreated with the expected config
+        if (STATIC_ISM_TYPES.includes(expectedConfig.type)) {
+            this.args.addresses.deployedIsm = await this.deploy({
+                config: expectedConfig,
+            });
+            return [];
+        }
+        let updateTxs = [];
+        if (expectedConfig.type === IsmType.ROUTING) {
+            const logger = this.logger.child({
+                destination: this.chain,
+                ismType: expectedConfig.type,
+            });
+            logger.debug(`Updating ${expectedConfig.type} on ${this.chain}`);
+            updateTxs = await this.updateRoutingIsm({
+                actual: actualConfig,
+                expected: expectedConfig,
+                logger,
+            });
+        }
+        return updateTxs;
+    }
+    // manually write static create function
+    static async create({ chain, config, addresses, multiProvider, signer, }) {
+        const module = new RadixIsmModule(multiProvider, {
+            addresses: {
+                ...addresses,
+                deployedIsm: '',
+            },
+            chain,
+            config,
+        }, signer);
+        module.args.addresses.deployedIsm = await module.deploy({ config });
+        return module;
+    }
+    async deploy({ config }) {
+        if (typeof config === 'string') {
+            return config;
+        }
+        const ismType = config.type;
+        this.logger.info(`Deploying ${ismType} to ${this.chain}`);
+        switch (ismType) {
+            case IsmType.MERKLE_ROOT_MULTISIG: {
+                return this.deployMerkleRootMultisigIsm(config);
+            }
+            case IsmType.MESSAGE_ID_MULTISIG: {
+                return this.deployMessageIdMultisigIsm(config);
+            }
+            case IsmType.ROUTING: {
+                return this.deployRoutingIsm(config);
+            }
+            case IsmType.TEST_ISM: {
+                return this.deployNoopIsm();
+            }
+            default:
+                throw new Error(`ISM type ${ismType} is not supported on Radix`);
+        }
+    }
+    async deployMerkleRootMultisigIsm(config) {
+        assert(config.threshold <= config.validators.length, `threshold (${config.threshold}) for merkle root multisig ISM is greater than number of validators (${config.validators.length})`);
+        return this.signer.tx.core.createMerkleRootMultisigIsm({
+            validators: config.validators,
+            threshold: config.threshold,
+        });
+    }
+    async deployMessageIdMultisigIsm(config) {
+        assert(config.threshold <= config.validators.length, `threshold (${config.threshold}) for message id multisig ISM is greater than number of validators (${config.validators.length})`);
+        return this.signer.tx.core.createMessageIdMultisigIsm({
+            validators: config.validators,
+            threshold: config.threshold,
+        });
+    }
+    async deployRoutingIsm(config) {
+        const routes = [];
+        // deploy ISMs for each domain
+        for (const chainName of Object.keys(config.domains)) {
+            const domainId = this.metadataManager.tryGetDomainId(chainName);
+            if (!domainId) {
+                this.logger.warn(`Unknown chain ${chainName}, skipping ISM configuration`);
+                continue;
+            }
+            const address = await this.deploy({ config: config.domains[chainName] });
+            routes.push({
+                ism: address,
+                domain: domainId,
+            });
+        }
+        const ism = await this.signer.tx.core.createRoutingIsm({
+            routes,
+        });
+        if (!eqAddress(this.signer.getAddress(), config.owner)) {
+            await this.signer.tx.core.setRoutingIsmOwner({
+                ism,
+                new_owner: config.owner,
+            });
+        }
+        return ism;
+    }
+    async updateRoutingIsm({ actual, expected, logger, }) {
+        assert(eqAddress(this.signer.getAddress(), actual.owner), `can not update routing ism since the owner ${actual.owner} is not the signer: ${this.signer.getAddress()}`);
+        const updateTxs = [];
+        const knownChains = new Set(this.metadataManager.getKnownChainNames());
+        const { domainsToEnroll, domainsToUnenroll } = calculateDomainRoutingDelta(actual, expected);
+        const knownEnrolls = intersection(knownChains, new Set(domainsToEnroll));
+        // Enroll domains
+        for (const origin of knownEnrolls) {
+            logger.debug(`Reconfiguring preexisting routing ISM for origin ${origin}...`);
+            const ism = await this.deploy({
+                config: expected.domains[origin],
+            });
+            const domain = this.metadataManager.getDomainId(origin);
+            updateTxs.push({
+                annotation: `Setting new ISM for origin ${origin}...`,
+                networkId: this.signer.getNetworkId(),
+                manifest: await this.signer.populate.core.setRoutingIsmRoute({
+                    from_address: this.signer.getAddress(),
+                    ism: this.args.addresses.deployedIsm,
+                    route: {
+                        ism_address: ism,
+                        domain,
+                    },
+                }),
+            });
+        }
+        const knownUnenrolls = intersection(knownChains, new Set(domainsToUnenroll));
+        // Unenroll domains
+        for (const origin of knownUnenrolls) {
+            const domain = this.metadataManager.getDomainId(origin);
+            updateTxs.push({
+                annotation: `Unenrolling originDomain ${domain} from preexisting routing ISM at ${this.args.addresses.deployedIsm}...`,
+                networkId: this.signer.getNetworkId(),
+                manifest: await this.signer.populate.core.removeRoutingIsmRoute({
+                    from_address: this.signer.getAddress(),
+                    ism: this.args.addresses.deployedIsm,
+                    domain,
+                }),
+            });
+        }
+        // Update ownership
+        if (!eqAddress(actual.owner, expected.owner)) {
+            updateTxs.push({
+                annotation: `Transferring ownership of ISM from ${actual.owner} to ${expected.owner}`,
+                networkId: this.signer.getNetworkId(),
+                manifest: await this.signer.populate.core.setRoutingIsmOwner({
+                    from_address: this.signer.getAddress(),
+                    ism: this.args.addresses.deployedIsm,
+                    new_owner: expected.owner,
+                }),
+            });
+        }
+        return updateTxs;
+    }
+    async deployNoopIsm() {
+        return this.signer.tx.core.createNoopIsm();
+    }
+}
+//# sourceMappingURL=RadixIsmModule.js.map

package/dist/ism/RadixIsmModule.js.map

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

package/dist/ism/RadixIsmReader.d.ts

@@ -0,0 +1,16 @@
+import { RadixSDK } from '@hyperlane-xyz/radix-sdk';
+import { Address } from '@hyperlane-xyz/utils';
+import { ChainMetadataManager } from '../metadata/ChainMetadataManager.js';
+import { DerivedIsmConfig } from './types.js';
+export declare class RadixIsmReader {
+    protected readonly metadataManager: ChainMetadataManager;
+    protected readonly sdk: RadixSDK;
+    protected readonly logger: import("pino").default.Logger<never>;
+    constructor(metadataManager: ChainMetadataManager, sdk: RadixSDK);
+    deriveIsmConfig(address: Address): Promise<DerivedIsmConfig>;
+    private deriveMerkleRootMultisigConfig;
+    private deriveMessageIdMultisigConfig;
+    private deriveRoutingIsmConfig;
+    private deriveTestConfig;
+}
+//# sourceMappingURL=RadixIsmReader.d.ts.map

package/dist/ism/RadixIsmReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadixIsmReader.d.ts","sourceRoot":"","sources":["../../src/ism/RadixIsmReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAmC,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IAMvB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,oBAAoB;IACxD,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ;IANlC,SAAS,CAAC,QAAQ,CAAC,MAAM,uCAEtB;gBAGkB,eAAe,EAAE,oBAAoB,EACrC,GAAG,EAAE,QAAQ;IAG5B,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAwBpD,8BAA8B;YAa9B,6BAA6B;YAa7B,sBAAsB;YA2BtB,gBAAgB;CAM/B"}

package/dist/ism/RadixIsmReader.js

@@ -0,0 +1,79 @@
+import { RadixIsmTypes } from '@hyperlane-xyz/radix-sdk';
+import { assert, rootLogger } from '@hyperlane-xyz/utils';
+import { IsmType, } from './types.js';
+export class RadixIsmReader {
+    metadataManager;
+    sdk;
+    logger = rootLogger.child({
+        module: 'RadixIsmReader',
+    });
+    constructor(metadataManager, sdk) {
+        this.metadataManager = metadataManager;
+        this.sdk = sdk;
+    }
+    async deriveIsmConfig(address) {
+        try {
+            const ismType = await this.sdk.query.core.getIsmType({ ism: address });
+            assert(ismType, `ISM with id ${address} not found`);
+            switch (ismType) {
+                case RadixIsmTypes.MERKLE_ROOT_MULTISIG:
+                    return this.deriveMerkleRootMultisigConfig(address);
+                case RadixIsmTypes.MESSAGE_ID_MULTISIG:
+                    return this.deriveMessageIdMultisigConfig(address);
+                case RadixIsmTypes.ROUTING_ISM:
+                    return this.deriveRoutingIsmConfig(address);
+                case RadixIsmTypes.NOOP_ISM:
+                    return this.deriveTestConfig(address);
+                default:
+                    throw new Error(`Unknown ISM ModuleType: ${ismType}`);
+            }
+        }
+        catch (error) {
+            this.logger.error(`Failed to derive ISM config for ${address}`, error);
+            throw error;
+        }
+    }
+    async deriveMerkleRootMultisigConfig(address) {
+        const ism = await this.sdk.query.core.getMultisigIsm({ ism: address });
+        return {
+            type: IsmType.MERKLE_ROOT_MULTISIG,
+            address,
+            validators: ism.validators,
+            threshold: ism.threshold,
+        };
+    }
+    async deriveMessageIdMultisigConfig(address) {
+        const ism = await this.sdk.query.core.getMultisigIsm({ ism: address });
+        return {
+            type: IsmType.MESSAGE_ID_MULTISIG,
+            address,
+            validators: ism.validators,
+            threshold: ism.threshold,
+        };
+    }
+    async deriveRoutingIsmConfig(address) {
+        const ism = await this.sdk.query.core.getRoutingIsm({ ism: address });
+        const domains = {};
+        for (const route of ism.routes) {
+            const chainName = this.metadataManager.tryGetChainName(route.domain);
+            if (!chainName) {
+                this.logger.warn(`Unknown domain ID ${route.domain}, skipping domain configuration`);
+                continue;
+            }
+            domains[chainName] = await this.deriveIsmConfig(route.ism);
+        }
+        return {
+            type: IsmType.ROUTING,
+            address,
+            owner: ism.owner,
+            domains,
+        };
+    }
+    async deriveTestConfig(address) {
+        return {
+            type: IsmType.TEST_ISM,
+            address,
+        };
+    }
+}
+//# sourceMappingURL=RadixIsmReader.js.map

package/dist/ism/RadixIsmReader.js.map

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

package/dist/metadata/ChainMetadataManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChainMetadataManager.test.d.ts.map

package/dist/metadata/ChainMetadataManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainMetadataManager.test.d.ts","sourceRoot":"","sources":["../../src/metadata/ChainMetadataManager.test.ts"],"names":[],"mappings":""}

package/dist/metadata/ChainMetadataManager.test.js

@@ -0,0 +1,119 @@
+import { expect } from 'chai';
+import { ProtocolType } from '@hyperlane-xyz/utils';
+import { ChainMetadataManager } from './ChainMetadataManager.js';
+describe(ChainMetadataManager.name, () => {
+    let manager;
+    const ethereumMetadata = {
+        chainId: 1,
+        domainId: 1,
+        name: 'ethereum',
+        protocol: ProtocolType.Ethereum,
+        rpcUrls: [{ http: 'https://ethereum.example.com' }],
+    };
+    const polygonMetadata = {
+        chainId: 137,
+        domainId: 137,
+        name: 'polygon',
+        protocol: ProtocolType.Ethereum,
+        rpcUrls: [{ http: 'https://polygon.example.com' }],
+    };
+    const cosmosMetadata = {
+        chainId: 'cosmoshub-4',
+        domainId: 118,
+        name: 'cosmos',
+        protocol: ProtocolType.Cosmos,
+        rpcUrls: [{ http: 'https://cosmos.example.com' }],
+        bech32Prefix: 'cosmos',
+        slip44: 118,
+        restUrls: [],
+        grpcUrls: [],
+    };
+    const solanaMetadata = {
+        chainId: 101,
+        domainId: 1399811149,
+        name: 'solana',
+        protocol: ProtocolType.Sealevel,
+        rpcUrls: [{ http: 'https://solana.example.com' }],
+    };
+    beforeEach(() => {
+        manager = new ChainMetadataManager({
+            ethereum: ethereumMetadata,
+            polygon: polygonMetadata,
+            cosmos: cosmosMetadata,
+            solana: solanaMetadata,
+        });
+    });
+    describe(ChainMetadataManager.prototype.tryGetChainMetadata.name, () => {
+        describe('basic functionality', () => {
+            const testCases = [
+                {
+                    description: 'valid chain name',
+                    input: 'ethereum',
+                    expected: ethereumMetadata,
+                },
+                {
+                    description: 'another valid chain name',
+                    input: 'polygon',
+                    expected: polygonMetadata,
+                },
+                {
+                    description: 'non-existent chain name',
+                    input: 'nonexistent',
+                    expected: null,
+                },
+                {
+                    description: 'valid domain ID',
+                    input: 1,
+                    expected: ethereumMetadata,
+                },
+                {
+                    description: 'another valid domain ID',
+                    input: 137,
+                    expected: polygonMetadata,
+                },
+                {
+                    description: 'non-existent domain ID',
+                    input: 99999,
+                    expected: null,
+                },
+            ];
+            testCases.forEach(({ description, input, expected }) => {
+                it(`should return correct result for ${description}`, () => {
+                    const result = manager.tryGetChainMetadata(input);
+                    expect(result).to.deep.equal(expected);
+                });
+            });
+        });
+        describe('different protocol types', () => {
+            const testCases = [
+                {
+                    description: 'Cosmos chain by name',
+                    input: 'cosmos',
+                    expected: cosmosMetadata,
+                },
+                {
+                    description: 'Cosmos chain by domain ID',
+                    input: 118,
+                    expected: cosmosMetadata,
+                },
+                {
+                    description: 'Sealevel chain by name',
+                    input: 'solana',
+                    expected: solanaMetadata,
+                },
+                {
+                    description: 'Sealevel chain by domain ID',
+                    input: 1399811149,
+                    expected: solanaMetadata,
+                },
+            ];
+            testCases.forEach(({ description, input, expected }) => {
+                it(`should handle ${description}`, () => {
+                    const result = manager.tryGetChainMetadata(input);
+                    expect(result).to.deep.equal(expected);
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=ChainMetadataManager.test.js.map

package/dist/metadata/ChainMetadataManager.test.js.map

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