sol-parser-sdk-nodejs 0.3.0 → 0.4.4

package/dist/core/dex_event.d.ts

@@ -14,6 +14,26 @@ export type DexEvent = {
     PumpFunBuyExactSolIn: PumpFunTradeEvent;
 } | {
     PumpFunMigrate: PumpFunMigrateEvent;
+} | {
+    PumpFeesCreateFeeSharingConfig: PumpFeesCreateFeeSharingConfigEvent;
+} | {
+    PumpFeesInitializeFeeConfig: PumpFeesInitializeFeeConfigEvent;
+} | {
+    PumpFeesResetFeeSharingConfig: PumpFeesResetFeeSharingConfigEvent;
+} | {
+    PumpFeesRevokeFeeSharingAuthority: PumpFeesRevokeFeeSharingAuthorityEvent;
+} | {
+    PumpFeesTransferFeeSharingAuthority: PumpFeesTransferFeeSharingAuthorityEvent;
+} | {
+    PumpFeesUpdateAdmin: PumpFeesUpdateAdminEvent;
+} | {
+    PumpFeesUpdateFeeConfig: PumpFeesUpdateFeeConfigEvent;
+} | {
+    PumpFeesUpdateFeeShares: PumpFeesUpdateFeeSharesEvent;
+} | {
+    PumpFeesUpsertFeeTiers: PumpFeesUpsertFeeTiersEvent;
+} | {
+    PumpFunMigrateBondingCurveCreator: PumpFunMigrateBondingCurveCreatorEvent;
 } | {
     PumpSwapTrade: PumpSwapTradeEvent;
 } | {
@@ -87,11 +107,13 @@ export type DexEvent = {
 } | {
     MeteoraDammV2RemoveLiquidity: MeteoraDammV2RemoveLiquidityEvent;
 } | {
-    MeteoraDammV2CreatePosition: MeteoraDammV2CreatePositionEvent;
+    MeteoraDammV2RemoveAllLiquidity: MeteoraDammV2RemoveAllLiquidityEvent;
 } | {
-    MeteoraDammV2ClosePosition: MeteoraDammV2ClosePositionEvent;
+    MeteoraDammV2CreatePosition: MeteoraDammV2CreatePositionEvent;
 } | {
     MeteoraDammV2InitializePool: MeteoraDammV2InitializePoolEvent;
+} | {
+    MeteoraDammV2ClosePosition: MeteoraDammV2ClosePositionEvent;
 } | {
     MeteoraDlmmSwap: MeteoraDlmmSwapEvent;
 } | {
@@ -120,6 +142,8 @@ export type DexEvent = {
     TokenAccount: TokenAccountEvent;
 } | {
     NonceAccount: NonceAccountEvent;
+} | {
+    PumpFunGlobalAccount: PumpFunGlobalAccountEvent;
 } | {
     PumpSwapGlobalConfigAccount: PumpSwapGlobalConfigAccountEvent;
 } | {
@@ -160,6 +184,7 @@ export interface PumpFunCreateV2TokenEvent extends PumpFunCreateTokenEvent {
     mayhem_token_vault: string;
     event_authority: string;
     program: string;
+    observed_fee_recipient: string;
 }
 export interface PumpFunTradeEvent {
     metadata: EventMetadata;
@@ -207,6 +232,103 @@ export interface PumpFunMigrateEvent {
     timestamp: bigint;
     pool: string;
 }
+export interface PumpFeesShareholder {
+    address: string;
+    share_bps: number;
+}
+export type PumpFeesConfigStatus = "Paused" | "Active";
+export interface PumpFeesFees {
+    lp_fee_bps: bigint;
+    protocol_fee_bps: bigint;
+    creator_fee_bps: bigint;
+}
+export interface PumpFeesFeeTier {
+    market_cap_lamports_threshold: bigint;
+    fees: PumpFeesFees;
+}
+export interface PumpFeesCreateFeeSharingConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    bonding_curve: string;
+    pool?: string;
+    sharing_config: string;
+    admin: string;
+    initial_shareholders: PumpFeesShareholder[];
+    status: PumpFeesConfigStatus;
+}
+export interface PumpFeesInitializeFeeConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+}
+export interface PumpFeesResetFeeSharingConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    old_admin: string;
+    old_shareholders: PumpFeesShareholder[];
+    new_admin: string;
+    new_shareholders: PumpFeesShareholder[];
+}
+export interface PumpFeesRevokeFeeSharingAuthorityEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    admin: string;
+}
+export interface PumpFeesTransferFeeSharingAuthorityEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    old_admin: string;
+    new_admin: string;
+}
+export interface PumpFeesUpdateAdminEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    old_admin: string;
+    new_admin: string;
+}
+export interface PumpFeesUpdateFeeConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+    fee_tiers: PumpFeesFeeTier[];
+    flat_fees: PumpFeesFees;
+}
+export interface PumpFeesUpdateFeeSharesEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    admin: string;
+    bonding_curve: string;
+    pump_creator_vault: string;
+    new_shareholders: PumpFeesShareholder[];
+}
+export interface PumpFeesUpsertFeeTiersEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+    fee_tiers: PumpFeesFeeTier[];
+    offset: number;
+}
+export interface PumpFunMigrateBondingCurveCreatorEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    bonding_curve: string;
+    sharing_config: string;
+    old_creator: string;
+    new_creator: string;
+}
 /** 与 `PumpSwapTradeEvent`（IDL TradeEvent）对齐 */
 export interface PumpSwapTradeEvent {
     metadata: EventMetadata;
@@ -761,67 +883,46 @@ export interface MeteoraDammV2RemoveLiquidityEvent {
     token_a_amount_threshold: bigint;
     token_b_amount_threshold: bigint;
 }
-/** 与 `MeteoraDammV2CreatePositionEvent` 对齐 */
-export interface MeteoraDammV2CreatePositionEvent {
+/** 外层 `remove_all_liquidity`；指令仅含两 u64 阈值，无 `liquidity_delta`。 */
+export interface MeteoraDammV2RemoveAllLiquidityEvent {
     metadata: EventMetadata;
     pool: string;
-    owner: string;
     position: string;
-    position_nft_mint: string;
+    owner: string;
+    token_a_amount_threshold: bigint;
+    token_b_amount_threshold: bigint;
 }
-/** 与 `MeteoraDammV2ClosePositionEvent` 对齐 */
-export interface MeteoraDammV2ClosePositionEvent {
+/** 与 `MeteoraDammV2CreatePositionEvent` 对齐 */
+export interface MeteoraDammV2CreatePositionEvent {
     metadata: EventMetadata;
     pool: string;
     owner: string;
     position: string;
     position_nft_mint: string;
 }
-/** Meteora `cp-amm` `DynamicFeeParameters`（Anchor 序列化） */
-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;
-}
-/** Meteora `cp-amm` `PoolFeeParameters`（Anchor 序列化解析） */
-export interface MeteoraDammV2PoolFeeParameters {
-    /** `BaseFeeParameters.data`，27 字节十六进制 */
-    base_fee_data: string;
-    compounding_fee_bps: number;
-    padding: number;
-    dynamic_fee: MeteoraDammV2DynamicFeeParameters | null;
-}
 /**
- * 与 Meteora `cp-amm` `EvtInitializePool` 对齐（Program data 载荷）。
- * Go/Python 中 `sqrt_min_price`、`liquidity`、`pool_fees.dynamic_fee.bin_step_u128` 等 u128 语义字段为十进制字符串。
+ * 外层 `initialize_pool`（`InitializePoolParameters`）；无日志时仅含指令内字段与账户索引映射。
+ * Go/Python 中 `liquidity` / `sqrt_price` 为十进制字符串；`activation_point` 为 `None` 或十进制字符串。
  */
 export interface MeteoraDammV2InitializePoolEvent {
     metadata: EventMetadata;
+    creator: string;
+    position_nft_mint: string;
     pool: string;
+    position: string;
     token_a_mint: string;
     token_b_mint: string;
-    creator: string;
-    payer: string;
-    alpha_vault: string;
-    pool_fees: MeteoraDammV2PoolFeeParameters;
-    sqrt_min_price: bigint;
-    sqrt_max_price: bigint;
-    activation_type: number;
-    collect_fee_mode: number;
     liquidity: bigint;
     sqrt_price: bigint;
-    activation_point: bigint;
-    token_a_flag: number;
-    token_b_flag: number;
-    token_a_amount: bigint;
-    token_b_amount: bigint;
-    total_amount_a: bigint;
-    total_amount_b: bigint;
-    pool_type: number;
+    activation_point: bigint | null;
+}
+/** 与 `MeteoraDammV2ClosePositionEvent` 对齐 */
+export interface MeteoraDammV2ClosePositionEvent {
+    metadata: EventMetadata;
+    pool: string;
+    owner: string;
+    position: string;
+    position_nft_mint: string;
 }
 /** Meteora DLMM Swap：`fee_bps` 在 Go/Python 为十进制字符串。 */
 export interface MeteoraDlmmSwapEvent {
@@ -957,6 +1058,33 @@ export interface NonceAccountEvent {
     nonce: string;
     authority: string;
 }
+export interface PumpFunGlobal {
+    initialized: boolean;
+    authority: string;
+    fee_recipient: string;
+    initial_virtual_token_reserves: bigint;
+    initial_virtual_sol_reserves: bigint;
+    initial_real_token_reserves: bigint;
+    token_total_supply: bigint;
+    fee_basis_points: bigint;
+    withdraw_authority: string;
+    enable_migrate: boolean;
+    pool_migration_fee: bigint;
+    creator_fee_basis_points: bigint;
+    fee_recipients: string[];
+    set_creator_authority: string;
+    admin_set_creator_authority: string;
+    create_v2_enabled: boolean;
+    whitelist_pda: string;
+    reserved_fee_recipient: string;
+    mayhem_mode_enabled: boolean;
+    reserved_fee_recipients: string[];
+}
+export interface PumpFunGlobalAccountEvent {
+    metadata: EventMetadata;
+    pubkey: string;
+    global: PumpFunGlobal;
+}
 export interface PumpSwapGlobalConfig {
     admin: string;
     lp_fee_basis_points: bigint;

package/dist/core/metadata.d.ts

@@ -2,6 +2,7 @@
 export interface EventMetadata {
     signature: string;
     slot: number;
+    /** gRPC：与 Yellowstone `SubscribeUpdateTransactionInfo.index` 一致（Rust `info.index`）。Shred 等其它路径含义见各实现说明。 */
     tx_index: number;
     block_time_us: number;
     grpc_recv_us: number;

package/dist/core/pumpfun_fee_enrich.d.ts

@@ -0,0 +1,4 @@
+import type { DexEvent } from "./dex_event.js";
+export declare function enrichCreateV2ObservedFeeRecipient(events: DexEvent[]): void;
+export declare function enrichPumpfunTradesFromCreateInstructions(events: DexEvent[]): void;
+export declare function enrichPumpfunSameTxPostMerge(events: DexEvent[]): void;

package/dist/core/pumpfun_fee_enrich.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enrichCreateV2ObservedFeeRecipient = enrichCreateV2ObservedFeeRecipient;
+exports.enrichPumpfunTradesFromCreateInstructions = enrichPumpfunTradesFromCreateInstructions;
+exports.enrichPumpfunSameTxPostMerge = enrichPumpfunSameTxPostMerge;
+const dex_event_js_1 = require("./dex_event.js");
+function pumpfunTradeEvent(ev) {
+    if ("PumpFunTrade" in ev)
+        return ev.PumpFunTrade;
+    if ("PumpFunBuy" in ev)
+        return ev.PumpFunBuy;
+    if ("PumpFunSell" in ev)
+        return ev.PumpFunSell;
+    if ("PumpFunBuyExactSolIn" in ev)
+        return ev.PumpFunBuyExactSolIn;
+    return null;
+}
+function pumpfunCreateFlags(ev) {
+    let c = null;
+    if ("PumpFunCreate" in ev)
+        c = ev.PumpFunCreate;
+    if ("PumpFunCreateV2" in ev)
+        c = ev.PumpFunCreateV2;
+    if (!c || !c.mint || c.mint === (0, dex_event_js_1.defaultPubkey)())
+        return null;
+    return [c.mint, c.is_cashback_enabled, c.is_mayhem_mode];
+}
+function enrichCreateV2ObservedFeeRecipient(events) {
+    const zero = (0, dex_event_js_1.defaultPubkey)();
+    const mintToFee = new Map();
+    for (const ev of events) {
+        const t = pumpfunTradeEvent(ev);
+        if (!t || !t.mint || t.mint === zero || !t.fee_recipient || t.fee_recipient === zero) {
+            continue;
+        }
+        const buyLike = ("PumpFunTrade" in ev && t.is_buy) ||
+            "PumpFunBuy" in ev ||
+            "PumpFunBuyExactSolIn" in ev;
+        if (buyLike && !mintToFee.has(t.mint)) {
+            mintToFee.set(t.mint, t.fee_recipient);
+        }
+    }
+    if (mintToFee.size === 0)
+        return;
+    for (const ev of events) {
+        if (!("PumpFunCreateV2" in ev))
+            continue;
+        const c = ev.PumpFunCreateV2;
+        if (!c.observed_fee_recipient || c.observed_fee_recipient === zero) {
+            c.observed_fee_recipient = mintToFee.get(c.mint) ?? c.observed_fee_recipient;
+        }
+    }
+}
+function enrichPumpfunTradesFromCreateInstructions(events) {
+    const flags = new Map();
+    for (const ev of events) {
+        const f = pumpfunCreateFlags(ev);
+        if (f && !flags.has(f[0]))
+            flags.set(f[0], [f[1], f[2]]);
+    }
+    if (flags.size === 0)
+        return;
+    for (const ev of events) {
+        const t = pumpfunTradeEvent(ev);
+        if (!t || !t.mint || t.mint === (0, dex_event_js_1.defaultPubkey)())
+            continue;
+        const f = flags.get(t.mint);
+        if (!f)
+            continue;
+        const [cashbackEnabled, mayhemMode] = f;
+        t.is_cashback_coin ||= cashbackEnabled;
+        t.mayhem_mode ||= mayhemMode;
+        if (cashbackEnabled)
+            t.track_volume = true;
+    }
+}
+function enrichPumpfunSameTxPostMerge(events) {
+    enrichCreateV2ObservedFeeRecipient(events);
+    enrichPumpfunTradesFromCreateInstructions(events);
+}

package/dist/core/unified_parser.d.ts

@@ -9,10 +9,10 @@ export type StreamingEventListener = {
 };
 /** 从交易解析事件；当前主路径为日志解析 */
 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): 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): 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;
 /** 带完整 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;

package/dist/core/unified_parser.js

@@ -8,20 +8,22 @@ exports.parseTransactionEventsStreaming = parseTransactionEventsStreaming;
 exports.parseLogsStreaming = parseLogsStreaming;
 exports.parseTransactionWithStreamingListener = parseTransactionWithStreamingListener;
 exports.parseLog = parseLog;
+const pumpfun_fee_enrich_js_1 = require("./pumpfun_fee_enrich.js");
 const optimized_matcher_js_1 = require("../logs/optimized_matcher.js");
 const clock_js_1 = require("./clock.js");
 Object.defineProperty(exports, "nowUs", { enumerable: true, get: function () { return clock_js_1.nowUs; } });
 /** 从交易解析事件；当前主路径为日志解析 */
 function parseTransactionEvents(_instructionData, _accounts, logs, signature, slot, _txIndex, blockTimeUs, _programId) {
-    return parseLogsOnly(logs, signature, slot, blockTimeUs);
+    return parseLogsOnly(logs, signature, slot, blockTimeUs, _txIndex);
 }
-function parseLogsOnly(logs, signature, slot, blockTimeUs) {
+function parseLogsOnly(logs, signature, slot, blockTimeUs, txIndex = 0) {
     const out = [];
     for (const log of logs) {
-        const e = (0, optimized_matcher_js_1.parseLogUnified)(log, signature, slot, blockTimeUs);
+        const e = (0, optimized_matcher_js_1.parseLogUnified)(log, signature, slot, blockTimeUs, txIndex);
         if (e)
             out.push(e);
     }
+    (0, pumpfun_fee_enrich_js_1.enrichPumpfunSameTxPostMerge)(out);
     return out;
 }
 function parseTransactionWithListener(instructionData, accounts, logs, signature, slot, txIndex, blockTimeUs, programId, listener) {
@@ -30,11 +32,11 @@ function parseTransactionWithListener(instructionData, accounts, logs, signature
     }
 }
 function parseTransactionEventsStreaming(_instructionData, _accounts, logs, signature, slot, _txIndex, blockTimeUs, _programId, callback) {
-    parseLogsStreaming(logs, signature, slot, blockTimeUs, callback);
+    parseLogsStreaming(logs, signature, slot, blockTimeUs, callback, _txIndex);
 }
-function parseLogsStreaming(logs, signature, slot, blockTimeUs, callback) {
+function parseLogsStreaming(logs, signature, slot, blockTimeUs, callback, txIndex = 0) {
     for (const log of logs) {
-        const e = (0, optimized_matcher_js_1.parseLogUnified)(log, signature, slot, blockTimeUs);
+        const e = (0, optimized_matcher_js_1.parseLogUnified)(log, signature, slot, blockTimeUs, txIndex);
         if (e)
             callback(e);
     }

package/dist/grpc/client.d.ts

@@ -2,14 +2,22 @@
  * Yellowstone gRPC 客户端实现 - 基于 @triton-one/yellowstone-grpc
  */
 import { CommitmentLevel } from "@triton-one/yellowstone-grpc";
-import { type ClientConfig, type TransactionFilter, type SubscribeCallbacks } from "./types.js";
+import type { DexEvent } from "../core/dex_event.js";
+import { type AccountFilter, type ClientConfig, type EventTypeFilter, type TransactionFilter, type SubscribeCallbacks } from "./types.js";
 export { SubscribeCallbacks };
+export interface DexEventSubscription extends AsyncIterable<DexEvent> {
+    id: string;
+    errors: AsyncIterable<Error>;
+    cancel(): void;
+    next(): Promise<IteratorResult<DexEvent>>;
+}
 /** Yellowstone gRPC 客户端包装器 */
 export declare class YellowstoneGrpc {
     private client;
     private config;
     private connected;
     private subscribers;
+    private dexSubscribers;
     constructor(endpoint: string, xToken: string, config?: ClientConfig);
     /** 连接到 gRPC 服务器 */
     connect(): Promise<void>;
@@ -23,13 +31,36 @@ export declare class YellowstoneGrpc {
     private convertSlotStatus;
     /** 转换订阅更新 */
     private convertUpdate;
+    /**
+     * 应答 Geyser 在 SubscribeUpdate 中下发的 ping（与 `solana-streamer` / Rust 侧一致）。
+     * 若不回复，公共节点或 LB 可能在超时后 RST_STREAM（HTTP/2 CANCEL）。
+     */
+    private subscribePingPongRequest;
+    private static toBytes;
+    private static toBigInt;
+    private static protobufNumber;
+    private static timestampToMicros;
+    private parseAccountEvent;
+    private initialSubscribeRequest;
     /** 订阅交易 */
     subscribeTransactions(filter: TransactionFilter, callbacks: SubscribeCallbacks): Promise<{
         id: string;
         cancel: () => void;
     }>;
+    /**
+     * 订阅并直接产出 `DexEvent`。
+     *
+     * 交易更新走统一交易解析（外层/内层指令 + 日志 + 数据填充）；账户更新走 `parseAccountUnified`。
+     * 事件队列满时丢弃新事件，避免回调阻塞 gRPC 读循环，保持低延迟。
+     */
+    subscribeDexEvents(transactionFilters?: TransactionFilter[], accountFilters?: AccountFilter[], eventTypeFilter?: EventTypeFilter, options?: {
+        autoReconnect?: boolean;
+    }): Promise<DexEventSubscription>;
     /** 取消订阅 */
     unsubscribe(subId: string): void;
+    /** 动态更新当前 DEX 订阅过滤器（与 Rust update_subscription 语义对齐）。 */
+    updateSubscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
+    update_subscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
     /** 获取最新区块哈希 */
     getLatestBlockhash(commitment?: CommitmentLevel): Promise<{
         slot: number;