@recoillink/deploy-sdk 0.0.0-stage → 11.0.1

package/dist/hook/hook-writer.test.js

@@ -0,0 +1,70 @@
+import { expect } from 'chai';
+import sinon from 'sinon';
+import { AltVM } from '@recoillink/provider-sdk';
+import { ArtifactState } from '@recoillink/provider-sdk/artifact';
+import { HookWriter } from './hook-writer.js';
+const chainLookup = {
+    getChainMetadata: () => {
+        throw new Error('not needed');
+    },
+    getDomainId: () => null,
+    getChainName: () => null,
+    getKnownChainNames: () => [],
+    getKnownDomainIds: () => new Set(),
+};
+describe('HookWriter', () => {
+    it('delegates protocolFee updates to the protocol writer', async () => {
+        const expectedTxs = [
+            { annotation: 'protocol fee update' },
+        ];
+        const update = sinon.stub().resolves(expectedTxs);
+        const createWriter = sinon.stub().returns({
+            create: sinon.stub(),
+            read: sinon.stub(),
+            update,
+        });
+        const artifactManager = {
+            createReader: sinon.stub(),
+            createWriter,
+            readHook: sinon.stub(),
+        };
+        const signer = {};
+        const writer = new HookWriter(artifactManager, chainLookup, signer);
+        const artifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                type: AltVM.HookType.PROTOCOL_FEE,
+                owner: '0xowner',
+                beneficiary: '0xbeneficiary',
+                maxProtocolFee: '100',
+                protocolFee: '10',
+            },
+            deployed: { address: '0x123' },
+        };
+        const txs = await writer.update(artifact);
+        expect(createWriter.calledOnceWith(AltVM.HookType.PROTOCOL_FEE, signer)).to.equal(true);
+        expect(update.calledOnceWith(artifact)).to.equal(true);
+        expect(txs).to.deep.equal(expectedTxs);
+    });
+    it('treats unknownHook updates as a no-op', async () => {
+        const createWriter = sinon.stub();
+        const artifactManager = {
+            createReader: sinon.stub(),
+            createWriter,
+            readHook: sinon.stub(),
+        };
+        const signer = {};
+        const writer = new HookWriter(artifactManager, chainLookup, signer);
+        const artifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                type: 'unknownHook',
+            },
+            deployed: { address: '0x123' },
+        };
+        const txs = await writer.update(artifact);
+        expect(createWriter.called).to.equal(false);
+        expect(txs).to.deep.equal([]);
+    });
+});
+//# sourceMappingURL=hook-writer.test.js.map

