sol-parser-sdk-nodejs 0.3.0 → 0.4.0

package/dist/instr/utils.d.ts

@@ -7,4 +7,4 @@ export declare function readBorshStrAt(data: Uint8Array, offset: number): {
     next: number;
 } | null;
 export declare function readPubkeyIx(data: Uint8Array, o: number): string | null;
-export { readU64LE, readU128LE, readU8, readBool, readI64LE, } from "../util/binary.js";
+export { readU64LE, readU128LE, readU8, readBool, readI64LE, readI32LE, } from "../util/binary.js";

package/dist/instr/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readI64LE = exports.readBool = exports.readU8 = exports.readU128LE = exports.readU64LE = void 0;
+exports.readI32LE = exports.readI64LE = exports.readBool = exports.readU8 = exports.readU128LE = exports.readU64LE = void 0;
 exports.ixMeta = ixMeta;
 exports.getAccount = getAccount;
 exports.readBorshStrAt = readBorshStrAt;
@@ -31,3 +31,4 @@ Object.defineProperty(exports, "readU128LE", { enumerable: true, get: function (
 Object.defineProperty(exports, "readU8", { enumerable: true, get: function () { return binary_js_2.readU8; } });
 Object.defineProperty(exports, "readBool", { enumerable: true, get: function () { return binary_js_2.readBool; } });
 Object.defineProperty(exports, "readI64LE", { enumerable: true, get: function () { return binary_js_2.readI64LE; } });
+Object.defineProperty(exports, "readI32LE", { enumerable: true, get: function () { return binary_js_2.readI32LE; } });

package/dist/logs/discriminator_lut.d.ts

@@ -0,0 +1,19 @@
+/** 与 Rust `discriminator_lut::Protocol` 变体名一致（字符串联合，便于 JSON / 日志）。 */
+export type LogProtocol = "PumpFun" | "PumpSwap" | "RaydiumClmm" | "RaydiumCpmm" | "RaydiumAmm" | "OrcaWhirlpool" | "MeteoraAmm" | "MeteoraDamm";
+/** Rust `discriminator_to_name` */
+export declare function discriminatorToName(discriminator: bigint): string | undefined;
+/** Rust `discriminator_to_protocol` */
+export declare function discriminatorToProtocol(discriminator: bigint): LogProtocol | undefined;
+export type LutDiscriminatorInfo = {
+    discriminator: bigint;
+    name: string;
+    protocol: LogProtocol;
+};
+/** Rust `lookup_discriminator`（无 parser 函数指针；含 `protocol`） */
+export declare function lookupDiscriminator(discriminator: bigint): LutDiscriminatorInfo | undefined;
+/** Rust `discriminator_to_name` */
+export declare const discriminator_to_name: typeof discriminatorToName;
+/** Rust `discriminator_to_protocol` */
+export declare const discriminator_to_protocol: typeof discriminatorToProtocol;
+/** Rust `lookup_discriminator` */
+export declare const lookup_discriminator: typeof lookupDiscriminator;

package/dist/logs/discriminator_lut.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookup_discriminator = exports.discriminator_to_protocol = exports.discriminator_to_name = void 0;
+exports.discriminatorToName = discriminatorToName;
+exports.discriminatorToProtocol = discriminatorToProtocol;
+exports.lookupDiscriminator = lookupDiscriminator;
+/**
+ * 与 Rust `logs::discriminator_lut` 中的名称 / 协议查询对齐（基于 `PROGRAM_LOG_DISC`，含 PumpSwap 子表）。
+ * 不含 `parse_with_discriminator`：完整数据路径请用 `parseLogOptimized` / `parse_log_optimized`。
+ */
+const program_log_discriminators_js_1 = require("./program_log_discriminators.js");
+function protocolForProgramLogKey(key) {
+    if (key.startsWith("PUMPFUN_"))
+        return "PumpFun";
+    if (key.startsWith("PUMPSWAP_"))
+        return "PumpSwap";
+    if (key.startsWith("RAYDIUM_CLMM_"))
+        return "RaydiumClmm";
+    if (key.startsWith("RAYDIUM_CPMM_"))
+        return "RaydiumCpmm";
+    if (key.startsWith("RAYDIUM_AMM_"))
+        return "RaydiumAmm";
+    if (key.startsWith("ORCA_"))
+        return "OrcaWhirlpool";
+    if (key.startsWith("METEORA_AMM_"))
+        return "MeteoraAmm";
+    if (key.startsWith("METEORA_DAMM_"))
+        return "MeteoraDamm";
+    throw new Error(`discriminator_lut: 无法从键推断协议: ${key}`);
+}
+const NAME_BY_DISC = new Map();
+const PROTOCOL_BY_DISC = new Map();
+for (const [name, disc] of Object.entries(program_log_discriminators_js_1.PROGRAM_LOG_DISC)) {
+    NAME_BY_DISC.set(disc, name);
+    PROTOCOL_BY_DISC.set(disc, protocolForProgramLogKey(name));
+}
+/** Rust `discriminator_to_name` */
+function discriminatorToName(discriminator) {
+    return NAME_BY_DISC.get(discriminator);
+}
+/** Rust `discriminator_to_protocol` */
+function discriminatorToProtocol(discriminator) {
+    return PROTOCOL_BY_DISC.get(discriminator);
+}
+/** Rust `lookup_discriminator`（无 parser 函数指针；含 `protocol`） */
+function lookupDiscriminator(discriminator) {
+    const name = NAME_BY_DISC.get(discriminator);
+    if (name === undefined)
+        return undefined;
+    const protocol = PROTOCOL_BY_DISC.get(discriminator);
+    if (protocol === undefined)
+        return undefined;
+    return { discriminator, name, protocol };
+}
+/** Rust `discriminator_to_name` */
+exports.discriminator_to_name = discriminatorToName;
+/** Rust `discriminator_to_protocol` */
+exports.discriminator_to_protocol = discriminatorToProtocol;
+/** Rust `lookup_discriminator` */
+exports.lookup_discriminator = lookupDiscriminator;

package/dist/logs/meteora_damm.d.ts

@@ -1,6 +1,5 @@
-import { type EventMetadata } from "../core/metadata.js";
 import type { DexEvent } from "../core/dex_event.js";
-/** `EvtInitializePool`：6 个 pubkey 后接 `PoolFeeParameters`（变长 Option）再接固定尾部 109 字节 */
-export declare function parseInitializePoolEvent(data: Uint8Array, meta: EventMetadata): DexEvent | null;
-/** Meteora DAMM Program data 入口；布局与 `parseMeteoraDammInstruction` CPI 内层载荷一致（Swap/Swap2 另含日志侧 32 字节填充，见 parseSwapEvent） */
+/**
+ * Meteora DAMM Program data 入口；与 Rust `logs/meteora_damm.rs` 一致，仅解析 Swap / Swap2（其余 discriminator 不产出事件）。
+ */
 export declare function parseMeteoraDammLog(log: string, signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, grpcRecvUs: number): DexEvent | null;

package/dist/logs/meteora_damm.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseInitializePoolEvent = parseInitializePoolEvent;
 exports.parseMeteoraDammLog = parseMeteoraDammLog;
 const metadata_js_1 = require("../core/metadata.js");
 const dex_event_js_1 = require("../core/dex_event.js");
@@ -14,13 +13,6 @@ function discOf(bytes) {
 }
 const SWAP = discOf([27, 60, 21, 213, 138, 170, 187, 147]);
 const SWAP2 = discOf([189, 66, 51, 168, 38, 80, 117, 153]);
-/** 与 `instr/meteora_damm_ix.ts` CPI 内层事件 disc 一致；Program data 去掉前 8 字节后与 CPI 载荷布局相同 */
-const CREATE_POSITION = discOf([156, 15, 119, 198, 29, 181, 221, 55]);
-const CLOSE_POSITION = discOf([20, 145, 144, 68, 143, 142, 214, 178]);
-const ADD_LIQUIDITY = discOf([175, 242, 8, 157, 30, 247, 185, 169]);
-const REMOVE_LIQUIDITY = discOf([87, 46, 88, 98, 175, 96, 34, 91]);
-/** Meteora `cp-amm` `EvtInitializePool`（见 `programs/cp-amm/src/event.rs`） */
-const INITIALIZE_POOL = discOf([228, 50, 246, 85, 203, 66, 134, 37]);
 function bn64(v) {
     return v ?? 0n;
 }
@@ -133,357 +125,9 @@ function parseSwap2Event(data, meta) {
     };
     return { MeteoraDammV2Swap: ev };
 }
-function parseCreatePositionEvent(data, meta) {
-    if (data.length < 32 * 4)
-        return null;
-    let o = 0;
-    const pool = (0, binary_js_1.readPubkey)(data, o);
-    if (!pool)
-        return null;
-    o += 32;
-    const owner = (0, binary_js_1.readPubkey)(data, o);
-    if (!owner)
-        return null;
-    o += 32;
-    const position = (0, binary_js_1.readPubkey)(data, o);
-    if (!position)
-        return null;
-    o += 32;
-    const position_nft_mint = (0, binary_js_1.readPubkey)(data, o);
-    if (!position_nft_mint)
-        return null;
-    return { MeteoraDammV2CreatePosition: { metadata: meta, pool, owner, position, position_nft_mint } };
-}
-function parseClosePositionEvent(data, meta) {
-    if (data.length < 32 * 4)
-        return null;
-    let o = 0;
-    const pool = (0, binary_js_1.readPubkey)(data, o);
-    if (!pool)
-        return null;
-    o += 32;
-    const owner = (0, binary_js_1.readPubkey)(data, o);
-    if (!owner)
-        return null;
-    o += 32;
-    const position = (0, binary_js_1.readPubkey)(data, o);
-    if (!position)
-        return null;
-    o += 32;
-    const position_nft_mint = (0, binary_js_1.readPubkey)(data, o);
-    if (!position_nft_mint)
-        return null;
-    return { MeteoraDammV2ClosePosition: { metadata: meta, pool, owner, position, position_nft_mint } };
-}
-function parseAddLiquidityEvent(data, meta) {
-    if (data.length < 32 * 3 + 16 + 8 * 6)
-        return null;
-    let o = 0;
-    const pool = (0, binary_js_1.readPubkey)(data, o);
-    if (!pool)
-        return null;
-    o += 32;
-    const position = (0, binary_js_1.readPubkey)(data, o);
-    if (!position)
-        return null;
-    o += 32;
-    const owner = (0, binary_js_1.readPubkey)(data, o);
-    if (!owner)
-        return null;
-    o += 32;
-    const liquidity_delta = (0, binary_js_1.readU128LE)(data, o);
-    if (liquidity_delta === null)
-        return null;
-    o += 16;
-    const token_a_amount_threshold = (0, binary_js_1.readU64LE)(data, o);
-    if (token_a_amount_threshold === null)
-        return null;
-    o += 8;
-    const token_b_amount_threshold = (0, binary_js_1.readU64LE)(data, o);
-    if (token_b_amount_threshold === null)
-        return null;
-    o += 8;
-    const token_a_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_a_amount === null)
-        return null;
-    o += 8;
-    const token_b_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_b_amount === null)
-        return null;
-    o += 8;
-    const total_amount_a = (0, binary_js_1.readU64LE)(data, o);
-    if (total_amount_a === null)
-        return null;
-    o += 8;
-    const total_amount_b = (0, binary_js_1.readU64LE)(data, o);
-    if (total_amount_b === null)
-        return null;
-    return {
-        MeteoraDammV2AddLiquidity: {
-            metadata: meta,
-            pool,
-            position,
-            owner,
-            liquidity_delta,
-            token_a_amount_threshold,
-            token_b_amount_threshold,
-            token_a_amount,
-            token_b_amount,
-            total_amount_a,
-            total_amount_b,
-        },
-    };
-}
-function parseRemoveLiquidityEvent(data, meta) {
-    if (data.length < 32 * 3 + 16 + 8 * 4)
-        return null;
-    let o = 0;
-    const pool = (0, binary_js_1.readPubkey)(data, o);
-    if (!pool)
-        return null;
-    o += 32;
-    const position = (0, binary_js_1.readPubkey)(data, o);
-    if (!position)
-        return null;
-    o += 32;
-    const owner = (0, binary_js_1.readPubkey)(data, o);
-    if (!owner)
-        return null;
-    o += 32;
-    const liquidity_delta = (0, binary_js_1.readU128LE)(data, o);
-    if (liquidity_delta === null)
-        return null;
-    o += 16;
-    const token_a_amount_threshold = (0, binary_js_1.readU64LE)(data, o);
-    if (token_a_amount_threshold === null)
-        return null;
-    o += 8;
-    const token_b_amount_threshold = (0, binary_js_1.readU64LE)(data, o);
-    if (token_b_amount_threshold === null)
-        return null;
-    o += 8;
-    const token_a_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_a_amount === null)
-        return null;
-    o += 8;
-    const token_b_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_b_amount === null)
-        return null;
-    return {
-        MeteoraDammV2RemoveLiquidity: {
-            metadata: meta,
-            pool,
-            position,
-            owner,
-            liquidity_delta,
-            token_a_amount_threshold,
-            token_b_amount_threshold,
-            token_a_amount,
-            token_b_amount,
-        },
-    };
-}
-function bytesToHex(u8, start, len) {
-    let out = "";
-    for (let i = 0; i < len; i++)
-        out += u8[start + i].toString(16).padStart(2, "0");
-    return out;
-}
-function parseDynamicFeeParameters(data, start) {
-    let o = start;
-    const bin_step = (0, binary_js_1.readU16LE)(data, o);
-    if (bin_step === null)
-        return null;
-    o += 2;
-    const bin_step_u128 = (0, binary_js_1.readU128LE)(data, o);
-    if (bin_step_u128 === null)
-        return null;
-    o += 16;
-    const filter_period = (0, binary_js_1.readU16LE)(data, o);
-    if (filter_period === null)
-        return null;
-    o += 2;
-    const decay_period = (0, binary_js_1.readU16LE)(data, o);
-    if (decay_period === null)
-        return null;
-    o += 2;
-    const reduction_factor = (0, binary_js_1.readU16LE)(data, o);
-    if (reduction_factor === null)
-        return null;
-    o += 2;
-    const max_volatility_accumulator = (0, binary_js_1.readU32LE)(data, o);
-    if (max_volatility_accumulator === null)
-        return null;
-    o += 4;
-    const variable_fee_control = (0, binary_js_1.readU32LE)(data, o);
-    if (variable_fee_control === null)
-        return null;
-    o += 4;
-    return {
-        v: {
-            bin_step,
-            bin_step_u128,
-            filter_period,
-            decay_period,
-            reduction_factor,
-            max_volatility_accumulator,
-            variable_fee_control,
-        },
-        next: o,
-    };
-}
-function parsePoolFeeParametersParsed(data, start) {
-    let o = start;
-    if (o + 30 > data.length)
-        return null;
-    const base_fee_data = bytesToHex(data, o, 27);
-    o += 27;
-    const compounding_fee_bps = (0, binary_js_1.readU16LE)(data, o);
-    if (compounding_fee_bps === null)
-        return null;
-    o += 2;
-    const padding = (0, binary_js_1.readU8)(data, o);
-    if (padding === null)
-        return null;
-    o += 1;
-    const tag = (0, binary_js_1.readU8)(data, o);
-    if (tag === null)
-        return null;
-    o += 1;
-    let dynamic_fee = null;
-    if (tag === 1) {
-        const inner = parseDynamicFeeParameters(data, o);
-        if (!inner)
-            return null;
-        dynamic_fee = inner.v;
-        o = inner.next;
-    }
-    else if (tag !== 0)
-        return null;
-    return {
-        v: { base_fee_data, compounding_fee_bps, padding, dynamic_fee },
-        next: o,
-    };
-}
-/** `EvtInitializePool`：6 个 pubkey 后接 `PoolFeeParameters`（变长 Option）再接固定尾部 109 字节 */
-function parseInitializePoolEvent(data, meta) {
-    const minTail = 31 + 109;
-    if (data.length < 32 * 6 + minTail)
-        return null;
-    let o = 0;
-    const pool = (0, binary_js_1.readPubkey)(data, o);
-    if (!pool)
-        return null;
-    o += 32;
-    const token_a_mint = (0, binary_js_1.readPubkey)(data, o);
-    if (!token_a_mint)
-        return null;
-    o += 32;
-    const token_b_mint = (0, binary_js_1.readPubkey)(data, o);
-    if (!token_b_mint)
-        return null;
-    o += 32;
-    const creator = (0, binary_js_1.readPubkey)(data, o);
-    if (!creator)
-        return null;
-    o += 32;
-    const payer = (0, binary_js_1.readPubkey)(data, o);
-    if (!payer)
-        return null;
-    o += 32;
-    const alpha_vault = (0, binary_js_1.readPubkey)(data, o);
-    if (!alpha_vault)
-        return null;
-    o += 32;
-    const pfp = parsePoolFeeParametersParsed(data, o);
-    if (!pfp)
-        return null;
-    o = pfp.next;
-    if (o + 109 > data.length)
-        return null;
-    const sqrt_min_price = (0, binary_js_1.readU128LE)(data, o);
-    if (sqrt_min_price === null)
-        return null;
-    o += 16;
-    const sqrt_max_price = (0, binary_js_1.readU128LE)(data, o);
-    if (sqrt_max_price === null)
-        return null;
-    o += 16;
-    const activation_type = (0, binary_js_1.readU8)(data, o);
-    if (activation_type === null)
-        return null;
-    o += 1;
-    const collect_fee_mode = (0, binary_js_1.readU8)(data, o);
-    if (collect_fee_mode === null)
-        return null;
-    o += 1;
-    const liquidity = (0, binary_js_1.readU128LE)(data, o);
-    if (liquidity === null)
-        return null;
-    o += 16;
-    const sqrt_price = (0, binary_js_1.readU128LE)(data, o);
-    if (sqrt_price === null)
-        return null;
-    o += 16;
-    const activation_point = (0, binary_js_1.readU64LE)(data, o);
-    if (activation_point === null)
-        return null;
-    o += 8;
-    const token_a_flag = (0, binary_js_1.readU8)(data, o);
-    if (token_a_flag === null)
-        return null;
-    o += 1;
-    const token_b_flag = (0, binary_js_1.readU8)(data, o);
-    if (token_b_flag === null)
-        return null;
-    o += 1;
-    const token_a_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_a_amount === null)
-        return null;
-    o += 8;
-    const token_b_amount = (0, binary_js_1.readU64LE)(data, o);
-    if (token_b_amount === null)
-        return null;
-    o += 8;
-    const total_amount_a = (0, binary_js_1.readU64LE)(data, o);
-    if (total_amount_a === null)
-        return null;
-    o += 8;
-    const total_amount_b = (0, binary_js_1.readU64LE)(data, o);
-    if (total_amount_b === null)
-        return null;
-    o += 8;
-    const pool_type = (0, binary_js_1.readU8)(data, o);
-    if (pool_type === null)
-        return null;
-    return {
-        MeteoraDammV2InitializePool: {
-            metadata: meta,
-            pool,
-            token_a_mint,
-            token_b_mint,
-            creator,
-            payer,
-            alpha_vault,
-            pool_fees: pfp.v,
-            sqrt_min_price,
-            sqrt_max_price,
-            activation_type,
-            collect_fee_mode,
-            liquidity,
-            sqrt_price,
-            activation_point,
-            token_a_flag,
-            token_b_flag,
-            token_a_amount,
-            token_b_amount,
-            total_amount_a,
-            total_amount_b,
-            pool_type,
-        },
-    };
-}
-/** Meteora DAMM Program data 入口；布局与 `parseMeteoraDammInstruction` CPI 内层载荷一致（Swap/Swap2 另含日志侧 32 字节填充，见 parseSwapEvent） */
+/**
+ * Meteora DAMM Program data 入口；与 Rust `logs/meteora_damm.rs` 一致，仅解析 Swap / Swap2（其余 discriminator 不产出事件）。
+ */
 function parseMeteoraDammLog(log, signature, slot, txIndex, blockTimeUs, grpcRecvUs) {
     const programData = (0, program_data_js_1.decodeProgramDataLine)(log);
     if (!programData)
@@ -495,15 +139,5 @@ function parseMeteoraDammLog(log, signature, slot, txIndex, blockTimeUs, grpcRec
         return parseSwapEvent(data, meta);
     if (disc === SWAP2)
         return parseSwap2Event(data, meta);
-    if (disc === CREATE_POSITION)
-        return parseCreatePositionEvent(data, meta);
-    if (disc === CLOSE_POSITION)
-        return parseClosePositionEvent(data, meta);
-    if (disc === ADD_LIQUIDITY)
-        return parseAddLiquidityEvent(data, meta);
-    if (disc === REMOVE_LIQUIDITY)
-        return parseRemoveLiquidityEvent(data, meta);
-    if (disc === INITIALIZE_POOL)
-        return parseInitializePoolEvent(data, meta);
     return null;
 }

package/dist/logs/optimized_matcher.d.ts

@@ -1,5 +1,5 @@
 import type { DexEvent } from "../core/dex_event.js";
 import type { EventTypeFilter } from "../grpc/types.js";
 export declare function parseLogOptimized(log: string, signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, grpcRecvUs: number, eventTypeFilter: EventTypeFilter | undefined, isCreatedBuy: boolean, recentBlockhash?: Uint8Array): DexEvent | null;
-/** 单行日志统一解析（无 gRPC 元数据时的便捷入口） */
-export declare function parseLogUnified(log: string, signature: string, slot: number, blockTimeUs: number | undefined): DexEvent | null;
+/** 单行日志统一解析；`txIndex` 与 Rust gRPC `parse_logs(..., tx_idx, ...)` / `info.index` 对齐。 */
+export declare function parseLogUnified(log: string, signature: string, slot: number, blockTimeUs: number | undefined, txIndex?: number): DexEvent | null;

package/dist/logs/optimized_matcher.js

@@ -187,8 +187,8 @@ function parseLogOptimized(log, signature, slot, txIndex, blockTimeUs, grpcRecvU
         }
     }
 }
