feat(sdks): sealevel fee support svm sdk [IGNORE FOR NOW]

.changeset/svm-fee-sdk-support.md

@@ -0,0 +1,20 @@
+---
+'@hyperlane-xyz/provider-sdk': major
+'@hyperlane-xyz/deploy-sdk': major
+'@hyperlane-xyz/sealevel-sdk': minor
+'@hyperlane-xyz/aleo-sdk': patch
+'@hyperlane-xyz/cosmos-sdk': patch
+'@hyperlane-xyz/radix-sdk': patch
+'@hyperlane-xyz/starknet-core': patch
+'@hyperlane-xyz/tron-sdk': patch
+---
+
+SVM fee program SDK support was added, enabling deployment and management of all 6 fee types (linear, regressive, progressive, offchainQuotedLinear, routing, crossCollateralRouting) on Solana/SVM chains.
+
+**Breaking change:** `ProtocolProvider.createFeeArtifactManager()` now requires a `FeeReadContext` parameter. This ensures routed fee types (routing, CC routing) receive the domain/router context needed to discover non-enumerable route PDAs. All protocol SDK implementations were updated.
+
+The SVM fee SDK includes:
+- Readers and writers for all 6 fee types with full create/update support.
+- Instruction builders for all 18 fee program instructions including runtime operations (QuoteFee, SubmitQuote, etc.).
+- PDA derivation, Borsh codecs, and account decoders for the fee program's on-chain state.
+- SvmFeeArtifactManager implementing IRawFeeArtifactManager, wired into SvmProtocolProvider.

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

@@ -174,6 +174,12 @@ jobs:
           - cross-collateral-token
           - provider
           - read-token
+          - fee-linear
+          - fee-regressive
+          - fee-progressive
+          - fee-offchain-quoted-linear
+          - fee-routing
+          - fee-cross-collateral-routing
         include:
           - test: read-token
             continue-on-error: true

typescript/aleo-sdk/src/clients/protocol.ts

@@ -19,7 +19,10 @@ import {
   type TxReceipt,
 } from '@hyperlane-xyz/provider-sdk/module';
 import { type IRawWarpArtifactManager } from '@hyperlane-xyz/provider-sdk/warp';
-import { type IRawFeeArtifactManager } from '@hyperlane-xyz/provider-sdk/fee';
+import {
+  type FeeReadContext,
+  type IRawFeeArtifactManager,
+} from '@hyperlane-xyz/provider-sdk/fee';
 import { type IRawValidatorAnnounceArtifactManager } from '@hyperlane-xyz/provider-sdk/validator-announce';
 import { assert } from '@hyperlane-xyz/utils';
 