package/dist/hook/hook-writer.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { AltVMJsonRpcSubmitter } from './AltVMJsonRpcSubmitter.js';
+export { createFeeReader, FeeReader } from './fee/fee-reader.js';
+export { createFeeWriter, FeeWriter } from './fee/fee-writer.js';
+export { CoreArtifactReader, createCoreReader, } from './core/core-artifact-reader.js';
+export { CoreWriter, createCoreWriter } from './core/core-writer.js';
+export { createHookReader } from './hook/hook-reader.js';
+export { createHookWriter, HookWriter } from './hook/hook-writer.js';
+export { createIsmWriter, IsmWriter } from './ism/generic-ism-writer.js';
+export { createIsmReader } from './ism/generic-ism.js';
+export { loadProtocolProviders } from './protocol.js';
+export { UnsupportedIsmTypeError, validateIsmConfig, validateIsmType, } from './utils/validation.js';
+export { createWarpTokenReader, WarpTokenReader } from './warp/warp-reader.js';
+export { createWarpTokenWriter, WarpTokenWriter } from './warp/warp-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// AltVMFileSubmitter removed from public exports as it uses Node.js fs module
+// and should not be bundled for browser use. CLI can import directly:
+// import { AltVMFileSubmitter } from '@recoillink/deploy-sdk/AltVMFileSubmitter';
+export { AltVMJsonRpcSubmitter } from './AltVMJsonRpcSubmitter.js';
+export { createFeeReader, FeeReader } from './fee/fee-reader.js';
+export { createFeeWriter, FeeWriter } from './fee/fee-writer.js';
+export { CoreArtifactReader, createCoreReader, } from './core/core-artifact-reader.js';
+export { CoreWriter, createCoreWriter } from './core/core-writer.js';
+export { createHookReader } from './hook/hook-reader.js';
+export { createHookWriter, HookWriter } from './hook/hook-writer.js';
+export { createIsmWriter, IsmWriter } from './ism/generic-ism-writer.js';
+export { createIsmReader } from './ism/generic-ism.js';
+export { loadProtocolProviders } from './protocol.js';
+export { UnsupportedIsmTypeError, validateIsmConfig, validateIsmType, } from './utils/validation.js';
+export { createWarpTokenReader, WarpTokenReader } from './warp/warp-reader.js';
+export { createWarpTokenWriter, WarpTokenWriter } from './warp/warp-writer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,kFAAkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,112 @@
+import { expect } from 'chai';
+import sinon from 'sinon';
+import { hasProtocol, registerProtocol, } from '@recoillink/provider-sdk';
+import { ArtifactState } from '@recoillink/provider-sdk/artifact';
+import { createIsmReader } from './generic-ism.js';
+import { IsmWriter, createIsmWriter } from './generic-ism-writer.js';
+// CAST: registers a synthetic protocol so the test cannot collide with a real
+// protocol provider registered by another suite in the same process.
+const TestProtocol = 'test-ism-context';
+const createIsmArtifactManager = sinon.stub();
+const mockProtocolProvider = {
+    createProvider: sinon.stub(),
+    createSigner: sinon.stub(),
+    createSubmitter: sinon.stub(),
+    createIsmArtifactManager,
+    createHookArtifactManager: sinon.stub(),
+    createMailboxArtifactManager: sinon.stub(),
+    createValidatorAnnounceArtifactManager: sinon.stub(),
+    createFeeArtifactManager: sinon.stub(),
+    getMinGas: sinon.stub(),
+    createWarpArtifactManager: sinon.stub(),
+};
+if (!hasProtocol(TestProtocol)) {
+    registerProtocol(TestProtocol, () => mockProtocolProvider);
+}
+const chainMetadata = {
+    name: 'solanatest',
+    chainId: 1,
+    domainId: 1399811149,
+    protocol: TestProtocol,
+};
+const domainIds = {
+    solanatest: 1399811149,
+    ethereum: 1,
+    polygon: 137,
+};
+const chainLookup = {
+    getChainMetadata: () => chainMetadata,
+    getChainName: () => null,
+    getDomainId: (chain) => domainIds[String(chain)] ?? null,
+    getKnownChainNames: () => Object.keys(domainIds),
+    getKnownDomainIds: () => new Set([1399811149, 1, 137]),
+};
+describe('ISM artifact manager context', () => {
+    beforeEach(() => {
+        createIsmArtifactManager.reset();
+        createIsmArtifactManager.returns({});
+    });
+    it('createIsmReader passes the unique known domain ids', () => {
+        createIsmReader(chainMetadata, chainLookup);
+        expect(createIsmArtifactManager.calledOnce).to.equal(true);
+        expect(createIsmArtifactManager.firstCall.args).to.deep.equal([
+            chainMetadata,
+            { knownDomainIds: [1399811149, 1, 137] },
+        ]);
+    });
+    it('createIsmWriter passes the unique known domain ids', () => {
+        // CAST: test double, the writer only stores the signer.
+        const signer = {};
+        createIsmWriter(chainMetadata, chainLookup, signer);
+        expect(createIsmArtifactManager.calledOnce).to.equal(true);
+        expect(createIsmArtifactManager.firstCall.args).to.deep.equal([
+            chainMetadata,
+            { knownDomainIds: [1399811149, 1, 137] },
+        ]);
+    });
+});
+describe('ISM artifact manager context without known domains', () => {
+    it('creates managers without a context when the lookup has no domains', () => {
+        createIsmArtifactManager.reset();
+        createIsmArtifactManager.returns({});
+        const emptyLookup = {
+            getChainMetadata: () => chainMetadata,
+            getChainName: () => null,
+            getDomainId: () => null,
+            getKnownChainNames: () => [],
+            getKnownDomainIds: () => new Set(),
+        };
+        // CAST: test double, the writer only stores the signer.
+        const signer = {};
+        createIsmReader(chainMetadata, emptyLookup);
+        createIsmWriter(chainMetadata, emptyLookup, signer);
+        expect(createIsmArtifactManager.callCount).to.equal(2);
+        for (const call of createIsmArtifactManager.getCalls()) {
+            expect(call.args).to.deep.equal([chainMetadata, undefined]);
+        }
+    });
+});
+describe('IsmWriter.update routingMessageIdMultisigIsm', () => {
+    it('delegates to the typed writer rather than treating the ISM as immutable', async () => {
+        const txs = [{ annotation: 'set validators' }];
+        const update = sinon.stub().resolves(txs);
+        const createWriter = sinon.stub().returns({ update });
+        // CAST: test doubles exposing only the members IsmWriter.update uses.
+        const manager = { createWriter };
+        const signer = {};
+        const artifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                type: 'routingMessageIdMultisigIsm',
+                owner: 'owner',
+                domains: { 1: { validators: ['0x1'], threshold: 1 } },
+            },
+            deployed: { address: 'program' },
+        };
+        const result = await new IsmWriter(manager, chainLookup, signer).update(artifact);
+        expect(result).to.equal(txs);
+        expect(createWriter.firstCall.args[0]).to.equal('routingMessageIdMultisigIsm');
+        expect(update.firstCall.args[0]).to.deep.equal(artifact);
+    });
+});
+//# sourceMappingURL=generic-ism-context.test.js.map

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

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

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

