@hyperlane-xyz/deploy-sdk 3.0.1 → 4.0.0

package/dist/core/core-artifact-reader.d.ts

@@ -0,0 +1,67 @@
+import { ChainMetadataForAltVM } from '@hyperlane-xyz/provider-sdk';
+import { ArtifactReader } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ChainLookup } from '@hyperlane-xyz/provider-sdk/chain';
+import { DerivedCoreConfig } from '@hyperlane-xyz/provider-sdk/core';
+import { DeployedMailboxAddress, DeployedMailboxArtifact, IRawMailboxArtifactManager, MailboxOnChain } from '@hyperlane-xyz/provider-sdk/mailbox';
+import { Logger } from '@hyperlane-xyz/utils';
+import { HookReader } from '../hook/hook-reader.js';
+import { IsmReader } from '../ism/generic-ism.js';
+/**
+ * Factory function to create a CoreArtifactReader instance.
+ * Follows pattern of createHookReader() and createIsmReader().
+ *
+ * @param chainMetadata Chain metadata for target chain
+ * @param chainLookup Chain lookup for domain resolution
+ * @returns CoreArtifactReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createCoreReader(chainMetadata, chainLookup);
+ * const coreConfig = await reader.deriveCoreConfig(mailboxAddress);
+ * ```
+ */
+export declare function createCoreReader(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup): CoreArtifactReader;
+/**
+ * Core Artifact Reader - composite artifact reader that orchestrates mailbox, ISM, and hook readers.
+ *
+ * This implements the artifact API pattern at the "composite" level in deploy-sdk.
+ * It takes a mailbox address and returns a fully expanded MailboxOnChain artifact with
+ * all nested ISM and hook configurations read from the chain.
+ *
+ * Architecture:
+ * - Raw level: IRawMailboxArtifactManager (protocol-specific, in radix-sdk, cosmos-sdk, etc.)
+ * - Composite level: CoreArtifactReader (this class, in deploy-sdk)
+ *
+ * The raw mailbox reader returns UNDERIVED ISM/hook references (just addresses).
+ * This composite reader expands them into full DEPLOYED artifacts with complete configs.
+ */
+export declare class CoreArtifactReader implements ArtifactReader<MailboxOnChain, DeployedMailboxAddress> {
+    protected readonly mailboxArtifactManager: IRawMailboxArtifactManager;
+    protected readonly chainMetadata: ChainMetadataForAltVM;
+    protected readonly chainLookup: ChainLookup;
+    protected readonly logger: Logger;
+    protected readonly ismReader: IsmReader;
+    protected readonly hookReaderFactory: (mailbox: string) => HookReader;
+    constructor(mailboxArtifactManager: IRawMailboxArtifactManager, chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup);
+    /**
+     * Read mailbox configuration and expand all nested ISM/hook configs.
+     *
+     * Takes a mailbox address, reads the raw mailbox config (which has UNDERIVED ISM/hook references),
+     * then recursively reads and expands all nested ISM and hook artifacts.
+     *
+     * @param mailboxAddress The deployed mailbox address
+     * @returns Fully expanded mailbox artifact with all nested configs in DEPLOYED state
+     */
+    read(mailboxAddress: string): Promise<DeployedMailboxArtifact>;
+    /**
+     * Backward compatibility method: convert deployed mailbox artifact to DerivedCoreConfig.
+     *
+     * This allows CoreArtifactReader to be used as a drop-in replacement for AltVMCoreReader.
+     * Existing code expects the deriveCoreConfig() method returning DerivedCoreConfig format.
+     *
+     * @param mailboxAddress The deployed mailbox address
+     * @returns DerivedCoreConfig in the legacy format
+     */
+    deriveCoreConfig(mailboxAddress: string): Promise<DerivedCoreConfig>;
+}
+//# sourceMappingURL=core-artifact-reader.d.ts.map