@@ -193,6 +196,7 @@ export class AleoProtocolProvider implements ProtocolProvider {
 
   createFeeArtifactManager(
     _chainMetadata: ChainMetadataForAltVM,
+    _context: FeeReadContext,
   ): IRawFeeArtifactManager | null {
     return null;
   }

typescript/cosmos-sdk/src/clients/protocol.ts

@@ -16,7 +16,10 @@ import {
   type TxReceipt,
 } from '@hyperlane-xyz/provider-sdk/module';
 import { type IRawWarpArtifactManager } from '@hyperlane-xyz/provider-sdk/warp';
-import { type IRawFeeArtifactManager } from '@hyperlane-xyz/provider-sdk/fee';
+import {
+  type FeeReadContext,
+  type IRawFeeArtifactManager,
+} from '@hyperlane-xyz/provider-sdk/fee';
 import { type IRawValidatorAnnounceArtifactManager } from '@hyperlane-xyz/provider-sdk/validator-announce';
 import { assert } from '@hyperlane-xyz/utils';
 
@@ -121,6 +124,7 @@ export class CosmosNativeProtocolProvider implements ProtocolProvider {
 
   createFeeArtifactManager(
     _chainMetadata: ChainMetadataForAltVM,
+    _context: FeeReadContext,
   ): IRawFeeArtifactManager | null {
     return null;
   }

typescript/deploy-sdk/src/fee/fee-reader.ts

@@ -25,7 +25,7 @@ export function createFeeReader(
 ): FeeReader | null {
   const protocolProvider = getProtocolProvider(chainMetadata.protocol);
   const artifactManager: IRawFeeArtifactManager | null =
-    protocolProvider.createFeeArtifactManager(chainMetadata);
+    protocolProvider.createFeeArtifactManager(chainMetadata, context);
 
   if (!artifactManager) {
     return null;

typescript/deploy-sdk/src/fee/fee-writer.ts

@@ -34,7 +34,7 @@ export function createFeeWriter(
 ): FeeWriter | null {
   const protocolProvider = getProtocolProvider(chainMetadata.protocol);
   const artifactManager: IRawFeeArtifactManager | null =
-    protocolProvider.createFeeArtifactManager(chainMetadata);
+    protocolProvider.createFeeArtifactManager(chainMetadata, context);
 
   if (!artifactManager) {
     return null;

typescript/provider-sdk/src/protocol.ts

@@ -13,7 +13,7 @@ import {
   JsonRpcSubmitterConfig,
   TransactionSubmitterConfig,
 } from './submitter.js';
-import { IRawFeeArtifactManager } from './fee.js';
+import { type FeeReadContext, IRawFeeArtifactManager } from './fee.js';
 import { IRawWarpArtifactManager } from './warp.js';
 import { IRawValidatorAnnounceArtifactManager } from './validator-announce.js';
 
@@ -112,10 +112,12 @@ export interface ProtocolProvider {
    * Not all protocols support fee programs.
    *
    * @param chainMetadata Chain metadata for the target chain
+   * @param context Fee read context with known domains and routers for non-enumerable route discovery
    * @returns A protocol-specific Fee artifact manager, or null if not supported
    */
   createFeeArtifactManager(
     chainMetadata: ChainMetadataForAltVM,
+    context: FeeReadContext,
   ): IRawFeeArtifactManager | null;
 
   getMinGas(): MinimumRequiredGasByAction;

typescript/radix-sdk/src/clients/protocol.ts

@@ -14,7 +14,10 @@ import { IRawHookArtifactManager } from '@hyperlane-xyz/provider-sdk/hook';
 import { IRawIsmArtifactManager } from '@hyperlane-xyz/provider-sdk/ism';
 import { IRawMailboxArtifactManager } from '@hyperlane-xyz/provider-sdk/mailbox';
 import { AnnotatedTx, TxReceipt } from '@hyperlane-xyz/provider-sdk/module';
-import { IRawFeeArtifactManager } from '@hyperlane-xyz/provider-sdk/fee';
+import {
+  FeeReadContext,
+  IRawFeeArtifactManager,
+} from '@hyperlane-xyz/provider-sdk/fee';
 import { IRawValidatorAnnounceArtifactManager } from '@hyperlane-xyz/provider-sdk/validator-announce';
 import { IRawWarpArtifactManager } from '@hyperlane-xyz/provider-sdk/warp';
 import { assert } from '@hyperlane-xyz/utils';
@@ -114,6 +117,7 @@ export class RadixProtocolProvider implements ProtocolProvider {
 
   createFeeArtifactManager(
     _chainMetadata: ChainMetadataForAltVM,
+    _context: FeeReadContext,
   ): IRawFeeArtifactManager | null {
     return null;
   }

typescript/starknet-sdk/src/clients/protocol.ts

@@ -12,7 +12,10 @@ import { IRawHookArtifactManager } from '@hyperlane-xyz/provider-sdk/hook';
 import { IRawIsmArtifactManager } from '@hyperlane-xyz/provider-sdk/ism';
 import { IRawMailboxArtifactManager } from '@hyperlane-xyz/provider-sdk/mailbox';
 import { AnnotatedTx, TxReceipt } from '@hyperlane-xyz/provider-sdk/module';
-import { IRawFeeArtifactManager } from '@hyperlane-xyz/provider-sdk/fee';
+import {
+  FeeReadContext,
+  IRawFeeArtifactManager,
+} from '@hyperlane-xyz/provider-sdk/fee';
 import { IRawValidatorAnnounceArtifactManager } from '@hyperlane-xyz/provider-sdk/validator-announce';
 import { IRawWarpArtifactManager } from '@hyperlane-xyz/provider-sdk/warp';
 import { assert } from '@hyperlane-xyz/utils';
@@ -93,6 +96,7 @@ export class StarknetProtocolProvider implements ProtocolProvider {
 
   createFeeArtifactManager(
     _chainMetadata: ChainMetadataForAltVM,
+    _context: FeeReadContext,
   ): IRawFeeArtifactManager | null {
     return null;
   }

typescript/svm-sdk/package.json

@@ -50,6 +50,7 @@
   },
   "devDependencies": {
     "@hyperlane-xyz/tsconfig": "workspace:^",
+    "@noble/curves": "^1.7.0",
     "@types/chai": "^4.3.14",
     "@types/chai-as-promised": "catalog:",
     "@types/mocha": "^10.0.6",

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

@@ -11,6 +11,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 const PROGRAMS_DIR = join(__dirname, '../../../rust/sealevel/target/deploy');
+const LOCAL_SO_DIR = join(__dirname, '../so-binaries');
 const OUTPUT_FILE = join(__dirname, '../src/hyperlane/program-bytes.ts');
 
 /** All Sealevel programs — keys match PROGRAM_BINARIES in testing/setup.ts. */
@@ -24,22 +25,29 @@ const PROGRAMS = {
   tokenNative: 'hyperlane_sealevel_token_native.so',
   tokenCollateral: 'hyperlane_sealevel_token_collateral.so',
   tokenCrossCollateral: 'hyperlane_sealevel_token_cross_collateral.so',
+  tokenFee: 'hyperlane_sealevel_fee.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);
+  const primaryPath = join(PROGRAMS_DIR, filename);
+  const fallbackPath = join(LOCAL_SO_DIR, filename);
+  let bytes;
   try {
-    const bytes = readFileSync(path);
-    programBytes[key] = Array.from(bytes);
-    console.log(`  ✅ ${key}: ${bytes.length.toLocaleString()} bytes`);
+    bytes = readFileSync(primaryPath);
   } catch {
-    console.error(`  ❌ ${key}: required .so file not found at ${path}`);
-    process.exit(1);
+    try {
+      bytes = readFileSync(fallbackPath);
+    } catch {
+      console.error(`  ❌ ${key}: .so not found at ${primaryPath} or ${fallbackPath}`);
+      process.exit(1);
+    }
   }
+  programBytes[key] = Array.from(bytes);
+  console.log(`  ✅ ${key}: ${bytes.length.toLocaleString()} bytes`);
 }
 
 const sourceHash = computeSealevelSourceHash();