@@ -0,0 +1,62 @@
+import { ChainMetadataForAltVM } from '@recoillink/provider-sdk';
+import { ISigner } from '@recoillink/provider-sdk/altvm';
+import { ArtifactNew, ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { ChainLookup } from '@recoillink/provider-sdk/chain';
+import { DeployedIsmAddress, DeployedIsmArtifact, IRawIsmArtifactManager, IsmArtifactConfig } from '@recoillink/provider-sdk/ism';
+import { AnnotatedTx, TxReceipt } from '@recoillink/provider-sdk/module';
+import { IsmReader } from './generic-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 declare function createIsmWriter(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>): IsmWriter;
+/**
+ * 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 declare class IsmWriter extends IsmReader implements ArtifactWriter<IsmArtifactConfig, DeployedIsmAddress> {
+    protected readonly artifactManager: IRawIsmArtifactManager;
+    protected readonly chainLookup: ChainLookup;
+    protected readonly signer: ISigner<AnnotatedTx, TxReceipt>;
+    private readonly routingWriter;
+    constructor(artifactManager: IRawIsmArtifactManager, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>);
+    /**
+     * 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]
+     */
+    create(artifact: ArtifactNew<IsmArtifactConfig>): Promise<[DeployedIsmArtifact, TxReceipt[]]>;
+    /**
+     * Updates an existing ISM to match the desired configuration.
+     * Routing ISMs (domain enrollment/unenrollment, owner changes), composite ISMs and
+     * routing message-id multisig ISMs support updates.
+     * Static 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
+     */
+    update(artifact: DeployedIsmArtifact): Promise<AnnotatedTx[]>;
+}
+//# sourceMappingURL=generic-ism-writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic-ism-writer.d.ts","sourceRoot":"","sources":["../../src/ism/generic-ism-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,SAAS,CAUX;AAED;;;;;;;;;;GAUG;AACH,qBAAa,SACX,SAAQ,SACR,YAAW,cAAc,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;uBAKlC,eAAe,EAAE,sBAAsB;uBACvC,WAAW,EAAE,WAAW;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;IAL5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IAEjD,YAC8B,eAAe,EAAE,sBAAsB,EACvC,WAAW,EAAE,WAAW,EACjC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAQ3D;IAED;;;;;;;OAOG;IACG,MAAM,CACV,QAAQ,EAAE,WAAW,CAAC,iBAAiB,CAAC,GACvC,OAAO,CAAC,CAAC,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC,CAgB7C;IAED;;;;;;;;OAQG;IACG,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BlE;CACF"}

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