package/dist/core/core-artifact-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-artifact-reader.d.ts","sourceRoot":"","sources":["../../src/core/core-artifact-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EAEf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,cAAc,EAEf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,MAAM,EAA8B,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAoB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAmB,MAAM,uBAAuB,CAAC;AAGnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,GACvB,kBAAkB,CAUpB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,cAAc,CACvD,cAAc,EACd,sBAAsB,CACvB;IAQG,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B;IACrE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB;IACvD,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAT7C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAE9B;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;gBAGjD,sBAAsB,EAAE,0BAA0B,EAClD,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW;IAO7C;;;;;;;;OAQG;IACG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwCpE;;;;;;;;OAQG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAQ3E"}

package/dist/core/core-artifact-reader.js

@@ -0,0 +1,117 @@
+import { getProtocolProvider, } from '@hyperlane-xyz/provider-sdk';
+import { ArtifactState, } from '@hyperlane-xyz/provider-sdk/artifact';
+import { hookArtifactToDerivedConfig } from '@hyperlane-xyz/provider-sdk/hook';
+import { mailboxArtifactToDerivedCoreConfig, } from '@hyperlane-xyz/provider-sdk/mailbox';
+import { isEmptyAddress, rootLogger } from '@hyperlane-xyz/utils';
+import { createHookReader } from '../hook/hook-reader.js';
+import { createIsmReader } from '../ism/generic-ism.js';
+import { ismArtifactToDerivedConfig } from '@hyperlane-xyz/provider-sdk/ism';
+/**
+ * Factory function to create a CoreArtifactReader instance.
+ * Follows pattern of createHookReader() and createIsmReader().
+ *
+ * @param chainMetadata Chain metadata for target chain
+ * @param chainLookup Chain lookup for domain resolution
+ * @returns CoreArtifactReader instance
+ *
+ * @example
+ * ```typescript
+ * const reader = createCoreReader(chainMetadata, chainLookup);
+ * const coreConfig = await reader.deriveCoreConfig(mailboxAddress);
+ * ```
+ */
+export function createCoreReader(chainMetadata, chainLookup) {
+    const protocolProvider = getProtocolProvider(chainMetadata.protocol);
+    const mailboxArtifactManager = protocolProvider.createMailboxArtifactManager(chainMetadata);
+    return new CoreArtifactReader(mailboxArtifactManager, chainMetadata, chainLookup);
+}
+/**
+ * Core Artifact Reader - composite artifact reader that orchestrates mailbox, ISM, and hook readers.
+ *
+ * This implements the artifact API pattern at the "composite" level in deploy-sdk.
+ * It takes a mailbox address and returns a fully expanded MailboxOnChain artifact with
+ * all nested ISM and hook configurations read from the chain.
+ *
+ * Architecture:
+ * - Raw level: IRawMailboxArtifactManager (protocol-specific, in radix-sdk, cosmos-sdk, etc.)
+ * - Composite level: CoreArtifactReader (this class, in deploy-sdk)
+ *
+ * The raw mailbox reader returns UNDERIVED ISM/hook references (just addresses).
+ * This composite reader expands them into full DEPLOYED artifacts with complete configs.
+ */
+export class CoreArtifactReader {
+    mailboxArtifactManager;
+    chainMetadata;
+    chainLookup;
+    logger = rootLogger.child({
+        module: CoreArtifactReader.name,
+    });
+    ismReader;
+    hookReaderFactory;
+    constructor(mailboxArtifactManager, chainMetadata, chainLookup) {
+        this.mailboxArtifactManager = mailboxArtifactManager;
+        this.chainMetadata = chainMetadata;
+        this.chainLookup = chainLookup;
+        this.ismReader = createIsmReader(this.chainMetadata, this.chainLookup);
+        this.hookReaderFactory = (mailbox) => createHookReader(this.chainMetadata, this.chainLookup, { mailbox });
+    }
+    /**
+     * Read mailbox configuration and expand all nested ISM/hook configs.
+     *
+     * Takes a mailbox address, reads the raw mailbox config (which has UNDERIVED ISM/hook references),
+     * then recursively reads and expands all nested ISM and hook artifacts.
+     *
+     * @param mailboxAddress The deployed mailbox address
+     * @returns Fully expanded mailbox artifact with all nested configs in DEPLOYED state
+     */
+    async read(mailboxAddress) {
+        // 1. Read raw mailbox config - returns UNDERIVED ISM/hook references (just addresses)
+        const rawMailbox = await this.mailboxArtifactManager.readMailbox(mailboxAddress);
+        // 2. Expand nested ISM and hooks using specialized readers
+        // Hook reader is created per-read with mailbox context (needed for SVM hook detection)
+        // Skip reading when address is empty (undefined, null, empty string, or zeroish)
+        const hookReader = this.hookReaderFactory(mailboxAddress);
+        const defaultIsmAddr = rawMailbox.config.defaultIsm.deployed.address;
+        const defaultHookAddr = rawMailbox.config.defaultHook.deployed.address;
+        const requiredHookAddr = rawMailbox.config.requiredHook.deployed.address;
+        const [defaultIsmArtifact, defaultHookArtifact, requiredHookArtifact] = await Promise.all([
+            isEmptyAddress(defaultIsmAddr)
+                ? rawMailbox.config.defaultIsm
+                : this.ismReader.read(defaultIsmAddr),
+            isEmptyAddress(defaultHookAddr)
+                ? rawMailbox.config.defaultHook
+                : hookReader.read(defaultHookAddr),
+            isEmptyAddress(requiredHookAddr)
+                ? rawMailbox.config.requiredHook
+                : hookReader.read(requiredHookAddr),
+        ]);
+        // 3. Return fully expanded mailbox artifact
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: rawMailbox.config.owner,
+                defaultIsm: defaultIsmArtifact,
+                defaultHook: defaultHookArtifact,
+                requiredHook: requiredHookArtifact,
+            },
+            deployed: rawMailbox.deployed,
+        };
+    }
+    /**
+     * Backward compatibility method: convert deployed mailbox artifact to DerivedCoreConfig.
+     *
+     * This allows CoreArtifactReader to be used as a drop-in replacement for AltVMCoreReader.
+     * Existing code expects the deriveCoreConfig() method returning DerivedCoreConfig format.
+     *
+     * @param mailboxAddress The deployed mailbox address
+     * @returns DerivedCoreConfig in the legacy format
+     */
+    async deriveCoreConfig(mailboxAddress) {
+        const artifact = await this.read(mailboxAddress);
+        return mailboxArtifactToDerivedCoreConfig(artifact, this.chainLookup, {
+            ismArtifactToDerivedConfig,
+            hookArtifactToDerivedConfig,
+        });
+    }
+}
+//# sourceMappingURL=core-artifact-reader.js.map

