@hyperlane-xyz/sealevel-sdk 27.0.0

package/dist/warp/warp-tx.js

@@ -0,0 +1,291 @@
+import { address as parseAddress } from '@solana/kit';
+import { computeRemoteRoutersUpdates, } from '@hyperlane-xyz/provider-sdk/warp';
+import { assert, eqAddressSol, eqOptionalAddress, isZeroishAddress, } from '@hyperlane-xyz/utils';
+import { u32le } from '../codecs/binary.js';
+import { InterchainGasPaymasterTypeKind } from '../codecs/shared.js';
+import { SYSTEM_PROGRAM_ADDRESS } from '../constants.js';
+import { getProgramUpgradeAuthority } from '../deploy/program-deployer.js';
+import { getSetUpgradeAuthorityInstruction } from '../instructions/loader.js';
+import { getTokenEnrollRemoteRoutersInstruction, getTokenSetDestinationGasConfigsInstruction, getTokenSetInterchainGasPaymasterInstruction, getTokenSetInterchainSecurityModuleInstruction, getTokenTransferOwnershipInstruction, } from '../instructions/token.js';
+import { DEFAULT_IGP_SALT } from '../hook/igp-hook.js';
+import { deriveAtaPayerPda, deriveOverheadIgpAccountPda } from '../pda.js';
+import { buildInstruction, writableAccount, writableSignerAddress, } from '../instructions/utils.js';
+import { routerHexToBytes } from './warp-query.js';
+/** Maximum local decimals allowed by the on-chain SVM token programs. */
+const MAX_LOCAL_DECIMALS = 9;
+/**
+ * Asserts that `localDecimals` does not exceed the SVM maximum of 9.
+ * The on-chain program stores decimals as u8 and the decimal-conversion math
+ * overflows for values > 9. Mirrors the Rust client's `assert_decimals_max`.
+ */
+export function assertLocalDecimals(localDecimals) {
+    assert(Number.isInteger(localDecimals) &&
+        localDecimals >= 0 &&
+        localDecimals <= MAX_LOCAL_DECIMALS, `Invalid decimals: ${localDecimals}. Must be an integer in [0, ${MAX_LOCAL_DECIMALS}]. Use scale/remoteDecimals for higher-precision remote chains.`);
+}
+/**
+ * Derives `remoteDecimals` from `localDecimals` and the optional `scale` factor.
+ * scale = 10^(remoteDecimals - localDecimals), so
+ * remoteDecimals = localDecimals + log10(scale).
+ * Falls back to localDecimals when scale is absent or 1.
+ * Supports both upscaling (scale >= 1, e.g. 1e9) and downscaling
+ * (scale < 1, e.g. 1e-4) to match the on-chain program which stores
+ * decimals and remote_decimals as independent u8 values.
+ * Asserts that scale is an exact power of 10.
+ */
+export function scaleToRemoteDecimals(localDecimals, scale) {
+    if (scale == null || scale === 1)
+        return localDecimals;
+    assert(scale > 0, `scale must be positive, got ${scale}`);
+    if (scale >= 1) {
+        let exp = 0;
+        let remaining = scale;
+        while (remaining > 1 && remaining % 10 === 0) {
+            remaining /= 10;
+            exp++;
+        }
+        assert(remaining === 1, `scale must be an exact power of 10 (e.g. 1e9), got ${scale}`);
+        return localDecimals + exp;
+    }
+    // Downscale: scale < 1 (e.g. 0.0001 = 1e-4).
+    // Invert to integer and reuse the integer-only loop to avoid FP accumulation.
+    const inverse = Math.round(1 / scale);
+    let exp = 0;
+    let remaining = inverse;
+    while (remaining > 1 && remaining % 10 === 0) {
+        remaining /= 10;
+        exp++;
+    }
+    assert(remaining === 1, `scale must be an exact power of 10 (e.g. 1e-4), got ${scale}`);
+    assert(localDecimals >= exp, `scale 1e-${exp} would produce negative remoteDecimals for localDecimals=${localDecimals}`);
+    return localDecimals - exp;
+}
+/**
+ * Derives the `scale` factor from on-chain `localDecimals` and `remoteDecimals`.
+ * Returns undefined when there is no scaling (remoteDecimals === localDecimals).
+ */
+export function remoteDecimalsToScale(localDecimals, remoteDecimals) {
+    const diff = remoteDecimals - localDecimals;
+    return diff === 0 ? undefined : Math.pow(10, diff);
+}
+/**
+ * Builds the TokenInitInstructionData shared by all warp token types.
+ * The caller is responsible for passing the token-type-specific decimals.
+ */
+export async function buildBaseInitData(config, decimals, remoteDecimals) {
+    const igpProgramId = config.hook?.deployed?.address;
+    let interchainGasPaymaster = null;
+    if (igpProgramId) {
+        const programId = parseAddress(igpProgramId);
+        const { address: overheadIgpPda } = await deriveOverheadIgpAccountPda(programId, DEFAULT_IGP_SALT);
+        interchainGasPaymaster = {
+            programId,
+            igp: {
+                kind: InterchainGasPaymasterTypeKind.OverheadIgp,
+                account: overheadIgpPda,
+            },
+        };
+    }
+    return {
+        mailbox: parseAddress(config.mailbox),
+        interchainSecurityModule: config.interchainSecurityModule?.deployed?.address
+            ? parseAddress(config.interchainSecurityModule.deployed.address)
+            : null,
+        interchainGasPaymaster,
+        decimals,
+        remoteDecimals,
+    };
+}
+// Solana txs are capped at 1232 bytes (https://solana.com/docs/core/transactions#transaction-size).
+// Each router entry is 37 bytes in the EnrollRemoteRouters instruction data.
+// With ~322 bytes of fixed tx overhead the 1232-byte limit allows at most 24
+// routers per tx. Use 20 to stay comfortably within that bound.
+const MAX_ROUTERS_PER_TX = 20;
+// Each gas config entry is 13 bytes in SetDestinationGasConfigs instruction
+// data. The same fixed overhead allows at most 70 configs per tx. Use 60.
+const MAX_GAS_CONFIGS_PER_TX = 60;
+/**
+ * Sends post-init configuration (remote routers + destination gas) in
+ * separate, batched transactions — matching the Rust CLI behaviour — to
+ * stay within Solana's 1232-byte transaction size limit.
+ *
+ * Router enrollments and gas configs are issued as independent instruction
+ * streams so each can use its full per-tx budget.
+ */
+export async function applyPostInitConfig(signer, programId, config) {
+    const receipts = [];
+    const routerEntries = Object.entries(config.remoteRouters);
+    for (let i = 0; i < routerEntries.length; i += MAX_ROUTERS_PER_TX) {
+        const batch = routerEntries.slice(i, i + MAX_ROUTERS_PER_TX);
+        receipts.push(await signer.send({
+            instructions: [
+                await getTokenEnrollRemoteRoutersInstruction(programId, signer.signer.address, batch.map(([domain, router]) => ({
+                    domain: parseInt(domain),
+                    router: routerHexToBytes(router.address),
+                }))),
+            ],
+        }));
+    }
+    const gasEntries = Object.entries(config.destinationGas);
+    for (let i = 0; i < gasEntries.length; i += MAX_GAS_CONFIGS_PER_TX) {
+        const batch = gasEntries.slice(i, i + MAX_GAS_CONFIGS_PER_TX);
+        receipts.push(await signer.send({
+            instructions: [
+                await getTokenSetDestinationGasConfigsInstruction(programId, signer.signer.address, batch.map(([domain, gas]) => ({
+                    domain: parseInt(domain),
+                    gas: BigInt(gas),
+                }))),
+            ],
+        }));
+    }
+    return receipts;
+}
+/**
+ * Returns a System Program transfer instruction to top up the ATA payer PDA
+ * to at least `targetLamports`, or undefined if already sufficiently funded.
+ * For synthetic and collateral tokens the ATA payer funds recipient ATA
+ * creation on transfer_out.
+ */
+export async function buildFundAtaPayerInstruction(rpc, payer, programId, targetLamports) {
+    const { address: ataPayerPda } = await deriveAtaPayerPda(programId);
+    const balance = await rpc.getBalance(ataPayerPda).send();
+    const current = BigInt(balance.value);
+    if (current >= targetLamports)
+        return undefined;
+    const topUp = targetLamports - current;
+    const data = new Uint8Array(12);
+    data.set(u32le(2), 0); // SystemProgram::Transfer discriminator (u32 LE)
+    new DataView(data.buffer).setBigUint64(4, topUp, true); // lamports, LE
+    return buildInstruction(SYSTEM_PROGRAM_ADDRESS, [writableSignerAddress(payer), writableAccount(ataPayerPda)], data);
+}
+/**
+ * Diffs current vs expected config and returns the minimal set of annotated
+ * update transactions needed to reconcile them, batched to stay within
+ * Solana's 1232-byte transaction size limit.
+ *
+ * Transaction grouping:
+ *   1. ISM + IGP hook changes (combined, both are small)
+ *   2. Router unenroll/enroll batches (MAX_ROUTERS_PER_TX each)
+ *   3. Gas config unenroll/enroll batches (MAX_GAS_CONFIGS_PER_TX each)
+ *   4. Ownership transfer (always last, own tx)
+ *
+ * @param label - Prefix used for transaction annotations,
+ *                e.g. "native token <programId>"
+ */
+export async function computeWarpTokenUpdateInstructions(current, expected, programId, ownerAddress, rpc, label) {
+    const txs = [];
+    // 1. ISM + IGP hook — combined into a single tx (both are small instructions)
+    const configInstructions = [];
+    const currentIsm = current.interchainSecurityModule?.deployed?.address;
+    const expectedIsm = expected.interchainSecurityModule?.deployed?.address;
+    if (!eqOptionalAddress(currentIsm, expectedIsm, eqAddressSol)) {
+        configInstructions.push(await getTokenSetInterchainSecurityModuleInstruction(programId, ownerAddress, expectedIsm ? parseAddress(expectedIsm) : null));
+    }
+    const currentHook = current.hook?.deployed?.address;
+    const expectedHook = expected.hook?.deployed?.address;
+    if (!eqOptionalAddress(currentHook, expectedHook, eqAddressSol)) {
+        let igpValue = null;
+        if (expectedHook) {
+            const expectedHookAddress = parseAddress(expectedHook);
+            const { address: overheadIgpPda } = await deriveOverheadIgpAccountPda(expectedHookAddress, DEFAULT_IGP_SALT);
+            igpValue = [
+                expectedHookAddress,
+                {
+                    kind: InterchainGasPaymasterTypeKind.OverheadIgp,
+                    account: overheadIgpPda,
+                },
+            ];
+        }
+        configInstructions.push(await getTokenSetInterchainGasPaymasterInstruction(programId, ownerAddress, igpValue));
+    }
+    if (configInstructions.length > 0) {
+        txs.push({
+            instructions: configInstructions,
+            annotation: `Update ${label}: ISM/hook config`,
+        });
+    }
+    // 2. Router diff — the same domain set (toUnenroll/toEnroll) drives both
+    //    router and gas config changes, batched independently because gas config
+    //    instructions are smaller and allow more entries per tx.
+    const diff = computeRemoteRoutersUpdates({
+        remoteRouters: current.remoteRouters,
+        destinationGas: current.destinationGas,
+    }, {
+        remoteRouters: expected.remoteRouters,
+        destinationGas: expected.destinationGas,
+    }, eqAddressSol);
+    const unenrollRouterBatches = Math.ceil(diff.toUnenroll.length / MAX_ROUTERS_PER_TX);
+    for (let i = 0; i < diff.toUnenroll.length; i += MAX_ROUTERS_PER_TX) {
+        const batch = diff.toUnenroll.slice(i, i + MAX_ROUTERS_PER_TX);
+        const batchNum = i / MAX_ROUTERS_PER_TX + 1;
+        txs.push({
+            instructions: [
+                await getTokenEnrollRemoteRoutersInstruction(programId, ownerAddress, batch.map((domain) => ({ domain, router: null }))),
+            ],
+            annotation: `Update ${label}: unenroll routers${unenrollRouterBatches > 1 ? ` (${batchNum}/${unenrollRouterBatches})` : ''}`,
+        });
+    }
+    const unenrollGasBatches = Math.ceil(diff.toUnenroll.length / MAX_GAS_CONFIGS_PER_TX);
+    for (let i = 0; i < diff.toUnenroll.length; i += MAX_GAS_CONFIGS_PER_TX) {
+        const batch = diff.toUnenroll.slice(i, i + MAX_GAS_CONFIGS_PER_TX);
+        const batchNum = i / MAX_GAS_CONFIGS_PER_TX + 1;
+        txs.push({
+            instructions: [
+                await getTokenSetDestinationGasConfigsInstruction(programId, ownerAddress, batch.map((domain) => ({ domain, gas: null }))),
+            ],
+            annotation: `Update ${label}: unenroll gas configs${unenrollGasBatches > 1 ? ` (${batchNum}/${unenrollGasBatches})` : ''}`,
+        });
+    }
+    const enrollRouterBatches = Math.ceil(diff.toEnroll.length / MAX_ROUTERS_PER_TX);
+    for (let i = 0; i < diff.toEnroll.length; i += MAX_ROUTERS_PER_TX) {
+        const batch = diff.toEnroll.slice(i, i + MAX_ROUTERS_PER_TX);
+        const batchNum = i / MAX_ROUTERS_PER_TX + 1;
+        txs.push({
+            instructions: [
+                await getTokenEnrollRemoteRoutersInstruction(programId, ownerAddress, batch.map((e) => ({
+                    domain: e.domainId,
+                    router: routerHexToBytes(e.routerAddress),
+                }))),
+            ],
+            annotation: `Update ${label}: enroll routers${enrollRouterBatches > 1 ? ` (${batchNum}/${enrollRouterBatches})` : ''}`,
+        });
+    }
+    const enrollGasBatches = Math.ceil(diff.toEnroll.length / MAX_GAS_CONFIGS_PER_TX);
+    for (let i = 0; i < diff.toEnroll.length; i += MAX_GAS_CONFIGS_PER_TX) {
+        const batch = diff.toEnroll.slice(i, i + MAX_GAS_CONFIGS_PER_TX);
+        const batchNum = i / MAX_GAS_CONFIGS_PER_TX + 1;
+        txs.push({
+            instructions: [
+                await getTokenSetDestinationGasConfigsInstruction(programId, ownerAddress, batch.map((e) => ({
+                    domain: e.domainId,
+                    gas: BigInt(e.gas),
+                }))),
+            ],
+            annotation: `Update ${label}: enroll gas configs${enrollGasBatches > 1 ? ` (${batchNum}/${enrollGasBatches})` : ''}`,
+        });
+    }
+    const expectedOwnerAddress = expected.owner && !isZeroishAddress(expected.owner) ? expected.owner : null;
+    // 3. Ownership change — own tx
+    if (!eqOptionalAddress(current.owner, expected.owner, eqAddressSol)) {
+        txs.push({
+            instructions: [
+                await getTokenTransferOwnershipInstruction(programId, ownerAddress, expectedOwnerAddress ? parseAddress(expectedOwnerAddress) : null),
+            ],
+            annotation: `Update ${label}: transfer ownership`,
+        });
+    }
+    // 4. Upgrade authority — always last tx.
+    // Skip when the program is immutable (no current authority).
+    const currentUpgradeAuthority = await getProgramUpgradeAuthority(rpc, programId);
+    if (currentUpgradeAuthority &&
+        !eqOptionalAddress(currentUpgradeAuthority, expectedOwnerAddress ?? undefined, eqAddressSol)) {
+        txs.push({
+            instructions: [
+                await getSetUpgradeAuthorityInstruction(programId, currentUpgradeAuthority, expectedOwnerAddress ? parseAddress(expectedOwnerAddress) : null),
+            ],
+            annotation: `Update ${label}: ${expectedOwnerAddress ? 'transfer' : 'renounce'} upgrade authority`,
+        });
+    }
+    return txs;
+}
+//# sourceMappingURL=warp-tx.js.map

