feat(deploy-sdk, cli): deploy sdk core artifact api integration (#8148)

Co-authored-by: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>

Author: xeno097

.changeset/core-artifact-api-breaking-changes.md

@@ -0,0 +1,7 @@
+---
+'@hyperlane-xyz/deploy-sdk': major
+'@hyperlane-xyz/provider-sdk': minor
+'@hyperlane-xyz/cli': patch
+---
+
+Removed `AltVMCoreModule`, `AltVMCoreReader`, and `coreModuleProvider` from deploy-sdk in favor of the new core artifact API (`CoreWriter`, `createCoreReader`). Added `coreConfigToArtifact` and `coreResultToDeployedAddresses` helpers to provider-sdk. Updated CLI core deploy and read commands to use the new API.

.github/workflows/test-cli-e2e.yml

@@ -234,6 +234,7 @@ jobs:
           # Core Commands
           - core-deploy
           - core-apply
+          - core-apply-updates
           # ISM Commands
           - ism
           # Warp Commands

typescript/cli/src/deploy/core.ts

@@ -1,8 +1,13 @@
 import { stringify as yamlStringify } from 'yaml';
 
 import { buildArtifact as coreBuildArtifact } from '@hyperlane-xyz/core/buildArtifact.js';
-import { AltVMCoreModule } from '@hyperlane-xyz/deploy-sdk';
-import { GasAction, ProtocolType } from '@hyperlane-xyz/provider-sdk';
+import { createCoreWriter } from '@hyperlane-xyz/deploy-sdk';
+import {
+  GasAction,
+  ProtocolType,
+  coreConfigToArtifact,
+  coreResultToDeployedAddresses,
+} from '@hyperlane-xyz/provider-sdk';
 import { type ChainAddresses } from '@hyperlane-xyz/registry';
 import {
   type ChainName,
@@ -29,6 +34,7 @@ import {
   validateCoreIsmCompatibility,
 } from './utils.js';
 import { getSubmitterByStrategy } from './warp.js';
+import { ArtifactState } from '@hyperlane-xyz/provider-sdk/artifact';
 
 interface DeployParams {
   context: WriteCommandContext;
@@ -111,17 +117,18 @@ export async function runCoreDeploy(params: DeployParams) {
       const userAddress = signer.getSignerAddress();
       const initialBalances = await getBalances(context, [chain], userAddress);
 
-      const coreModule = await AltVMCoreModule.create({
-        chain,
-        config: validateCoreConfigForAltVM(config, chain),
-        chainLookup: altVmChainLookup(multiProvider),
-        signer,
-      });
+      const validatedConfig = validateCoreConfigForAltVM(config, chain);
+      const chainLookup = altVmChainLookup(multiProvider);
+      const metadata = chainLookup.getChainMetadata(chain);
+
+      const coreWriter = createCoreWriter(metadata, chainLookup, signer);
+      const coreArtifact = coreConfigToArtifact(validatedConfig, chainLookup);
+      const [result] = await coreWriter.create(coreArtifact);
 
       await completeDeploy(context, 'core', initialBalances, userAddress, [
         chain,
       ]);
-      deployedAddresses = coreModule.serialize();
+      deployedAddresses = coreResultToDeployedAddresses(result);
     }
   }
 
@@ -178,18 +185,18 @@ export async function runCoreApply(params: ApplyParams) {
       });
 
       const validatedConfig = validateCoreConfigForAltVM(config, chain);
-
-      const coreModule = new AltVMCoreModule(
-        altVmChainLookup(multiProvider),
-        signer,
-        {
-          chain,
-          config: validatedConfig,
-          addresses: deployedCoreAddresses,
+      const chainLookup = altVmChainLookup(multiProvider);
+      const metadata = chainLookup.getChainMetadata(chain);
+
+      const coreWriter = createCoreWriter(metadata, chainLookup, signer);
+      const coreArtifact = coreConfigToArtifact(validatedConfig, chainLookup);
+      const transactions = await coreWriter.update({
+        artifactState: ArtifactState.DEPLOYED,
+        config: coreArtifact.config,
+        deployed: {
+          address: deployedCoreAddresses.mailbox,
         },
-      );
-
-      const transactions = await coreModule.update(validatedConfig);
+      });
 
       if (transactions.length) {
         logGray('Updating deployed core contracts');

typescript/cli/src/read/core.ts

@@ -1,16 +1,11 @@
-import { AltVMCoreReader } from '@hyperlane-xyz/deploy-sdk';
+import { createCoreReader } from '@hyperlane-xyz/deploy-sdk';
 import {
   type ChainName,
   type CoreConfig,
   EvmCoreReader,
   altVmChainLookup,
 } from '@hyperlane-xyz/sdk';
-import {
-  type Address,
-  ProtocolType,
-  assert,
-  mustGet,
-} from '@hyperlane-xyz/utils';
+import { type Address, ProtocolType, assert } from '@hyperlane-xyz/utils';
 
 import { type CommandContext } from '../context/types.js';
 import { errorRed } from '../logger.js';
@@ -55,11 +50,10 @@ export async function executeCoreRead({
       break;
     }
     default: {
-      const provider = mustGet(context.altVmProviders, chain);
-      const chainLookup = altVmChainLookup(context.multiProvider);
-      const metadata = chainLookup.getChainMetadata(chain);
-      const coreReader = new AltVMCoreReader(metadata, chainLookup, provider);
       try {
+        const chainLookup = altVmChainLookup(context.multiProvider);
+        const metadata = chainLookup.getChainMetadata(chain);
+        const coreReader = createCoreReader(metadata, chainLookup);
         return await coreReader.deriveCoreConfig(mailbox);
       } catch (e: any) {
         errorRed(