@hyperlane-xyz/deploy-sdk 1.3.6 → 1.4.0-beta.c18552aafdcb7b75f759e8a85ebac103cfe26ec4

package/LICENSE.md

@@ -1,4 +1,5 @@
-# Apache License
+Apache License
+==============
 
 _Version 2.0, January 2004_  
 _&lt;<http://www.apache.org/licenses/>&gt;_
@@ -88,27 +89,27 @@ You may reproduce and distribute copies of the Work or Derivative Works thereof
 in any medium, with or without modifications, and in Source or Object form,
 provided that You meet the following conditions:
 
-- **(a)** You must give any other recipients of the Work or Derivative Works a copy of
-  this License; and
-- **(b)** You must cause any modified files to carry prominent notices stating that You
-  changed the files; and
-- **(c)** You must retain, in the Source form of any Derivative Works that You distribute,
-  all copyright, patent, trademark, and attribution notices from the Source form
-  of the Work, excluding those notices that do not pertain to any part of the
-  Derivative Works; and
-- **(d)** If the Work includes a “NOTICE” text file as part of its distribution, then any
-  Derivative Works that You distribute must include a readable copy of the
-  attribution notices contained within such NOTICE file, excluding those notices
-  that do not pertain to any part of the Derivative Works, in at least one of the
-  following places: within a NOTICE text file distributed as part of the
-  Derivative Works; within the Source form or documentation, if provided along
-  with the Derivative Works; or, within a display generated by the Derivative
-  Works, if and wherever such third-party notices normally appear. The contents of
-  the NOTICE file are for informational purposes only and do not modify the
-  License. You may add Your own attribution notices within Derivative Works that
-  You distribute, alongside or as an addendum to the NOTICE text from the Work,
-  provided that such additional attribution notices cannot be construed as
-  modifying the License.
+* **(a)** You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+* **(b)** You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+* **(c)** You must retain, in the Source form of any Derivative Works that You distribute,
+all copyright, patent, trademark, and attribution notices from the Source form
+of the Work, excluding those notices that do not pertain to any part of the
+Derivative Works; and
+* **(d)** If the Work includes a “NOTICE” text file as part of its distribution, then any
+Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents of
+the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License.
 
 You may add Your own copyright statement to Your modifications and may provide
 additional or different license terms and conditions for use, reproduction, or
@@ -179,15 +180,16 @@ the same “printed page” as the copyright notice for easier identification wi
 third-party archives.
 
     Copyright [yyyy] [name of copyright owner]
-
+    
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
-
+    
       http://www.apache.org/licenses/LICENSE-2.0
-
+    
     Unless required by applicable law or agreed to in writing, software
     distributed under the License is distributed on an "AS IS" BASIS,
     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     See the License for the specific language governing permissions and
     limitations under the License.
+

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

@@ -0,0 +1,66 @@
+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';
+/**
+ * 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;
+    private readonly ismReader;
+    protected readonly hookReader: 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,EAAc,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAoB,MAAM,wBAAwB,CAAC;AAOtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,GACvB,kBAAkB,CAUpB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBACX,YAAW,cAAc,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAS/D,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,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;gBAGrB,sBAAsB,EAAE,0BAA0B,EAClD,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW;IAM7C;;;;;;;;OAQG;IACG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2BpE;;;;;;;;OAQG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAQ3E"}

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

@@ -0,0 +1,105 @@
+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 { rootLogger } from '@hyperlane-xyz/utils';
+import { createHookReader } from '../hook/hook-reader.js';
+import { createIsmReader, ismArtifactToDerivedConfig, } 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 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;
+    hookReader;
+    constructor(mailboxArtifactManager, chainMetadata, chainLookup) {
+        this.mailboxArtifactManager = mailboxArtifactManager;
+        this.chainMetadata = chainMetadata;
+        this.chainLookup = chainLookup;
+        this.hookReader = createHookReader(this.chainMetadata, this.chainLookup);
+        this.ismReader = createIsmReader(this.chainMetadata, this.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
+     */
+    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
+        // The readers handle type detection and recursive expansion automatically
+        const [defaultIsmArtifact, defaultHookArtifact, requiredHookArtifact] = await Promise.all([
+            this.ismReader.read(rawMailbox.config.defaultIsm.deployed.address),
+            this.hookReader.read(rawMailbox.config.defaultHook.deployed.address),
+            this.hookReader.read(rawMailbox.config.requiredHook.deployed.address),
+        ]);
+        // 3. Return fully expanded mailbox artifact
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: rawMailbox.config.owner,
+                defaultIsm: defaultIsmArtifact, // Now DEPLOYED with full config
+                defaultHook: defaultHookArtifact, // Now DEPLOYED with full config
+                requiredHook: requiredHookArtifact, // Now DEPLOYED with full config
+            },
+            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-writer.d.ts

