@humanode-hyperlane/deploy-sdk 0.0.0-stage → 4.2.3-humanode.1

package/dist/ism/generic-ism-writer.js

@@ -0,0 +1,84 @@
+import { AltVM, getProtocolProvider, } from '@humanode-hyperlane/provider-sdk';
+import { IsmReader } from './generic-ism.js';
+import { RoutingIsmWriter } from './routing-ism.js';
+/**
+ * Factory function to create an IsmWriter instance.
+ * This helper centralizes the creation of artifact managers and ISM writers,
+ * making it easier to instantiate writers across the codebase.
+ *
+ * @param chainMetadata Chain metadata for the target chain (protocol type is extracted from metadata.protocol)
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @param signer Signer interface for signing transactions
+ * @returns An IsmWriter instance
+ *
+ * @example
+ * ```typescript
+ * const writer = createIsmWriter(chainMetadata, chainLookup, signer);
+ * const [deployed, receipts] = await writer.create({ config: ismConfig });
+ * ```
+ */
+export function createIsmWriter(chainMetadata, chainLookup, signer) {
+    const protocolProvider = getProtocolProvider(chainMetadata.protocol);
+    const artifactManager = protocolProvider.createIsmArtifactManager(chainMetadata);
+    return new IsmWriter(artifactManager, chainLookup, signer);
+}
+/**
+ * IsmWriter handles creation and updates of ISMs using the Artifact API.
+ * It delegates to protocol-specific artifact writers for individual ISM types.
+ *
+ * Key features:
+ * - Extends IsmReader to inherit read() functionality
+ * - Works with pure Artifact API (IsmArtifactConfig)
+ * - Delegates to typed writers from artifact manager for specific ISM types
+ * - Uses RoutingIsmWriter for composite routing ISM operations
+ * - Protocol-agnostic through artifact manager abstraction
+ */
+export class IsmWriter extends IsmReader {
+    artifactManager;
+    chainLookup;
+    signer;
+    routingWriter;
+    constructor(artifactManager, chainLookup, signer) {
+        super(artifactManager, chainLookup);
+        this.artifactManager = artifactManager;
+        this.chainLookup = chainLookup;
+        this.signer = signer;
+        this.routingWriter = new RoutingIsmWriter(artifactManager, chainLookup, signer);
+    }
+    /**
+     * Creates a new ISM by deploying it on-chain.
+     * For routing ISMs, delegates to RoutingIsmWriter to handle nested ISM deployments.
+     * For other ISM types, requests a typed writer from the artifact manager.
+     *
+     * @param artifact The ISM configuration to deploy (can be new or reference existing)
+     * @returns A tuple of [deployed artifact, transaction receipts]
+     */
+    async create(artifact) {
+        const { artifactState, config } = artifact;
+        // Routing ISMs are composite - use RoutingIsmWriter for nested deployments
+        if (config.type === AltVM.IsmType.ROUTING) {
+            return this.routingWriter.create({ artifactState, config });
+        }
+        // For other ISM types, request typed writer from artifact manager
+        const writer = this.artifactManager.createWriter(config.type, this.signer);
+        return writer.create({ artifactState, config });
+    }
+    /**
+     * Updates an existing ISM to match the desired configuration.
+     * Only routing ISMs support updates (domain enrollment/unenrollment, owner changes).
+     * Multisig and test ISMs are immutable - returns empty array.
+     *
+     * @param artifact The desired ISM state (must include deployed address)
+     * @returns Array of transactions needed to perform the update
+     */
+    async update(artifact) {
+        const { artifactState, config, deployed } = artifact;
+        // Only routing ISMs are mutable - support domain updates and owner changes
+        if (config.type === AltVM.IsmType.ROUTING) {
+            return this.routingWriter.update({ artifactState, config, deployed });
+        }
+        // Multisig and test ISMs are immutable - no updates possible
+        return [];
+    }
+}
+//# sourceMappingURL=generic-ism-writer.js.map

