sol-parser-sdk 0.5.14 → 0.5.16

package/dist/logs/pump.js

@@ -171,6 +171,8 @@ function parseTradeFromData(data, metadata, isCreatedBuy) {
     const quote_amount = readOptionalU64(data, tail);
     const virtual_quote_reserves = readOptionalU64(data, tail);
     const real_quote_reserves = readOptionalU64(data, tail);
+    const holder_rewards_bps = readOptionalU64(data, tail);
+    const holder_rewards = readOptionalU64(data, tail);
     const trade = {
         metadata,
         mint,
@@ -206,6 +208,8 @@ function parseTradeFromData(data, metadata, isCreatedBuy) {
         quote_amount,
         virtual_quote_reserves,
         real_quote_reserves,
+        holder_rewards_bps,
+        holder_rewards,
         is_cashback_coin: cashback_fee_basis_points > 0n,
         bonding_curve: (0, dex_event_js_1.defaultPubkey)(),
         associated_bonding_curve: (0, dex_event_js_1.defaultPubkey)(),
@@ -274,6 +278,10 @@ function parseCreateFromData(data, metadata) {
     const quote_mint = normalizePumpfunQuoteMint(o + 32 <= data.length ? (0, binary_js_1.readPubkey)(data, o) : (0, dex_event_js_1.defaultPubkey)());
     o += 32;
     const virtual_quote_reserves = o + 8 <= data.length ? bnU64((0, binary_js_1.readU64LE)(data, o)) : 0n;
+    o += 8;
+    const creator_fee_bps = o + 8 <= data.length ? bnU64((0, binary_js_1.readU64LE)(data, o)) : 0n;
+    o += 8;
+    const is_holder_reward = (0, binary_js_1.readBool)(data, o) ?? false;
     const ev = {
         metadata,
         name: n1.s,
@@ -295,6 +303,8 @@ function parseCreateFromData(data, metadata) {
         quote_vault: (0, dex_event_js_1.defaultPubkey)(),
         quote_token_program: (0, dex_event_js_1.defaultPubkey)(),
         virtual_quote_reserves,
+        creator_fee_bps,
+        is_holder_reward,
         ix_name: "create",
     };
     return { PumpFunCreate: ev };

package/dist/logs/pump_amm.js

@@ -26,6 +26,8 @@ function emptyTradeTail() {
         virtual_quote_reserves: 0n,
         can_boost: false,
         base_supply: 0n,
+        holder_rewards_bps: 0n,
+        holder_rewards: 0n,
     };
 }
 function parseTradeTail(data) {
@@ -55,6 +57,12 @@ function parseTradeTail(data) {
         return null;
     tail.can_boost = canBoost === 1;
     tail.base_supply = bn64((0, binary_js_1.readU64LE)(data, 49));
+    if (data.length !== 57 && data.length < 73)
+        return null;
+    if (data.length >= 73) {
+        tail.holder_rewards_bps = bn64((0, binary_js_1.readU64LE)(data, 57));
+        tail.holder_rewards = bn64((0, binary_js_1.readU64LE)(data, 65));
+    }
     return tail;
 }
 function readStrictBorshString(data, offset) {
@@ -188,6 +196,8 @@ function parseBuyFromData(data, metadata) {
         virtual_quote_reserves: tail.virtual_quote_reserves,
         can_boost: tail.can_boost,
         base_supply: tail.base_supply,
+        holder_rewards_bps: tail.holder_rewards_bps,
+        holder_rewards: tail.holder_rewards,
         is_pump_pool: false,
         base_mint: ZP,
         quote_mint: ZP,
@@ -286,6 +296,8 @@ function parseSellFromData(data, metadata) {
         virtual_quote_reserves: tail.virtual_quote_reserves,
         can_boost: tail.can_boost,
         base_supply: tail.base_supply,
+        holder_rewards_bps: tail.holder_rewards_bps,
+        holder_rewards: tail.holder_rewards,
         is_pump_pool: false,
         base_mint: ZP,
         quote_mint: ZP,
@@ -299,9 +311,11 @@ function parseSellFromData(data, metadata) {
     return { PumpSwapSell: ev };
 }
 function parseCreatePoolFromData(data, metadata) {
-    const REQUIRED = 8 + 2 + 32 * 6 + 2 + 8 * 7 + 1;
+    const REQUIRED = 326;
     if (data.length < REQUIRED)
         return null;
+    if (data.length !== REQUIRED && data.length < 335)
+        return null;
     let o = 0;
     const timestamp = bnI64((0, binary_js_1.readI64LE)(data, o));
     o += 8;
@@ -344,6 +358,9 @@ function parseCreatePoolFromData(data, metadata) {
     const coin_creator = (0, binary_js_1.readPubkey)(data, o);
     o += 32;
     const is_mayhem_mode = data.length > 325 && (0, binary_js_1.readBool)(data, 325) === true;
+    const creator_fee_bps = data.length >= 334 ? bn64((0, binary_js_1.readU64LE)(data, 326)) : 0n;
+    const can_edit_creator_fee = data.length > 334 && (0, binary_js_1.readBool)(data, 334) === true;
+    const is_holder_reward = data.length > 335 && (0, binary_js_1.readBool)(data, 335) === true;
     const ev = {
         metadata,
         timestamp,
@@ -367,6 +384,10 @@ function parseCreatePoolFromData(data, metadata) {
         user_quote_token_account,
         coin_creator,
         is_mayhem_mode,
+        is_cashback_coin: false,
+        creator_fee_bps,
+        can_edit_creator_fee,
+        is_holder_reward,
     };
     return { PumpSwapCreatePool: ev };
 }

package/dist/logs/raydium_launchlab.js

@@ -19,12 +19,18 @@ function bn64(v) {
     return v ?? 0n;
 }
 function parseRaydiumLaunchlabTradeFromData(data, metadata) {
+    if (data.length !== 139 || data[136] > 1 || data[137] > 2 || data[138] > 1)
+        return null;
     const pool_state = (0, binary_js_1.readPubkey)(data, 0);
     const amount_in = (0, binary_js_1.readU64LE)(data, 88);
     const amount_out = (0, binary_js_1.readU64LE)(data, 96);
     const trade_direction = (0, binary_js_1.readU8)(data, 136);
     const exact_in = (0, binary_js_1.readBool)(data, 138);
-    if (!pool_state || amount_in === null || amount_out === null || trade_direction === null || exact_in === null) {
+    if (!pool_state ||
+        amount_in === null ||
+        amount_out === null ||
+        trade_direction === null ||
+        exact_in === null) {
         return null;
     }
     const is_buy = trade_direction === 0;
@@ -36,6 +42,18 @@ function parseRaydiumLaunchlabTradeFromData(data, metadata) {
         amount_out: bn64(amount_out),
         is_buy,
         trade_direction: is_buy ? "Buy" : "Sell",
+        total_base_sell: (0, binary_js_1.readU64LE)(data, 32),
+        virtual_base: (0, binary_js_1.readU64LE)(data, 40),
+        virtual_quote: (0, binary_js_1.readU64LE)(data, 48),
+        real_base_before: (0, binary_js_1.readU64LE)(data, 56),
+        real_quote_before: (0, binary_js_1.readU64LE)(data, 64),
+        real_base_after: (0, binary_js_1.readU64LE)(data, 72),
+        real_quote_after: (0, binary_js_1.readU64LE)(data, 80),
+        protocol_fee: (0, binary_js_1.readU64LE)(data, 104),
+        platform_fee: (0, binary_js_1.readU64LE)(data, 112),
+        creator_fee: (0, binary_js_1.readU64LE)(data, 120),
+        share_fee: (0, binary_js_1.readU64LE)(data, 128),
+        pool_status: ["Fund", "Migrate", "Trade"][data[137]],
         exact_in,
     };
     return { RaydiumLaunchlabTrade: ev };

package/dist/rpc_transaction.d.ts

@@ -13,9 +13,10 @@ export declare function applyAccountFillsToLogEvents(events: DexEvent[], msg: Me
  * 解析已获取的 `VersionedTransactionResponse`（顺序：指令 → 日志 → 账户/数据填充）。
  */
 export declare function parseRpcTransaction(tx: VersionedTransactionResponse, signature: string, filter?: EventTypeFilter, options?: {
-    grpcRecvUs?: number;
-    txIndex?: number;
-    blockTimeUs?: number;
+    slot?: bigint | string | number;
+    grpcRecvUs?: bigint | string | number;
+    txIndex?: bigint | string | number;
+    blockTimeUs?: bigint | string | number;
 }): {
     ok: true;
     events: DexEvent[];

package/dist/rpc_transaction.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fillDataRpc = exports.fillAccountsFromTransactionDataRpc = void 0;
 exports.applyAccountFillsToLogEvents = applyAccountFillsToLogEvents;
 exports.parseRpcTransaction = parseRpcTransaction;
+const metadata_js_1 = require("./core/metadata.js");
 /**
  * RPC 交易解析：外层 + 内层指令 → 日志 → `fillAccountsFromTransactionDataRpc` → `fillDataRpc`。
  */
@@ -483,8 +484,8 @@ function parseRpcTransaction(tx, signature, filter, options) {
         };
     }
     const meta = tx.meta ?? null;
-    const slot = tx.slot;
-    const blockTimeUs = options?.blockTimeUs ?? (tx.blockTime != null ? tx.blockTime * 1_000_000 : undefined);
+    const slot = (0, metadata_js_1.exactU64)(options?.slot ?? tx.slot, "slot");
+    const blockTimeUs = options?.blockTimeUs ?? (tx.blockTime != null ? (0, metadata_js_1.exactI64)(tx.blockTime) * 1000000n : undefined);
     const grpcRecvUs = options?.grpcRecvUs ?? Math.floor(Date.now() * 1000);
     const txIndex = options?.txIndex ?? 0;
     const rb = recentBlockhashBytes(msg.recentBlockhash);

package/dist/shredstream/client.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ShredStreamClient = exports.ShredEventQueue = void 0;
+const metadata_js_1 = require("../core/metadata.js");
 /**
  * ShredStream 客户端：与 Rust `shredstream/client.rs` 对齐（gRPC + bincode 解码 + `parseTransactionEvents`）。
  */
@@ -120,7 +121,7 @@ function setGrpcRecvUsMut(event, grpcRecvUs) {
         return;
     const inner = event[key];
     if (inner?.metadata)
-        inner.metadata.grpc_recv_us = grpcRecvUs;
+        inner.metadata.grpc_recv_us = (0, metadata_js_1.exactI64)(grpcRecvUs);
 }
 class ShredStreamClient {
     endpoint;
@@ -394,10 +395,5 @@ class ShredStreamClient {
 }
 exports.ShredStreamClient = ShredStreamClient;
 function toSlotNumber(slot) {
-    if (typeof slot === "number")
-        return slot;
-    if (typeof slot === "bigint")
-        return Number(slot);
-    const n = Number(slot);
-    return Number.isFinite(n) ? Math.floor(n) : 0;
+    return (0, metadata_js_1.exactU64)(slot, "ShredStream slot");
 }

package/dist/shredstream/entries_decode.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bincodeVecEntryCount = bincodeVecEntryCount;
 exports.decodeCompactU16 = decodeCompactU16;
@@ -6,6 +9,8 @@ exports.parseTransaction = parseTransaction;
 exports.decodeEntriesBincodeFlat = decodeEntriesBincodeFlat;
 exports.decodeEntriesBincodeNested = decodeEntriesBincodeNested;
 exports.decodeShredstreamEntriesBincode = decodeShredstreamEntriesBincode;
+const bs58_1 = __importDefault(require("bs58"));
+const wire_transaction_js_1 = require("../wire_transaction.js");
 const wire_to_shred_tx_js_1 = require("./wire_to_shred_tx.js");
 const MAX_VEC_ENTRIES = 100_000;
 function readU64LE(buf, offset) {
@@ -43,94 +48,13 @@ function decodeCompactU16(buf, pos) {
 }
 /** 返回 (txWireLength, signatures)；失败返回 null */
 function parseTransaction(buf, pos) {
-    const start = pos;
-    if (pos >= buf.length)
-        return null;
-    const sigCountEnc = decodeCompactU16(buf, pos);
-    if (!sigCountEnc)
-        return null;
-    let p = pos + sigCountEnc.bytes;
-    const sigCount = sigCountEnc.value;
-    const sigsEnd = p + sigCount * 64;
-    if (sigsEnd > buf.length)
-        return null;
-    const sigs = [];
-    for (let i = 0; i < sigCount; i++) {
-        sigs.push(buf.subarray(p, p + 64));
-        p += 64;
+    try {
+        const { transaction, length } = (0, wire_transaction_js_1.decodeWireTransaction)(buf, pos, false);
+        return { txLen: length, sigs: transaction.signatures.map(s => bs58_1.default.decode(s)) };
     }
-    if (p >= buf.length)
-        return null;
-    const msgFirst = buf[p];
-    const isV0 = msgFirst >= 0x80;
-    if (isV0)
-        p += 1;
-    p += 3;
-    if (p > buf.length)
-        return null;
-    const acctEnc = decodeCompactU16(buf, p);
-    if (!acctEnc)
-        return null;
-    p += acctEnc.bytes;
-    p += acctEnc.value * 32;
-    if (p > buf.length)
-        return null;
-    p += 32;
-    if (p > buf.length)
-        return null;
-    const ixCountEnc = decodeCompactU16(buf, p);
-    if (!ixCountEnc)
+    catch {
         return null;
-    p += ixCountEnc.bytes;
-    const ixCount = ixCountEnc.value;
-    for (let ix = 0; ix < ixCount; ix++) {
-        p += 1;
-        if (p > buf.length)
-            return null;
-        const acctLenEnc = decodeCompactU16(buf, p);
-        if (!acctLenEnc)
-            return null;
-        p += acctLenEnc.bytes;
-        p += acctLenEnc.value;
-        if (p > buf.length)
-            return null;
-        const dataLenEnc = decodeCompactU16(buf, p);
-        if (!dataLenEnc)
-            return null;
-        p += dataLenEnc.bytes;
-        p += dataLenEnc.value;
-        if (p > buf.length)
-            return null;
-    }
-    if (isV0) {
-        if (p >= buf.length)
-            return null;
-        const atlCountEnc = decodeCompactU16(buf, p);
-        if (!atlCountEnc)
-            return null;
-        p += atlCountEnc.bytes;
-        const atlCount = atlCountEnc.value;
-        for (let atl = 0; atl < atlCount; atl++) {
-            p += 32;
-            if (p > buf.length)
-                return null;
-            const wLenEnc = decodeCompactU16(buf, p);
-            if (!wLenEnc)
-                return null;
-            p += wLenEnc.bytes;
-            p += wLenEnc.value;
-            if (p > buf.length)
-                return null;
-            const rLenEnc = decodeCompactU16(buf, p);
-            if (!rLenEnc)
-                return null;
-            p += rLenEnc.bytes;
-            p += rLenEnc.value;
-            if (p > buf.length)
-                return null;
-        }
     }
-    return { txLen: p - start, sigs };
 }
 class BatchDecoder {
     buffer = new Uint8Array(0);

package/dist/shredstream/instruction_parse.d.ts

@@ -21,7 +21,7 @@ export type ShredWasmTx = {
     accounts: string[];
     instructions?: ShredWasmCompiledIx[];
     /** 缺省则按仅静态账户处理 */
-    messageVersion?: "legacy" | "v0";
+    messageVersion?: "legacy" | "v0" | "v1";
     header?: MessageHeader;
     recentBlockhash?: Uint8Array;
     addressTableLookups?: ShredAddressTableLookup[];
@@ -29,6 +29,6 @@ export type ShredWasmTx = {
 /**
  * 使用已解析的完整账户表（静态+ALT）解析外层指令。
  */
-export declare function dexEventsFromShredWasmTxWithFullKeys(tx: ShredWasmTx, fullAccountKeys: string[], slot: number, txIndex: number, grpcRecvUs: number, eventTypeFilter?: EventTypeFilter): DexEvent[];
+export declare function dexEventsFromShredWasmTxWithFullKeys(tx: ShredWasmTx, fullAccountKeys: string[], slot: number | bigint | string, txIndex: number | bigint | string, grpcRecvUs: number | bigint | string, eventTypeFilter?: EventTypeFilter): DexEvent[];
 /** 仅静态账户表（无 RPC 时；V0+ALT 缺失账户以默认 pubkey 占位） */
-export declare function dexEventsFromShredWasmTx(tx: ShredWasmTx, slot: number, txIndex: number, grpcRecvUs: number, eventTypeFilter?: EventTypeFilter): DexEvent[];
+export declare function dexEventsFromShredWasmTx(tx: ShredWasmTx, slot: number | bigint | string, txIndex: number | bigint | string, grpcRecvUs: number | bigint | string, eventTypeFilter?: EventTypeFilter): DexEvent[];

package/dist/shredstream/proto_types.d.ts

@@ -4,6 +4,6 @@
  */
 export type SubscribeEntriesRequest = Record<string, never>;
 export interface ShredstreamEntryMessage {
-    slot: number | string | bigint;
+    slot: number | bigint | string | string | bigint;
     entries: Uint8Array | Buffer;
 }

package/dist/shredstream/wire_to_shred_tx.d.ts

@@ -1,2 +1,2 @@
-import type { ShredWasmTx } from "./instruction_parse.js";
+import type { ShredWasmTx } from './instruction_parse.js';
 export declare function wireBytesToShredWasmTx(raw: Uint8Array): ShredWasmTx | null;

package/dist/shredstream/wire_to_shred_tx.js

@@ -4,54 +4,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wireBytesToShredWasmTx = wireBytesToShredWasmTx;
-/**
- * 线格式交易字节 → `ShredWasmTx`（与原 wasm-pack 展开字段对齐，供 `parseInstructionUnified`）。
- */
-const web3_js_1 = require("@solana/web3.js");
+/** Native wire decoding shared with RPC routes, including V1 without ALT. */
 const bs58_1 = __importDefault(require("bs58"));
+const wire_transaction_js_1 = require("../wire_transaction.js");
 function wireBytesToShredWasmTx(raw) {
     try {
-        const vt = web3_js_1.VersionedTransaction.deserialize(Buffer.from(raw));
-        const sig0 = vt.signatures[0];
-        if (!sig0)
+        const { transaction: tx } = (0, wire_transaction_js_1.decodeWireTransaction)(raw), msg = tx.message;
+        if (!tx.signatures[0])
             return null;
-        const signature = bs58_1.default.encode(sig0);
-        const msg = vt.message;
-        if (msg instanceof web3_js_1.MessageV0) {
-            const lookups = msg.addressTableLookups.map((l) => ({
-                accountKey: l.accountKey.toBase58(),
-                writableIndexes: new Uint8Array(l.writableIndexes),
-                readonlyIndexes: new Uint8Array(l.readonlyIndexes),
-            }));
-            const instructions = msg.compiledInstructions.map((ix) => ({
-                programIdIndex: ix.programIdIndex,
-                accounts: new Uint8Array(ix.accountKeyIndexes),
-                data: new Uint8Array(ix.data),
-            }));
-            return {
-                signature,
-                accounts: msg.staticAccountKeys.map((k) => k.toBase58()),
-                instructions,
-                messageVersion: "v0",
-                header: msg.header,
-                recentBlockhash: Uint8Array.from(bs58_1.default.decode(msg.recentBlockhash)),
-                addressTableLookups: lookups,
-            };
-        }
-        const m = msg;
-        const instructions = m.compiledInstructions.map((ix) => ({
-            programIdIndex: ix.programIdIndex,
-            accounts: new Uint8Array(ix.accountKeyIndexes),
-            data: new Uint8Array(ix.data),
-        }));
-        return {
-            signature,
-            accounts: m.staticAccountKeys.map((k) => k.toBase58()),
-            instructions,
-            messageVersion: "legacy",
-            header: m.header,
-            recentBlockhash: Uint8Array.from(bs58_1.default.decode(m.recentBlockhash)),
-        };
+        return { signature: tx.signatures[0], accounts: msg.accountKeys,
+            instructions: msg.instructions.map(ix => ({ programIdIndex: ix.programIdIndex, accounts: Uint8Array.from(ix.accounts), data: bs58_1.default.decode(ix.data) })),
+            messageVersion: tx.version === 'legacy' ? 'legacy' : tx.version === 0 ? 'v0' : 'v1', header: msg.header,
+            recentBlockhash: bs58_1.default.decode(msg.recentBlockhash),
+            addressTableLookups: msg.addressTableLookups.map(l => ({ ...l, writableIndexes: Uint8Array.from(l.writableIndexes), readonlyIndexes: Uint8Array.from(l.readonlyIndexes) })) };
     }
     catch {
         return null;

package/dist/simulation_route.d.ts

@@ -0,0 +1,6 @@
+import { type TransactionRoute } from "./transaction_route.js";
+/** Original wire plus simulateTransaction response. Parsed SPL transfers and ATA setup.
+ * Unsupported parsed CPI fail explicitly; raw/compiled CPI are preserved.
+ * V0 ALT requires the existing compiled route API and loadedAddresses.
+ */
+export declare function analyzeSimulationRoutes(wire: Uint8Array, response: unknown, graduatedPools?: readonly string[]): TransactionRoute;