package/dist/core/core-artifact-reader.js.map

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

package/dist/core/core-artifact-reader.test.d.ts

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

package/dist/core/core-artifact-reader.test.d.ts.map

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

package/dist/core/core-artifact-reader.test.js

@@ -0,0 +1,300 @@
+import { expect } from 'chai';
+import sinon from 'sinon';
+import { hasProtocol, registerProtocol, } from '@hyperlane-xyz/provider-sdk';
+import { ArtifactState } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ZERO_ADDRESS_HEX_32 } from '@hyperlane-xyz/utils';
+import { CoreArtifactReader } from './core-artifact-reader.js';
+// Test protocol
+const TestProtocol = 'test-core-reader';
+const mockProtocolProvider = {
+    createProvider: sinon.stub(),
+    createSigner: sinon.stub(),
+    createSubmitter: sinon.stub(),
+    createIsmArtifactManager: sinon.stub(),
+    createHookArtifactManager: sinon.stub(),
+    createMailboxArtifactManager: sinon.stub(),
+    createValidatorAnnounceArtifactManager: sinon.stub(),
+    getMinGas: sinon.stub(),
+    createWarpArtifactManager: sinon.stub(),
+};
+if (!hasProtocol(TestProtocol)) {
+    registerProtocol(TestProtocol, () => mockProtocolProvider);
+}
+describe('CoreArtifactReader', () => {
+    const mockMailboxAddress = '0xMAILBOX';
+    const mockIsmAddress = '0xISM';
+    const mockDefaultHookAddress = '0xDEFAULTHOOK';
+    const mockRequiredHookAddress = '0xREQUIREDHOOK';
+    const mockOwner = '0xOWNER';
+    const mockDomainId = 1;
+    const chainName = 'test-chain';
+    let readMailboxStub;
+    let mailboxArtifactManager;
+    let chainLookup;
+    let chainMetadata;
+    let coreReader;
+    const mockRawMailbox = {
+        artifactState: ArtifactState.DEPLOYED,
+        config: {
+            owner: mockOwner,
+            defaultIsm: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: mockIsmAddress },
+            },
+            defaultHook: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: mockDefaultHookAddress },
+            },
+            requiredHook: {
+                artifactState: ArtifactState.UNDERIVED,
+                deployed: { address: mockRequiredHookAddress },
+            },
+        },
+        deployed: { address: mockMailboxAddress, domainId: mockDomainId },
+    };
+    const mockExpandedIsm = {
+        artifactState: ArtifactState.DEPLOYED,
+        config: {
+            type: 'merkleRootMultisigIsm',
+            validators: ['0xVALIDATOR1'],
+            threshold: 1,
+        },
+        deployed: { address: mockIsmAddress },
+    };
+    const mockExpandedDefaultHook = {
+        artifactState: ArtifactState.DEPLOYED,
+        config: {
+            type: 'merkleTreeHook',
+        },
+        deployed: { address: mockDefaultHookAddress },
+    };
+    const mockExpandedRequiredHook = {
+        artifactState: ArtifactState.DEPLOYED,
+        config: {
+            type: 'interchainGasPaymaster',
+            owner: mockOwner,
+            beneficiary: '0xBENEFICIARY',
+            oracleKey: '0xORACLE',
+            overhead: {},
+            oracleConfig: {},
+        },
+        deployed: { address: mockRequiredHookAddress },
+    };
+    let mockIsmReader;
+    let mockHookReader;
+    beforeEach(() => {
+        readMailboxStub = sinon
+            .stub()
+            .resolves(mockRawMailbox);
+        mailboxArtifactManager = {
+            readMailbox: readMailboxStub,
+            createReader: sinon.stub(),
+            createWriter: sinon.stub(),
+        };
+        chainMetadata = {
+            name: chainName,
+            domainId: mockDomainId,
+            protocol: TestProtocol,
+            chainId: mockDomainId,
+        };
+        chainLookup = {
+            getChainMetadata: sinon
+                .stub()
+                .returns(chainMetadata),
+            getChainName: sinon.stub().returns(chainName),
+            getDomainId: sinon
+                .stub()
+                .returns(mockDomainId),
+            getKnownChainNames: sinon.stub().returns([chainName]),
+        };
+        mockIsmReader = {
+            read: sinon.stub(),
+        };
+        mockHookReader = {
+            read: sinon.stub(),
+        };
+        coreReader = Object.create(CoreArtifactReader.prototype);
+        Object.assign(coreReader, {
+            mailboxArtifactManager,
+            chainMetadata,
+            chainLookup,
+            ismReader: mockIsmReader,
+            hookReaderFactory: () => mockHookReader,
+        });
+    });
+    afterEach(() => {
+        sinon.restore();
+    });
+    describe('read', () => {
+        it('should read mailbox and expand nested ISM/hook artifacts', async () => {
+            // ARRANGE
+            mockIsmReader.read.resolves(mockExpandedIsm);
+            mockHookReader.read
+                .onFirstCall()
+                .resolves(mockExpandedDefaultHook)
+                .onSecondCall()
+                .resolves(mockExpandedRequiredHook);
+            // ACT
+            const result = await coreReader.read(mockMailboxAddress);
+            // ASSERT
+            expect(result.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(result.config.owner).to.equal(mockOwner);
+            expect(result.deployed.address).to.equal(mockMailboxAddress);
+            expect(result.deployed.domainId).to.equal(mockDomainId);
+            expect(result.config.defaultIsm).to.deep.equal(mockExpandedIsm);
+            expect(result.config.defaultHook).to.deep.equal(mockExpandedDefaultHook);
+            expect(result.config.requiredHook).to.deep.equal(mockExpandedRequiredHook);
+            sinon.assert.calledOnceWithExactly(readMailboxStub, mockMailboxAddress);
+            sinon.assert.calledOnceWithExactly(mockIsmReader.read, mockIsmAddress);
+            sinon.assert.calledWith(mockHookReader.read.firstCall, mockDefaultHookAddress);
+            sinon.assert.calledWith(mockHookReader.read.secondCall, mockRequiredHookAddress);
+        });
+        it('should read ISM and hooks in parallel via Promise.all', async () => {
+            // ARRANGE
+            const callOrder = [];
+            mockIsmReader.read.callsFake(async () => {
+                callOrder.push('ism');
+                return mockExpandedIsm;
+            });
+            mockHookReader.read.callsFake(async (address) => {
+                if (address === mockDefaultHookAddress) {
+                    callOrder.push('defaultHook');
+                    return mockExpandedDefaultHook;
+                }
+                callOrder.push('requiredHook');
+                return mockExpandedRequiredHook;
+            });
+            // ACT
+            await coreReader.read(mockMailboxAddress);
+            // ASSERT
+            expect(callOrder).to.have.lengthOf(3);
+            expect(callOrder).to.include.members([
+                'ism',
+                'defaultHook',
+                'requiredHook',
+            ]);
+        });
+        it('should propagate mailbox reading errors', async () => {
+            // ARRANGE
+            const error = new Error('Failed to read mailbox');
+            readMailboxStub.rejects(error);
+            // ACT & ASSERT
+            await expect(coreReader.read(mockMailboxAddress)).to.be.rejectedWith('Failed to read mailbox');
+        });
+        it('should skip ISM/hook reader expansion for zero-address artifacts', async () => {
+            // ARRANGE
+            const zeroAddressMailbox = {
+                artifactState: ArtifactState.DEPLOYED,
+                config: {
+                    owner: mockOwner,
+                    defaultIsm: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                    defaultHook: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                    requiredHook: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                },
+                deployed: { address: mockMailboxAddress, domainId: mockDomainId },
+            };
+            readMailboxStub.resolves(zeroAddressMailbox);
+            mockIsmReader.read.resolves(mockExpandedIsm);
+            mockHookReader.read.resolves(mockExpandedDefaultHook);
+            // ACT
+            const result = await coreReader.read(mockMailboxAddress);
+            // ASSERT
+            expect(result.artifactState).to.equal(ArtifactState.DEPLOYED);
+            expect(result.config.owner).to.equal(mockOwner);
+            // Nested artifacts should remain UNDERIVED (not expanded)
+            expect(result.config.defaultIsm.artifactState).to.equal(ArtifactState.UNDERIVED);
+            expect(result.config.defaultHook.artifactState).to.equal(ArtifactState.UNDERIVED);
+            expect(result.config.requiredHook.artifactState).to.equal(ArtifactState.UNDERIVED);
+            // Readers should NOT have been called
+            sinon.assert.notCalled(mockIsmReader.read);
+            sinon.assert.notCalled(mockHookReader.read);
+        });
+        it('should propagate ISM reader errors', async () => {
+            // ARRANGE
+            const error = new Error('ISM read failed');
+            mockIsmReader.read.rejects(error);
+            mockHookReader.read.resolves(mockExpandedDefaultHook);
+            // ACT & ASSERT
+            await expect(coreReader.read(mockMailboxAddress)).to.be.rejectedWith('ISM read failed');
+        });
+        it('should propagate hook reader errors', async () => {
+            // ARRANGE
+            const error = new Error('Hook read failed');
+            mockIsmReader.read.resolves(mockExpandedIsm);
+            mockHookReader.read.rejects(error);
+            // ACT & ASSERT
+            await expect(coreReader.read(mockMailboxAddress)).to.be.rejectedWith('Hook read failed');
+        });
+    });
+    describe('deriveCoreConfig', () => {
+        it('should convert artifact to DerivedCoreConfig format', async () => {
+            // ARRANGE
+            mockIsmReader.read.resolves(mockExpandedIsm);
+            mockHookReader.read
+                .onFirstCall()
+                .resolves(mockExpandedDefaultHook)
+                .onSecondCall()
+                .resolves(mockExpandedRequiredHook);
+            // ACT
+            const result = await coreReader.deriveCoreConfig(mockMailboxAddress);
+            // ASSERT
+            expect(result.owner).to.equal(mockOwner);
+            expect(result.defaultIsm).to.be.an('object');
+            expect(result.defaultHook).to.be.an('object');
+            expect(result.requiredHook).to.be.an('object');
+            sinon.assert.calledOnce(readMailboxStub);
+            sinon.assert.calledOnce(mockIsmReader.read);
+            expect(mockHookReader.read.callCount).to.equal(2);
+        });
+        it('should propagate read errors', async () => {
+            // ARRANGE
+            const error = new Error('Mailbox read failed');
+            readMailboxStub.rejects(error);
+            // ACT & ASSERT
+            await expect(coreReader.deriveCoreConfig(mockMailboxAddress)).to.be.rejectedWith('Mailbox read failed');
+        });
+        it('should return ZERO_ADDRESS_HEX_32 for zero-address ISM/hooks', async () => {
+            // ARRANGE
+            const zeroAddressMailbox = {
+                artifactState: ArtifactState.DEPLOYED,
+                config: {
+                    owner: mockOwner,
+                    defaultIsm: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                    defaultHook: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                    requiredHook: {
+                        artifactState: ArtifactState.UNDERIVED,
+                        deployed: { address: ZERO_ADDRESS_HEX_32 },
+                    },
+                },
+                deployed: { address: mockMailboxAddress, domainId: mockDomainId },
+            };
+            readMailboxStub.resolves(zeroAddressMailbox);
+            // ACT
+            const result = await coreReader.deriveCoreConfig(mockMailboxAddress);
+            // ASSERT
+            expect(result.owner).to.equal(mockOwner);
+            expect(result.defaultIsm).to.equal(ZERO_ADDRESS_HEX_32);
+            expect(result.defaultHook).to.equal(ZERO_ADDRESS_HEX_32);
+            expect(result.requiredHook).to.equal(ZERO_ADDRESS_HEX_32);
+            // Readers should NOT have been called
+            sinon.assert.notCalled(mockIsmReader.read);
+            sinon.assert.notCalled(mockHookReader.read);
+        });
+    });
+});
+//# sourceMappingURL=core-artifact-reader.test.js.map

