@hyperlane-xyz/sealevel-sdk 27.0.0

package/dist/warp/synthetic-token.js

@@ -0,0 +1,180 @@
+import { ArtifactState, } from '@hyperlane-xyz/provider-sdk/artifact';
+import { TokenType, } from '@hyperlane-xyz/provider-sdk/warp';
+import { assert, isNullish, isZeroishAddress, ZERO_ADDRESS_HEX_32, } from '@hyperlane-xyz/utils';
+import { getAddressEncoder, address as parseAddress, } from '@solana/kit';
+import { fetchMintMetadata } from '../accounts/mint.js';
+import { concatBytes, u32le, u64le, u8 } from '../codecs/binary.js';
+import { RENT_SYSVAR_ADDRESS, SYSTEM_PROGRAM_ADDRESS, TOKEN_2022_PROGRAM_ADDRESS, } from '../constants.js';
+import { resolveProgram } from '../deploy/resolve-program.js';
+import { getTokenInitInstruction } from '../instructions/token.js';
+import { buildInstruction, readonlyAccount, readonlySigner, writableAccount, writableSigner, } from '../instructions/utils.js';
+import { deriveAtaPayerPda, deriveSyntheticMintPda } from '../pda.js';
+import { fetchTokenAccount, routerBytesToHex } from './warp-query.js';
+import { applyPostInitConfig, assertLocalDecimals, buildBaseInitData, buildFundAtaPayerInstruction, computeWarpTokenUpdateInstructions, remoteDecimalsToScale, scaleToRemoteDecimals, } from './warp-tx.js';
+// Borsh discriminator for the Token 2022 InitializeTokenMetadata instruction.
+const METADATA_INITIALIZE_DISCRIMINATOR = new Uint8Array([
+    210, 225, 30, 162, 88, 184, 77, 141,
+]);
+const addressEncoder = getAddressEncoder();
+/**
+ * SPL Token 2022: InitializeMetadataPointer (extension type 39).
+ * authority and metadataAddress are encoded into the 66-byte payload.
+ */
+function createInitializeMetadataPointerInstruction(mint, authority, metadataAddress) {
+    const data = new Uint8Array(66);
+    data[0] = 39; // extension type: MetadataPointer
+    data[1] = 0;
+    data.set(addressEncoder.encode(authority), 2);
+    data.set(addressEncoder.encode(metadataAddress), 34);
+    return buildInstruction(TOKEN_2022_PROGRAM_ADDRESS, [writableAccount(mint)], data);
+}
+/** SPL Token 2022: InitializeMint2 (discriminator 20). */
+function createInitializeMint2Instruction(mint, decimals, mintAuthority) {
+    const data = concatBytes(u8(20), // InitializeMint2 discriminator
+    u8(decimals), addressEncoder.encode(mintAuthority), u8(0));
+    return buildInstruction(TOKEN_2022_PROGRAM_ADDRESS, [writableAccount(mint), readonlyAccount(RENT_SYSVAR_ADDRESS)], data);
+}
+/** SPL Token 2022: SetAuthority (discriminator 6, authority type 0 = MintTokens). */
+function createSetAuthorityInstruction(mint, currentAuthority, newAuthority) {
+    const data = concatBytes(u8(6), // SetAuthority discriminator
+    u8(0), // authority type: MintTokens
+    u8(1), // has new authority
+    addressEncoder.encode(newAuthority));
+    return buildInstruction(TOKEN_2022_PROGRAM_ADDRESS, [writableAccount(mint), readonlySigner(currentAuthority)], data);
+}
+/** SPL Token 2022: InitializeTokenMetadata (Borsh discriminator). */
+function createInitializeMetadataInstruction(mint, updateAuthority, mintAuthority, name, symbol, uri) {
+    const nameBytes = new TextEncoder().encode(name);
+    const symbolBytes = new TextEncoder().encode(symbol);
+    const uriBytes = new TextEncoder().encode(uri);
+    const data = concatBytes(METADATA_INITIALIZE_DISCRIMINATOR, u32le(nameBytes.length), nameBytes, u32le(symbolBytes.length), symbolBytes, u32le(uriBytes.length), uriBytes);
+    return buildInstruction(TOKEN_2022_PROGRAM_ADDRESS, [
+        writableAccount(mint),
+        readonlyAccount(updateAuthority),
+        readonlyAccount(mint),
+        readonlySigner(mintAuthority),
+    ], data);
+}
+export class SvmSyntheticTokenReader {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    async read(programAddress) {
+        const programId = parseAddress(programAddress);
+        const token = await fetchTokenAccount(this.rpc, programId);
+        assert(!isNullish(token), `Synthetic token not initialized at ${programId}`);
+        const remoteRouters = {};
+        for (const [domain, router] of token.remoteRouters.entries()) {
+            remoteRouters[domain] = { address: routerBytesToHex(router) };
+        }
+        const destinationGas = {};
+        for (const [domain, gas] of token.destinationGas.entries()) {
+            destinationGas[domain] = gas.toString();
+        }
+        const { address: mintPda } = await deriveSyntheticMintPda(programId);
+        const metadata = await fetchMintMetadata(this.rpc, mintPda);
+        const config = {
+            type: TokenType.synthetic,
+            owner: token.owner ?? ZERO_ADDRESS_HEX_32,
+            mailbox: token.mailbox,
+            interchainSecurityModule: token.interchainSecurityModule
+                ? {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: token.interchainSecurityModule },
+                }
+                : undefined,
+            hook: token.interchainGasPaymaster
+                ? {
+                    artifactState: ArtifactState.UNDERIVED,
+                    deployed: { address: token.interchainGasPaymaster.programId },
+                }
+                : undefined,
+            remoteRouters,
+            destinationGas,
+            name: metadata.name,
+            symbol: metadata.symbol,
+            decimals: token.decimals,
+            metadataUri: metadata.uri,
+            scale: remoteDecimalsToScale(token.decimals, token.remoteDecimals),
+        };
+        return {
+            artifactState: ArtifactState.DEPLOYED,
+            config,
+            deployed: { address: programId },
+        };
+    }
+}
+export class SvmSyntheticTokenWriter extends SvmSyntheticTokenReader {
+    config;
+    svmSigner;
+    constructor(config, rpc, svmSigner) {
+        super(rpc);
+        this.config = config;
+        this.svmSigner = svmSigner;
+    }
+    async create(artifact) {
+        const receipts = [];
+        const tokenConfig = artifact.config;
+        assert(tokenConfig.metadataUri !== undefined, 'metadataUri is required for Solana synthetic token deployments');
+        assertLocalDecimals(tokenConfig.decimals);
+        const remoteDecimals = scaleToRemoteDecimals(tokenConfig.decimals, tokenConfig.scale);
+        const { programAddress, receipts: deployReceipts } = await resolveProgram(this.config.program, this.svmSigner, this.rpc, true);
+        receipts.push(...deployReceipts);
+        const { address: mintPda } = await deriveSyntheticMintPda(programAddress);
+        const { address: ataPayerPda } = await deriveAtaPayerPda(programAddress);
+        const initData = await buildBaseInitData(tokenConfig, tokenConfig.decimals, remoteDecimals);
+        const initIx = await getTokenInitInstruction(programAddress, this.svmSigner.signer, initData, [writableAccount(mintPda), writableAccount(ataPayerPda)]);
+        const initMetadataPtrIx = createInitializeMetadataPointerInstruction(mintPda, this.svmSigner.signer.address, mintPda);
+        const initMintIx = createInitializeMint2Instruction(mintPda, tokenConfig.decimals, this.svmSigner.signer.address);
+        receipts.push(await this.svmSigner.send({
+            instructions: [initIx, initMetadataPtrIx, initMintIx],
+            computeUnits: 400_000,
+            skipPreflight: true,
+        }));
+        // Initialize Token 2022 metadata.
+        // Fund mint account to cover the rent increase from metadata TLV being
+        // appended to the mint account. Metadata on-chain layout (Borsh):
+        //   TLV header(4) + update_authority(32) + mint(32)
+        //   + name(4+N) + symbol(4+M) + uri(4+L) + additional_metadata(4)
+        const encoder = new TextEncoder();
+        const nameLen = encoder.encode(tokenConfig.name).length;
+        const symbolLen = encoder.encode(tokenConfig.symbol).length;
+        const uriLen = encoder.encode(tokenConfig.metadataUri).length;
+        const metadataSize = 4 + 32 + 32 + (4 + nameLen) + (4 + symbolLen) + (4 + uriLen) + 4;
+        const metadataRent = await this.rpc
+            .getMinimumBalanceForRentExemption(BigInt(metadataSize))
+            .send();
+        const fundMintIx = buildInstruction(SYSTEM_PROGRAM_ADDRESS, [writableSigner(this.svmSigner.signer), writableAccount(mintPda)], concatBytes(u32le(2), // SystemProgram::Transfer discriminator (u32 LE)
+        u64le(metadataRent)));
+        const initMetadataIx = createInitializeMetadataInstruction(mintPda, this.svmSigner.signer.address, this.svmSigner.signer, tokenConfig.name, tokenConfig.symbol, tokenConfig.metadataUri);
+        // Transfer mint authority to mintPda so the program owns minting.
+        // Bundled with metadata init to avoid leaving the deployer as mint
+        // authority if a separate authority-transfer tx were to fail.
+        const setAuthorityIx = createSetAuthorityInstruction(mintPda, this.svmSigner.signer, mintPda);
+        receipts.push(await this.svmSigner.send({
+            instructions: [fundMintIx, initMetadataIx, setAuthorityIx],
+            skipPreflight: true,
+        }));
+        const fundAtaPayerIx = await buildFundAtaPayerInstruction(this.rpc, this.svmSigner.signer.address, programAddress, this.config.ataPayerFundingAmount);
+        if (fundAtaPayerIx) {
+            receipts.push(await this.svmSigner.send({ instructions: [fundAtaPayerIx] }));
+        }
+        receipts.push(...(await applyPostInitConfig(this.svmSigner, programAddress, tokenConfig)));
+        return [
+            {
+                artifactState: ArtifactState.DEPLOYED,
+                config: tokenConfig,
+                deployed: { address: programAddress },
+            },
+            receipts,
+        ];
+    }
+    async update(artifact) {
+        const programId = parseAddress(artifact.deployed.address);
+        const current = await this.read(programId);
+        assert(!isZeroishAddress(current.config.owner), `Cannot update synthetic token ${programId}: token has no owner`);
+        return computeWarpTokenUpdateInstructions(current.config, artifact.config, programId, parseAddress(current.config.owner), this.rpc, `synthetic token ${programId}`);
+    }
+}
+//# sourceMappingURL=synthetic-token.js.map

