sol-parser-sdk-nodejs 0.3.0

package/dist/logs/raydium_clmm.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSwapFromData = parseSwapFromData;
+exports.parseIncreaseLiquidityFromData = parseIncreaseLiquidityFromData;
+exports.parseDecreaseLiquidityFromData = parseDecreaseLiquidityFromData;
+exports.parseCreatePoolFromData = parseCreatePoolFromData;
+exports.parseCollectFeeFromData = parseCollectFeeFromData;
+const dex_event_js_1 = require("../core/dex_event.js");
+const binary_js_1 = require("../util/binary.js");
+function bn64(v) {
+    return v ?? 0n;
+}
+/** Swap 日志载荷中 16 字节 u128 为 sqrt price limit，映射到 `RaydiumClmmSwapEvent.sqrt_price_x64`（与 Go/Python 字段名一致）。 */
+function parseSwapFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool_state)
+        return null;
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    if (!user)
+        return null;
+    o += 32;
+    if (o + 8 + 8 + 16 + 1 > data.length)
+        return null;
+    o += 8;
+    o += 8;
+    const sqrt_price_limit_x64 = (0, binary_js_1.readU128LE)(data, o);
+    o += 16;
+    const is_base_input = (0, binary_js_1.readBool)(data, o);
+    const ev = {
+        metadata,
+        pool_state,
+        token_account_0: (0, dex_event_js_1.defaultPubkey)(),
+        token_account_1: (0, dex_event_js_1.defaultPubkey)(),
+        amount_0: 0n,
+        amount_1: 0n,
+        zero_for_one: is_base_input,
+        sqrt_price_x64: sqrt_price_limit_x64,
+        liquidity: 0n,
+        sender: user,
+        transfer_fee_0: 0n,
+        transfer_fee_1: 0n,
+        tick: 0,
+    };
+    return { RaydiumClmmSwap: ev };
+}
+function parseIncreaseLiquidityFromData(data, metadata) {
+    let o = 0;
+    const pool = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool)
+        return null;
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    if (!user)
+        return null;
+    o += 32;
+    const liquidity = (0, binary_js_1.readU128LE)(data, o);
+    o += 16;
+    const amount0_max = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const amount1_max = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool,
+        position_nft_mint: (0, dex_event_js_1.defaultPubkey)(),
+        user,
+        liquidity,
+        amount0_max,
+        amount1_max,
+    };
+    return { RaydiumClmmIncreaseLiquidity: ev };
+}
+function parseDecreaseLiquidityFromData(data, metadata) {
+    let o = 0;
+    const pool = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool)
+        return null;
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    if (!user)
+        return null;
+    o += 32;
+    const liquidity = (0, binary_js_1.readU128LE)(data, o);
+    o += 16;
+    const amount0_min = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const amount1_min = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool,
+        position_nft_mint: (0, dex_event_js_1.defaultPubkey)(),
+        user,
+        liquidity,
+        amount0_min,
+        amount1_min,
+    };
+    return { RaydiumClmmDecreaseLiquidity: ev };
+}
+function parseCreatePoolFromData(data, metadata) {
+    let o = 0;
+    const pool = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool)
+        return null;
+    o += 32;
+    const creator = (0, binary_js_1.readPubkey)(data, o);
+    if (!creator)
+        return null;
+    o += 32;
+    const sqrt_price_x64 = (0, binary_js_1.readU128LE)(data, o);
+    o += 16;
+    const open_time = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool,
+        token_0_mint: (0, dex_event_js_1.defaultPubkey)(),
+        token_1_mint: (0, dex_event_js_1.defaultPubkey)(),
+        tick_spacing: 0,
+        fee_rate: 0,
+        creator,
+        sqrt_price_x64,
+        open_time,
+    };
+    return { RaydiumClmmCreatePool: ev };
+}
+function parseCollectFeeFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool_state)
+        return null;
+    o += 32;
+    const position_nft_mint = (0, binary_js_1.readPubkey)(data, o);
+    if (!position_nft_mint)
+        return null;
+    o += 32;
+    const amount_0 = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const amount_1 = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = { metadata, pool_state, position_nft_mint, amount_0, amount_1 };
+    return { RaydiumClmmCollectFee: ev };
+}

package/dist/logs/raydium_cpmm.d.ts