package/dist/ism/generic-ism-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-ism-writer.js","sourceRoot":"","sources":["../../src/ism/generic-ism-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAEL,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAkB1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,aAAoC,EACpC,WAAwB,EACxB,MAAuC;IAEvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,eAAe,GACnB,gBAAgB,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;IAE3D,OAAO,IAAI,SAAS,CAAC,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SACX,SAAQ,SAAS;IAMI;IACA;IACA;IALJ,aAAa,CAAmB;IAEjD,YACqB,eAAuC,EACvC,WAAwB,EACxB,MAAuC;QAE1D,KAAK,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAJjB,oBAAe,GAAf,eAAe,CAAwB;QACvC,gBAAW,GAAX,WAAW,CAAa;QACxB,WAAM,GAAN,MAAM,CAAiC;QAG1D,IAAI,CAAC,aAAa,GAAG,IAAI,gBAAgB,CACvC,eAAe,EACf,WAAW,EACX,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,QAAwC;QAExC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAE3C,2EAA2E;QAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,kEAAkE;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,QAA6B;QACxC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QAErD,2EAA2E;QAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,6DAA6D;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/ism/generic-ism.d.ts

@@ -0,0 +1,43 @@
+import { ChainMetadataForAltVM } from '@humanode-hyperlane/provider-sdk';
+import { ArtifactReader } from '@humanode-hyperlane/provider-sdk/artifact';
+import { ChainLookup } from '@humanode-hyperlane/provider-sdk/chain';
+import { DeployedIsmAddress, DeployedIsmArtifact, DerivedIsmConfig, IRawIsmArtifactManager, IsmArtifactConfig } from '@humanode-hyperlane/provider-sdk/ism';
+import { Logger } from '@humanode-hyperlane/utils';
+/**
+ * Factory function to create an IsmReader instance.
+ * This helper centralizes the creation of artifact managers and ISM readers,
+ * making it easier to instantiate readers across the codebase.
+ *
+ * @param chainMetadata Chain metadata for the target chain (protocol type is extracted from metadata.protocol)
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @returns An IsmReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createIsmReader(chainMetadata, chainLookup);
+ * const ismConfig = await reader.read(ismAddress);
+ * ```
+ */
+export declare function createIsmReader(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup): IsmReader;
+/**
+ * Generic ISM Reader that can read any ISM type by detecting its type
+ * and recursively expanding nested ISMs (e.g., for routing ISMs).
+ */
+export declare class IsmReader implements ArtifactReader<IsmArtifactConfig, DeployedIsmAddress> {
+    protected readonly artifactManager: IRawIsmArtifactManager;
+    protected readonly chainLookup: ChainLookup;
+    protected readonly logger: Logger;
+    constructor(artifactManager: IRawIsmArtifactManager, chainLookup: ChainLookup);
+    read(address: string): Promise<DeployedIsmArtifact>;
+    /**
+     * Expands a raw routing ISM config by recursively reading the domain ISMs.
+     * Takes a pre-read raw artifact to avoid double reading.
+     */
+    private expandRoutingIsm;
+    /**
+     * Backward compatibility method that converts DeployedIsmArtifact to DerivedIsmConfig.
+     * This allows IsmReader to be used as a drop-in replacement for the old AltVMIsmReader.
+     */
+    deriveIsmConfig(address: string): Promise<DerivedIsmConfig>;
+}
+//# sourceMappingURL=generic-ism.d.ts.map

package/dist/ism/generic-ism.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-ism.d.ts","sourceRoot":"","sources":["../../src/ism/generic-ism.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EAEtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,cAAc,EAEf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EAIlB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAc,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,GACvB,SAAS,CAMX;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,cAAc,CAC9C,iBAAiB,EACjB,kBAAkB,CACnB;IAMG,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,sBAAsB;IAC1D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAN7C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAE9B;gBAGkB,eAAe,EAAE,sBAAsB,EACvC,WAAW,EAAE,WAAW;IAGvC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBzD;;;OAGG;YACW,gBAAgB;IAwC9B;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAIlE"}

package/dist/ism/generic-ism.js

