@hyperlane-xyz/sealevel-sdk 27.0.0

package/dist/clients/signer.js

@@ -0,0 +1,314 @@
+import { addSignersToTransactionMessage, createKeyPairSignerFromBytes, createKeyPairSignerFromPrivateKeyBytes, getBase58Encoder, getBase64EncodedWireTransaction, getSignatureFromTransaction, signTransactionMessageWithSigners, } from '@solana/kit';
+import { assert, rootLogger, strip0x } from '@hyperlane-xyz/utils';
+import { createRpc } from '../rpc.js';
+import { DEFAULT_COMPUTE_UNITS, buildTransactionMessage } from '../tx.js';
+import { SvmProvider } from './provider.js';
+class SvmTransactionError extends Error {
+    constructor(signature, cause) {
+        super(`Transaction failed: ${signature}, err: ${JSON.stringify(cause, (_k, v) => (typeof v === 'bigint' ? v.toString() : v))}`);
+        this.name = 'SvmTransactionError';
+        this.cause = cause;
+    }
+}
+const base58Encoder = getBase58Encoder();
+function parseKeyBytes(privateKey) {
+    // Try hex (32 bytes = 64 hex chars, 64 bytes = 128 hex chars)
+    const stripped = strip0x(privateKey);
+    if (/^[0-9a-fA-F]{64}$/.test(stripped)) {
+        return new Uint8Array(Buffer.from(stripped, 'hex'));
+    }
+    if (/^[0-9a-fA-F]{128}$/.test(stripped)) {
+        return new Uint8Array(Buffer.from(stripped, 'hex'));
+    }
+    // Try base58
+    let keyBytes;
+    try {
+        keyBytes = base58Encoder.encode(privateKey);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse private key. Expected hex (64 or 128 chars) or base58. ` +
+            `Base58 error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (keyBytes.length !== 32 && keyBytes.length !== 64) {
+        throw new Error(`Base58-decoded key has invalid length: ${keyBytes.length}. Expected 32 (private key) or 64 (keypair).`);
+    }
+    return keyBytes;
+}
+export class SvmSigner extends SvmProvider {
+    signer;
+    logger = rootLogger.child({ module: 'SvmSigner' });
+    constructor(rpc, rpcUrls, signer) {
+        super(rpc, rpcUrls);
+        this.signer = signer;
+    }
+    static async connectWithSigner(rpcUrls, privateKey, _extraParams) {
+        assert(rpcUrls.length > 0, 'At least one RPC URL is required');
+        const rpc = createRpc(rpcUrls[0]);
+        const keyBytes = parseKeyBytes(privateKey);
+        let keypair;
+        if (keyBytes.length === 32) {
+            keypair = await createKeyPairSignerFromPrivateKeyBytes(keyBytes);
+        }
+        else if (keyBytes.length === 64) {
+            keypair = await createKeyPairSignerFromBytes(keyBytes);
+        }
+        else {
+            throw new Error(`Invalid key length: ${keyBytes.length}. Expected 32 (private key) or 64 (keypair).`);
+        }
+        return new SvmSigner(rpc, rpcUrls, keypair);
+    }
+    getSignerAddress() {
+        return this.signer.address;
+    }
+    supportsTransactionBatching() {
+        return false;
+    }
+    async transactionToPrintableJson(transaction) {
+        return {
+            instructions: transaction.instructions.map((ix) => ({
+                programAddress: ix.programAddress,
+                accounts: ix.accounts,
+                data: ix.data ? Buffer.from(ix.data).toString('hex') : undefined,
+            })),
+            computeUnits: transaction.computeUnits,
+        };
+    }
+    /**
+     * Builds, signs, and sends a transaction with a confirmed blockhash.
+     * Retries on blockhash-not-found errors from the RPC.
+     * Returns the raw transaction bytes for rebroadcasting and the
+     * lastValidBlockHeight for block-height-based expiry detection.
+     */
+    async signAndSend(tx, maxAttempts = 3) {
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const { value: latestBlockhash } = await this.rpc
+                .getLatestBlockhash({ commitment: 'confirmed' })
+                .send();
+            let txMessage = buildTransactionMessage({
+                instructions: tx.instructions,
+                feePayer: this.signer,
+                recentBlockhash: latestBlockhash.blockhash,
+                lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,
+                computeUnits: tx.computeUnits ?? DEFAULT_COMPUTE_UNITS,
+            });
+            if (tx.additionalSigners?.length) {
+                txMessage = addSignersToTransactionMessage(tx.additionalSigners, txMessage);
+            }
+            const signedTx = await signTransactionMessageWithSigners(txMessage);
+            const signature = getSignatureFromTransaction(signedTx);
+            try {
+                const rawTx = getBase64EncodedWireTransaction(signedTx);
+                await this.rpc
+                    .sendTransaction(rawTx, {
+                    encoding: 'base64',
+                    skipPreflight: tx.skipPreflight ?? false,
+                })
+                    .send();
+                return {
+                    signature,
+                    rawTx,
+                    lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,
+                };
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                if (msg.includes('Blockhash not found') && attempt < maxAttempts - 1) {
+                    this.logger.warn(`Blockhash not found on send attempt ${attempt + 1}, retrying with fresh blockhash`);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw new Error('signAndSend: all attempts exhausted');
+    }
+    /**
+     * Evaluates a signature status result. Throws on error, returns
+     * `{ confirmed: true, slot }` if confirmed/finalized, `{ confirmed: false }`
+     * if still progressing, or `null` if the signature was not found.
+     */
+    checkSignatureResult(signature, result) {
+        if (!result)
+            return null;
+        if (result.err) {
+            throw new SvmTransactionError(signature, result.err);
+        }
+        if (result.confirmationStatus === 'confirmed' ||
+            result.confirmationStatus === 'finalized') {
+            return { confirmed: true, slot: result.slot };
+        }
+        return { confirmed: false };
+    }
+    async send(tx) {
+        let { signature, rawTx, lastValidBlockHeight } = await this.signAndSend(tx);
+        let confirmed = false;
+        let slot = 0n;
+        const maxPolls = 60;
+        let delay = 500;
+        for (let i = 0; i < maxPolls && !confirmed; i++) {
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            delay = Math.min(delay * 1.5, 4000);
+            try {
+                // Check signature status
+                const status = await this.rpc.getSignatureStatuses([signature]).send();
+                const check = this.checkSignatureResult(signature, status.value[0]);
+                if (check?.confirmed) {
+                    confirmed = true;
+                    slot = check.slot;
+                    break;
+                }
+                if (check) {
+                    // Transaction seen (e.g. 'processed') — keep polling, do NOT resubmit
+                    continue;
+                }
+                // Transaction not found — check if blockhash expired via block height
+                const currentBlockHeight = await this.rpc
+                    .getBlockHeight({ commitment: 'confirmed' })
+                    .send();
+                if (currentBlockHeight <= lastValidBlockHeight) {
+                    // Blockhash still valid — rebroadcast same signed transaction
+                    this.logger.debug('Rebroadcasting transaction');
+                    await this.rpc
+                        .sendTransaction(rawTx, {
+                        encoding: 'base64',
+                        skipPreflight: tx.skipPreflight ?? false,
+                    })
+                        .send();
+                    continue;
+                }
+                // Blockhash expired — deep check with transaction history search
+                const historyStatus = await this.rpc
+                    .getSignatureStatuses([signature], {
+                    searchTransactionHistory: true,
+                })
+                    .send();
+                const historyCheck = this.checkSignatureResult(signature, historyStatus.value[0]);
+                if (historyCheck?.confirmed) {
+                    confirmed = true;
+                    slot = historyCheck.slot;
+                    break;
+                }
+                if (historyCheck) {
+                    // Found in history but still progressing — keep polling
+                    continue;
+                }
+                // Blockhash expired and signature never seen — safe to resubmit
+                this.logger.warn('Blockhash expired and transaction not found, resubmitting');
+                ({ signature, rawTx, lastValidBlockHeight } =
+                    await this.signAndSend(tx));
+                delay = 500;
+            }
+            catch (error) {
+                if (error instanceof SvmTransactionError) {
+                    throw error;
+                }
+                this.logger.warn(`Polling attempt ${i + 1} failed`, { error });
+            }
+        }
+        if (!confirmed) {
+            throw new Error(`Transaction not confirmed within polling timeout: ${signature}`);
+        }
+        return { signature, slot };
+    }
+    async sendAndConfirmTransaction(transaction) {
+        return this.send(transaction);
+    }
+    async sendAndConfirmBatchTransactions(_transactions) {
+        throw new Error('Sealevel does not support transaction batching');
+    }
+    // ### TX CORE ###
+    async createMailbox(_req) {
+        throw new Error('createMailbox not supported on Sealevel');
+    }
+    async setDefaultIsm(_req) {
+        throw new Error('setDefaultIsm not supported on Sealevel');
+    }
+    async setDefaultHook(_req) {
+        throw new Error('setDefaultHook not supported on Sealevel');
+    }
+    async setRequiredHook(_req) {
+        throw new Error('setRequiredHook not supported on Sealevel');
+    }
+    async setMailboxOwner(_req) {
+        throw new Error('setMailboxOwner not supported on Sealevel');
+    }
+    async createMerkleRootMultisigIsm(_req) {
+        throw new Error('createMerkleRootMultisigIsm not supported on Sealevel');
+    }
+    async createMessageIdMultisigIsm(_req) {
+        throw new Error('createMessageIdMultisigIsm not supported on Sealevel');
+    }
+    async createRoutingIsm(_req) {
+        throw new Error('createRoutingIsm not supported on Sealevel');
+    }
+    async setRoutingIsmRoute(_req) {
+        throw new Error('setRoutingIsmRoute not supported on Sealevel');
+    }
+    async removeRoutingIsmRoute(_req) {
+        throw new Error('removeRoutingIsmRoute not supported on Sealevel');
+    }
+    async setRoutingIsmOwner(_req) {
+        throw new Error('setRoutingIsmOwner not supported on Sealevel');
+    }
+    async createNoopIsm(_req) {
+        throw new Error('createNoopIsm not supported on Sealevel');
+    }
+    async createMerkleTreeHook(_req) {
+        throw new Error('createMerkleTreeHook not supported on Sealevel');
+    }
+    async createInterchainGasPaymasterHook(_req) {
+        throw new Error('createInterchainGasPaymasterHook not supported on Sealevel');
+    }
+    async setInterchainGasPaymasterHookOwner(_req) {
+        throw new Error('setInterchainGasPaymasterHookOwner not supported on Sealevel');
+    }
+    async setDestinationGasConfig(_req) {
+        throw new Error('setDestinationGasConfig not supported on Sealevel');
+    }
+    async removeDestinationGasConfig(_req) {
+        throw new Error('removeDestinationGasConfig not supported on Sealevel');
+    }
+    async createNoopHook(_req) {
+        throw new Error('createNoopHook not supported on Sealevel');
+    }
+    async createValidatorAnnounce(_req) {
+        throw new Error('createValidatorAnnounce not supported on Sealevel');
+    }
+    async createProxyAdmin(_req) {
+        throw new Error('createProxyAdmin not supported on Sealevel');
+    }
+    async setProxyAdminOwner(_req) {
+        throw new Error('setProxyAdminOwner not supported on Sealevel');
+    }
+    // ### TX WARP ###
+    async createNativeToken(_req) {
+        throw new Error('createNativeToken not supported on Sealevel, use the Artifact API instead');
+    }
+    async createCollateralToken(_req) {
+        throw new Error('createCollateralToken not supported on Sealevel, use the Artifact API instead');
+    }
+    async createSyntheticToken(_req) {
+        throw new Error('createSyntheticToken not supported on Sealevel, use the Artifact API instead');
+    }
+    async setTokenOwner(_req) {
+        throw new Error('setTokenOwner not supported on Sealevel, use the Artifact API instead');
+    }
+    async setTokenIsm(_req) {
+        throw new Error('setTokenIsm not supported on Sealevel, use the Artifact API instead');
+    }
+    async setTokenHook(_req) {
+        throw new Error('setTokenHook not supported on Sealevel, use the Artifact API instead');
+    }
+    async enrollRemoteRouter(_req) {
+        throw new Error('enrollRemoteRouter not supported on Sealevel, use the Artifact API instead');
+    }
+    async unenrollRemoteRouter(_req) {
+        throw new Error('unenrollRemoteRouter not supported on Sealevel, use the Artifact API instead');
+    }
+    async transfer(_req) {
+        throw new Error('transfer not supported on Sealevel, use the Artifact API instead');
+    }
+    async remoteTransfer(_req) {
+        throw new Error('remoteTransfer not supported on Sealevel, use the Artifact API instead');
+    }
+}
+//# sourceMappingURL=signer.js.map

package/dist/clients/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../src/clients/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,8BAA8B,EAC9B,4BAA4B,EAC5B,sCAAsC,EACtC,gBAAgB,EAChB,+BAA+B,EAC/B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,MAAM,mBAAoB,SAAQ,KAAK;IACrC,YAAY,SAAiB,EAAE,KAAc;QAC3C,KAAK,CACH,uBAAuB,SAAS,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACzH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAEzC,SAAS,aAAa,CAAC,UAAkB;IACvC,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,aAAa;IACb,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC;QACH,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,CAAC,MAAM,8CAA8C,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,SACX,SAAQ,WAAW;IAGV,MAAM,CAAoB;IAClB,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAEpE,YACE,GAAW,EACX,OAAiB,EACjB,MAAyB;QAEzB,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,OAAiB,EACjB,UAAkB,EAClB,YAAkC;QAElC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,kCAAkC,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAE3C,IAAI,OAAsB,CAAC;QAC3B,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO,GAAG,MAAM,sCAAsC,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,GAAG,MAAM,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,MAAM,8CAA8C,CACrF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,2BAA2B;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,WAA2B;QAE3B,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAClD,cAAc,EAAE,EAAE,CAAC,cAAc;gBACjC,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC,CAAC;YACH,YAAY,EAAE,WAAW,CAAC,YAAY;SACvC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,WAAW,CACvB,EAAkB,EAClB,WAAW,GAAG,CAAC;QAMf,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG;iBAC9C,kBAAkB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;iBAC/C,IAAI,EAAE,CAAC;YAEV,IAAI,SAAS,GAAG,uBAAuB,CAAC;gBACtC,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM;gBACrB,eAAe,EAAE,eAAe,CAAC,SAAS;gBAC1C,oBAAoB,EAAE,eAAe,CAAC,oBAAoB;gBAC1D,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,qBAAqB;aACvD,CAAC,CAAC;YAEH,IAAI,EAAE,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;gBACjC,SAAS,GAAG,8BAA8B,CACxC,EAAE,CAAC,iBAAiB,EACpB,SAAS,CACV,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CAAC,SAAS,CAAC,CAAC;YACpE,MAAM,SAAS,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;YAExD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;gBACxD,MAAM,IAAI,CAAC,GAAG;qBACX,eAAe,CAAC,KAAK,EAAE;oBACtB,QAAQ,EAAE,QAAQ;oBAClB,aAAa,EAAE,EAAE,CAAC,aAAa,IAAI,KAAK;iBACzC,CAAC;qBACD,IAAI,EAAE,CAAC;gBAEV,OAAO;oBACL,SAAS;oBACT,KAAK;oBACL,oBAAoB,EAAE,eAAe,CAAC,oBAAoB;iBAC3D,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnE,IAAI,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;oBACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,uCAAuC,OAAO,GAAG,CAAC,iCAAiC,CACpF,CAAC;oBACF,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACK,oBAAoB,CAC1B,SAAoB,EACpB,MAA+B;QAE/B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAED,IACE,MAAM,CAAC,kBAAkB,KAAK,WAAW;YACzC,MAAM,CAAC,kBAAkB,KAAK,WAAW,EACzC,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAkB;QAC3B,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAE5E,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,GAAW,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC;gBACH,yBAAyB;gBACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvE,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEpE,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;oBACrB,SAAS,GAAG,IAAI,CAAC;oBACjB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;oBAClB,MAAM;gBACR,CAAC;gBAED,IAAI,KAAK,EAAE,CAAC;oBACV,sEAAsE;oBACtE,SAAS;gBACX,CAAC;gBAED,sEAAsE;gBACtE,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,GAAG;qBACtC,cAAc,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;qBAC3C,IAAI,EAAE,CAAC;gBAEV,IAAI,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;oBAC/C,8DAA8D;oBAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;oBAChD,MAAM,IAAI,CAAC,GAAG;yBACX,eAAe,CAAC,KAAK,EAAE;wBACtB,QAAQ,EAAE,QAAQ;wBAClB,aAAa,EAAE,EAAE,CAAC,aAAa,IAAI,KAAK;qBACzC,CAAC;yBACD,IAAI,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,iEAAiE;gBACjE,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,GAAG;qBACjC,oBAAoB,CAAC,CAAC,SAAS,CAAC,EAAE;oBACjC,wBAAwB,EAAE,IAAI;iBAC/B,CAAC;qBACD,IAAI,EAAE,CAAC;gBACV,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAC5C,SAAS,EACT,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CACvB,CAAC;gBAEF,IAAI,YAAY,EAAE,SAAS,EAAE,CAAC;oBAC5B,SAAS,GAAG,IAAI,CAAC;oBACjB,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;oBACzB,MAAM;gBACR,CAAC;gBAED,IAAI,YAAY,EAAE,CAAC;oBACjB,wDAAwD;oBACxD,SAAS;gBACX,CAAC;gBAED,gEAAgE;gBAChE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,2DAA2D,CAC5D,CAAC;gBACF,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE;oBACzC,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,KAAK,GAAG,GAAG,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;oBACzC,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qDAAqD,SAAS,EAAE,CACjE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,WAA2B;QAE3B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,+BAA+B,CACnC,aAA+B;QAE/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,kBAAkB;IAElB,KAAK,CAAC,aAAa,CACjB,IAA4C;QAE5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAA4C;QAE5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,IAA6C;QAE7C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAA8C;QAE9C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAA8C;QAE9C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,2BAA2B,CAC/B,IAA0D;QAE1D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,IAAyD;QAEzD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,IAA+C;QAE/C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,IAAiD;QAEjD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,IAAoD;QAEpD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,IAAiD;QAEjD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAA4C;QAE5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,IAAmD;QAEnD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,gCAAgC,CACpC,IAA+D;QAE/D,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kCAAkC,CACtC,IAAiE;QAEjE,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,IAAsD;QAEtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,IAAyD;QAEzD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,IAA6C;QAE7C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,IAAsD;QAEtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,IAA+C;QAE/C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,IAAiD;QAEjD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,kBAAkB;IAElB,KAAK,CAAC,iBAAiB,CACrB,IAAgD;QAEhD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,IAAoD;QAEpD,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,IAAmD;QAEnD,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAA4C;QAE5C,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAA0C;QAE1C,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,IAA2C;QAE3C,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,IAAiD;QAEjD,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,IAAmD;QAEnD,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAuC;QAEvC,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,IAA6C;QAE7C,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;CACF"}

package/dist/codecs/account-data.d.ts

@@ -0,0 +1,8 @@
+import { ByteCursor } from './binary.js';
+export interface DecodedAccountData<T> {
+    initialized: boolean;
+    data: T | null;
+}
+export declare function decodeAccountData<T>(raw: Uint8Array, decodeInner: (cursor: ByteCursor) => T): DecodedAccountData<T>;
+export declare function decodeDiscriminatorPrefixed<T>(cursor: ByteCursor, expectedDiscriminator: Uint8Array, decodeInner: (cursor: ByteCursor) => T): T;
+//# sourceMappingURL=account-data.d.ts.map

package/dist/codecs/account-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-data.d.ts","sourceRoot":"","sources":["../../src/codecs/account-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,UAAU,EACf,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,CAAC,GACrC,kBAAkB,CAAC,CAAC,CAAC,CAQvB;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,MAAM,EAAE,UAAU,EAClB,qBAAqB,EAAE,UAAU,EACjC,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,CAAC,GACrC,CAAC,CASH"}

package/dist/codecs/account-data.js

@@ -0,0 +1,20 @@
+import { ByteCursor } from './binary.js';
+export function decodeAccountData(raw, decodeInner) {
+    if (raw.length === 0)
+        return { initialized: false, data: null };
+    const cursor = new ByteCursor(raw);
+    const initialized = cursor.readBool();
+    if (!initialized) {
+        return { initialized: false, data: null };
+    }
+    return { initialized: true, data: decodeInner(cursor) };
+}
+export function decodeDiscriminatorPrefixed(cursor, expectedDiscriminator, decodeInner) {
+    const discriminator = cursor.readBytes(expectedDiscriminator.length);
+    const mismatch = discriminator.some((value, i) => value !== expectedDiscriminator[i]);
+    if (mismatch) {
+        throw new Error('Invalid discriminator');
+    }
+    return decodeInner(cursor);
+}
+//# sourceMappingURL=account-data.js.map

package/dist/codecs/account-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-data.js","sourceRoot":"","sources":["../../src/codecs/account-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,MAAM,UAAU,iBAAiB,CAC/B,GAAe,EACf,WAAsC;IAEtC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAkB,EAClB,qBAAiC,EACjC,WAAsC;IAEtC,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CACjC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,CACjD,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/codecs/binary.d.ts

@@ -0,0 +1,34 @@
+import { type Decoder, type ReadonlyUint8Array } from '@solana/kit';
+export declare class ByteCursor {
+    private readonly data;
+    private offset;
+    constructor(data: Uint8Array);
+    remaining(): number;
+    readU8(): number;
+    readBool(): boolean;
+    readU32LE(): number;
+    readU64LE(): bigint;
+    readU128LE(): bigint;
+    readU256LE(): bigint;
+    readBytes(length: number): Uint8Array;
+    readVecBytes(): Uint8Array;
+    readString(): string;
+    readWithDecoder<T>(decoder: Decoder<T>): T;
+    private ensure;
+}
+export declare function concatBytes(...parts: readonly ArrayLike<number>[]): ReadonlyUint8Array;
+export declare function u8(value: number): ReadonlyUint8Array;
+export declare function bool(value: boolean): ReadonlyUint8Array;
+export declare function u32le(value: number): ReadonlyUint8Array;
+export declare function u64le(value: bigint): ReadonlyUint8Array;
+export declare function u128le(value: bigint): ReadonlyUint8Array;
+export declare function u256le(value: bigint): ReadonlyUint8Array;
+export declare function vecBytes(bytes: ReadonlyUint8Array): ReadonlyUint8Array;
+export declare function vec<T>(items: readonly T[], encodeItem: (item: T) => ArrayLike<number>): ReadonlyUint8Array;
+export declare function option<T>(item: T | null | undefined, encodeItem: (value: T) => ArrayLike<number>): ReadonlyUint8Array;
+export declare function mapU32<T>(entries: Iterable<[number, T]>, encodeValue: (value: T) => ArrayLike<number>): ReadonlyUint8Array;
+export declare function addressBytes(input: string | ReadonlyUint8Array): ReadonlyUint8Array;
+export declare function ensureLength(bytes: ReadonlyUint8Array, length: number, label: string): ReadonlyUint8Array;
+export declare function readBigIntLE(bytes: Uint8Array): bigint;
+export declare function writeBigIntLE(value: bigint, length: number): Uint8Array;
+//# sourceMappingURL=binary.d.ts.map

package/dist/codecs/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/codecs/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EASZ,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAerB,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,MAAM,CAAK;gBAEU,IAAI,EAAE,UAAU;IAE7C,SAAS,IAAI,MAAM;IAInB,MAAM,IAAI,MAAM;IAShB,QAAQ,IAAI,OAAO;IASnB,SAAS,IAAI,MAAM;IASnB,SAAS,IAAI,MAAM;IASnB,UAAU,IAAI,MAAM;IASpB,UAAU,IAAI,MAAM;IAIpB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAOrC,YAAY,IAAI,UAAU;IAS1B,UAAU,IAAI,MAAM;IAIpB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAU1C,OAAO,CAAC,MAAM;CAOf;AAED,wBAAgB,WAAW,CACzB,GAAG,KAAK,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,GACrC,kBAAkB,CASpB;AAED,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAEpD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAEvD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAEvD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAEvD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAExD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAExD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAEtE;AAED,wBAAgB,GAAG,CAAC,CAAC,EACnB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GACzC,kBAAkB,CAEpB;AAED,wBAAgB,MAAM,CAAC,CAAC,EACtB,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1B,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GAC1C,kBAAkB,CAGpB;AAED,wBAAgB,MAAM,CAAC,CAAC,EACtB,OAAO,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GAC3C,kBAAkB,CAMpB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,kBAAkB,GACjC,kBAAkB,CAQpB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAKpB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAYvE"}

package/dist/codecs/binary.js

@@ -0,0 +1,165 @@
+import { addCodecSizePrefix, getBase16Codec, getBooleanCodec, getBytesCodec, getU128Codec, getU32Codec, getU64Codec, getU8Codec, getUtf8Codec, } from '@solana/kit';
+import { assert, isNullish } from '@hyperlane-xyz/utils';
+import { MAX_ACCOUNT_DATA_SIZE } from '../constants.js';
+const U8_CODEC = getU8Codec();
+const BOOL_CODEC = getBooleanCodec();
+const U32_CODEC = getU32Codec();
+const U64_CODEC = getU64Codec();
+const U128_CODEC = getU128Codec();
+const UTF8_CODEC = getUtf8Codec();
+const BASE16_CODEC = getBase16Codec();
+const VEC_BYTES_CODEC = addCodecSizePrefix(getBytesCodec(), U32_CODEC);
+export class ByteCursor {
+    data;
+    offset = 0;
+    constructor(data) {
+        this.data = data;
+    }
+    remaining() {
+        return this.data.length - this.offset;
+    }
+    readU8() {
+        this.ensure(1);
+        const value = U8_CODEC.decode(this.data.slice(this.offset, this.offset + 1));
+        this.offset += 1;
+        return value;
+    }
+    readBool() {
+        this.ensure(1);
+        const value = BOOL_CODEC.decode(this.data.slice(this.offset, this.offset + 1));
+        this.offset += 1;
+        return value;
+    }
+    readU32LE() {
+        this.ensure(4);
+        const value = U32_CODEC.decode(this.data.slice(this.offset, this.offset + 4));
+        this.offset += 4;
+        return value;
+    }
+    readU64LE() {
+        this.ensure(8);
+        const value = U64_CODEC.decode(this.data.slice(this.offset, this.offset + 8));
+        this.offset += 8;
+        return value;
+    }
+    readU128LE() {
+        this.ensure(16);
+        const value = U128_CODEC.decode(this.data.slice(this.offset, this.offset + 16));
+        this.offset += 16;
+        return value;
+    }
+    readU256LE() {
+        return readBigIntLE(this.readBytes(32));
+    }
+    readBytes(length) {
+        this.ensure(length);
+        const start = this.offset;
+        this.offset += length;
+        return this.data.slice(start, this.offset);
+    }
+    readVecBytes() {
+        const length = this.readU32LE();
+        assert(length <= MAX_ACCOUNT_DATA_SIZE, `Vec length ${length} exceeds Solana max account size (${MAX_ACCOUNT_DATA_SIZE})`);
+        return this.readBytes(length);
+    }
+    readString() {
+        return UTF8_CODEC.decode(this.readVecBytes());
+    }
+    readWithDecoder(decoder) {
+        try {
+            const [value, nextOffset] = decoder.read(this.data, this.offset);
+            this.offset = nextOffset;
+            return value;
+        }
+        catch (e) {
+            throw new Error(`Decoder failed at offset ${this.offset}`, { cause: e });
+        }
+    }
+    ensure(length) {
+        if (this.remaining() < length) {
+            throw new Error(`Buffer underflow: need ${length}, remaining ${this.remaining()}`);
+        }
+    }
+}
+export function concatBytes(...parts) {
+    const total = parts.reduce((acc, p) => acc + p.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+export function u8(value) {
+    return U8_CODEC.encode(value);
+}
+export function bool(value) {
+    return BOOL_CODEC.encode(value);
+}
+export function u32le(value) {
+    return U32_CODEC.encode(value);
+}
+export function u64le(value) {
+    return U64_CODEC.encode(value);
+}
+export function u128le(value) {
+    return U128_CODEC.encode(value);
+}
+export function u256le(value) {
+    return writeBigIntLE(value, 32);
+}
+export function vecBytes(bytes) {
+    return VEC_BYTES_CODEC.encode(bytes);
+}
+export function vec(items, encodeItem) {
+    return concatBytes(u32le(items.length), ...items.map(encodeItem));
+}
+export function option(item, encodeItem) {
+    if (item == null)
+        return u8(0);
+    return concatBytes(u8(1), encodeItem(item));
+}
+export function mapU32(entries, encodeValue) {
+    const materialized = Array.from(entries);
+    return concatBytes(u32le(materialized.length), ...materialized.map(([k, v]) => concatBytes(u32le(k), encodeValue(v))));
+}
+export function addressBytes(input) {
+    if (input instanceof Uint8Array)
+        return input;
+    if (typeof input === 'string' && input.startsWith('0x')) {
+        return BASE16_CODEC.encode(input.slice(2).toLowerCase());
+    }
+    throw new Error(`Expected raw bytes or 0x-prefixed hex string, got: ${input.slice(0, 12)}`);
+}
+export function ensureLength(bytes, length, label) {
+    if (bytes.length !== length) {
+        throw new Error(`${label} must be ${length} bytes, got ${bytes.length}`);
+    }
+    return bytes;
+}
+export function readBigIntLE(bytes) {
+    let result = 0n;
+    for (let i = 0; i < bytes.length; i += 1) {
+        const byte = bytes[i];
+        if (isNullish(byte))
+            continue;
+        result |= BigInt(byte) << (8n * BigInt(i));
+    }
+    return result;
+}
+export function writeBigIntLE(value, length) {
+    if (value < 0n)
+        throw new Error('Negative bigint not supported');
+    if (value >= 1n << BigInt(length * 8)) {
+        throw new Error(`Integer does not fit in ${length} bytes`);
+    }
+    const out = new Uint8Array(length);
+    let remaining = value;
+    for (let i = 0; i < length; i += 1) {
+        out[i] = Number(remaining & 0xffn);
+        remaining >>= 8n;
+    }
+    return out;
+}
+//# sourceMappingURL=binary.js.map

package/dist/codecs/binary.js.map

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