@@ -0,0 +1,7 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+export declare function parseSwapBaseInFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseSwapBaseOutFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseCreatePoolFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseDepositFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseWithdrawFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;

package/dist/logs/raydium_cpmm.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSwapBaseInFromData = parseSwapBaseInFromData;
+exports.parseSwapBaseOutFromData = parseSwapBaseOutFromData;
+exports.parseCreatePoolFromData = parseCreatePoolFromData;
+exports.parseDepositFromData = parseDepositFromData;
+exports.parseWithdrawFromData = parseWithdrawFromData;
+const binary_js_1 = require("../util/binary.js");
+function bn64(v) {
+    return v ?? 0n;
+}
+function parseSwapBaseInFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    o += 32;
+    const amount_in = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    o += 8;
+    const amount_out = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const is_base_input = (0, binary_js_1.readBool)(data, o);
+    const ev = {
+        metadata,
+        pool_id: pool_state,
+        input_vault_before: 0n,
+        output_vault_before: 0n,
+        input_amount: amount_in,
+        output_amount: amount_out,
+        input_transfer_fee: 0n,
+        output_transfer_fee: 0n,
+        base_input: is_base_input,
+    };
+    return { RaydiumCpmmSwap: ev };
+}
+function parseSwapBaseOutFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    o += 32;
+    o += 8;
+    const amount_out = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const amount_in = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const is_base_output = (0, binary_js_1.readBool)(data, o);
+    const ev = {
+        metadata,
+        pool_id: pool_state,
+        input_vault_before: 0n,
+        output_vault_before: 0n,
+        input_amount: amount_in,
+        output_amount: amount_out,
+        input_transfer_fee: 0n,
+        output_transfer_fee: 0n,
+        base_input: !is_base_output,
+    };
+    return { RaydiumCpmmSwap: ev };
+}
+function parseCreatePoolFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    o += 32;
+    o += 32;
+    const creator = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const initial_amount_0 = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const initial_amount_1 = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool: pool_state,
+        creator,
+        init_amount0: initial_amount_0,
+        init_amount1: initial_amount_1,
+    };
+    return { RaydiumCpmmInitialize: ev };
+}
+function parseDepositFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const lp_token_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const token_0_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const token_1_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool: pool_state,
+        user,
+        lp_token_amount,
+        token0_amount: token_0_amount,
+        token1_amount: token_1_amount,
+    };
+    return { RaydiumCpmmDeposit: ev };
+}
+function parseWithdrawFromData(data, metadata) {
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const lp_token_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const token_0_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const token_1_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = {
+        metadata,
+        pool: pool_state,
+        user,
+        lp_token_amount,
+        token0_amount: token_0_amount,
+        token1_amount: token_1_amount,
+    };
+    return { RaydiumCpmmWithdraw: ev };
+}

package/dist/logs/raydium_launchpad.d.ts

@@ -0,0 +1,12 @@
+/** Raydium Launchpad / Bonk 日志解析 */
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+export declare const BONK_DISC: {
+    TRADE: bigint;
+    POOL_CREATE: bigint;
+    MIGRATE_AMM: bigint;
+};
+export declare function parseBonkTradeFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseBonkPoolCreateFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseBonkMigrateAmmFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseBonkFromDiscriminator(discriminator: bigint, data: Uint8Array, metadata: EventMetadata): DexEvent | null;