@@ -0,0 +1,95 @@
+import { AltVM, getProtocolProvider, } from '@humanode-hyperlane/provider-sdk';
+import { isArtifactDeployed, } from '@humanode-hyperlane/provider-sdk/artifact';
+import { ismArtifactToDerivedConfig, } from '@humanode-hyperlane/provider-sdk/ism';
+import { rootLogger } from '@humanode-hyperlane/utils';
+/**
+ * Factory function to create an IsmReader instance.
+ * This helper centralizes the creation of artifact managers and ISM readers,
+ * making it easier to instantiate readers across the codebase.
+ *
+ * @param chainMetadata Chain metadata for the target chain (protocol type is extracted from metadata.protocol)
+ * @param chainLookup Chain lookup interface for resolving chain names and domain IDs
+ * @returns An IsmReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createIsmReader(chainMetadata, chainLookup);
+ * const ismConfig = await reader.read(ismAddress);
+ * ```
+ */
+export function createIsmReader(chainMetadata, chainLookup) {
+    const protocolProvider = getProtocolProvider(chainMetadata.protocol);
+    const artifactManager = protocolProvider.createIsmArtifactManager(chainMetadata);
+    return new IsmReader(artifactManager, chainLookup);
+}
+/**
+ * Generic ISM Reader that can read any ISM type by detecting its type
+ * and recursively expanding nested ISMs (e.g., for routing ISMs).
+ */
+export class IsmReader {
+    artifactManager;
+    chainLookup;
+    logger = rootLogger.child({
+        module: IsmReader.name,
+    });
+    constructor(artifactManager, chainLookup) {
+        this.artifactManager = artifactManager;
+        this.chainLookup = chainLookup;
+    }
+    async read(address) {
+        // Read once via readIsm() - detects type
+        const { artifactState, config, deployed } = await this.artifactManager.readIsm(address);
+        // For routing ISMs, expand nested domain ISMs recursively
+        if (config.type === AltVM.IsmType.ROUTING) {
+            return this.expandRoutingIsm({ artifactState, config, deployed });
+        }
+        // For non-routing ISMs, the raw and expanded configs are identical
+        return {
+            artifactState,
+            config,
+            deployed,
+        };
+    }
+    /**
+     * Expands a raw routing ISM config by recursively reading the domain ISMs.
+     * Takes a pre-read raw artifact to avoid double reading.
+     */
+    async expandRoutingIsm(rawArtifact) {
+        const { artifactState, config, deployed } = rawArtifact;
+        const domains = {};
+        for (const [domainId, domainIsmConfig] of Object.entries(config.domains)) {
+            if (!this.chainLookup.getChainName(parseInt(domainId))) {
+                this.logger.warn(`Skipping derivation of unknown ${AltVM.IsmType.ROUTING} domain ${domainId}`);
+                continue;
+            }
+            let nestedIsm;
+            if (isArtifactDeployed(domainIsmConfig)) {
+                // Already a full deployed artifact, use as-is
+                nestedIsm = domainIsmConfig;
+            }
+            else {
+                // ArtifactUnderived - recursively read using self to get full config
+                nestedIsm = await this.read(domainIsmConfig.deployed.address);
+            }
+            domains[parseInt(domainId)] = nestedIsm;
+        }
+        return {
+            artifactState,
+            config: {
+                type: AltVM.IsmType.ROUTING,
+                owner: config.owner,
+                domains,
+            },
+            deployed,
+        };
+    }
+    /**
+     * Backward compatibility method that converts DeployedIsmArtifact to DerivedIsmConfig.
+     * This allows IsmReader to be used as a drop-in replacement for the old AltVMIsmReader.
+     */
+    async deriveIsmConfig(address) {
+        const artifact = await this.read(address);
+        return ismArtifactToDerivedConfig(artifact, this.chainLookup);
+    }
+}
+//# sourceMappingURL=generic-ism.js.map

package/dist/ism/generic-ism.js.map

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

package/dist/ism/routing-ism.d.ts

@@ -0,0 +1,21 @@
+import { ISigner } from '@humanode-hyperlane/provider-sdk/altvm';
+import { ArtifactDeployed, ArtifactNew, ArtifactWriter } from '@humanode-hyperlane/provider-sdk/artifact';
+import { ChainLookup } from '@humanode-hyperlane/provider-sdk/chain';
+import { DeployedIsmAddress, IRawIsmArtifactManager, RoutingIsmArtifactConfig } from '@humanode-hyperlane/provider-sdk/ism';
+import { AnnotatedTx, TxReceipt } from '@humanode-hyperlane/provider-sdk/module';
+import { Logger } from '@humanode-hyperlane/utils';
+type DeployedRoutingIsmArtifact = ArtifactDeployed<RoutingIsmArtifactConfig, DeployedIsmAddress>;
+export declare class RoutingIsmWriter implements ArtifactWriter<RoutingIsmArtifactConfig, DeployedIsmAddress> {
+    protected readonly artifactManager: IRawIsmArtifactManager;
+    protected readonly chainLookup: ChainLookup;
+    private readonly signer;
+    protected readonly logger: Logger;
+    private readonly ismReader;
+    constructor(artifactManager: IRawIsmArtifactManager, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>);
+    read(address: string): Promise<DeployedRoutingIsmArtifact>;
+    create(artifact: ArtifactNew<RoutingIsmArtifactConfig>): Promise<[DeployedRoutingIsmArtifact, TxReceipt[]]>;
+    update(artifact: DeployedRoutingIsmArtifact): Promise<AnnotatedTx[]>;
+    private deployDomainIsm;
+}
+export {};
+//# sourceMappingURL=routing-ism.d.ts.map

