sol-parser-sdk 0.5.14 → 0.5.16

package/dist/core/dex_event.d.ts

@@ -1,6 +1,11 @@
+import type { RawAccountSnapshotEvent, LiquidityAccountSnapshotEvent } from '../liquidity_snapshot.js';
 import type { EventMetadata } from "./metadata.js";
 /** 统一 DEX 事件：外部标签 JSON（单键对象）；键名清单见 `scripts/dex-event-variant-names.json` */
 export type DexEvent = {
+    RawAccountSnapshot: RawAccountSnapshotEvent;
+} | {
+    LiquidityAccountSnapshot: LiquidityAccountSnapshotEvent;
+} | {
     PumpFunCreate: PumpFunCreateTokenEvent;
 } | {
     PumpFunCreateV2: PumpFunCreateV2TokenEvent;
@@ -130,6 +135,14 @@ export type DexEvent = {
     MeteoraDammV2InitializePool: MeteoraDammV2InitializePoolEvent;
 } | {
     MeteoraDammV2ClosePosition: MeteoraDammV2ClosePositionEvent;
+} | {
+    MeteoraDammV2UpdateDelegatePermission: MeteoraDammV2UpdateDelegatePermissionEvent;
+} | {
+    MeteoraDammV2WithdrawDeadLiquidityReward: MeteoraDammV2WithdrawDeadLiquidityRewardEvent;
+} | {
+    MeteoraDammV2CreateConfig: MeteoraDammV2CreateConfigEvent;
+} | {
+    MeteoraDammV2CreateDynamicConfig: MeteoraDammV2CreateDynamicConfigEvent;
 } | {
     MeteoraDbcSwap: MeteoraDbcSwapEvent;
 } | {
@@ -226,6 +239,8 @@ export interface PumpFunCreateTokenEvent {
     quote_vault: string;
     quote_token_program: string;
     virtual_quote_reserves: bigint;
+    creator_fee_bps: bigint;
+    is_holder_reward: boolean;
     ix_name: string;
 }
 export interface PumpFunCreateV2TokenEvent extends PumpFunCreateTokenEvent {
@@ -278,6 +293,8 @@ export interface PumpFunTradeEvent {
     quote_amount?: bigint;
     virtual_quote_reserves?: bigint;
     real_quote_reserves?: bigint;
+    holder_rewards_bps: bigint;
+    holder_rewards: bigint;
     is_cashback_coin: boolean;
     amount?: bigint;
     max_sol_cost?: bigint;
@@ -285,6 +302,12 @@ export interface PumpFunTradeEvent {
     spendable_sol_in?: bigint;
     spendable_quote_in?: bigint;
     min_tokens_out?: bigint;
+    /** User base-mint token balance before tx; absent when meta unavailable (e.g. ShredStream). */
+    pre_token_balance?: bigint | null;
+    post_token_balance?: bigint | null;
+    /** User native SOL lamports before/after tx. */
+    pre_sol_balance?: bigint | null;
+    post_sol_balance?: bigint | null;
     global?: string;
     bonding_curve: string;
     bonding_curve_v2?: string;
@@ -485,6 +508,8 @@ export interface PumpSwapBuyEvent {
     virtual_quote_reserves: bigint;
     can_boost: boolean;
     base_supply: bigint;
+    holder_rewards_bps: bigint;
+    holder_rewards: bigint;
     /** 由 fees 指令数据填充（见 `fillDataRpc`） */
     is_pump_pool: boolean;
     /** 自指令账户填充（account_fillers/pumpswap） */
@@ -532,6 +557,8 @@ export interface PumpSwapSellEvent {
     virtual_quote_reserves: bigint;
     can_boost: boolean;
     base_supply: bigint;
+    holder_rewards_bps: bigint;
+    holder_rewards: bigint;
     is_pump_pool: boolean;
     base_mint: string;
     quote_mint: string;
@@ -568,6 +595,10 @@ export interface PumpSwapCreatePoolEvent {
     user_quote_token_account: string;
     coin_creator: string;
     is_mayhem_mode: boolean;
+    is_cashback_coin: boolean;
+    creator_fee_bps: bigint;
+    can_edit_creator_fee: boolean;
+    is_holder_reward: boolean;
 }
 export interface PumpSwapLiquidityAdded {
     metadata: EventMetadata;
@@ -1060,6 +1091,19 @@ export interface MeteoraDammV2SwapEvent {
     referral_fee: bigint;
     actual_amount_in: bigint;
     current_timestamp: bigint;
+    collect_fee_mode?: number;
+    amount_0?: bigint;
+    amount_1?: bigint;
+    swap_mode?: number;
+    excluded_fee_input_amount?: bigint;
+    amount_left?: bigint;
+    claiming_fee?: bigint;
+    compounding_fee?: bigint;
+    included_transfer_fee_amount_in?: bigint;
+    included_transfer_fee_amount_out?: bigint;
+    excluded_transfer_fee_amount_out?: bigint;
+    reserve_a_amount?: bigint;
+    reserve_b_amount?: bigint;
     token_a_vault: string;
     token_b_vault: string;
     token_a_mint: string;
@@ -1080,6 +1124,8 @@ export interface MeteoraDammV2AddLiquidityEvent {
     token_b_amount_threshold: bigint;
     total_amount_a: bigint;
     total_amount_b: bigint;
+    reserve_a_amount?: bigint;
+    reserve_b_amount?: bigint;
 }
 /** 与 `MeteoraDammV2RemoveLiquidityEvent` 对齐；Go/Python 中 `liquidity_delta` 为十进制字符串。 */
 export interface MeteoraDammV2RemoveLiquidityEvent {
@@ -1092,6 +1138,10 @@ export interface MeteoraDammV2RemoveLiquidityEvent {
     liquidity_delta: bigint;
     token_a_amount_threshold: bigint;
     token_b_amount_threshold: bigint;
+    total_amount_a?: bigint;
+    total_amount_b?: bigint;
+    reserve_a_amount?: bigint;
+    reserve_b_amount?: bigint;
 }
 /** 与 `MeteoraDammV2CreatePositionEvent` 对齐 */
 export interface MeteoraDammV2CreatePositionEvent {
@@ -1135,6 +1185,56 @@ export interface MeteoraDammV2ClosePositionEvent {
     position: string;
     position_nft_mint: string;
 }
+/** Nested dynamic fee parameters from DAMM v2 `PoolFeeParameters`. */
+export interface MeteoraDammV2DynamicFeeParameters {
+    bin_step: number;
+    bin_step_u128: bigint;
+    filter_period: number;
+    decay_period: number;
+    reduction_factor: number;
+    max_volatility_accumulator: number;
+    variable_fee_control: number;
+}
+/** IDL `EvtUpdateDelegatePermission` */
+export interface MeteoraDammV2UpdateDelegatePermissionEvent {
+    metadata: EventMetadata;
+    position: string;
+    owner: string;
+    permission: number;
+    delegate: string | null;
+}
+/** IDL `EvtWithdrawDeadLiquidityReward` */
+export interface MeteoraDammV2WithdrawDeadLiquidityRewardEvent {
+    metadata: EventMetadata;
+    pool: string;
+    reward_mint: string;
+    amount: bigint;
+}
+/** IDL `EvtCreateConfig` (includes DAMM v2 0.2.4 `permission`) */
+export interface MeteoraDammV2CreateConfigEvent {
+    metadata: EventMetadata;
+    base_fee_data: Uint8Array | number[];
+    compounding_fee_bps: number;
+    padding: number;
+    dynamic_fee: MeteoraDammV2DynamicFeeParameters | null;
+    vault_config_key: string;
+    pool_creator_authority: string;
+    activation_type: number;
+    sqrt_min_price: bigint;
+    sqrt_max_price: bigint;
+    collect_fee_mode: number;
+    index: bigint;
+    config: string;
+    permission: bigint;
+}
+/** IDL `EvtCreateDynamicConfig` */
+export interface MeteoraDammV2CreateDynamicConfigEvent {
+    metadata: EventMetadata;
+    config: string;
+    pool_creator_authority: string;
+    index: bigint;
+    permission: bigint;
+}
 export interface MeteoraDbcSwapEvent {
     metadata: EventMetadata;
     pool: string;
@@ -1170,6 +1270,13 @@ export interface MeteoraDbcCurveCompleteEvent {
 /** Meteora DLMM Swap：`fee_bps` 在 Go/Python 为十进制字符串。 */
 export interface MeteoraDlmmSwapEvent {
     metadata: EventMetadata;
+    /** Account-fill / instruction context; empty string default when absent. */
+    token_x_mint?: string;
+    token_y_mint?: string;
+    user_token_in?: string;
+    user_token_out?: string;
+    /** Exact-in min out; 0 when instruction context absent. */
+    min_amount_out?: bigint;
     pool: string;
     from: string;
     start_bin_id: number;
@@ -1251,6 +1358,31 @@ export interface RaydiumLaunchlabTradeEvent {
     is_buy: boolean;
     trade_direction: TradeDirection;
     exact_in: boolean;
+    total_base_sell?: bigint;
+    virtual_base?: bigint;
+    virtual_quote?: bigint;
+    real_base_before?: bigint;
+    real_quote_before?: bigint;
+    real_base_after?: bigint;
+    real_quote_after?: bigint;
+    protocol_fee?: bigint;
+    platform_fee?: bigint;
+    creator_fee?: bigint;
+    share_fee?: bigint;
+    pool_status?: "Fund" | "Migrate" | "Trade";
+    system_program?: string;
+    platform_associated_account?: string;
+    creator_associated_account?: string;
+    global_config?: string;
+    platform_config?: string;
+    user_base_token?: string;
+    user_quote_token?: string;
+    base_vault?: string;
+    quote_vault?: string;
+    base_mint?: string;
+    quote_mint?: string;
+    base_token_program?: string;
+    quote_token_program?: string;
 }
 export interface BaseMintParam {
     symbol: string;
@@ -1263,6 +1395,15 @@ export interface RaydiumLaunchlabPoolCreateEvent {
     base_mint_param: BaseMintParam;
     pool_state: string;
     creator: string;
+    payer?: string;
+    global_config?: string;
+    platform_config?: string;
+    base_mint?: string;
+    quote_mint?: string;
+    base_vault?: string;
+    quote_vault?: string;
+    base_token_program?: string;
+    quote_token_program?: string;
 }
 export interface RaydiumLaunchlabMigrateAmmEvent {
     metadata: EventMetadata;
@@ -1270,6 +1411,11 @@ export interface RaydiumLaunchlabMigrateAmmEvent {
     new_pool: string;
     user: string;
     liquidity_amount: bigint;
+    liquidity_amount_known?: boolean;
+    base_mint?: string;
+    quote_mint?: string;
+    platform_config?: string;
+    destination_program?: string;
 }
 export interface TokenInfoEvent {
     metadata: EventMetadata;
@@ -1344,6 +1490,9 @@ export interface PumpFunBondingCurve {
     is_mayhem_mode: boolean;
     is_cashback_coin: boolean;
     quote_mint: string;
+    creator_fee_bps: bigint;
+    can_edit_creator_fee: boolean;
+    is_holder_reward: boolean;
 }
 export interface PumpFunBondingCurveAccountEvent {
     metadata: EventMetadata;
@@ -1443,6 +1592,9 @@ export interface PumpSwapPool {
     is_mayhem_mode: boolean;
     is_cashback_coin: boolean;
     virtual_quote_reserves: bigint;
+    creator_fee_bps: bigint;
+    can_edit_creator_fee: boolean;
+    is_holder_reward: boolean;
 }
 export interface PumpSwapPoolAccountEvent {
     metadata: EventMetadata;
@@ -1713,3 +1865,8 @@ export interface BlockMetaEvent {
 }
 export declare function metadataForDexEvent(ev: DexEvent): EventMetadata | null;
 export declare function defaultPubkey(): string;
+/** Rust platform aliases share the existing LaunchLab event shape. */
+export type LaunchLabPoolCreateEvent = RaydiumLaunchlabPoolCreateEvent;
+export type StonkFunPoolCreateEvent = RaydiumLaunchlabPoolCreateEvent;
+export type LaunchLabTradeEvent = RaydiumLaunchlabTradeEvent;
+export type StonkFunTradeEvent = RaydiumLaunchlabTradeEvent;

package/dist/core/metadata.d.ts

@@ -1,11 +1,11 @@
 /** 事件元数据（signature 为 Base58 字符串） */
 export interface EventMetadata {
     signature: string;
-    slot: number;
+    slot: bigint;
     /** gRPC：与 Yellowstone `SubscribeUpdateTransactionInfo.index` 一致（Rust `info.index`）。Shred 等其它路径含义见各实现说明。 */
-    tx_index: number;
-    block_time_us: number;
-    grpc_recv_us: number;
+    tx_index: bigint;
+    block_time_us: bigint;
+    grpc_recv_us: bigint;
     /** Time waiting in the local pre-parser queue, measured with a monotonic clock. */
     local_queue_latency_us?: number;
     /** Pure local adapter + parser duration. No network or RPC calls are included. */
@@ -16,4 +16,8 @@ export interface EventMetadata {
     source_to_grpc_latency_us?: number;
     recent_blockhash?: string;
 }
-export declare function makeMetadata(signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, grpcRecvUs: number, recentBlockhash?: string): EventMetadata;
+export declare function makeMetadata(signature: string, slot: number | bigint | string, txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, grpcRecvUs: number | bigint | string, recentBlockhash?: string): EventMetadata;
+export type ExactIntegerInput = bigint | string | number;
+export declare function exactInteger(value: ExactIntegerInput, label?: string): bigint;
+export declare function exactU64(value: ExactIntegerInput, label?: string): bigint;
+export declare function exactI64(value: ExactIntegerInput, label?: string): bigint;

package/dist/core/metadata.js

@@ -1,13 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeMetadata = makeMetadata;
+exports.exactInteger = exactInteger;
+exports.exactU64 = exactU64;
+exports.exactI64 = exactI64;
 function makeMetadata(signature, slot, txIndex, blockTimeUs, grpcRecvUs, recentBlockhash) {
     return {
         signature,
-        slot,
-        tx_index: txIndex,
-        block_time_us: blockTimeUs ?? 0,
-        grpc_recv_us: grpcRecvUs,
+        slot: exactU64(slot, "slot"),
+        tx_index: exactU64(txIndex, "tx_index"),
+        block_time_us: exactI64(blockTimeUs ?? 0, "block_time_us"),
+        grpc_recv_us: exactI64(grpcRecvUs, "grpc_recv_us"),
         recent_blockhash: recentBlockhash,
     };
 }
+function exactInteger(value, label = "integer") {
+    if (typeof value === "number" && !Number.isSafeInteger(value))
+        throw new RangeError(`Unsafe ${label} integer`);
+    if (typeof value === "string" && !/^-?\d+$/.test(value))
+        throw new TypeError(`Invalid ${label} integer`);
+    if (!["bigint", "number", "string"].includes(typeof value))
+        throw new TypeError(`Invalid ${label} type`);
+    return BigInt(value);
+}
+function exactU64(value, label = "u64") {
+    const n = exactInteger(value, label);
+    if (n < 0n || n > (1n << 64n) - 1n)
+        throw new RangeError(`${label} outside u64`);
+    return n;
+}
+function exactI64(value, label = "i64") {
+    const n = exactInteger(value, label);
+    if (n < -(1n << 63n) || n > (1n << 63n) - 1n)
+        throw new RangeError(`${label} outside i64`);
+    return n;
+}

package/dist/core/unified_parser.d.ts

@@ -8,12 +8,12 @@ export type StreamingEventListener = {
     onDexEventStreaming: (event: DexEvent) => void;
 };
 /** 从交易解析事件；当前主路径为日志解析 */
-export declare function parseTransactionEvents(_instructionData: Uint8Array, _accounts: string[], logs: string[], signature: string, slot: number, _txIndex: number, blockTimeUs: number | undefined, _programId: string): DexEvent[];
-export declare function parseLogsOnly(logs: string[], signature: string, slot: number, blockTimeUs: number | undefined, txIndex?: number): DexEvent[];
-export declare function parseTransactionWithListener(instructionData: Uint8Array, accounts: string[], logs: string[], signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, programId: string, listener: EventListener): void;
-export declare function parseTransactionEventsStreaming(_instructionData: Uint8Array, _accounts: string[], logs: string[], signature: string, slot: number, _txIndex: number, blockTimeUs: number | undefined, _programId: string, callback: (event: DexEvent) => void): void;
-export declare function parseLogsStreaming(logs: string[], signature: string, slot: number, blockTimeUs: number | undefined, callback: (event: DexEvent) => void, txIndex?: number): void;
-export declare function parseTransactionWithStreamingListener(instructionData: Uint8Array, accounts: string[], logs: string[], signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, programId: string, listener: StreamingEventListener): void;
+export declare function parseTransactionEvents(_instructionData: Uint8Array, _accounts: string[], logs: string[], signature: string, slot: number | bigint | string, _txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, _programId: string): DexEvent[];
+export declare function parseLogsOnly(logs: string[], signature: string, slot: number | bigint | string, blockTimeUs: number | bigint | string | undefined, txIndex?: number | bigint | string): DexEvent[];
+export declare function parseTransactionWithListener(instructionData: Uint8Array, accounts: string[], logs: string[], signature: string, slot: number | bigint | string, txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, programId: string, listener: EventListener): void;
+export declare function parseTransactionEventsStreaming(_instructionData: Uint8Array, _accounts: string[], logs: string[], signature: string, slot: number | bigint | string, _txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, _programId: string, callback: (event: DexEvent) => void): void;
+export declare function parseLogsStreaming(logs: string[], signature: string, slot: number | bigint | string, blockTimeUs: number | bigint | string | undefined, callback: (event: DexEvent) => void, txIndex?: number | bigint | string): void;
+export declare function parseTransactionWithStreamingListener(instructionData: Uint8Array, accounts: string[], logs: string[], signature: string, slot: number | bigint | string, txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, programId: string, listener: StreamingEventListener): void;
 /** 带完整 gRPC 元数据字段的日志解析 */
-export declare function parseLog(log: string, signature: string, slot: number, txIndex: number, blockTimeUs: number | undefined, grpcRecvUs: number, eventTypeFilter: EventTypeFilter | undefined, isCreatedBuy: boolean, recentBlockhash?: Uint8Array): DexEvent | null;
+export declare function parseLog(log: string, signature: string, slot: number | bigint | string, txIndex: number | bigint | string, blockTimeUs: number | bigint | string | undefined, grpcRecvUs: number | bigint | string, eventTypeFilter: EventTypeFilter | undefined, isCreatedBuy: boolean, recentBlockhash?: Uint8Array): DexEvent | null;
 export { nowUs };

package/dist/grpc/block_meta.d.ts

@@ -0,0 +1,9 @@
+/** Local BlockMeta adapter; never fetches a block or blockhash. */
+import type { DexEvent } from "../core/dex_event.js";
+export declare function parseBlockMetaUpdate(meta: {
+    slot: string | number | bigint;
+    blockhash: string;
+    blockTime?: {
+        timestamp: string | number | bigint;
+    };
+}, grpcRecvUs: number | bigint | string, fallbackBlockUs?: number | bigint | string): DexEvent;

package/dist/grpc/block_meta.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBlockMetaUpdate = parseBlockMetaUpdate;
+const metadata_js_1 = require("../core/metadata.js");
+function parseBlockMetaUpdate(meta, grpcRecvUs, fallbackBlockUs) {
+    const slot = (0, metadata_js_1.exactInteger)(meta.slot, "slot");
+    (0, metadata_js_1.exactU64)(slot, "slot");
+    const seconds = meta.blockTime?.timestamp;
+    let blockUs = (0, metadata_js_1.exactI64)(fallbackBlockUs ?? 0);
+    if (seconds !== undefined) {
+        const v = (0, metadata_js_1.exactInteger)(seconds, "timestamp") * 1000000n, lo = -(1n << 63n), hi = (1n << 63n) - 1n;
+        blockUs = v < lo ? lo : v > hi ? hi : v;
+    }
+    return {
+        BlockMeta: {
+            metadata: {
+                signature: "1".repeat(64),
+                slot,
+                tx_index: 0n,
+                block_time_us: blockUs,
+                grpc_recv_us: (0, metadata_js_1.exactI64)(grpcRecvUs),
+                recent_blockhash: meta.blockhash || undefined,
+            },
+        },
+    };
+}

package/dist/grpc/client.d.ts

@@ -1,16 +1,24 @@
-/**
- * Yellowstone gRPC 客户端实现 - 基于 @triton-one/yellowstone-grpc
- */
-import { CommitmentLevel } from "@triton-one/yellowstone-grpc";
+import { CommitmentLevel } from "./protocol/geyser.js";
 import { type DexEvent } from "../core/dex_event.js";
 import { type EventQueueOverflowStrategy } from "./async_event_queue.js";
 import { type AccountFilter, type ClientConfig, type EventTypeFilter, type TransactionFilter, type SubscribeCallbacks } from "./types.js";
 export { SubscribeCallbacks };
 export type { EventQueueOverflowStrategy } from "./async_event_queue.js";
+export interface GrpcStreamStatus {
+    readonly state: "connecting" | "connected" | "reconnecting" | "stopped";
+    readonly continuityBroken: boolean;
+    readonly reconnects: number;
+    readonly dropped: number;
+}
 export interface DexEventSubscription extends AsyncIterable<DexEvent> {
     id: string;
     errors: AsyncIterable<Error>;
+    /** Bounded transition stream; inspect status() even if notifications were dropped. */
+    states: AsyncIterable<GrpcStreamStatus>;
+    status(): GrpcStreamStatus;
     cancel(): void;
+    /** Wait until the stream and associated workers exit. */
+    join(): Promise<void>;
     next(): Promise<IteratorResult<DexEvent>>;
     len(): number;
     /** Total drops across ingress and the public event queue. */
@@ -49,6 +57,11 @@ export declare class YellowstoneGrpc {
     private connectPromise?;
     private subscribers;
     private dexSubscribers;
+    private dexLifecycle;
+    private activeDex?;
+    private withDexLifecycle;
+    private stopDexUnlocked;
+    stop(): Promise<void>;
     constructor(endpoint: string, xToken: string, config?: ClientConfig);
     /** 连接到 gRPC 服务器 */
     connect(): Promise<void>;
@@ -86,26 +99,28 @@ export declare class YellowstoneGrpc {
      * 事件队列满时按配置丢弃事件，避免回调阻塞 gRPC 读循环并让丢弃可观测。
      */
     subscribeDexEvents(transactionFilters?: TransactionFilter[], accountFilters?: AccountFilter[], eventTypeFilter?: EventTypeFilter, options?: SubscribeDexEventsOptions): Promise<DexEventSubscription>;
+    private startDexEvents;
     /** 取消订阅 */
     unsubscribe(subId: string): void;
     /** 动态更新当前 DEX 订阅过滤器（与 Rust update_subscription 语义对齐）。 */
     updateSubscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
+    private updateDexUnlocked;
     update_subscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
     /** 获取最新区块哈希 */
     getLatestBlockhash(commitment?: CommitmentLevel): Promise<{
-        slot: number;
+        slot: bigint;
         blockhash: string;
-        lastValidBlockHeight: number;
+        lastValidBlockHeight: bigint;
     }>;
     /** 获取区块高度 */
-    getBlockHeight(commitment?: CommitmentLevel): Promise<number>;
+    getBlockHeight(commitment?: CommitmentLevel): Promise<bigint>;
     /** 获取当前 Slot */
-    getSlot(commitment?: CommitmentLevel): Promise<number>;
+    getSlot(commitment?: CommitmentLevel): Promise<bigint>;
     /** 获取服务器版本 */
     getVersion(): Promise<string>;
     /** 验证区块哈希是否有效 */
     isBlockhashValid(blockhash: string, commitment?: CommitmentLevel): Promise<{
-        slot: number;
+        slot: bigint;
         valid: boolean;
     }>;
     /** 发送 Ping 请求 */