package/dist/logs/raydium_launchpad.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BONK_DISC = void 0;
+exports.parseBonkTradeFromData = parseBonkTradeFromData;
+exports.parseBonkPoolCreateFromData = parseBonkPoolCreateFromData;
+exports.parseBonkMigrateAmmFromData = parseBonkMigrateAmmFromData;
+exports.parseBonkFromDiscriminator = parseBonkFromDiscriminator;
+const binary_js_1 = require("../util/binary.js");
+function disc(bytes) {
+    const u8 = new Uint8Array(8);
+    for (let i = 0; i < 8; i++)
+        u8[i] = bytes[i];
+    return new DataView(u8.buffer).getBigUint64(0, true);
+}
+exports.BONK_DISC = {
+    TRADE: disc([2, 3, 4, 5, 6, 7, 8, 9]),
+    POOL_CREATE: disc([1, 2, 3, 4, 5, 6, 7, 8]),
+    MIGRATE_AMM: disc([3, 4, 5, 6, 7, 8, 9, 10]),
+};
+function bn64(v) {
+    return v ?? 0n;
+}
+function parseBonkTradeFromData(data, metadata) {
+    if (data.length < 32 + 32 + 8 + 8 + 1 + 1)
+        return null;
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const amount_in = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const amount_out = bn64((0, binary_js_1.readU64LE)(data, o));
+    o += 8;
+    const is_buy = (0, binary_js_1.readBool)(data, o);
+    o += 1;
+    const exact_in = (0, binary_js_1.readBool)(data, o);
+    const ev = {
+        metadata,
+        pool_state,
+        user,
+        amount_in,
+        amount_out,
+        is_buy,
+        trade_direction: is_buy ? "Buy" : "Sell",
+        exact_in,
+    };
+    return { BonkTrade: ev };
+}
+function parseBonkPoolCreateFromData(data, metadata) {
+    if (data.length < 32 + 32 + 32 + 32 + 8 + 8)
+        return null;
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    o += 32;
+    o += 32;
+    const creator = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    o += 8;
+    o += 8;
+    const ev = {
+        metadata,
+        base_mint_param: { symbol: "BONK", name: "Bonk Pool", uri: "https://bonk.com", decimals: 5 },
+        pool_state,
+        creator,
+    };
+    return { BonkPoolCreate: ev };
+}
+function parseBonkMigrateAmmFromData(data, metadata) {
+    if (data.length < 32 + 32 + 32 + 8)
+        return null;
+    let o = 0;
+    const old_pool = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const new_pool = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const user = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const liquidity_amount = bn64((0, binary_js_1.readU64LE)(data, o));
+    const ev = { metadata, old_pool, new_pool, user, liquidity_amount };
+    return { BonkMigrateAmm: ev };
+}
+function parseBonkFromDiscriminator(discriminator, data, metadata) {
+    if (discriminator === exports.BONK_DISC.TRADE)
+        return parseBonkTradeFromData(data, metadata);
+    if (discriminator === exports.BONK_DISC.POOL_CREATE)
+        return parseBonkPoolCreateFromData(data, metadata);
+    if (discriminator === exports.BONK_DISC.MIGRATE_AMM)
+        return parseBonkMigrateAmmFromData(data, metadata);
+    return null;
+}

package/dist/parser_alias.d.ts

@@ -0,0 +1,3 @@
+import type { DexEvent } from "./core/dex_event.js";
+/** `DexEvent` 别名（兼容旧导入名） */
+export type ParsedEvent = DexEvent;

package/dist/parser_alias.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/rpc_parser.d.ts

@@ -0,0 +1,16 @@
+import { Connection } from "@solana/web3.js";
+import type { DexEvent } from "./core/dex_event.js";
+import type { EventTypeFilter } from "./grpc/types.js";
+import type { ParseError } from "./core/error.js";
+export { parseRpcTransaction, fillAccountsFromTransactionDataRpc, fillDataRpc, applyAccountFillsToLogEvents, } from "./rpc_transaction.js";
+/**
+ * 通过 RPC 拉取交易并解析：
+ * 外层 + 内层编译指令 + 日志；不含账户字段填充（需另行调用 RPC 填充 API）。
+ */
+export declare function parseTransactionFromRpc(connection: Connection, signature: string, filter?: EventTypeFilter): Promise<{
+    ok: true;
+    events: DexEvent[];
+} | {
+    ok: false;
+    error: ParseError;
+}>;