package/dist/ism/routing-ism.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-ism.d.ts","sourceRoot":"","sources":["../../src/ism/routing-ism.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACjE,OAAO,EAEL,gBAAgB,EAChB,WAAW,EAGX,cAAc,EAIf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EACL,kBAAkB,EAElB,sBAAsB,EAGtB,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,SAAS,EACV,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,MAAM,EAAc,MAAM,2BAA2B,CAAC;AAI/D,KAAK,0BAA0B,GAAG,gBAAgB,CAChD,wBAAwB,EACxB,kBAAkB,CACnB,CAAC;AAEF,qBAAa,gBAAiB,YAAW,cAAc,CACrD,wBAAwB,EACxB,kBAAkB,CACnB;IAQG,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,sBAAsB;IAC1D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAE9B;IAEH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAGjB,eAAe,EAAE,sBAAsB,EACvC,WAAW,EAAE,WAAW,EAC1B,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;IAKpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAU1D,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,wBAAwB,CAAC,GAC9C,OAAO,CAAC,CAAC,0BAA0B,EAAE,SAAS,EAAE,CAAC,CAAC;IA+D/C,MAAM,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAoF5D,eAAe;CAkB9B"}

package/dist/ism/routing-ism.js

@@ -0,0 +1,145 @@
+import { AltVM } from '@humanode-hyperlane/provider-sdk';
+import { ArtifactState, isArtifactDeployed, isArtifactNew, isArtifactUnderived, } from '@humanode-hyperlane/provider-sdk/artifact';
+import { rootLogger } from '@humanode-hyperlane/utils';
+import { IsmReader } from './generic-ism.js';
+export class RoutingIsmWriter {
+    artifactManager;
+    chainLookup;
+    signer;
+    logger = rootLogger.child({
+        module: RoutingIsmWriter.name,
+    });
+    ismReader;
+    constructor(artifactManager, chainLookup, signer) {
+        this.artifactManager = artifactManager;
+        this.chainLookup = chainLookup;
+        this.signer = signer;
+        this.ismReader = new IsmReader(artifactManager, chainLookup);
+    }
+    async read(address) {
+        const artifact = await this.ismReader.read(address);
+        if (artifact.config.type !== AltVM.IsmType.ROUTING) {
+            throw new Error(`Expected ROUTING ISM at ${address}, got ${artifact.config.type}`);
+        }
+        return artifact;
+    }
+    async create(artifact) {
+        const { config } = artifact;
+        const allReceipts = [];
+        const deployedDomainIsms = {};
+        for (const [domainId, nestedArtifact] of Object.entries(config.domains)) {
+            const domain = parseInt(domainId);
+            if (isArtifactDeployed(nestedArtifact)) {
+                deployedDomainIsms[domain] = nestedArtifact;
+            }
+            else if (isArtifactUnderived(nestedArtifact)) {
+                // UNDERIVED means predeployed ISM - just pass through without reading
+                deployedDomainIsms[domain] = nestedArtifact;
+            }
+            else if (isArtifactNew(nestedArtifact)) {
+                const [deployedNested, receipts] = await this.deployDomainIsm(nestedArtifact);
+                deployedDomainIsms[domain] = deployedNested;
+                allReceipts.push(...receipts);
+            }
+            else {
+                // This should never happen - all artifact states are handled above
+                const _exhaustiveCheck = nestedArtifact;
+                this.logger.error(`Unexpected artifact state ${_exhaustiveCheck.artifactState} for domain ${domainId}`);
+            }
+        }
+        const rawRoutingIsmWriter = this.artifactManager.createWriter(AltVM.IsmType.ROUTING, this.signer);
+        const rawRoutingConfig = {
+            config: {
+                type: config.type,
+                owner: config.owner,
+                domains: deployedDomainIsms,
+            },
+        };
+        const [deployedRoutingIsm, routingIsmReceipts] = await rawRoutingIsmWriter.create(rawRoutingConfig);
+        allReceipts.push(...routingIsmReceipts);
+        const deployedRoutingIsmConfig = {
+            artifactState: deployedRoutingIsm.artifactState,
+            config: {
+                type: deployedRoutingIsm.config.type,
+                owner: deployedRoutingIsm.config.owner,
+                domains: deployedDomainIsms,
+            },
+            deployed: deployedRoutingIsm.deployed,
+        };
+        return [deployedRoutingIsmConfig, allReceipts];
+    }
+    async update(artifact) {
+        const { config, deployed } = artifact;
+        const updateTxs = [];
+        const deployedDomains = {};
+        for (const [domainId, domainIsmConfig] of Object.entries(config.domains)) {
+            if (!this.chainLookup.getChainName(parseInt(domainId))) {
+                this.logger.warn(`Skipping update of unknown ${AltVM.IsmType.ROUTING} domain ${domainId}`);
+                continue;
+            }
+            const domain = parseInt(domainId);
+            if (isArtifactDeployed(domainIsmConfig)) {
+                const { artifactState, config, deployed } = domainIsmConfig;
+                const domainIsmWriter = this.artifactManager.createWriter(domainIsmConfig.config.type, this.signer);
+                let domainIsmUpdateTxs;
+                if (config.type === AltVM.IsmType.ROUTING) {
+                    domainIsmUpdateTxs = await this.update({
+                        artifactState,
+                        config,
+                        deployed,
+                    });
+                }
+                else {
+                    domainIsmUpdateTxs = await domainIsmWriter.update({
+                        artifactState,
+                        config,
+                        deployed,
+                    });
+                }
+                updateTxs.push(...domainIsmUpdateTxs);
+                deployedDomains[domain] = domainIsmConfig;
+            }
+            else if (isArtifactUnderived(domainIsmConfig)) {
+                // UNDERIVED means predeployed ISM - just pass through without reading
+                deployedDomains[domain] = domainIsmConfig;
+                // Note: We don't generate update transactions for UNDERIVED artifacts
+                // since they represent existing ISMs that we're just referencing
+            }
+            else if (isArtifactNew(domainIsmConfig)) {
+                [deployedDomains[domain]] = await this.deployDomainIsm(domainIsmConfig);
+            }
+            else {
+                // This should never happen - all artifact states are handled above
+                const _exhaustiveCheck = domainIsmConfig;
+                this.logger.error(`Unexpected artifact state ${_exhaustiveCheck.artifactState} for domain ${domainId}`);
+            }
+        }
+        const rawRoutingWriter = this.artifactManager.createWriter(AltVM.IsmType.ROUTING, this.signer);
+        const rawRoutingArtifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                type: config.type,
+                owner: config.owner,
+                domains: deployedDomains,
+            },
+            deployed: deployed,
+        };
+        const routingUpdateTxs = await rawRoutingWriter.update(rawRoutingArtifact);
+        return [...updateTxs, ...routingUpdateTxs];
+    }
+    async deployDomainIsm(artifact) {
+        const { config, artifactState } = artifact;
+        if (config.type === AltVM.IsmType.ROUTING) {
+            return this.create({
+                config,
+                artifactState,
+            });
+        }
+        const writer = this.artifactManager.createWriter(config.type, this.signer);
+        return writer.create({
+            config,
+            artifactState,
+        });
+    }
+}
+//# sourceMappingURL=routing-ism.js.map