package/dist/warp/warp-tx.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@hyperlane-xyz/sealevel-sdk",
+  "version": "27.0.0",
+  "description": "Hand-crafted Solana/SVM client for Hyperlane Sealevel programs",
+  "keywords": [
+    "hyperlane",
+    "sealevel",
+    "solana",
+    "svm"
+  ],
+  "homepage": "https://www.hyperlane.xyz",
+  "license": "Apache-2.0",
+  "repository": "https://github.com/hyperlane-xyz/hyperlane-monorepo",
+  "files": [
+    "/dist"
+  ],
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.7.1",
+    "@solana-program/loader-v3": "^0.3.0",
+    "@solana-program/system": "^0.12.0",
+    "@solana/kit": "^6.1.0",
+    "@hyperlane-xyz/provider-sdk": "3.0.1",
+    "@hyperlane-xyz/utils": "27.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/chai": "^4.3.14",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^24.10.9",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "chai": "^4.4.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "mocha": "^10.4.0",
+    "oxfmt": "^0.32.0",
+    "testcontainers": "^10.13.2",
+    "tsx": "^4.19.1",
+    "typescript": "5.8.3",
+    "typescript-eslint": "^8.54.0",
+    "@hyperlane-xyz/eslint-config": "^27.0.0",
+    "@hyperlane-xyz/tsconfig": "^27.0.0"
+  },
+  "scripts": {
+    "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: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'"
+  }
+}