package/dist/rpc_parser.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyAccountFillsToLogEvents = exports.fillDataRpc = exports.fillAccountsFromTransactionDataRpc = exports.parseRpcTransaction = void 0;
+exports.parseTransactionFromRpc = parseTransactionFromRpc;
+const rpc_transaction_js_1 = require("./rpc_transaction.js");
+var rpc_transaction_js_2 = require("./rpc_transaction.js");
+Object.defineProperty(exports, "parseRpcTransaction", { enumerable: true, get: function () { return rpc_transaction_js_2.parseRpcTransaction; } });
+Object.defineProperty(exports, "fillAccountsFromTransactionDataRpc", { enumerable: true, get: function () { return rpc_transaction_js_2.fillAccountsFromTransactionDataRpc; } });
+Object.defineProperty(exports, "fillDataRpc", { enumerable: true, get: function () { return rpc_transaction_js_2.fillDataRpc; } });
+Object.defineProperty(exports, "applyAccountFillsToLogEvents", { enumerable: true, get: function () { return rpc_transaction_js_2.applyAccountFillsToLogEvents; } });
+/**
+ * 通过 RPC 拉取交易并解析：
+ * 外层 + 内层编译指令 + 日志；不含账户字段填充（需另行调用 RPC 填充 API）。
+ */
+async function parseTransactionFromRpc(connection, signature, filter) {
+    try {
+        const tx = await connection.getTransaction(signature, {
+            maxSupportedTransactionVersion: 0,
+        });
+        if (!tx) {
+            return {
+                ok: false,
+                error: {
+                    kind: "RpcError",
+                    message: "Transaction not found or null response (try archive RPC for old txs).",
+                },
+            };
+        }
+        const grpcRecvUs = Math.floor(Date.now() * 1000);
+        return (0, rpc_transaction_js_1.parseRpcTransaction)(tx, signature, filter, { grpcRecvUs });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, error: { kind: "RpcError", message: msg } };
+    }
+}

package/dist/rpc_transaction.d.ts

@@ -0,0 +1,25 @@
+import { type VersionedTransactionResponse } from "@solana/web3.js";
+import type { Message, MessageV0 } from "@solana/web3.js";
+import type { ConfirmedTransactionMeta } from "@solana/web3.js";
+import type { DexEvent } from "./core/dex_event.js";
+import type { ParseError } from "./core/error.js";
+import type { EventTypeFilter } from "./grpc/types.js";
+/**
+ * 与 Rust gRPC `parse_logs` 中 `fill_accounts_from_transaction_data` + `fill_data` 对齐：
+ * 对已由日志解析出的 `DexEvent` 用交易 message + meta 补全账户等字段。
+ */
+export declare function applyAccountFillsToLogEvents(events: DexEvent[], msg: Message | MessageV0, meta: ConfirmedTransactionMeta | null): void;
+/**
+ * 解析已获取的 `VersionedTransactionResponse`（顺序：指令 → 日志 → 账户/数据填充）。
+ */
+export declare function parseRpcTransaction(tx: VersionedTransactionResponse, signature: string, filter?: EventTypeFilter, options?: {
+    grpcRecvUs?: number;
+}): {
+    ok: true;
+    events: DexEvent[];
+} | {
+    ok: false;
+    error: ParseError;
+};
+export { fillAccountsFromTransactionDataRpc } from "./core/account_dispatcher_rpc.js";
+export { fillDataRpc } from "./core/common_filler_rpc.js";