package/dist/ism/routing-ism.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-ism.js","sourceRoot":"","sources":["../../src/ism/routing-ism.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAEzD,OAAO,EAKL,aAAa,EAEb,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,2CAA2C,CAAC;AAcnD,OAAO,EAAU,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAO7C,MAAM,OAAO,gBAAgB;IAWN;IACA;IACF;IATA,MAAM,GAAW,UAAU,CAAC,KAAK,CAAC;QACnD,MAAM,EAAE,gBAAgB,CAAC,IAAI;KAC9B,CAAC,CAAC;IAEc,SAAS,CAAY;IAEtC,YACqB,eAAuC,EACvC,WAAwB,EAC1B,MAAuC;QAFrC,oBAAe,GAAf,eAAe,CAAwB;QACvC,gBAAW,GAAX,WAAW,CAAa;QAC1B,WAAM,GAAN,MAAM,CAAiC;QAExD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,SAAS,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,QAAsC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAA+C;QAE/C,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC5B,MAAM,WAAW,GAAgB,EAAE,CAAC;QAEpC,MAAM,kBAAkB,GAGpB,EAAE,CAAC;QACP,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAElC,IAAI,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,kBAAkB,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;YAC9C,CAAC;iBAAM,IAAI,mBAAmB,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC/C,sEAAsE;gBACtE,kBAAkB,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;YAC9C,CAAC;iBAAM,IAAI,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,GAC9B,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;gBAC7C,kBAAkB,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;gBAC5C,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,MAAM,gBAAgB,GAAU,cAAc,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6BAA8B,gBAAwB,CAAC,aAAa,eAAe,QAAQ,EAAE,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAC3D,KAAK,CAAC,OAAO,CAAC,OAAO,EACrB,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,MAAM,gBAAgB,GAGlB;YACF,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,kBAAkB;aAC5B;SACF,CAAC;QAEF,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,GAC5C,MAAM,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrD,WAAW,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC;QAExC,MAAM,wBAAwB,GAA+B;YAC3D,aAAa,EAAE,kBAAkB,CAAC,aAAa;YAC/C,MAAM,EAAE;gBACN,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI;gBACpC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK;gBACtC,OAAO,EAAE,kBAAkB;aAC5B;YACD,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;SACtC,CAAC;QAEF,OAAO,CAAC,wBAAwB,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAoC;QAC/C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QAEtC,MAAM,SAAS,GAAkB,EAAE,CAAC;QAEpC,MAAM,eAAe,GAGjB,EAAE,CAAC;QAEP,KAAK,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,8BAA8B,KAAK,CAAC,OAAO,CAAC,OAAO,WAAW,QAAQ,EAAE,CACzE,CAAC;gBAEF,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAElC,IAAI,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC;gBACxC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;gBAE5D,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CACvD,eAAe,CAAC,MAAM,CAAC,IAAI,EAC3B,IAAI,CAAC,MAAM,CACZ,CAAC;gBAEF,IAAI,kBAAiC,CAAC;gBACtC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBAC1C,kBAAkB,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC;wBACrC,aAAa;wBACb,MAAM;wBACN,QAAQ;qBACT,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,kBAAkB,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;wBAChD,aAAa;wBACb,MAAM;wBACN,QAAQ;qBACT,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC;gBAEtC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC;YAC5C,CAAC;iBAAM,IAAI,mBAAmB,CAAC,eAAe,CAAC,EAAE,CAAC;gBAChD,sEAAsE;gBACtE,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC;gBAC1C,sEAAsE;gBACtE,iEAAiE;YACnE,CAAC;iBAAM,IAAI,aAAa,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC1C,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,MAAM,gBAAgB,GAAU,eAAe,CAAC;gBAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6BAA8B,gBAAwB,CAAC,aAAa,eAAe,QAAQ,EAAE,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CACxD,KAAK,CAAC,OAAO,CAAC,OAAO,EACrB,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,MAAM,kBAAkB,GAGpB;YACF,aAAa,EAAE,aAAa,CAAC,QAAQ;YACrC,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,eAAe;aACzB;YACD,QAAQ,EAAE,QAAQ;SACnB,CAAC;QAEF,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,QAAwC;QAExC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,MAAM,CAAC;gBACjB,MAAM;gBACN,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3E,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM;YACN,aAAa;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/protocol.d.ts