package/dist/core/core-artifact-reader.test.js.map

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

package/dist/core/core-writer.d.ts

@@ -0,0 +1,42 @@
+import { ChainMetadataForAltVM } from '@hyperlane-xyz/provider-sdk';
+import { ISigner } from '@hyperlane-xyz/provider-sdk/altvm';
+import { ArtifactDeployed, ArtifactNew } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ChainLookup } from '@hyperlane-xyz/provider-sdk/chain';
+import { DeployedMailboxAddress, DeployedMailboxArtifact, IRawMailboxArtifactManager, MailboxArtifactConfig } from '@hyperlane-xyz/provider-sdk/mailbox';
+import { AnnotatedTx, TxReceipt } from '@hyperlane-xyz/provider-sdk/module';
+import { DeployedValidatorAnnounceArtifact, IRawValidatorAnnounceArtifactManager } from '@hyperlane-xyz/provider-sdk/validator-announce';
+import { Logger } from '@hyperlane-xyz/utils';
+import { CoreArtifactReader } from './core-artifact-reader.js';
+export declare function createCoreWriter(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>): CoreWriter;
+/**
+ * Orchestrates core deployment (mailbox, ISM, hooks, validator announce)
+ * using the Artifact API. Extends CoreArtifactReader for read().
+ *
+ * Does not implement ArtifactWriter<MailboxArtifactConfig, DeployedMailboxAddress>
+ * because create() returns a composite result (mailbox + validator announce) rather
+ * than a single [ArtifactDeployed, TxReceipt[]] tuple. The update() signature does
+ * conform to the standard pattern.
+ */
+export declare class CoreWriter extends CoreArtifactReader {
+    protected readonly validatorAnnounceArtifactManager: IRawValidatorAnnounceArtifactManager | null;
+    protected readonly signer: ISigner<AnnotatedTx, TxReceipt>;
+    protected readonly logger: Logger;
+    private readonly ismWriter;
+    constructor(mailboxArtifactManager: IRawMailboxArtifactManager, validatorAnnounceArtifactManager: IRawValidatorAnnounceArtifactManager | null, chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>);
+    create(artifact: ArtifactNew<MailboxArtifactConfig>): Promise<[
+        {
+            mailbox: DeployedMailboxArtifact;
+            validatorAnnounce: DeployedValidatorAnnounceArtifact | null;
+        },
+        TxReceipt[]
+    ]>;
+    /**
+     * Returns mailbox update transactions for the caller to submit.
+     * Note: may perform on-chain writes as a side effect when sub-components
+     * (ISM, hooks) require fresh deployment via `create()`.
+     */
+    update(expectedArtifact: ArtifactDeployed<MailboxArtifactConfig, DeployedMailboxAddress>): Promise<AnnotatedTx[]>;
+    private deployOrUpdateIsm;
+    private deployOrUpdateHook;
+}
+//# sourceMappingURL=core-writer.d.ts.map