package/dist/warp/synthetic-token.js.map

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

package/dist/warp/types.d.ts

@@ -0,0 +1,16 @@
+import type { SvmProgramTarget } from '../types.js';
+/**
+ * Deployment-time configuration for any SVM warp token.
+ * Passed to writer constructors; separate from the on-chain artifact config.
+ */
+export type SvmWarpTokenConfig = Readonly<{
+    /** How to obtain the deployed program: fresh bytes or pre-existing ID. */
+    program: SvmProgramTarget;
+    /**
+     * Lamports to ensure the ATA payer PDA holds after deployment.
+     * Required for synthetic and collateral tokens to pay for recipient ATA
+     * creation on transfer_out.
+     */
+    ataPayerFundingAmount: bigint;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/warp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/warp/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,0EAA0E;IAC1E,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC,CAAC"}

package/dist/warp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/warp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/warp/types.ts"],"names":[],"mappings":""}

package/dist/warp/warp-artifact-manager.d.ts

@@ -0,0 +1,14 @@
+import { type Rpc, type SolanaRpcApi } from '@solana/kit';
+import type { ArtifactReader, ArtifactWriter } from '@hyperlane-xyz/provider-sdk/artifact';
+import type { DeployedRawWarpArtifact, DeployedWarpAddress, IRawWarpArtifactManager, RawWarpArtifactConfigs, WarpType } from '@hyperlane-xyz/provider-sdk/warp';
+import type { SvmSigner } from '../clients/signer.js';
+export declare class SvmWarpArtifactManager implements IRawWarpArtifactManager {
+    private readonly rpc;
+    private readonly ataPayerFundingAmount;
+    constructor(rpc: Rpc<SolanaRpcApi>, ataPayerFundingAmount?: bigint);
+    readWarpToken(tokenAddress: string): Promise<DeployedRawWarpArtifact>;
+    createReader<T extends WarpType>(type: T): ArtifactReader<RawWarpArtifactConfigs[T], DeployedWarpAddress>;
+    createWriter<T extends WarpType>(type: T, signer: SvmSigner): ArtifactWriter<RawWarpArtifactConfigs[T], DeployedWarpAddress>;
+    supportsHookUpdates(): boolean;
+}
+//# sourceMappingURL=warp-artifact-manager.d.ts.map

package/dist/warp/warp-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/warp/warp-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAatD,qBAAa,sBAAuB,YAAW,uBAAuB;IAElE,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBADrB,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,qBAAqB,GAAE,MAAqB;IAGzD,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAU3E,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,GACN,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAejE,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,SAAS,GAChB,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC;IA2CjE,mBAAmB,IAAI,OAAO;CAG/B"}

package/dist/warp/warp-artifact-manager.js

@@ -0,0 +1,52 @@
+import { address } from '@solana/kit';
+import { HYPERLANE_SVM_PROGRAM_BYTES } from '../hyperlane/program-bytes.js';
+import { SvmCollateralTokenReader, SvmCollateralTokenWriter, } from './collateral-token.js';
+import { SvmNativeTokenReader, SvmNativeTokenWriter } from './native-token.js';
+import { SvmSyntheticTokenReader, SvmSyntheticTokenWriter, } from './synthetic-token.js';
+import { detectWarpTokenType } from './warp-query.js';
+export class SvmWarpArtifactManager {
+    rpc;
+    ataPayerFundingAmount;
+    constructor(rpc, ataPayerFundingAmount = 100000000n) {
+        this.rpc = rpc;
+        this.ataPayerFundingAmount = ataPayerFundingAmount;
+    }
+    async readWarpToken(tokenAddress) {
+        const tokenType = await detectWarpTokenType(this.rpc, address(tokenAddress));
+        const reader = this.createReader(tokenType);
+        return reader.read(tokenAddress);
+    }
+    createReader(type) {
+        const readers = {
+            native: () => new SvmNativeTokenReader(this.rpc),
+            synthetic: () => new SvmSyntheticTokenReader(this.rpc),
+            collateral: () => new SvmCollateralTokenReader(this.rpc),
+        };
+        return readers[type]();
+    }
+    createWriter(type, signer) {
+        const writers = {
+            native: () => new SvmNativeTokenWriter({
+                program: { programBytes: HYPERLANE_SVM_PROGRAM_BYTES.tokenNative },
+                ataPayerFundingAmount: this.ataPayerFundingAmount,
+            }, this.rpc, signer),
+            synthetic: () => new SvmSyntheticTokenWriter({
+                program: {
+                    programBytes: HYPERLANE_SVM_PROGRAM_BYTES.tokenSynthetic,
+                },
+                ataPayerFundingAmount: this.ataPayerFundingAmount,
+            }, this.rpc, signer),
+            collateral: () => new SvmCollateralTokenWriter({
+                program: {
+                    programBytes: HYPERLANE_SVM_PROGRAM_BYTES.tokenCollateral,
+                },
+                ataPayerFundingAmount: this.ataPayerFundingAmount,
+            }, this.rpc, signer),
+        };
+        return writers[type]();
+    }
+    supportsHookUpdates() {
+        return true;
+    }
+}
+//# sourceMappingURL=warp-artifact-manager.js.map

package/dist/warp/warp-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-artifact-manager.js","sourceRoot":"","sources":["../../src/warp/warp-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+B,MAAM,aAAa,CAAC;AAenE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,OAAO,sBAAsB;IAEd;IACA;IAFnB,YACmB,GAAsB,EACtB,wBAAgC,UAAY;QAD5C,QAAG,GAAH,GAAG,CAAmB;QACtB,0BAAqB,GAArB,qBAAqB,CAAuB;IAC5D,CAAC;IAEJ,KAAK,CAAC,aAAa,CAAC,YAAoB;QACtC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CACzC,IAAI,CAAC,GAAG,EACR,OAAO,CAAC,YAAY,CAAC,CACtB,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,CACV,IAAO;QAEP,MAAM,OAAO,GAKT;YACF,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;YACtD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;SACzD,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,YAAY,CACV,IAAO,EACP,MAAiB;QAEjB,MAAM,OAAO,GAKT;YACF,MAAM,EAAE,GAAG,EAAE,CACX,IAAI,oBAAoB,CACtB;gBACE,OAAO,EAAE,EAAE,YAAY,EAAE,2BAA2B,CAAC,WAAW,EAAE;gBAClE,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;aAClD,EACD,IAAI,CAAC,GAAG,EACR,MAAM,CACP;YACH,SAAS,EAAE,GAAG,EAAE,CACd,IAAI,uBAAuB,CACzB;gBACE,OAAO,EAAE;oBACP,YAAY,EAAE,2BAA2B,CAAC,cAAc;iBACzD;gBACD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;aAClD,EACD,IAAI,CAAC,GAAG,EACR,MAAM,CACP;YACH,UAAU,EAAE,GAAG,EAAE,CACf,IAAI,wBAAwB,CAC1B;gBACE,OAAO,EAAE;oBACP,YAAY,EAAE,2BAA2B,CAAC,eAAe;iBAC1D;gBACD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;aAClD,EACD,IAAI,CAAC,GAAG,EACR,MAAM,CACP;SACJ,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/warp/warp-query.d.ts

@@ -0,0 +1,30 @@
+import { type Address } from '@solana/kit';
+import { type HyperlaneTokenAccountData } from '../accounts/token.js';
+import type { SvmRpc } from '../types.js';
+export declare enum SvmWarpTokenType {
+    Native = "native",
+    Synthetic = "synthetic",
+    Collateral = "collateral"
+}
+/**
+ * Fetches and decodes the HyperlaneToken PDA for a given warp program.
+ * Returns null if the account does not exist or is not initialized.
+ */
+export declare function fetchTokenAccount(rpc: SvmRpc, programId: Address): Promise<HyperlaneTokenAccountData | null>;
+/**
+ * Detects the warp token type by checking which type-specific PDA exists on-chain.
+ *
+ * Each token type creates exactly one unique PDA during init:
+ *   Native:     nativeCollateralPda  ["hyperlane_token", "-", "native_collateral"]
+ *   Synthetic:  syntheticMintPda     ["hyperlane_token", "-", "mint"]
+ *   Collateral: escrowPda            ["hyperlane_token", "-", "escrow"]
+ */
+export declare function detectWarpTokenType(rpc: SvmRpc, programId: Address): Promise<SvmWarpTokenType>;
+/** Converts a 32-byte router H256 to a 0x-prefixed hex string. */
+export declare function routerBytesToHex(bytes: Uint8Array): string;
+/**
+ * Converts a 0x-prefixed hex string to a 32-byte Uint8Array.
+ * Asserts the result is exactly 32 bytes.
+ */
+export declare function routerHexToBytes(hex: string): Uint8Array;
+//# sourceMappingURL=warp-query.d.ts.map

package/dist/warp/warp-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-query.d.ts","sourceRoot":"","sources":["../../src/warp/warp-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAuB,MAAM,aAAa,CAAC;AAIhE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAK3C;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAOxD"}

package/dist/warp/warp-query.js

@@ -0,0 +1,66 @@
+import { fetchEncodedAccount } from '@solana/kit';
+import { assert, fromHexString, toHexString } from '@hyperlane-xyz/utils';
+import { decodeHyperlaneTokenAccount, } from '../accounts/token.js';
+import { deriveHyperlaneTokenPda, deriveNativeCollateralPda, deriveSyntheticMintPda, deriveEscrowPda, } from '../pda.js';
+export var SvmWarpTokenType;
+(function (SvmWarpTokenType) {
+    SvmWarpTokenType["Native"] = "native";
+    SvmWarpTokenType["Synthetic"] = "synthetic";
+    SvmWarpTokenType["Collateral"] = "collateral";
+})(SvmWarpTokenType || (SvmWarpTokenType = {}));
+/**
+ * Fetches and decodes the HyperlaneToken PDA for a given warp program.
+ * Returns null if the account does not exist or is not initialized.
+ */
+export async function fetchTokenAccount(rpc, programId) {
+    const { address: tokenPda } = await deriveHyperlaneTokenPda(programId);
+    const account = await fetchEncodedAccount(rpc, tokenPda);
+    if (!account.exists)
+        return null;
+    return decodeHyperlaneTokenAccount(account.data);
+}
+/**
+ * Detects the warp token type by checking which type-specific PDA exists on-chain.
+ *
+ * Each token type creates exactly one unique PDA during init:
+ *   Native:     nativeCollateralPda  ["hyperlane_token", "-", "native_collateral"]
+ *   Synthetic:  syntheticMintPda     ["hyperlane_token", "-", "mint"]
+ *   Collateral: escrowPda            ["hyperlane_token", "-", "escrow"]
+ */
+export async function detectWarpTokenType(rpc, programId) {
+    const [{ address: nativeCollateralPda }, { address: syntheticMintPda }, { address: escrowPda },] = await Promise.all([
+        deriveNativeCollateralPda(programId),
+        deriveSyntheticMintPda(programId),
+        deriveEscrowPda(programId),
+    ]);
+    const [nativeAccount, syntheticAccount, collateralAccount] = await Promise.all([
+        fetchEncodedAccount(rpc, nativeCollateralPda),
+        fetchEncodedAccount(rpc, syntheticMintPda),
+        fetchEncodedAccount(rpc, escrowPda),
+    ]);
+    const matches = [];
+    if (nativeAccount.exists)
+        matches.push(SvmWarpTokenType.Native);
+    if (syntheticAccount.exists)
+        matches.push(SvmWarpTokenType.Synthetic);
+    if (collateralAccount.exists)
+        matches.push(SvmWarpTokenType.Collateral);
+    assert(matches.length === 1, matches.length === 0
+        ? `Unable to detect warp token type for program ${programId}: no type-specific PDA found`
+        : `Ambiguous warp token type for program ${programId}: multiple type-specific PDAs exist (${matches.join(', ')})`);
+    return matches[0];
+}
+/** Converts a 32-byte router H256 to a 0x-prefixed hex string. */
+export function routerBytesToHex(bytes) {
+    return toHexString(Buffer.from(bytes));
+}
+/**
+ * Converts a 0x-prefixed hex string to a 32-byte Uint8Array.
+ * Asserts the result is exactly 32 bytes.
+ */
+export function routerHexToBytes(hex) {
+    const bytes = fromHexString(hex);
+    assert(bytes.length === 32, `Router address must be 32 bytes (64 hex chars), got ${bytes.length}`);
+    return bytes;
+}
+//# sourceMappingURL=warp-query.js.map

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

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

package/dist/warp/warp-tx.d.ts

@@ -0,0 +1,64 @@
+import { type Address } from '@solana/kit';
+import { type RawWarpArtifactConfig } from '@hyperlane-xyz/provider-sdk/warp';
+import type { SvmSigner } from '../clients/signer.js';
+import { type TokenInitInstructionData } from '../instructions/token.js';
+import type { AnnotatedSvmTransaction, SvmInstruction, SvmReceipt, SvmRpc } from '../types.js';
+/**
+ * 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 declare function assertLocalDecimals(localDecimals: number): void;
+/**
+ * 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 declare function scaleToRemoteDecimals(localDecimals: number, scale?: number): number;
+/**
+ * Derives the `scale` factor from on-chain `localDecimals` and `remoteDecimals`.
+ * Returns undefined when there is no scaling (remoteDecimals === localDecimals).
+ */
+export declare function remoteDecimalsToScale(localDecimals: number, remoteDecimals: number): number | undefined;
+/**
+ * Builds the TokenInitInstructionData shared by all warp token types.
+ * The caller is responsible for passing the token-type-specific decimals.
+ */
+export declare function buildBaseInitData(config: Pick<RawWarpArtifactConfig, 'mailbox' | 'interchainSecurityModule' | 'hook'>, decimals: number, remoteDecimals: number): Promise<TokenInitInstructionData>;
+/**
+ * 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 declare function applyPostInitConfig(signer: SvmSigner, programId: Address, config: Pick<RawWarpArtifactConfig, 'remoteRouters' | 'destinationGas'>): Promise<SvmReceipt[]>;
+/**
+ * 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 declare function buildFundAtaPayerInstruction(rpc: SvmRpc, payer: Address, programId: Address, targetLamports: bigint): Promise<SvmInstruction | undefined>;
+/**
+ * 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 declare function computeWarpTokenUpdateInstructions(current: RawWarpArtifactConfig, expected: RawWarpArtifactConfig, programId: Address, ownerAddress: Address, rpc: SvmRpc, label: string): Promise<AnnotatedSvmTransaction[]>;
+//# sourceMappingURL=warp-tx.d.ts.map

package/dist/warp/warp-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-tx.d.ts","sourceRoot":"","sources":["../../src/warp/warp-tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA2B,MAAM,aAAa,CAAC;AAEpE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,EAML,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,MAAM,EACP,MAAM,aAAa,CAAC;AAOrB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAO/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAoCR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,SAAS,CAGpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,IAAI,CACV,qBAAqB,EACrB,SAAS,GAAG,0BAA0B,GAAG,MAAM,CAChD,EACD,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAYD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,gBAAgB,CAAC,GACtE,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,OAAO,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAgBrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,qBAAqB,EAC/B,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA+LpC"}