@@ -0,0 +1,3 @@
+import { ProtocolType } from '@humanode-hyperlane/provider-sdk';
+export declare function loadProtocolProviders(neededProtocols: Set<ProtocolType>): Promise<void>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,kCAAkC,CAAC;AAG1C,wBAAsB,qBAAqB,CACzC,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,iBAwCnC"}

package/dist/protocol.js

@@ -0,0 +1,38 @@
+import { ProtocolType, hasProtocol, registerProtocol, } from '@humanode-hyperlane/provider-sdk';
+import { rootLogger } from '@humanode-hyperlane/utils';
+export async function loadProtocolProviders(neededProtocols) {
+    for (const protocol of neededProtocols) {
+        if (hasProtocol(protocol)) {
+            rootLogger.debug(`${protocol} already loaded`);
+            continue;
+        }
+        switch (protocol) {
+            case ProtocolType.CosmosNative: {
+                const { CosmosNativeProtocolProvider } = await import('@humanode-hyperlane/cosmos-sdk');
+                registerProtocol(protocol, () => new CosmosNativeProtocolProvider());
+                break;
+            }
+            case ProtocolType.Radix: {
+                const { RadixProtocolProvider } = await import('@humanode-hyperlane/radix-sdk');
+                registerProtocol(protocol, () => new RadixProtocolProvider());
+                break;
+            }
+            case ProtocolType.Aleo: {
+                const { AleoProtocolProvider } = await import('@humanode-hyperlane/aleo-sdk');
+                registerProtocol(protocol, () => new AleoProtocolProvider());
+                break;
+            }
+            case ProtocolType.Sealevel: {
+                const { SealevelProtocolProvider } = await import('@humanode-hyperlane/sealevel-sdk');
+                registerProtocol(protocol, () => new SealevelProtocolProvider());
+                break;
+            }
+            case ProtocolType.Starknet: {
+                const { StarknetProtocolProvider } = await import('@humanode-hyperlane/starknet-sdk');
+                registerProtocol(protocol, () => new StarknetProtocolProvider());
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,eAAkC;IAElC,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ,iBAAiB,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC/B,MAAM,EAAE,4BAA4B,EAAE,GACpC,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;gBACjD,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE,CAAC,CAAC;gBACrE,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxB,MAAM,EAAE,qBAAqB,EAAE,GAC7B,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;gBAChD,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;gBAC9D,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvB,MAAM,EAAE,oBAAoB,EAAE,GAC5B,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;gBAC/C,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;gBAC7D,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC3B,MAAM,EAAE,wBAAwB,EAAE,GAChC,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;gBACnD,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;gBACjE,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC3B,MAAM,EAAE,wBAAwB,EAAE,GAChC,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;gBACnD,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;gBACjE,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/protocol.test.d.ts

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

package/dist/protocol.test.d.ts.map

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

package/dist/protocol.test.js

@@ -0,0 +1,14 @@
+import { expect } from 'chai';
+import { ProtocolType, getProtocolProvider, hasProtocol, } from '@humanode-hyperlane/provider-sdk';
+import { loadProtocolProviders } from './protocol.js';
+describe('loadProtocolProviders', () => {
+    it('registers Starknet provider implementation', async () => {
+        await loadProtocolProviders(new Set([ProtocolType.Starknet]));
+        expect(hasProtocol(ProtocolType.Starknet)).to.equal(true);
+        const provider = getProtocolProvider(ProtocolType.Starknet);
+        expect(provider).to.have.property('createProvider');
+        expect(provider).to.have.property('createSigner');
+        expect(provider).to.have.property('createIsmArtifactManager');
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.js","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,qBAAqB,CAAC,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE9D,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Validation utilities for Alt-VM ISM configurations.
+ *
+ * The provider-sdk has a limited subset of ISM types compared to the full SDK.
+ * These utilities validate ISM configs and provide clear error messages for unsupported types.
+ */
+import { IsmConfig } from '@humanode-hyperlane/provider-sdk/ism';
+/**
+ * Validates that an ISM type is supported by provider-sdk.
+ *
+ * @param ismType - The ISM type string to validate
+ * @param chain - Chain name for error messages
+ * @param context - Context string for error messages (e.g., "warp route", "core")
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export declare function validateIsmType(ismType: string, chain: string, context?: string): void;
+/**
+ * Validates that an ISM configuration is supported by provider-sdk.
+ *
+ * @param config - ISM configuration (can be string address or config object)
+ * @param chain - Chain name for error messages
+ * @param context - Context string for error messages (e.g., "warp route", "core")
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export declare function validateIsmConfig(config: IsmConfig | string, chain: string, context?: string): void;
+/**
+ * Custom error class for unsupported ISM types.
+ * Provides concise error messages.
+ */
+export declare class UnsupportedIsmTypeError extends Error {
+    readonly ismType: string;
+    readonly chain: string;
+    readonly context: string;
+    readonly supportedTypes: string;
+    constructor(ismType: string, chain: string, context: string, supportedTypes: string);
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAW,MAAM,sCAAsC,CAAC;AAa1E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAwB,GAChC,IAAI,CAKN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAwB,GAChC,IAAI,CAmBN;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,OAAO,EAAE,MAAM;aACf,KAAK,EAAE,MAAM;aACb,OAAO,EAAE,MAAM;aACf,cAAc,EAAE,MAAM;gBAHtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM;CAQzC"}

package/dist/utils/validation.js

@@ -0,0 +1,66 @@
+/**
+ * ISM types supported by provider-sdk for Alt-VM chains.
+ * These correspond to the types defined in provider-sdk/src/ism.ts
+ */
+const SUPPORTED_ISM_TYPES = new Set([
+    'domainRoutingIsm',
+    'merkleRootMultisigIsm',
+    'messageIdMultisigIsm',
+    'testIsm',
+]);
+/**
+ * Validates that an ISM type is supported by provider-sdk.
+ *
+ * @param ismType - The ISM type string to validate
+ * @param chain - Chain name for error messages
+ * @param context - Context string for error messages (e.g., "warp route", "core")
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export function validateIsmType(ismType, chain, context = 'configuration') {
+    if (!SUPPORTED_ISM_TYPES.has(ismType)) {
+        const supportedTypes = Array.from(SUPPORTED_ISM_TYPES).join(', ');
+        throw new UnsupportedIsmTypeError(ismType, chain, context, supportedTypes);
+    }
+}
+/**
+ * Validates that an ISM configuration is supported by provider-sdk.
+ *
+ * @param config - ISM configuration (can be string address or config object)
+ * @param chain - Chain name for error messages
+ * @param context - Context string for error messages (e.g., "warp route", "core")
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export function validateIsmConfig(config, chain, context = 'configuration') {
+    // If it's a string address, it's valid (pre-deployed ISM)
+    if (typeof config === 'string') {
+        return;
+    }
+    // Validate the ISM type
+    validateIsmType(config.type, chain, context);
+    // Recursively validate nested ISMs in routing configs
+    if (config.type === 'domainRoutingIsm') {
+        for (const [domain, domainConfig] of Object.entries(config.domains)) {
+            validateIsmConfig(domainConfig, chain, `${context} (domain routing for ${domain})`);
+        }
+    }
+}
+/**
+ * Custom error class for unsupported ISM types.
+ * Provides concise error messages.
+ */
+export class UnsupportedIsmTypeError extends Error {
+    ismType;
+    chain;
+    context;
+    supportedTypes;
+    constructor(ismType, chain, context, supportedTypes) {
+        super(`Unsupported ISM type '${ismType}' for Alt-VM chain '${chain}' in ${context}. ` +
+            `Supported types: ${supportedTypes}`);
+        this.ismType = ismType;
+        this.chain = chain;
+        this.context = context;
+        this.supportedTypes = supportedTypes;
+        this.name = 'UnsupportedIsmTypeError';
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,mBAAmB,GAAiB,IAAI,GAAG,CAAC;IAChD,kBAAkB;IAClB,uBAAuB;IACvB,sBAAsB;IACtB,SAAS;CACV,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,KAAa,EACb,UAAkB,eAAe;IAEjC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAkB,CAAC,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,IAAI,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA0B,EAC1B,KAAa,EACb,UAAkB,eAAe;IAEjC,0DAA0D;IAC1D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,wBAAwB;IACxB,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE7C,sDAAsD;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,iBAAiB,CACf,YAAY,EACZ,KAAK,EACL,GAAG,OAAO,wBAAwB,MAAM,GAAG,CAC5C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAE9B;IACA;IACA;IACA;IAJlB,YACkB,OAAe,EACf,KAAa,EACb,OAAe,EACf,cAAsB;QAEtC,KAAK,CACH,yBAAyB,OAAO,uBAAuB,KAAK,QAAQ,OAAO,IAAI;YAC7E,oBAAoB,cAAc,EAAE,CACvC,CAAC;QARc,YAAO,GAAP,OAAO,CAAQ;QACf,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,mBAAc,GAAd,cAAc,CAAQ;QAMtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}