sol-parser-sdk 0.5.9

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_launchlab.d.ts

@@ -0,0 +1,10 @@
+/** Raydium LaunchLab 日志解析 */
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+export declare const RAYDIUM_LAUNCHLAB_DISC: {
+    TRADE: bigint;
+    POOL_CREATE: bigint;
+};
+export declare function parseRaydiumLaunchlabTradeFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseRaydiumLaunchlabPoolCreateFromData(data: Uint8Array, metadata: EventMetadata): DexEvent | null;
+export declare function parseRaydiumLaunchlabFromDiscriminator(discriminator: bigint, data: Uint8Array, metadata: EventMetadata): DexEvent | null;

package/dist/logs/raydium_launchlab.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAYDIUM_LAUNCHLAB_DISC = void 0;
+exports.parseRaydiumLaunchlabTradeFromData = parseRaydiumLaunchlabTradeFromData;
+exports.parseRaydiumLaunchlabPoolCreateFromData = parseRaydiumLaunchlabPoolCreateFromData;
+exports.parseRaydiumLaunchlabFromDiscriminator = parseRaydiumLaunchlabFromDiscriminator;
+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.RAYDIUM_LAUNCHLAB_DISC = {
+    TRADE: disc([189, 219, 127, 211, 78, 230, 97, 238]),
+    POOL_CREATE: disc([151, 215, 226, 9, 118, 161, 115, 174]),
+};
+function bn64(v) {
+    return v ?? 0n;
+}
+function parseRaydiumLaunchlabTradeFromData(data, metadata) {
+    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) {
+        return null;
+    }
+    const is_buy = trade_direction === 0;
+    const ev = {
+        metadata,
+        pool_state,
+        user: "11111111111111111111111111111111",
+        amount_in: bn64(amount_in),
+        amount_out: bn64(amount_out),
+        is_buy,
+        trade_direction: is_buy ? "Buy" : "Sell",
+        exact_in,
+    };
+    return { RaydiumLaunchlabTrade: ev };
+}
+function parseRaydiumLaunchlabPoolCreateFromData(data, metadata) {
+    if (data.length < 97)
+        return null;
+    let o = 0;
+    const pool_state = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const creator = (0, binary_js_1.readPubkey)(data, o);
+    o += 32;
+    const config = (0, binary_js_1.readPubkey)(data, o);
+    if (!pool_state || !creator || !config)
+        return null;
+    o += 32;
+    const decimals = (0, binary_js_1.readU8)(data, o);
+    if (decimals === null)
+        return null;
+    o += 1;
+    const name = (0, binary_js_1.readBorshString)(data, o);
+    if (!name)
+        return null;
+    o = name.next;
+    const symbol = (0, binary_js_1.readBorshString)(data, o);
+    if (!symbol)
+        return null;
+    o = symbol.next;
+    const uri = (0, binary_js_1.readBorshString)(data, o);
+    if (!uri)
+        return null;
+    const ev = {
+        metadata,
+        base_mint_param: { symbol: symbol.s, name: name.s, uri: uri.s, decimals },
+        pool_state,
+        creator,
+    };
+    return { RaydiumLaunchlabPoolCreate: ev };
+}
+function parseRaydiumLaunchlabFromDiscriminator(discriminator, data, metadata) {
+    if (discriminator === exports.RAYDIUM_LAUNCHLAB_DISC.TRADE)
+        return parseRaydiumLaunchlabTradeFromData(data, metadata);
+    if (discriminator === exports.RAYDIUM_LAUNCHLAB_DISC.POOL_CREATE)
+        return parseRaydiumLaunchlabPoolCreateFromData(data, metadata);
+    return null;
+}

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/logs/rust_aliases.d.ts

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

package/dist/logs/rust_aliases.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse_log_unified = exports.parse_log_optimized_with_program_id = exports.parse_log_optimized = exports.parse_meteora_dlmm_log = exports.parse_meteora_dbc_from_discriminator = 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_dbc_js_1 = require("./meteora_dbc.js");
+Object.defineProperty(exports, "parse_meteora_dbc_from_discriminator", { enumerable: true, get: function () { return meteora_dbc_js_1.parseMeteoraDbcFromDiscriminator; } });
+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_optimized_with_program_id", { enumerable: true, get: function () { return optimized_matcher_js_1.parseLogOptimizedWithProgramId; } });
+Object.defineProperty(exports, "parse_log_unified", { enumerable: true, get: function () { return optimized_matcher_js_1.parseLogUnified; } });

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,17 @@
+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";
+export { convertRpcToGrpc, convert_rpc_to_grpc, type ConvertRpcToGrpcOk, type ConvertRpcToGrpcErr, } from "./grpc/rpc_to_grpc.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,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+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; } });
+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）。
+ */
+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,27 @@
+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;
+    txIndex?: number;
+    blockTimeUs?: 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";