@@ -0,0 +1,76 @@
+import { ChainMetadataForAltVM } from '@hyperlane-xyz/provider-sdk';
+import { ISigner } from '@hyperlane-xyz/provider-sdk/altvm';
+import { ArtifactNew } from '@hyperlane-xyz/provider-sdk/artifact';
+import { ChainLookup } from '@hyperlane-xyz/provider-sdk/chain';
+import { DeployedMailboxArtifact, IRawMailboxArtifactManager, MailboxConfig } 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';
+/**
+ * Factory function to create a CoreWriter instance.
+ * Follows pattern of createHookWriter() and createIsmWriter().
+ *
+ * @param chainMetadata Chain metadata for target chain
+ * @param chainLookup Chain lookup for domain resolution
+ * @param signer Signer for transaction signing
+ * @returns CoreWriter instance
+ *
+ * @example
+ * ```typescript
+ * const writer = createCoreWriter(chainMetadata, chainLookup, signer);
+ * const { mailbox, validatorAnnounce } = await writer.create(coreArtifact);
+ * ```
+ */
+export declare function createCoreWriter(chainMetadata: ChainMetadataForAltVM, chainLookup: ChainLookup, signer: ISigner<AnnotatedTx, TxReceipt>): CoreWriter;
+/**
+ * CoreWriter orchestrates full core deployment using the Artifact API.
+ * Handles mailbox, ISM, hook, and validator announce deployment.
+ *
+ * Extends CoreArtifactReader to inherit read() functionality.
+ * Follows same pattern as HookWriter, IsmWriter, and WarpTokenWriter.
+ *
+ * Deployment flow:
+ * 1. Deploy ISM if NEW (via IsmWriter)
+ * 2. Create Mailbox with ISM + zero hooks (via mailboxWriter)
+ * 3. Deploy hooks if NEW with mailbox context (via HookWriter)
+ * 4. Update mailbox with hooks + owner (via mailboxWriter.update + signer)
+ * 5. Deploy validator announce (via vaWriter)
+ */
+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>);
+    /**
+     * Deploys full core contracts: ISM, hooks, mailbox, validator announce.
+     *
+     * @param artifact Mailbox artifact with nested ISM and hook artifacts
+     * @returns Object containing deployed mailbox, validator announce artifacts, and receipts
+     */
+    create(artifact: ArtifactNew<MailboxConfig>): Promise<{
+        mailbox: DeployedMailboxArtifact;
+        validatorAnnounce: DeployedValidatorAnnounceArtifact | null;
+        receipts: TxReceipt[];
+    }>;
+    /**
+     * Updates existing core deployment.
+     *
+     * @param mailboxAddress Existing mailbox address
+     * @param expectedArtifact Expected mailbox artifact with nested ISM/hook artifacts
+     * @returns Array of update transactions
+     */
+    update(mailboxAddress: string, expectedArtifact: ArtifactNew<MailboxConfig>): Promise<AnnotatedTx[]>;
+    /**
+     * Helper: Deploy or update ISM based on current vs expected.
+     * Uses IsmWriter internally, follows merge pattern from WarpTokenWriter.
+     */
+    private deployOrUpdateIsm;
+    /**
+     * Helper: Deploy or update hook based on current vs expected.
+     * Uses HookWriter internally, follows merge pattern from WarpTokenWriter.
+     */
+    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,WAAW,EAMZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAahE,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EAEd,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,EACL,MAAM,EAIP,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GACtC,UAAU,CAgBZ;AAED;;;;;;;;;;;;;GAaG;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;IAW5D;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;QAC1D,OAAO,EAAE,uBAAuB,CAAC;QACjC,iBAAiB,EAAE,iCAAiC,GAAG,IAAI,CAAC;QAC5D,QAAQ,EAAE,SAAS,EAAE,CAAC;KACvB,CAAC;IA0KF;;;;;;OAMG;IACG,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,WAAW,CAAC,aAAa,CAAC,GAC3C,OAAO,CAAC,WAAW,EAAE,CAAC;IAoFzB;;;OAGG;YACW,iBAAiB;IA0C/B;;;OAGG;YACW,kBAAkB;CA8CjC"}