package/dist/core/core-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-writer.d.ts","sourceRoot":"","sources":["../../src/core/core-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAC5D,OAAO,EAEL,gBAAgB,EAChB,WAAW,EAMZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAahE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,iCAAiC,EACjC,oCAAoC,EAErC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAK/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,UAAU,CAgBZ;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAW,SAAQ,kBAAkB;IAS9C,SAAS,CAAC,QAAQ,CAAC,gCAAgC,EAAE,oCAAoC,GAAG,IAAI;IAGhG,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;IAX5D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAE9B;IAEH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAGpC,sBAAsB,EAAE,0BAA0B,EAC/B,gCAAgC,EAAE,oCAAoC,GAAG,IAAI,EAChG,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACL,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;IAWtD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,qBAAqB,CAAC,GAAG,OAAO,CACjE;QACE;YACE,OAAO,EAAE,uBAAuB,CAAC;YACjC,iBAAiB,EAAE,iCAAiC,GAAG,IAAI,CAAC;SAC7D;QACD,SAAS,EAAE;KACZ,CACF;IAuJD;;;;OAIG;IACG,MAAM,CACV,gBAAgB,EAAE,gBAAgB,CAChC,qBAAqB,EACrB,sBAAsB,CACvB,GACA,OAAO,CAAC,WAAW,EAAE,CAAC;YA8EX,iBAAiB;YA6BjB,kBAAkB;CAuCjC"}