package/dist/rpc_transaction.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fillDataRpc = exports.fillAccountsFromTransactionDataRpc = void 0;
+exports.applyAccountFillsToLogEvents = applyAccountFillsToLogEvents;
+exports.parseRpcTransaction = parseRpcTransaction;
+/**
+ * RPC 交易解析：外层 + 内层指令 → 日志 → `fillAccountsFromTransactionDataRpc` → `fillDataRpc`。
+ */
+const bs58_1 = __importDefault(require("bs58"));
+const web3_js_1 = require("@solana/web3.js");
+const account_dispatcher_rpc_js_1 = require("./core/account_dispatcher_rpc.js");
+const common_filler_rpc_js_1 = require("./core/common_filler_rpc.js");
+const rpc_invoke_map_js_1 = require("./core/rpc_invoke_map.js");
+const mod_js_1 = require("./instr/mod.js");
+const optimized_matcher_js_1 = require("./logs/optimized_matcher.js");
+const DEFAULT_PK = web3_js_1.PublicKey.default.toBase58();
+function resolveAccounts(resolver, indices) {
+    const idxs = indices instanceof Uint8Array ? Array.from(indices) : indices;
+    return idxs.map((i) => (0, rpc_invoke_map_js_1.accountKeyToBase58)(resolver.get(i)) ?? DEFAULT_PK);
+}
+function parseOuterAndInnerInstructions(message, meta, signature, slot, txIndex, blockTimeUs, grpcRecvUs, filter, events) {
+    const resolver = (0, rpc_invoke_map_js_1.getAccountKeyResolver)(message, meta);
+    for (const ix of message.compiledInstructions) {
+        const programId = (0, rpc_invoke_map_js_1.accountKeyToBase58)(resolver.get(ix.programIdIndex));
+        if (!programId)
+            continue;
+        const data = (0, rpc_invoke_map_js_1.decodeIxData)(ix.data);
+        const accounts = resolveAccounts(resolver, ix.accountKeyIndexes);
+        const ev = (0, mod_js_1.parseInstructionUnified)(data, accounts, signature, slot, txIndex, blockTimeUs, grpcRecvUs, filter, programId);
+        if (ev)
+            events.push(ev);
+    }
+    const innerGroups = meta?.innerInstructions;
+    if (!innerGroups)
+        return;
+    for (const group of innerGroups) {
+        for (const ix of group.instructions) {
+            const programId = (0, rpc_invoke_map_js_1.accountKeyToBase58)(resolver.get(ix.programIdIndex));
+            if (!programId)
+                continue;
+            const data = (0, rpc_invoke_map_js_1.decodeIxData)(ix.data);
+            const accounts = resolveAccounts(resolver, ix.accounts);
+            const ev = (0, mod_js_1.parseInstructionUnified)(data, accounts, signature, slot, txIndex, blockTimeUs, grpcRecvUs, filter, programId);
+            if (ev)
+                events.push(ev);
+        }
+    }
+}
+function recentBlockhashBytes(recentBlockhash) {
+    try {
+        return Uint8Array.from(bs58_1.default.decode(recentBlockhash));
+    }
+    catch {
+        return undefined;
+    }
+}
+function applyRpcFills(events, msg, meta) {
+    const resolver = (0, rpc_invoke_map_js_1.getAccountKeyResolver)(msg, meta);
+    const programInvokes = (0, rpc_invoke_map_js_1.buildProgramInvokesMap)(msg, meta, resolver);
+    for (const ev of events) {
+        (0, account_dispatcher_rpc_js_1.fillAccountsFromTransactionDataRpc)(ev, msg, meta, programInvokes, resolver);
+        (0, common_filler_rpc_js_1.fillDataRpc)(ev, msg, meta, programInvokes);
+    }
+}
+/**
+ * 与 Rust gRPC `parse_logs` 中 `fill_accounts_from_transaction_data` + `fill_data` 对齐：
+ * 对已由日志解析出的 `DexEvent` 用交易 message + meta 补全账户等字段。
+ */
+function applyAccountFillsToLogEvents(events, msg, meta) {
+    applyRpcFills(events, msg, meta);
+}
+/**
+ * 解析已获取的 `VersionedTransactionResponse`（顺序：指令 → 日志 → 账户/数据填充）。
+ */
+function parseRpcTransaction(tx, signature, filter, options) {
+    const msg = tx.transaction?.message;
+    if (!msg || !(0, rpc_invoke_map_js_1.isCompiledVersionedMessage)(msg)) {
+        return {
+            ok: false,
+            error: {
+                kind: "ConversionError",
+                message: "交易 message 非编译形态（例如使用了 jsonParsed）。请使用默认/非 parsed 的 getTransaction 响应。",
+            },
+        };
+    }
+    const meta = tx.meta ?? null;
+    const slot = tx.slot;
+    const blockTimeUs = tx.blockTime != null ? tx.blockTime * 1_000_000 : undefined;
+    const grpcRecvUs = options?.grpcRecvUs ?? Math.floor(Date.now() * 1000);
+    const rb = recentBlockhashBytes(msg.recentBlockhash);
+    const events = [];
+    parseOuterAndInnerInstructions(msg, meta, signature, slot, 0, blockTimeUs, grpcRecvUs, filter, events);
+    let isCreatedBuy = false;
+    for (const log of meta?.logMessages ?? []) {
+        const e = (0, optimized_matcher_js_1.parseLogOptimized)(log, signature, slot, 0, blockTimeUs, grpcRecvUs, filter, isCreatedBuy, rb);
+        if (e) {
+            if ("PumpFunCreate" in e || "PumpFunCreateV2" in e)
+                isCreatedBuy = true;
+            events.push(e);
+        }
+    }
+    applyRpcFills(events, msg, meta);
+    return { ok: true, events };
+}
+var account_dispatcher_rpc_js_2 = require("./core/account_dispatcher_rpc.js");
+Object.defineProperty(exports, "fillAccountsFromTransactionDataRpc", { enumerable: true, get: function () { return account_dispatcher_rpc_js_2.fillAccountsFromTransactionDataRpc; } });
+var common_filler_rpc_js_2 = require("./core/common_filler_rpc.js");
+Object.defineProperty(exports, "fillDataRpc", { enumerable: true, get: function () { return common_filler_rpc_js_2.fillDataRpc; } });