-/** 单行日志统一解析（无 gRPC 元数据时的便捷入口） */
-function parseLogUnified(log, signature, slot, blockTimeUs) {
+/** 单行日志统一解析；`txIndex` 与 Rust gRPC `parse_logs(..., tx_idx, ...)` / `info.index` 对齐。 */
+function parseLogUnified(log, signature, slot, blockTimeUs, txIndex = 0) {
     const grpcRecvUs = (0, clock_js_1.nowUs)();
-    return parseLogOptimized(log, signature, slot, 0, blockTimeUs, grpcRecvUs, undefined, false, undefined);
+    return parseLogOptimized(log, signature, slot, txIndex, blockTimeUs, grpcRecvUs, undefined, false, undefined);
 }

package/dist/logs/rust_aliases.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rust `logs` 模块中 `parse_*_log` / `parse_log_*` 命名风格的别名（与现有 TS 实现对应）。
+ */
+export { parseMeteoraDammLog as parse_meteora_damm_log } from "./meteora_damm.js";
+export { parseMeteoraDlmmLog as parse_meteora_dlmm_log } from "./meteora_dlmm.js";
+export { parseLogOptimized as parse_log_optimized, parseLogUnified as parse_log_unified } from "./optimized_matcher.js";

package/dist/logs/rust_aliases.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse_log_unified = exports.parse_log_optimized = exports.parse_meteora_dlmm_log = exports.parse_meteora_damm_log = void 0;
+/**
+ * Rust `logs` 模块中 `parse_*_log` / `parse_log_*` 命名风格的别名（与现有 TS 实现对应）。
+ */
+var meteora_damm_js_1 = require("./meteora_damm.js");
+Object.defineProperty(exports, "parse_meteora_damm_log", { enumerable: true, get: function () { return meteora_damm_js_1.parseMeteoraDammLog; } });
+var meteora_dlmm_js_1 = require("./meteora_dlmm.js");
+Object.defineProperty(exports, "parse_meteora_dlmm_log", { enumerable: true, get: function () { return meteora_dlmm_js_1.parseMeteoraDlmmLog; } });
+var optimized_matcher_js_1 = require("./optimized_matcher.js");
+Object.defineProperty(exports, "parse_log_optimized", { enumerable: true, get: function () { return optimized_matcher_js_1.parseLogOptimized; } });
+Object.defineProperty(exports, "parse_log_unified", { enumerable: true, get: function () { return optimized_matcher_js_1.parseLogUnified; } });

package/dist/rpc_parser.d.ts

@@ -3,6 +3,7 @@ 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";
+export { convertRpcToGrpc, convert_rpc_to_grpc, type ConvertRpcToGrpcOk, type ConvertRpcToGrpcErr, } from "./grpc/rpc_to_grpc.js";
 /**
  * 通过 RPC 拉取交易并解析：
  * 外层 + 内层编译指令 + 日志；不含账户字段填充（需另行调用 RPC 填充 API）。

package/dist/rpc_parser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyAccountFillsToLogEvents = exports.fillDataRpc = exports.fillAccountsFromTransactionDataRpc = exports.parseRpcTransaction = void 0;
+exports.convert_rpc_to_grpc = exports.convertRpcToGrpc = 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");
@@ -8,6 +8,9 @@ Object.defineProperty(exports, "parseRpcTransaction", { enumerable: true, get: f
 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; } });
+var rpc_to_grpc_js_1 = require("./grpc/rpc_to_grpc.js");
+Object.defineProperty(exports, "convertRpcToGrpc", { enumerable: true, get: function () { return rpc_to_grpc_js_1.convertRpcToGrpc; } });
+Object.defineProperty(exports, "convert_rpc_to_grpc", { enumerable: true, get: function () { return rpc_to_grpc_js_1.convert_rpc_to_grpc; } });
 /**
  * 通过 RPC 拉取交易并解析：
  * 外层 + 内层编译指令 + 日志；不含账户字段填充（需另行调用 RPC 填充 API）。

package/dist/shredstream/alt_lookup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * V0 交易：从链上拉取 ALT 账户，拼出与运行时一致的完整账户 key 列表（静态 + 查找表展开）。
+ */
+import { AddressLookupTableAccount, Connection } from "@solana/web3.js";
+import type { ShredWasmTx } from "./instruction_parse.js";
+/** 批量拉取 ALT，供同一 Entry 内多笔交易复用 */
+export declare function loadAddressLookupTableAccounts(connection: Connection, lookupTableAddresses: readonly string[]): Promise<Map<string, AddressLookupTableAccount>>;
+/** 使用已拉取的 ALT 构造完整账户表（base58）；失败时退回仅静态表 */
+export declare function fullAccountKeyStringsFromShredTx(tx: ShredWasmTx, altByAddress: Map<string, AddressLookupTableAccount>): string[];

package/dist/shredstream/alt_lookup.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAddressLookupTableAccounts = loadAddressLookupTableAccounts;
+exports.fullAccountKeyStringsFromShredTx = fullAccountKeyStringsFromShredTx;
+/**
+ * V0 交易：从链上拉取 ALT 账户，拼出与运行时一致的完整账户 key 列表（静态 + 查找表展开）。
+ */
+const web3_js_1 = require("@solana/web3.js");
+const bs58_1 = __importDefault(require("bs58"));
+/** 批量拉取 ALT，供同一 Entry 内多笔交易复用 */
+async function loadAddressLookupTableAccounts(connection, lookupTableAddresses) {
+    const map = new Map();
+    if (lookupTableAddresses.length === 0)
+        return map;
+    const pks = lookupTableAddresses.map((s) => new web3_js_1.PublicKey(s));
+    const infos = await connection.getMultipleAccountsInfo(pks);
+    for (let i = 0; i < pks.length; i++) {
+        const info = infos[i];
+        if (!info?.data)
+            continue;
+        const state = web3_js_1.AddressLookupTableAccount.deserialize(info.data);
+        const alt = new web3_js_1.AddressLookupTableAccount({ key: pks[i], state });
+        map.set(pks[i].toBase58(), alt);
+    }
+    return map;
+}
+/** 使用已拉取的 ALT 构造完整账户表（base58）；失败时退回仅静态表 */
+function fullAccountKeyStringsFromShredTx(tx, altByAddress) {
+    if (tx.messageVersion !== "v0" || !tx.addressTableLookups?.length) {
+        return tx.accounts;
+    }
+    const lookups = tx.addressTableLookups;
+    const altAccounts = [];
+    for (const l of lookups) {
+        const alt = altByAddress.get(l.accountKey);
+        if (!alt) {
+            return tx.accounts;
+        }
+        altAccounts.push(alt);
+    }
+    const header = tx.header;
+    const rb = tx.recentBlockhash;
+    if (!header || !rb || rb.length !== 32) {
+        return tx.accounts;
+    }
+    const msg = new web3_js_1.MessageV0({
+        header,
+        staticAccountKeys: tx.accounts.map((s) => new web3_js_1.PublicKey(s)),
+        recentBlockhash: bs58_1.default.encode(rb),
+        compiledInstructions: (tx.instructions ?? []).map((ix) => ({
+            programIdIndex: ix.programIdIndex,
+            accountKeyIndexes: Array.from(ix.accounts),
+            data: Buffer.from(ix.data),
+        })),
+        addressTableLookups: lookups.map((l) => ({
+            accountKey: new web3_js_1.PublicKey(l.accountKey),
+            writableIndexes: Array.from(l.writableIndexes),
+            readonlyIndexes: Array.from(l.readonlyIndexes),
+        })),
+    });
+    const keys = msg.getAccountKeys({ addressLookupTableAccounts: altAccounts });
+    const out = [];
+    for (let i = 0; i < keys.length; i++) {
+        out.push(keys.get(i).toBase58());
+    }
+    return out;
+}