@@ -0,0 +1,100 @@
+import { AltVM, getProtocolProvider, } from '@recoillink/provider-sdk';
+import { assert, isNonEmptyArray } from '@recoillink/utils';
+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 knownDomainIds = [...chainLookup.getKnownDomainIds()];
+    const artifactManager = protocolProvider.createIsmArtifactManager(chainMetadata, isNonEmptyArray(knownDomainIds) ? { knownDomainIds } : undefined);
+    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;
+        assert(config.type !== AltVM.IsmType.AGGREGATION &&
+            config.type !== AltVM.IsmType.PAUSABLE, 'Aggregation and pausable ISM artifacts currently support reading only');
+        // 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.
+     * Routing ISMs (domain enrollment/unenrollment, owner changes), composite ISMs and
+     * routing message-id multisig ISMs support updates.
+     * Static 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;
+        assert(config.type !== AltVM.IsmType.AGGREGATION &&
+            config.type !== AltVM.IsmType.PAUSABLE, 'Aggregation and pausable ISM artifacts currently support reading only');
+        // Routing ISMs are mutable - support domain updates and owner changes
+        if (config.type === AltVM.IsmType.ROUTING) {
+            return this.routingWriter.update({ artifactState, config, deployed });
+        }
+        // Composite and routing message-id multisig ISMs are mutable too, but
+        // self-contained: they diff their own state against on-chain state
+        // (re-read internally), so they're delegated to directly rather than
+        // routed through RoutingIsmWriter's nested-artifact recursion.
+        if (config.type === AltVM.IsmType.COMPOSITE ||
+            config.type === AltVM.IsmType.ROUTING_MESSAGE_ID_MULTISIG) {
+            const writer = this.artifactManager.createWriter(config.type, this.signer);
+            return writer.update({ artifactState, config, deployed });
+        }
+        // Static 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":"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"}

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

@@ -0,0 +1,43 @@
+import { ChainMetadataForAltVM } from '@recoillink/provider-sdk';
+import { ArtifactReader } from '@recoillink/provider-sdk/artifact';
+import { ChainLookup } from '@recoillink/provider-sdk/chain';
+import { DeployedIsmAddress, DeployedIsmArtifact, DerivedIsmConfig, IRawIsmArtifactManager, IsmArtifactConfig } from '@recoillink/provider-sdk/ism';
+import { Logger } from '@recoillink/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,0BAA0B,CAAC;AAClC,OAAO,EAEL,cAAc,EAEf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EAIlB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,MAAM,EAA+B,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,GACvB,SAAS,CAUX;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;IAEH,YACqB,eAAe,EAAE,sBAAsB,EACvC,WAAW,EAAE,WAAW,EACzC;IAEE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4BxD;IAED;;;OAGG;YACW,gBAAgB;IAwC9B;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGhE;CACF"}

package/dist/ism/generic-ism.js

@@ -0,0 +1,105 @@
+import { AltVM, getProtocolProvider, } from '@recoillink/provider-sdk';
+import { isArtifactDeployed, } from '@recoillink/provider-sdk/artifact';
+import { ismArtifactToDerivedConfig, } from '@recoillink/provider-sdk/ism';
+import { rootLogger, isNonEmptyArray } from '@recoillink/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 knownDomainIds = [...chainLookup.getKnownDomainIds()];
+    const artifactManager = protocolProvider.createIsmArtifactManager(chainMetadata, isNonEmptyArray(knownDomainIds) ? { knownDomainIds } : undefined);
+    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 });
+        }
+        if (config.type === AltVM.IsmType.AGGREGATION) {
+            const modules = [];
+            for (const module of config.modules) {
+                modules.push(isArtifactDeployed(module)
+                    ? module
+                    : await this.read(module.deployed.address));
+            }
+            return { artifactState, config: { ...config, modules }, 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/generic-ism.test.d.ts

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

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

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