feat(svm-provider): svm provider warp artifact api impl (#8219)

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

Author: xeno097

.github/workflows/test.yml

@@ -143,6 +143,7 @@ jobs:
       has_tron: ${{ steps.decide.outputs.has_tron }}
       has_relayer: ${{ steps.decide.outputs.has_relayer }}
       has_rebalancer: ${{ steps.decide.outputs.has_rebalancer }}
+      has_svm: ${{ steps.decide.outputs.has_svm }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -181,6 +182,7 @@ jobs:
             echo "has_tron=true" >> $GITHUB_OUTPUT
             echo "has_relayer=true" >> $GITHUB_OUTPUT
             echo "has_rebalancer=true" >> $GITHUB_OUTPUT
+            echo "has_svm=true" >> $GITHUB_OUTPUT
             exit 0
           fi
 
@@ -192,6 +194,7 @@ jobs:
             echo "has_tron=false" >> $GITHUB_OUTPUT
             echo "has_relayer=false" >> $GITHUB_OUTPUT
             echo "has_rebalancer=false" >> $GITHUB_OUTPUT
+            echo "has_svm=false" >> $GITHUB_OUTPUT
             exit 0
           fi
 
@@ -200,6 +203,7 @@ jobs:
           has_aleo=$(echo "$CHANGED_FILES" | grep -qE '^typescript/aleo-sdk/' && echo true || echo false)
           has_cosmos=$(echo "$CHANGED_FILES" | grep -qE '^typescript/(cosmos-sdk|cosmos-types)/' && echo true || echo false)
           has_tron=$(echo "$CHANGED_FILES" | grep -qE '^typescript/tron-sdk/' && echo true || echo false)
+          has_svm=$(echo "$CHANGED_FILES" | grep -qE '^(rust/sealevel/|typescript/svm-sdk/)' && echo true || echo false)
 
           # Package-specific changes (run only their targeted CLI e2e tests)
           has_relayer=$(echo "$CHANGED_FILES" | grep -qE '^typescript/relayer/' && echo true || echo false)
@@ -222,6 +226,9 @@ jobs:
           echo "CLI changes: $has_cli_changes"
           echo "VM-specific — radix=$has_radix aleo=$has_aleo cosmos=$has_cosmos tron=$has_tron"
           echo "Package-specific — relayer=$has_relayer rebalancer=$has_rebalancer"
+          echo "has_svm=$has_svm" >> $GITHUB_OUTPUT
+
+          echo "VM-specific — radix=$has_radix aleo=$has_aleo cosmos=$has_cosmos tron=$has_tron svm=$has_svm"
 
       - name: Decide what to run
         id: decide
@@ -244,6 +251,7 @@ jobs:
             echo "has_tron=false" >> $GITHUB_OUTPUT
             echo "has_relayer=false" >> $GITHUB_OUTPUT
             echo "has_rebalancer=false" >> $GITHUB_OUTPUT
+            echo "has_svm=false" >> $GITHUB_OUTPUT
             exit 0
           fi
 
@@ -257,6 +265,7 @@ jobs:
             echo "has_tron=true" >> $GITHUB_OUTPUT
             echo "has_relayer=true" >> $GITHUB_OUTPUT
             echo "has_rebalancer=true" >> $GITHUB_OUTPUT
+            echo "has_svm=true" >> $GITHUB_OUTPUT
             exit 0
           fi
 
@@ -269,6 +278,7 @@ jobs:
           echo "has_tron=${{ steps.check-vm.outputs.has_tron }}" >> $GITHUB_OUTPUT
           echo "has_relayer=${{ steps.check-vm.outputs.has_relayer }}" >> $GITHUB_OUTPUT
           echo "has_rebalancer=${{ steps.check-vm.outputs.has_rebalancer }}" >> $GITHUB_OUTPUT
+          echo "has_svm=${{ steps.check-vm.outputs.has_svm }}" >> $GITHUB_OUTPUT
 
   pnpm-test-run:
     runs-on: depot-ubuntu-24.04
@@ -478,6 +488,22 @@ jobs:
             exit 1
           fi
 
+  svm-program-bytes:
+    runs-on: ubuntu-latest
+    needs: [change-detection]
+    if: needs.change-detection.outputs.has_svm == 'true'
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+
+      - name: Check program-bytes.ts staleness
+        run: node typescript/svm-sdk/scripts/check-program-bytes-hash.mjs
+
   env-tests:
     needs: [change-detection]
     uses: ./.github/workflows/test-env.yml

rust/sealevel/programs/build-programs.sh

@@ -12,7 +12,7 @@ PROGRAM_TYPE="${1:-all}"
 SOLANA_CLI_VERSION_FOR_BUILDING_PROGRAMS="3.0.14"
 
 # The paths to the programs
-CORE_PROGRAM_PATHS=("mailbox" "ism/multisig-ism-message-id" "validator-announce" "hyperlane-sealevel-igp")
+CORE_PROGRAM_PATHS=("mailbox" "ism/multisig-ism-message-id" "ism/test-ism" "validator-announce" "hyperlane-sealevel-igp")
 TOKEN_PROGRAM_PATHS=("hyperlane-sealevel-token" "hyperlane-sealevel-token-collateral" "hyperlane-sealevel-token-native")
 
 build_program () {

typescript/provider-sdk/src/warp.ts

@@ -133,6 +133,7 @@ interface BaseWarpArtifactConfig {
   name?: string;
   symbol?: string;
   decimals?: number;
+  scale?: number;
 }
 
 export interface CollateralWarpArtifactConfig extends BaseWarpArtifactConfig {
@@ -145,6 +146,7 @@ export interface SyntheticWarpArtifactConfig extends BaseWarpArtifactConfig {
   name: string;
   symbol: string;
   decimals: number;
+  metadataUri?: string;
 }
 
 export interface NativeWarpArtifactConfig extends BaseWarpArtifactConfig {

typescript/svm-sdk/.gitignore

@@ -1 +1,2 @@
 dist
+src/generated/

typescript/svm-sdk/package.json

@@ -28,14 +28,22 @@
     }
   },
   "scripts": {
-    "build": "rm -rf ./dist && tsc",
+    "build": "node scripts/generate-core-addresses.mjs && rm -rf ./dist && tsc",
+    "program:build": "(cd ../../rust/sealevel/programs && bash build-programs.sh)",
+    "program:generate": "node scripts/generate-program-bytes.mjs",
+    "program:check": "node scripts/check-program-bytes-hash.mjs",
     "format": "oxfmt --write ./src",
     "lint": "eslint -c ./eslint.config.mjs",
     "clean": "rm -rf ./dist ./cache",
     "dev": "tsc --watch",
     "test": "mocha --require tsx --timeout 300000 'src/tests/**/*.e2e-test.ts'",
+    "test:unit": "mocha --require tsx --timeout 10000 'src/tests/**/*.unit-test.ts'",
     "test:ism": "mocha --require tsx --timeout 300000 'src/tests/ism.e2e-test.ts'",
-    "test:hook": "mocha --require tsx --timeout 300000 'src/tests/hook.e2e-test.ts'"
+    "test:hook": "mocha --require tsx --timeout 300000 'src/tests/hook.e2e-test.ts'",
+    "test:native-token": "mocha --require tsx --timeout 300000 'src/tests/native-token.e2e-test.ts'",
+    "test:synthetic-token": "mocha --require tsx --timeout 300000 'src/tests/synthetic-token.e2e-test.ts'",
+    "test:collateral-token": "mocha --require tsx --timeout 300000 'src/tests/collateral-token.e2e-test.ts'",
+    "test:read-token": "mocha --require tsx --timeout 300000 'src/tests/read-token.e2e-test.ts'"
   },
   "dependencies": {
     "@hyperlane-xyz/provider-sdk": "workspace:*",

typescript/svm-sdk/scripts/check-program-bytes-hash.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+/* eslint-disable import/no-nodejs-modules */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { computeSealevelSourceHash } from './sealevel-source-hash.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROGRAM_BYTES_FILE = join(__dirname, '../src/hyperlane/program-bytes.ts');
+
+let content;
+try {
+  content = readFileSync(PROGRAM_BYTES_FILE, 'utf-8');
+} catch {
+  console.error(
+    'ERROR: program-bytes.ts not found. Regenerate with:\n' +
+      '  pnpm -C typescript/svm-sdk program:build\n' +
+      '  pnpm -C typescript/svm-sdk program:generate',
+  );
+  process.exit(1);
+}
+
+const match = content.match(/SEALEVEL_SOURCE_HASH\s*=\s*'([a-f0-9]{64})'/);
+if (!match) {
+  console.error(
+    'ERROR: SEALEVEL_SOURCE_HASH not found in program-bytes.ts.\n' +
+      'The file may predate the staleness check. Regenerate with:\n' +
+      '  pnpm -C typescript/svm-sdk program:build\n' +
+      '  pnpm -C typescript/svm-sdk program:generate',
+  );
+  process.exit(1);
+}
+
+const embeddedHash = match[1];
+const currentHash = computeSealevelSourceHash();
+
+if (embeddedHash === currentHash) {
+  console.log('program-bytes.ts is up to date with Rust sealevel sources.');
+  process.exit(0);
+}
+
+console.error('ERROR: program-bytes.ts is STALE.');
+console.error(`  Embedded hash: ${embeddedHash}`);
+console.error(`  Current hash:  ${currentHash}`);
+console.error('');
+console.error(
+  'Rust sealevel sources changed but program-bytes.ts was not regenerated.\n' +
+    'To fix:\n' +
+    '  pnpm -C typescript/svm-sdk program:build\n' +
+    '  pnpm -C typescript/svm-sdk program:generate',
+);
+process.exit(1);

typescript/svm-sdk/scripts/generate-core-addresses.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+/* eslint-disable import/no-nodejs-modules */
+import { readFileSync, writeFileSync, readdirSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ENVIRONMENTS_DIR = join(
+  __dirname,
+  '../../../rust/sealevel/environments/mainnet3',
+);
+const OUTPUT_FILE = join(__dirname, '../src/generated/core-addresses.ts');
+
+/** Snake_case key to camelCase. */
+function camelCase(s) {
+  return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+
+const chains = {};
+
+for (const entry of readdirSync(ENVIRONMENTS_DIR, { withFileTypes: true })) {
+  if (!entry.isDirectory()) continue;
+
+  const programIdsPath = join(
+    ENVIRONMENTS_DIR,
+    entry.name,
+    'core',
+    'program-ids.json',
+  );
+
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync(programIdsPath, 'utf-8'));
+  } catch {
+    continue; // no core/program-ids.json for this entry
+  }
+
+  const camelCased = {};
+  for (const [key, value] of Object.entries(raw)) {
+    camelCased[camelCase(key)] = value;
+  }
+
+  chains[entry.name] = camelCased;
+}
+
+const chainNames = Object.keys(chains).sort();
+
+if (chainNames.length === 0) {
+  console.error('No valid chains found in', ENVIRONMENTS_DIR);
+  process.exit(1);
+}
+
+const interfaceFields = Object.keys(chains[chainNames[0]])
+  .map((k) => `  ${k}: string;`)
+  .join('\n');
+
+const entries = chainNames
+  .map((chain) => {
+    const fields = Object.entries(chains[chain])
+      .map(([k, v]) => `    ${k}: '${v}',`)
+      .join('\n');
+    return `  ${chain}: {\n${fields}\n  },`;
+  })
+  .join('\n');
+
+const tsContent = `/**
+ * Auto-generated SVM core deployment addresses from rust/sealevel/environments/mainnet3.
+ * DO NOT EDIT — regenerate with: node scripts/generate-core-addresses.mjs
+ */
+
+export interface SvmCoreAddresses {
+${interfaceFields}
+}
+
+export const SVM_CORE_ADDRESSES: Record<string, SvmCoreAddresses> = {
+${entries}
+};
+`;
+
+mkdirSync(dirname(OUTPUT_FILE), { recursive: true });
+writeFileSync(OUTPUT_FILE, tsContent);
+console.log(
+  `Generated ${OUTPUT_FILE} with ${chainNames.length} chains: ${chainNames.join(', ')}`,
+);

typescript/svm-sdk/scripts/generate-program-bytes.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+/* eslint-disable import/no-nodejs-modules */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { computeSealevelSourceHash } from './sealevel-source-hash.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const PROGRAMS_DIR = join(__dirname, '../../../rust/sealevel/target/deploy');
+const OUTPUT_FILE = join(__dirname, '../src/hyperlane/program-bytes.ts');
+
+/** All Sealevel programs — keys match PROGRAM_BINARIES in testing/setup.ts. */
+const PROGRAMS = {
+  mailbox: 'hyperlane_sealevel_mailbox.so',
+  igp: 'hyperlane_sealevel_igp.so',
+  multisigIsm: 'hyperlane_sealevel_multisig_ism_message_id.so',
+  testIsm: 'hyperlane_sealevel_test_ism.so',
+  validatorAnnounce: 'hyperlane_sealevel_validator_announce.so',
+  tokenSynthetic: 'hyperlane_sealevel_token.so',
+  tokenNative: 'hyperlane_sealevel_token_native.so',
+  tokenCollateral: 'hyperlane_sealevel_token_collateral.so',
+};
+
+console.log('🔧 Generating program bytes from .so files...\n');
+
+const programBytes = {};
+
+for (const [key, filename] of Object.entries(PROGRAMS)) {
+  const path = join(PROGRAMS_DIR, filename);
+  try {
+    const bytes = readFileSync(path);
+    programBytes[key] = Array.from(bytes);
+    console.log(`  ✅ ${key}: ${bytes.length.toLocaleString()} bytes`);
+  } catch {
+    console.error(`  ❌ ${key}: required .so file not found at ${path}`);
+    process.exit(1);
+  }
+}
+
+const sourceHash = computeSealevelSourceHash();
+console.log(`\n  Source hash: ${sourceHash}`);
+
+const entries = Object.entries(programBytes)
+  .map(([key, bytes]) => `  ${key}: new Uint8Array([${bytes}]),`)
+  .join('\n');
+
+const tsContent = `/**
+ * Auto-generated program bytes from compiled .so binaries.
+ * DO NOT EDIT — regenerate with:
+ *   pnpm -C typescript/svm-sdk program:build
+ *   pnpm -C typescript/svm-sdk program:generate
+ */
+
+/** SHA-256 of Rust sealevel sources at generation time. Used for CI staleness detection. */
+export const SEALEVEL_SOURCE_HASH = '${sourceHash}';
+
+export const HYPERLANE_SVM_PROGRAM_BYTES = {
+${entries}
+} as const;
+
+export type HyperlaneSvmProgramBytesKey = keyof typeof HYPERLANE_SVM_PROGRAM_BYTES;
+`;
+
+mkdirSync(dirname(OUTPUT_FILE), { recursive: true });
+writeFileSync(OUTPUT_FILE, tsContent);
+console.log(`\n✨ Generated ${OUTPUT_FILE}\n`);