@recoillink/deploy-sdk 0.0.0-stage → 11.0.1

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

@@ -0,0 +1,145 @@
+import { expect } from 'chai';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { ArtifactState } from '@recoillink/provider-sdk/artifact';
+import { ismArtifactToDerivedConfig, ismConfigToArtifact, } from '@recoillink/provider-sdk/ism';
+import { assert } from '@recoillink/utils';
+import { IsmReader } from './generic-ism.js';
+const chainLookup = {
+    getChainMetadata: () => ({
+        name: 'ethereum',
+        chainId: 1,
+        domainId: 1,
+        protocol: ProtocolType.Ethereum,
+    }),
+    getChainName: (domain) => (domain === 1 ? 'ethereum' : null),
+    getDomainId: (chain) => (chain === 'ethereum' ? 1 : null),
+    getKnownChainNames: () => ['ethereum'],
+    getKnownDomainIds: () => new Set([1]),
+};
+const reference = (address) => ({
+    artifactState: ArtifactState.UNDERIVED,
+    deployed: { address },
+});
+function fixture() {
+    const artifacts = {
+        aggregation: {
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'aggregation' },
+            config: {
+                type: 'staticAggregationIsm',
+                threshold: 2,
+                modules: [reference('routing'), reference('pausable')],
+            },
+        },
+        routing: {
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'routing' },
+            config: {
+                type: 'domainRoutingIsm',
+                owner: 'router-owner',
+                domains: { 1: reference('multisig') },
+            },
+        },
+        multisig: {
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'multisig' },
+            config: {
+                type: 'messageIdMultisigIsm',
+                threshold: 2,
+                validators: ['validator1', 'validator2', 'validator3'],
+            },
+        },
+        pausable: {
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'pausable' },
+            config: { type: 'pausableIsm', owner: 'pauser', paused: false },
+        },
+    };
+    const reads = [];
+    const manager = {
+        readIsm: async (address) => {
+            reads.push(address);
+            const artifact = artifacts[address];
+            assert(artifact, `Unsupported ISM ${address}`);
+            return artifact;
+        },
+        createReader: () => {
+            throw new Error('Unexpected typed reader');
+        },
+        createWriter: () => {
+            throw new Error('Unexpected writer');
+        },
+    };
+    return { artifacts, reads, reader: new IsmReader(manager, chainLookup) };
+}
+describe('IsmReader aggregation', () => {
+    it('expands the Starknet aggregation → routing → multisig and pausable tree', async () => {
+        const { reader, reads } = fixture();
+        expect(await reader.deriveIsmConfig('aggregation')).to.deep.equal({
+            type: 'staticAggregationIsm',
+            address: 'aggregation',
+            threshold: 2,
+            modules: [
+                {
+                    type: 'domainRoutingIsm',
+                    address: 'routing',
+                    owner: 'router-owner',
+                    domains: {
+                        ethereum: {
+                            type: 'messageIdMultisigIsm',
+                            address: 'multisig',
+                            threshold: 2,
+                            validators: ['validator1', 'validator2', 'validator3'],
+                        },
+                    },
+                },
+                {
+                    type: 'pausableIsm',
+                    address: 'pausable',
+                    owner: 'pauser',
+                    paused: false,
+                },
+            ],
+        });
+        expect(reads).to.deep.equal([
+            'aggregation',
+            'routing',
+            'multisig',
+            'pausable',
+        ]);
+    });
+    it('propagates unsupported children instead of partially reporting a tree', async () => {
+        const { reader, artifacts } = fixture();
+        delete artifacts['pausable'];
+        const result = await reader
+            .read('aggregation')
+            .catch((error) => error);
+        expect(String(result)).to.match(/Unsupported ISM pausable/);
+    });
+    it('converts nested aggregation config references without losing their addresses', () => {
+        const config = {
+            type: 'staticAggregationIsm',
+            threshold: 1,
+            modules: ['existing-module'],
+        };
+        const artifact = ismConfigToArtifact(config, chainLookup);
+        expect(ismArtifactToDerivedConfig({
+            ...artifact,
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'root' },
+        }, chainLookup)).to.deep.equal({ ...config, address: 'root' });
+    });
+    it('rejects a NEW aggregation child when deriving deployed configuration', () => {
+        const artifact = ismConfigToArtifact({
+            type: 'staticAggregationIsm',
+            threshold: 1,
+            modules: [{ type: 'testIsm' }],
+        }, chainLookup);
+        expect(() => ismArtifactToDerivedConfig({
+            ...artifact,
+            artifactState: ArtifactState.DEPLOYED,
+            deployed: { address: 'root' },
+        }, chainLookup)).to.throw(/nested ISM is NEW/);
+    });
+});
+//# sourceMappingURL=generic-ism.test.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { ISigner } from '@recoillink/provider-sdk/altvm';
+import { ArtifactDeployed, ArtifactNew, ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { ChainLookup } from '@recoillink/provider-sdk/chain';
+import { DeployedIsmAddress, IRawIsmArtifactManager, RoutingIsmArtifactConfig } from '@recoillink/provider-sdk/ism';
+import { AnnotatedTx, TxReceipt } from '@recoillink/provider-sdk/module';
+import { Logger } from '@recoillink/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,gCAAgC,CAAC;AACzD,OAAO,EAEL,gBAAgB,EAChB,WAAW,EAGX,cAAc,EAIf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAElB,sBAAsB,EAGtB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAsB,MAAM,mBAAmB,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;IAEtC,YACqB,eAAe,EAAE,sBAAsB,EACvC,WAAW,EAAE,WAAW,EAC1B,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAGzD;IAEK,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAQ/D;IAEK,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,wBAAwB,CAAC,GAC9C,OAAO,CAAC,CAAC,0BAA0B,EAAE,SAAS,EAAE,CAAC,CAAC,CA6DpD;IAEK,MAAM,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAuFzE;YAEa,eAAe;CAuB9B"}

package/dist/ism/routing-ism.js

@@ -0,0 +1,149 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { ArtifactState, isArtifactDeployed, isArtifactNew, isArtifactUnderived, } from '@recoillink/provider-sdk/artifact';
+import { assert, rootLogger } from '@recoillink/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;
+                assert(config.type !== AltVM.IsmType.AGGREGATION &&
+                    config.type !== AltVM.IsmType.PAUSABLE, 'Aggregation and pausable ISM artifacts currently support reading only');
+                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;
+        assert(config.type !== AltVM.IsmType.AGGREGATION &&
+            config.type !== AltVM.IsmType.PAUSABLE, 'Aggregation and pausable ISM artifacts currently support reading only');
+        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":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,3 @@
+import { ProtocolType } from '@recoillink/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,0BAA0B,CAAC;AAGlC,wBAAsB,qBAAqB,CACzC,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,iBAsCnC"}

package/dist/protocol.js

@@ -0,0 +1,38 @@
+import { ProtocolType, hasProtocol, registerProtocol, } from '@recoillink/provider-sdk';
+import { rootLogger } from '@recoillink/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('@recoillink/cosmos-sdk');
+                registerProtocol(protocol, () => new CosmosNativeProtocolProvider());
+                break;
+            }
+            case ProtocolType.Radix: {
+                const { RadixProtocolProvider } = await import('@recoillink/radix-sdk');
+                registerProtocol(protocol, () => new RadixProtocolProvider());
+                break;
+            }
+            case ProtocolType.Aleo: {
+                const { AleoProtocolProvider } = await import('@recoillink/aleo-sdk');
+                registerProtocol(protocol, () => new AleoProtocolProvider());
+                break;
+            }
+            case ProtocolType.Sealevel: {
+                const { SealevelProtocolProvider } = await import('@recoillink/sealevel-sdk');
+                registerProtocol(protocol, () => new SealevelProtocolProvider());
+                break;
+            }
+            case ProtocolType.Starknet: {
+                const { StarknetProtocolProvider } = await import('@recoillink/starknet-sdk/runtime');
+                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,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,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,EAAE,CAAC;gBAC/B,MAAM,EAAE,4BAA4B,EAAE,GACpC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACzC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE,CAAC,CAAC;gBACrE,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;gBACxE,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;gBAC9D,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;gBACvB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBACtE,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;gBAC7D,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,EAAE,wBAAwB,EAAE,GAChC,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;gBAC3C,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;gBACjE,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,QAAQ,EAAE,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 '@recoillink/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,0BAA0B,CAAC;AAElC,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,46 @@
+/**
+ * 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 { ProtocolType } from '@recoillink/provider-sdk';
+import { IsmConfig } from '@recoillink/provider-sdk/ism';
+/**
+ * Validates that an ISM type is supported by provider-sdk for the given protocol.
+ *
+ * @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")
+ * @param protocol - Protocol of the chain being validated. `protocol` is
+ * optional only so pre-existing callers (validating one of the
+ * always-cross-protocol types below) keep compiling — it does NOT loosen
+ * validation for a protocol-gated type like compositeIsm. At the point
+ * compositeIsm was introduced it was never accepted without a matching
+ * protocol, so omitting `protocol` for it still fails, just with a
+ * clearer "protocol required" reason instead of a generic type mismatch.
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export declare function validateIsmType(ismType: string, chain: string, context?: string, protocol?: ProtocolType): void;
+/**
+ * Validates that an ISM configuration is supported by provider-sdk for the given protocol.
+ *
+ * @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")
+ * @param protocol - Protocol of the chain being validated. See validateIsmType.
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export declare function validateIsmConfig(config: IsmConfig | string, chain: string, context?: string, protocol?: ProtocolType): 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,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,SAAS,EAGV,MAAM,8BAA8B,CAAC;AAuCtC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAwB,EACjC,QAAQ,CAAC,EAAE,YAAY,GACtB,IAAI,CAmDN;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAwB,EACjC,QAAQ,CAAC,EAAE,YAAY,GACtB,IAAI,CA8BN;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,OAAO,EAAE,MAAM;aACf,KAAK,EAAE,MAAM;aACb,OAAO,EAAE,MAAM;aACf,cAAc,EAAE,MAAM;IAJxC,YACkB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EAOvC;CACF"}

package/dist/utils/validation.js

@@ -0,0 +1,132 @@
+/**
+ * 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 { ProtocolType } from '@recoillink/provider-sdk';
+import { IsmType, assertValidDomainRoutingMultisig, } from '@recoillink/provider-sdk/ism';
+/**
+ * ISM types supported by provider-sdk for Alt-VM chains.
+ * These correspond to the types defined in provider-sdk/src/ism.ts
+ *
+ * Typed as `ReadonlySet<string>` rather than `ReadonlySet<IsmType>`
+ * deliberately: `validateIsmType`'s `ismType` parameter is arbitrary,
+ * not-yet-validated input (a raw config field, possibly from an untrusted
+ * registry entry), so `.has()` is called with a plain `string`. Narrowing
+ * the set to `ReadonlySet<IsmType>` would just push an unsafe cast to
+ * every call site instead of removing it.
+ */
+const SUPPORTED_ISM_TYPES = new Set([
+    IsmType.ROUTING,
+    IsmType.MERKLE_ROOT_MULTISIG,
+    IsmType.MESSAGE_ID_MULTISIG,
+    IsmType.TEST_ISM,
+    IsmType.COMPOSITE,
+    IsmType.ROUTING_MESSAGE_ID_MULTISIG,
+]);
+/** ISM types restricted to a single Alt-VM protocol (Sealevel program, no cross-VM equivalent). */
+const PROTOCOL_SPECIFIC_ISM_TYPES = {
+    [IsmType.COMPOSITE]: ProtocolType.Sealevel,
+    [IsmType.ROUTING_MESSAGE_ID_MULTISIG]: ProtocolType.Sealevel,
+};
+/** ISM types otherwise supported but rejected on a specific protocol, with the type to use instead. */
+const PROTOCOL_UNSUPPORTED_ISM_TYPES = {
+    [ProtocolType.Sealevel]: {
+        [IsmType.MESSAGE_ID_MULTISIG]: IsmType.ROUTING_MESSAGE_ID_MULTISIG,
+    },
+};
+/**
+ * Validates that an ISM type is supported by provider-sdk for the given protocol.
+ *
+ * @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")
+ * @param protocol - Protocol of the chain being validated. `protocol` is
+ * optional only so pre-existing callers (validating one of the
+ * always-cross-protocol types below) keep compiling — it does NOT loosen
+ * validation for a protocol-gated type like compositeIsm. At the point
+ * compositeIsm was introduced it was never accepted without a matching
+ * protocol, so omitting `protocol` for it still fails, just with a
+ * clearer "protocol required" reason instead of a generic type mismatch.
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export function validateIsmType(ismType, chain, context = 'configuration', protocol) {
+    const requiredProtocol = PROTOCOL_SPECIFIC_ISM_TYPES[ismType];
+    const protocolUnsupported = protocol === undefined
+        ? {}
+        : (PROTOCOL_UNSUPPORTED_ISM_TYPES[protocol] ?? {});
+    const supported = SUPPORTED_ISM_TYPES.has(ismType) &&
+        (requiredProtocol === undefined || requiredProtocol === protocol) &&
+        !Object.prototype.hasOwnProperty.call(protocolUnsupported, ismType);
+    if (!supported) {
+        const supportedTypes = Array.from(SUPPORTED_ISM_TYPES)
+            .filter((type) => {
+            const required = PROTOCOL_SPECIFIC_ISM_TYPES[type];
+            return ((required === undefined || required === protocol) &&
+                !Object.prototype.hasOwnProperty.call(protocolUnsupported, type));
+        })
+            .join(', ');
+        const replacement = Object.prototype.hasOwnProperty.call(protocolUnsupported, ismType)
+            ? protocolUnsupported[ismType]
+            : undefined;
+        if (replacement !== undefined) {
+            throw new UnsupportedIsmTypeError(ismType, chain, context, `${supportedTypes} (${ismType} is unsupported on ${protocol}, use ${replacement} instead)`);
+        }
+        if (SUPPORTED_ISM_TYPES.has(ismType) &&
+            requiredProtocol !== undefined &&
+            protocol === undefined) {
+            throw new UnsupportedIsmTypeError(ismType, chain, context, `${supportedTypes} (ismType '${ismType}' requires the chain's protocol to be passed explicitly to validateIsmType/validateIsmConfig)`);
+        }
+        throw new UnsupportedIsmTypeError(ismType, chain, context, supportedTypes);
+    }
+}
+/**
+ * Validates that an ISM configuration is supported by provider-sdk for the given protocol.
+ *
+ * @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")
+ * @param protocol - Protocol of the chain being validated. See validateIsmType.
+ * @throws UnsupportedIsmTypeError if ISM type is not supported
+ */
+export function validateIsmConfig(config, chain, context = 'configuration', protocol) {
+    // 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, protocol);
+    // Recursively validate nested ISMs in routing configs
+    if (config.type === IsmType.ROUTING) {
+        for (const [domain, domainConfig] of Object.entries(config.domains)) {
+            validateIsmConfig(domainConfig, chain, `${context} (domain routing for ${domain})`, protocol);
+        }
+    }
+    // Fail before any deployment transaction is sent.
+    if (config.type === IsmType.ROUTING_MESSAGE_ID_MULTISIG) {
+        for (const [domain, domainConfig] of Object.entries(config.domains)) {
+            assertValidDomainRoutingMultisig(domainConfig, `${IsmType.ROUTING_MESSAGE_ID_MULTISIG} domain '${domain}' on ${chain} in ${context}`);
+        }
+    }
+}
+/**
+ * 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":"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"}

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

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

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

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