package/dist/util/binary.d.ts

@@ -0,0 +1,14 @@
+export declare function readU8(u8: Uint8Array, o: number): number | null;
+export declare function readU16LE(u8: Uint8Array, o: number): number | null;
+export declare function readU32LE(u8: Uint8Array, o: number): number | null;
+export declare function readI32LE(u8: Uint8Array, o: number): number | null;
+export declare function readU64LE(u8: Uint8Array, o: number): bigint | null;
+export declare function readI64LE(u8: Uint8Array, o: number): bigint | null;
+export declare function readU128LE(u8: Uint8Array, o: number): bigint | null;
+export declare function readBool(u8: Uint8Array, o: number): boolean | null;
+export declare function readPubkey(u8: Uint8Array, o: number): string | null;
+export declare function readBorshString(u8: Uint8Array, o: number): {
+    s: string;
+    next: number;
+} | null;
+export declare function readDiscriminatorU64(u8: Uint8Array): bigint | null;

package/dist/util/binary.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readU8 = readU8;
+exports.readU16LE = readU16LE;
+exports.readU32LE = readU32LE;
+exports.readI32LE = readI32LE;
+exports.readU64LE = readU64LE;
+exports.readI64LE = readI64LE;
+exports.readU128LE = readU128LE;
+exports.readBool = readBool;
+exports.readPubkey = readPubkey;
+exports.readBorshString = readBorshString;
+exports.readDiscriminatorU64 = readDiscriminatorU64;
+const web3_js_1 = require("@solana/web3.js");
+function readU8(u8, o) {
+    if (o >= u8.length)
+        return null;
+    return u8[o];
+}
+function readU16LE(u8, o) {
+    if (o + 2 > u8.length)
+        return null;
+    const v = new DataView(u8.buffer, u8.byteOffset + o, 2);
+    return v.getUint16(0, true);
+}
+function readU32LE(u8, o) {
+    if (o + 4 > u8.length)
+        return null;
+    const v = new DataView(u8.buffer, u8.byteOffset + o, 4);
+    return v.getUint32(0, true);
+}
+function readI32LE(u8, o) {
+    if (o + 4 > u8.length)
+        return null;
+    const v = new DataView(u8.buffer, u8.byteOffset + o, 4);
+    return v.getInt32(0, true);
+}
+function readU64LE(u8, o) {
+    if (o + 8 > u8.length)
+        return null;
+    const v = new DataView(u8.buffer, u8.byteOffset + o, 8);
+    return v.getBigUint64(0, true);
+}
+function readI64LE(u8, o) {
+    if (o + 8 > u8.length)
+        return null;
+    const v = new DataView(u8.buffer, u8.byteOffset + o, 8);
+    return v.getBigInt64(0, true);
+}
+function readU128LE(u8, o) {
+    const lo = readU64LE(u8, o);
+    const hi = readU64LE(u8, o + 8);
+    if (lo === null || hi === null)
+        return null;
+    return lo | (hi << 64n);
+}
+function readBool(u8, o) {
+    const b = readU8(u8, o);
+    if (b === null)
+        return null;
+    return b === 1;
+}
+function readPubkey(u8, o) {
+    if (o + 32 > u8.length)
+        return null;
+    return new web3_js_1.PublicKey(u8.subarray(o, o + 32)).toBase58();
+}
+function readBorshString(u8, o) {
+    const len = readU32LE(u8, o);
+    if (len === null || o + 4 + len > u8.length)
+        return null;
+    const bytes = u8.subarray(o + 4, o + 4 + len);
+    try {
+        return { s: new TextDecoder().decode(bytes), next: o + 4 + len };
+    }
+    catch {
+        return null;
+    }
+}
+function readDiscriminatorU64(u8) {
+    return readU64LE(u8, 0);
+}

package/dist/warmup.d.ts

@@ -0,0 +1,3 @@
+/** 预热 Base64 解码与热路径 */
+export declare function warmupParser(): void;
+export declare function isWarmedUp(): boolean;