package/dist/core/core-writer.js

@@ -0,0 +1,287 @@
+import { getProtocolProvider, } from '@hyperlane-xyz/provider-sdk';
+import { ArtifactState, isArtifactDeployed, isArtifactNew, isArtifactUnderived, } from '@hyperlane-xyz/provider-sdk/artifact';
+import { mergeHookArtifacts, } from '@hyperlane-xyz/provider-sdk/hook';
+import { mergeIsmArtifacts, } from '@hyperlane-xyz/provider-sdk/ism';
+import { ZERO_ADDRESS_HEX_32, assert, rootLogger, } from '@hyperlane-xyz/utils';
+import { createHookWriter } from '../hook/hook-writer.js';
+import { createIsmWriter } from '../ism/generic-ism-writer.js';
+import { CoreArtifactReader } from './core-artifact-reader.js';
+/**
+ * Factory function to create a CoreWriter instance.
+ * Follows pattern of createHookWriter() and createIsmWriter().
+ *
+ * @param chainMetadata Chain metadata for target chain
+ * @param chainLookup Chain lookup for domain resolution
+ * @param signer Signer for transaction signing
+ * @returns CoreWriter instance
+ *
+ * @example
+ * ```typescript
+ * const writer = createCoreWriter(chainMetadata, chainLookup, signer);
+ * const { mailbox, validatorAnnounce } = await writer.create(coreArtifact);
+ * ```
+ */
+export function createCoreWriter(chainMetadata, chainLookup, signer) {
+    const protocolProvider = getProtocolProvider(chainMetadata.protocol);
+    const mailboxArtifactManager = protocolProvider.createMailboxArtifactManager(chainMetadata);
+    const validatorAnnounceArtifactManager = protocolProvider.createValidatorAnnounceArtifactManager(chainMetadata);
+    return new CoreWriter(mailboxArtifactManager, validatorAnnounceArtifactManager, chainMetadata, chainLookup, signer);
+}
+/**
+ * CoreWriter orchestrates full core deployment using the Artifact API.
+ * Handles mailbox, ISM, hook, and validator announce deployment.
+ *
+ * Extends CoreArtifactReader to inherit read() functionality.
+ * Follows same pattern as HookWriter, IsmWriter, and WarpTokenWriter.
+ *
+ * Deployment flow:
+ * 1. Deploy ISM if NEW (via IsmWriter)
+ * 2. Create Mailbox with ISM + zero hooks (via mailboxWriter)
+ * 3. Deploy hooks if NEW with mailbox context (via HookWriter)
+ * 4. Update mailbox with hooks + owner (via mailboxWriter.update + signer)
+ * 5. Deploy validator announce (via vaWriter)
+ */
+export class CoreWriter extends CoreArtifactReader {
+    validatorAnnounceArtifactManager;
+    signer;
+    logger = rootLogger.child({
+        module: CoreWriter.name,
+    });
+    ismWriter;
+    constructor(mailboxArtifactManager, validatorAnnounceArtifactManager, chainMetadata, chainLookup, signer) {
+        super(mailboxArtifactManager, chainMetadata, chainLookup);
+        this.validatorAnnounceArtifactManager = validatorAnnounceArtifactManager;
+        this.signer = signer;
+        this.ismWriter = createIsmWriter(this.chainMetadata, this.chainLookup, this.signer);
+    }
+    /**
+     * Deploys full core contracts: ISM, hooks, mailbox, validator announce.
+     *
+     * @param artifact Mailbox artifact with nested ISM and hook artifacts
+     * @returns Object containing deployed mailbox, validator announce artifacts, and receipts
+     */
+    async create(artifact) {
+        const { config } = artifact;
+        const allReceipts = [];
+        const chainName = this.chainMetadata.name;
+        this.logger.info(`Starting core deployment on ${chainName}`);
+        // Step 1: Deploy ISM if NEW
+        let onChainIsmArtifact;
+        if (isArtifactNew(config.defaultIsm)) {
+            this.logger.info(`Deploying default ISM on ${chainName}`);
+            const [deployed, ismReceipts] = await this.ismWriter.create(config.defaultIsm);
+            allReceipts.push(...ismReceipts);
+            onChainIsmArtifact = deployed;
+            this.logger.info(`Default ISM deployed at ${deployed.deployed.address} on ${chainName}`);
+        }
+        else {
+            // DEPLOYED or UNDERIVED - use as-is
+            onChainIsmArtifact = config.defaultIsm;
+            this.logger.info(`Using existing ISM at ${config.defaultIsm.deployed.address} for core deployment on ${chainName}`);
+        }
+        // Step 2: Create mailbox with ISM + zero hooks initially
+        this.logger.info(`Creating mailbox on ${chainName}`);
+        const mailboxWriter = this.mailboxArtifactManager.createWriter('mailbox', this.signer);
+        // Create mailbox with ISM but zero hooks initially.
+        // Hooks require the mailbox address for deployment (circular dependency),
+        // so we create mailbox first, deploy hooks in Step 3, then update mailbox in Step 4.
+        const initialMailboxArtifact = {
+            artifactState: ArtifactState.NEW,
+            config: {
+                owner: this.signer.getSignerAddress(), // Initial owner (will transfer later)
+                defaultIsm: onChainIsmArtifact,
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: ZERO_ADDRESS_HEX_32 },
+                },
+            },
+        };
+        const [deployedMailbox, mailboxReceipts] = await mailboxWriter.create(initialMailboxArtifact);
+        allReceipts.push(...mailboxReceipts);
+        const mailboxAddress = deployedMailbox.deployed.address;
+        this.logger.info(`Mailbox created at ${mailboxAddress} on ${chainName}`);
+        const hookWriter = createHookWriter(this.chainMetadata, this.chainLookup, this.signer, { mailbox: mailboxAddress });
+        // Step 3: Deploy hooks if NEW (hooks need mailbox address)
+        let onChainDefaultHookArtifact;
+        if (isArtifactNew(config.defaultHook)) {
+            this.logger.info(`Deploying default hook on ${chainName}`);
+            const [deployed, hookReceipts] = await hookWriter.create(config.defaultHook);
+            allReceipts.push(...hookReceipts);
+            onChainDefaultHookArtifact = deployed;
+            this.logger.info(`Default hook deployed at ${deployed.deployed.address} on ${chainName}`);
+        }
+        else {
+            onChainDefaultHookArtifact = config.defaultHook;
+            this.logger.info(`Using existing default hook at ${config.defaultHook.deployed.address} for core deployment on ${chainName}`);
+        }
+        let onChainRequiredHookArtifact;
+        if (isArtifactNew(config.requiredHook)) {
+            this.logger.info(`Deploying required hook on ${chainName}`);
+            const [deployed, hookReceipts] = await hookWriter.create(config.requiredHook);
+            allReceipts.push(...hookReceipts);
+            onChainRequiredHookArtifact = deployed;
+            this.logger.info(`Required hook deployed at ${deployed.deployed.address} on ${chainName}`);
+        }
+        else {
+            onChainRequiredHookArtifact = config.requiredHook;
+            this.logger.info(`Using existing required hook at ${config.requiredHook.deployed.address} for core deployment on ${chainName}`);
+        }
+        // Step 4: Update mailbox with hooks + transfer owner
+        this.logger.info(`Updating mailbox configuration on ${chainName}`);
+        const updatedMailboxArtifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: config.owner,
+                defaultIsm: onChainIsmArtifact,
+                defaultHook: onChainDefaultHookArtifact,
+                requiredHook: onChainRequiredHookArtifact,
+            },
+            deployed: deployedMailbox.deployed,
+        };
+        const updateTxs = await mailboxWriter.update(updatedMailboxArtifact);
+        for (const tx of updateTxs) {
+            this.logger.debug(`Executing update transaction on ${chainName}: ${tx.annotation}`);
+            const receipt = await this.signer.sendAndConfirmTransaction(tx);
+            allReceipts.push(receipt);
+        }
+        // Step 5: Deploy validator announce (if supported by protocol)
+        let validatorAnnounceArtifact = null;
+        if (this.validatorAnnounceArtifactManager) {
+            this.logger.info(`Deploying validator announce on ${chainName}`);
+            const vaWriter = this.validatorAnnounceArtifactManager.createWriter('validatorAnnounce', this.signer);
+            const vaArtifact = {
+                artifactState: ArtifactState.NEW,
+                config: { mailboxAddress },
+            };
+            const [deployed, vaReceipts] = await vaWriter.create(vaArtifact);
+            allReceipts.push(...vaReceipts);
+            validatorAnnounceArtifact = deployed;
+            this.logger.info(`Validator announce deployed at ${deployed.deployed.address} on ${chainName}`);
+        }
+        else {
+            this.logger.info(`Validator announce not supported by protocol for ${chainName}`);
+        }
+        this.logger.info(`Core deployment complete on ${chainName}`);
+        return {
+            mailbox: updatedMailboxArtifact,
+            validatorAnnounce: validatorAnnounceArtifact,
+            receipts: allReceipts,
+        };
+    }
+    /**
+     * Updates existing core deployment.
+     *
+     * @param mailboxAddress Existing mailbox address
+     * @param expectedArtifact Expected mailbox artifact with nested ISM/hook artifacts
+     * @returns Array of update transactions
+     */
+    async update(mailboxAddress, expectedArtifact) {
+        const { config: expectedConfig } = expectedArtifact;
+        const updateTxs = [];
+        const chainName = this.chainMetadata.name;
+        this.logger.info(`Starting core update on ${chainName}`);
+        // Read actual state (fully expanded)
+        const currentArtifact = await this.read(mailboxAddress);
+        const currentConfig = currentArtifact.config;
+        // Verify that reader expanded all nested artifacts
+        assert(isArtifactDeployed(currentConfig.defaultIsm), 'Expected Core Reader to expand the ISM config');
+        assert(isArtifactDeployed(currentConfig.defaultHook), 'Expected Core Reader to expand the default hook config');
+        assert(isArtifactDeployed(currentConfig.requiredHook), 'Expected Core Reader to expand the required hook config');
+        // Update ISM
+        const { address: newIsmAddress, transactions: ismTxs } = await this.deployOrUpdateIsm(currentConfig.defaultIsm, expectedConfig.defaultIsm);
+        updateTxs.push(...ismTxs);
+        // Update default hook
+        const { address: newDefaultHookAddress, transactions: defaultHookTxs } = await this.deployOrUpdateHook(currentConfig.defaultHook, expectedConfig.defaultHook, mailboxAddress);
+        updateTxs.push(...defaultHookTxs);
+        // Update required hook
+        const { address: newRequiredHookAddress, transactions: requiredHookTxs } = await this.deployOrUpdateHook(currentConfig.requiredHook, expectedConfig.requiredHook, mailboxAddress);
+        updateTxs.push(...requiredHookTxs);
+        this.logger.info(`Updating mailbox configuration on ${chainName}`);
+        const mailboxWriter = this.mailboxArtifactManager.createWriter('mailbox', this.signer);
+        const updatedMailboxArtifact = {
+            artifactState: ArtifactState.DEPLOYED,
+            config: {
+                owner: expectedConfig.owner,
+                defaultIsm: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: newIsmAddress },
+                },
+                defaultHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: newDefaultHookAddress },
+                },
+                requiredHook: {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: newRequiredHookAddress },
+                },
+            },
+            deployed: currentArtifact.deployed,
+        };
+        const mailboxUpdateTxs = await mailboxWriter.update(updatedMailboxArtifact);
+        updateTxs.push(...mailboxUpdateTxs);
+        return updateTxs;
+    }
+    /**
+     * Helper: Deploy or update ISM based on current vs expected.
+     * Uses IsmWriter internally, follows merge pattern from WarpTokenWriter.
+     */
+    async deployOrUpdateIsm(currentIsmArtifact, expectedIsm) {
+        const chainName = this.chainMetadata.name;
+        // If expected is UNDERIVED (just an address reference), use as-is
+        if (isArtifactUnderived(expectedIsm)) {
+            return { address: expectedIsm.deployed.address, transactions: [] };
+        }
+        const ismWriter = createIsmWriter(this.chainMetadata, this.chainLookup, this.signer);
+        // Merge current with expected (preserves DEPLOYED state for unchanged nested ISMs)
+        const mergedArtifact = mergeIsmArtifacts(currentIsmArtifact, expectedIsm);
+        if (isArtifactNew(mergedArtifact)) {
+            // Deploy new ISM
+            this.logger.info(`Deploying new ISM on ${chainName}`);
+            const [deployed] = await ismWriter.create(mergedArtifact);
+            this.logger.info(`New ISM deployed at ${deployed.deployed.address} on ${chainName}`);
+            return { address: deployed.deployed.address, transactions: [] };
+        }
+        // Update in-place
+        this.logger.info(`Updating existing ISM on ${chainName}`);
+        const updateTxs = await ismWriter.update(mergedArtifact);
+        this.logger.info(`ISM update generated ${updateTxs.length} transactions on ${chainName}`);
+        return {
+            address: mergedArtifact.deployed.address,
+            transactions: updateTxs,
+        };
+    }
+    /**
+     * Helper: Deploy or update hook based on current vs expected.
+     * Uses HookWriter internally, follows merge pattern from WarpTokenWriter.
+     */
+    async deployOrUpdateHook(currentHookArtifact, expectedHook, mailboxAddress) {
+        const chainName = this.chainMetadata.name;
+        // If expected is UNDERIVED (just an address reference), use as-is
+        if (isArtifactUnderived(expectedHook)) {
+            return { address: expectedHook.deployed.address, transactions: [] };
+        }
+        const hookWriter = createHookWriter(this.chainMetadata, this.chainLookup, this.signer, { mailbox: mailboxAddress });
+        // Merge current with expected
+        const mergedArtifact = mergeHookArtifacts(currentHookArtifact, expectedHook);
+        if (isArtifactNew(mergedArtifact)) {
+            // Deploy new hook
+            this.logger.info(`Deploying new hook on ${chainName}`);
+            const [deployed] = await hookWriter.create(mergedArtifact);
+            this.logger.info(`New hook deployed at ${deployed.deployed.address} on ${chainName}`);
+            return { address: deployed.deployed.address, transactions: [] };
+        }
+        // Update in-place
+        this.logger.info(`Updating existing hook on ${chainName}`);
+        const updateTxs = await hookWriter.update(mergedArtifact);
+        this.logger.info(`Hook update generated ${updateTxs.length} transactions on ${chainName}`);
+        return {
+            address: mergedArtifact.deployed.address,
+            transactions: updateTxs,
+        };
+    }
+}
+//# sourceMappingURL=core-writer.js.map

package/dist/core/core-writer.js.map

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