sol-parser-sdk-nodejs 0.4.0 → 0.5.5

package/dist/grpc/types.d.ts

@@ -1,8 +1,9 @@
 import type { SubscribeRequestFilterAccountsFilter } from "@triton-one/yellowstone-grpc";
+import type { DexEvent } from "../core/dex_event.js";
 /** gRPC 订阅顺序模式 */
 export type OrderMode = "Unordered" | "Ordered" | "StreamingOrdered" | "MicroBatch";
 /** 与 Rust `grpc::types::Protocol` 一致 */
-export type Protocol = "PumpFun" | "PumpSwap" | "Bonk" | "RaydiumCpmm" | "RaydiumClmm" | "RaydiumAmmV4" | "MeteoraDammV2";
+export type Protocol = "PumpFun" | "PumpSwap" | "PumpFees" | "RaydiumLaunchlab" | "RaydiumCpmm" | "RaydiumClmm" | "RaydiumAmmV4" | "OrcaWhirlpool" | "MeteoraPools" | "MeteoraDammV2" | "MeteoraDlmm" | "MeteoraDbc";
 export type SlotStatus = "Processed" | "Confirmed" | "Finalized" | "FirstShredReceived" | "Completed" | "CreatedBank" | "Dead";
 export interface SubscribeUpdateAccountInfo {
     pubkey: Uint8Array;
@@ -73,6 +74,8 @@ export interface SubscribeUpdate {
     blockMeta?: SubscribeUpdateBlockMeta;
     ping?: SubscribeUpdatePing;
     pong?: SubscribeUpdatePong;
+    /** Yellowstone SubscribeUpdate.created_at, Unix timestamp in microseconds. */
+    createdAtUs?: number;
 }
 export interface SubscribeCallbacks {
     onUpdate?: (update: SubscribeUpdate) => void;
@@ -146,11 +149,13 @@ export declare function accountFilterFromProgramOwners(programIds: string[]): Ac
  */
 export declare function accountFilterMemcmp(offset: number, bytes: Uint8Array): SubscribeRequestFilterAccountsFilter;
 /** 事件类型过滤标签 */
-export type EventType = "BlockMeta" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumClmmSwap" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmClosePosition" | "RaydiumClmmCollectFee" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4WithdrawPnl" | "RaydiumAmmV4Initialize2" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2RemoveAllLiquidity" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2InitializePool" | "MeteoraDammV2ClosePosition" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "BonkTrade" | "BonkPoolCreate" | "BonkMigrateAmm" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool";
+export type EventType = "BlockMeta" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpFeesCreateFeeSharingConfig" | "PumpFeesInitializeFeeConfig" | "PumpFeesResetFeeSharingConfig" | "PumpFeesRevokeFeeSharingAuthority" | "PumpFeesTransferFeeSharingAuthority" | "PumpFeesUpdateAdmin" | "PumpFeesUpdateFeeConfig" | "PumpFeesUpdateFeeShares" | "PumpFeesUpsertFeeTiers" | "PumpFunMigrateBondingCurveCreator" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumClmmSwap" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmClosePosition" | "RaydiumClmmCollectFee" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4WithdrawPnl" | "RaydiumAmmV4Initialize2" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2InitializePool" | "MeteoraDammV2ClosePosition" | "MeteoraDbcSwap" | "MeteoraDbcInitializePool" | "MeteoraDbcCurveComplete" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "RaydiumLaunchlabTrade" | "RaydiumLaunchlabPoolCreate" | "RaydiumLaunchlabMigrateAmm" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpFunGlobal" | "AccountPumpFunBondingCurve" | "AccountPumpFunFeeConfig" | "AccountPumpFunSharingConfig" | "AccountPumpFunGlobalVolumeAccumulator" | "AccountPumpFunUserVolumeAccumulator" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool" | "AccountRaydiumClmmAmmConfig" | "AccountRaydiumClmmPoolState" | "AccountRaydiumClmmTickArrayState" | "AccountRaydiumCpmmAmmConfig" | "AccountRaydiumCpmmPoolState" | "AccountOrcaWhirlpool" | "AccountOrcaPosition" | "AccountOrcaTickArray" | "AccountOrcaFeeTier" | "AccountOrcaWhirlpoolsConfig";
 /** 与 Rust `grpc::EventType`（由 `StreamingEventType` 导出）一致 */
 export type StreamingEventType = EventType;
 /** 所有事件类型列表 */
 export declare const ALL_EVENT_TYPES: EventType[];
+export declare function eventTypeFromDexEvent(event: DexEvent): EventType | null;
+export declare function eventTypeFilterShouldIncludeDexEvent(filter: EventTypeFilter, event: DexEvent): boolean;
 export interface EventTypeFilter {
     include_only?: EventType[];
     exclude_types?: EventType[];
@@ -160,10 +165,18 @@ export declare function eventTypeFilterIncludeOnly(types: EventType[]): EventTyp
 export declare function eventTypeFilterExclude(types: EventType[]): EventTypeFilter;
 /** 过滤器是否包含 PumpFun 相关类型 */
 export declare function eventTypeFilterIncludesPumpfun(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Pump Fees (`pfeeUx...`) 相关类型 */
+export declare function eventTypeFilterIncludesPumpFees(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 PumpSwap 相关类型 */
 export declare function eventTypeFilterIncludesPumpswap(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Meteora DAMM V2 相关类型 */
 export declare function eventTypeFilterIncludesMeteoraDammV2(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora DBC 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraDbc(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora Pools 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraPools(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora DLMM 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraDlmm(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Raydium CLMM 相关类型 */
 export declare function eventTypeFilterIncludesRaydiumClmm(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Raydium CPMM 相关类型 */
@@ -172,10 +185,8 @@ export declare function eventTypeFilterIncludesRaydiumCpmm(filter: EventTypeFilt
 export declare function eventTypeFilterIncludesRaydiumAmmV4(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Orca Whirlpool 相关类型 */
 export declare function eventTypeFilterIncludesOrcaWhirlpool(filter: EventTypeFilter): boolean;
-/** 过滤器是否包含 Bonk Launchpad 相关类型（与 Rust `includes_raydium_launchpad` / Bonk 集合一致） */
-export declare function eventTypeFilterIncludesBonk(filter: EventTypeFilter): boolean;
-/** 与 Rust `EventTypeFilter::includes_raydium_launchpad` 同名语义 */
-export declare function eventTypeFilterIncludesRaydiumLaunchpad(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Raydium LaunchLab 相关类型（与 Rust `includes_raydium_launchlab` 集合一致） */
+export declare function eventTypeFilterIncludesRaydiumLaunchlab(filter: EventTypeFilter): boolean;
 /**
  * `parseInstructionUnified` 前置白名单：仅当 `include_only` 与下列指令相关类型有交集时才解析指令。
  * 若白名单中不含下列任一类型，则整条指令解析入口返回 null。

package/dist/grpc/types.js

@@ -12,17 +12,22 @@ exports.slotFilterMinSlot = slotFilterMinSlot;
 exports.slotFilterMaxSlot = slotFilterMaxSlot;
 exports.accountFilterFromProgramOwners = accountFilterFromProgramOwners;
 exports.accountFilterMemcmp = accountFilterMemcmp;
+exports.eventTypeFromDexEvent = eventTypeFromDexEvent;
+exports.eventTypeFilterShouldIncludeDexEvent = eventTypeFilterShouldIncludeDexEvent;
 exports.eventTypeFilterIncludeOnly = eventTypeFilterIncludeOnly;
 exports.eventTypeFilterExclude = eventTypeFilterExclude;
 exports.eventTypeFilterIncludesPumpfun = eventTypeFilterIncludesPumpfun;
+exports.eventTypeFilterIncludesPumpFees = eventTypeFilterIncludesPumpFees;
 exports.eventTypeFilterIncludesPumpswap = eventTypeFilterIncludesPumpswap;
 exports.eventTypeFilterIncludesMeteoraDammV2 = eventTypeFilterIncludesMeteoraDammV2;
+exports.eventTypeFilterIncludesMeteoraDbc = eventTypeFilterIncludesMeteoraDbc;
+exports.eventTypeFilterIncludesMeteoraPools = eventTypeFilterIncludesMeteoraPools;
+exports.eventTypeFilterIncludesMeteoraDlmm = eventTypeFilterIncludesMeteoraDlmm;
 exports.eventTypeFilterIncludesRaydiumClmm = eventTypeFilterIncludesRaydiumClmm;
 exports.eventTypeFilterIncludesRaydiumCpmm = eventTypeFilterIncludesRaydiumCpmm;
 exports.eventTypeFilterIncludesRaydiumAmmV4 = eventTypeFilterIncludesRaydiumAmmV4;
 exports.eventTypeFilterIncludesOrcaWhirlpool = eventTypeFilterIncludesOrcaWhirlpool;
-exports.eventTypeFilterIncludesBonk = eventTypeFilterIncludesBonk;
-exports.eventTypeFilterIncludesRaydiumLaunchpad = eventTypeFilterIncludesRaydiumLaunchpad;
+exports.eventTypeFilterIncludesRaydiumLaunchlab = eventTypeFilterIncludesRaydiumLaunchlab;
 exports.eventTypeFilterAllowsInstructionParsing = eventTypeFilterAllowsInstructionParsing;
 function defaultClientConfig() {
     return {
@@ -129,6 +134,16 @@ exports.ALL_EVENT_TYPES = [
     "PumpFunCreateV2",
     "PumpFunComplete",
     "PumpFunMigrate",
+    "PumpFeesCreateFeeSharingConfig",
+    "PumpFeesInitializeFeeConfig",
+    "PumpFeesResetFeeSharingConfig",
+    "PumpFeesRevokeFeeSharingAuthority",
+    "PumpFeesTransferFeeSharingAuthority",
+    "PumpFeesUpdateAdmin",
+    "PumpFeesUpdateFeeConfig",
+    "PumpFeesUpdateFeeShares",
+    "PumpFeesUpsertFeeTiers",
+    "PumpFunMigrateBondingCurveCreator",
     // PumpSwap
     "PumpSwapTrade",
     "PumpSwapBuy",
@@ -172,10 +187,13 @@ exports.ALL_EVENT_TYPES = [
     "MeteoraDammV2Swap",
     "MeteoraDammV2AddLiquidity",
     "MeteoraDammV2RemoveLiquidity",
-    "MeteoraDammV2RemoveAllLiquidity",
     "MeteoraDammV2CreatePosition",
     "MeteoraDammV2InitializePool",
     "MeteoraDammV2ClosePosition",
+    // Meteora DBC
+    "MeteoraDbcSwap",
+    "MeteoraDbcInitializePool",
+    "MeteoraDbcCurveComplete",
     // Meteora DLMM
     "MeteoraDlmmSwap",
     "MeteoraDlmmAddLiquidity",
@@ -185,17 +203,174 @@ exports.ALL_EVENT_TYPES = [
     "MeteoraDlmmCreatePosition",
     "MeteoraDlmmClosePosition",
     "MeteoraDlmmClaimFee",
-    // Bonk
-    "BonkTrade",
-    "BonkPoolCreate",
-    "BonkMigrateAmm",
+    // RaydiumLaunchlab
+    "RaydiumLaunchlabTrade",
+    "RaydiumLaunchlabPoolCreate",
+    "RaydiumLaunchlabMigrateAmm",
     // Account types
     "TokenAccount",
     "TokenInfo",
     "NonceAccount",
+    "AccountPumpFunGlobal",
+    "AccountPumpFunBondingCurve",
+    "AccountPumpFunFeeConfig",
+    "AccountPumpFunSharingConfig",
+    "AccountPumpFunGlobalVolumeAccumulator",
+    "AccountPumpFunUserVolumeAccumulator",
     "AccountPumpSwapGlobalConfig",
     "AccountPumpSwapPool",
+    "AccountRaydiumClmmAmmConfig",
+    "AccountRaydiumClmmPoolState",
+    "AccountRaydiumClmmTickArrayState",
+    "AccountRaydiumCpmmAmmConfig",
+    "AccountRaydiumCpmmPoolState",
+    "AccountOrcaWhirlpool",
+    "AccountOrcaPosition",
+    "AccountOrcaTickArray",
+    "AccountOrcaFeeTier",
+    "AccountOrcaWhirlpoolsConfig",
 ];
+const ALL_EVENT_TYPE_SET = new Set(exports.ALL_EVENT_TYPES);
+const PUMPFUN_BUY_FAMILY = ["PumpFunBuy", "PumpFunBuyExactSolIn"];
+const PUMPFUN_TRADE_FAMILY = [
+    "PumpFunBuy",
+    "PumpFunSell",
+    "PumpFunBuyExactSolIn",
+];
+const PUMPFUN_CREATE_FAMILY = ["PumpFunCreate", "PumpFunCreateV2"];
+const PUMPSWAP_TRADE_FAMILY = ["PumpSwapBuy", "PumpSwapSell"];
+const PUMP_FEES_EVENT_TYPES = [
+    "PumpFeesCreateFeeSharingConfig",
+    "PumpFeesInitializeFeeConfig",
+    "PumpFeesResetFeeSharingConfig",
+    "PumpFeesRevokeFeeSharingAuthority",
+    "PumpFeesTransferFeeSharingAuthority",
+    "PumpFeesUpdateAdmin",
+    "PumpFeesUpdateFeeConfig",
+    "PumpFeesUpdateFeeShares",
+    "PumpFeesUpsertFeeTiers",
+];
+const PUMPFUN_FILTER_TYPES = [
+    "PumpFunTrade",
+    "PumpFunBuy",
+    "PumpFunSell",
+    "PumpFunBuyExactSolIn",
+    "PumpFunCreate",
+    "PumpFunCreateV2",
+    "PumpFunComplete",
+    "PumpFunMigrate",
+    "PumpFunMigrateBondingCurveCreator",
+];
+const PUMPSWAP_FILTER_TYPES = [
+    "PumpSwapTrade",
+    "PumpSwapBuy",
+    "PumpSwapSell",
+    "PumpSwapCreatePool",
+    "PumpSwapLiquidityAdded",
+    "PumpSwapLiquidityRemoved",
+];
+const METEORA_DAMM_V2_FILTER_TYPES = [
+    "MeteoraDammV2Swap",
+    "MeteoraDammV2AddLiquidity",
+    "MeteoraDammV2RemoveLiquidity",
+    "MeteoraDammV2CreatePosition",
+    "MeteoraDammV2InitializePool",
+    "MeteoraDammV2ClosePosition",
+];
+const METEORA_DBC_FILTER_TYPES = [
+    "MeteoraDbcSwap",
+    "MeteoraDbcInitializePool",
+    "MeteoraDbcCurveComplete",
+];
+const METEORA_POOLS_FILTER_TYPES = [
+    "MeteoraPoolsSwap",
+    "MeteoraPoolsAddLiquidity",
+    "MeteoraPoolsRemoveLiquidity",
+    "MeteoraPoolsBootstrapLiquidity",
+    "MeteoraPoolsPoolCreated",
+    "MeteoraPoolsSetPoolFees",
+];
+const METEORA_DLMM_FILTER_TYPES = [
+    "MeteoraDlmmSwap",
+    "MeteoraDlmmAddLiquidity",
+    "MeteoraDlmmRemoveLiquidity",
+    "MeteoraDlmmInitializePool",
+    "MeteoraDlmmInitializeBinArray",
+    "MeteoraDlmmCreatePosition",
+    "MeteoraDlmmClosePosition",
+    "MeteoraDlmmClaimFee",
+];
+const RAYDIUM_CLMM_FILTER_TYPES = [
+    "RaydiumClmmSwap",
+    "RaydiumClmmIncreaseLiquidity",
+    "RaydiumClmmDecreaseLiquidity",
+    "RaydiumClmmCreatePool",
+    "RaydiumClmmOpenPosition",
+    "RaydiumClmmOpenPositionWithTokenExtNft",
+    "RaydiumClmmClosePosition",
+    "RaydiumClmmCollectFee",
+];
+const RAYDIUM_CPMM_FILTER_TYPES = [
+    "RaydiumCpmmSwap",
+    "RaydiumCpmmDeposit",
+    "RaydiumCpmmWithdraw",
+    "RaydiumCpmmInitialize",
+];
+const RAYDIUM_AMM_V4_FILTER_TYPES = [
+    "RaydiumAmmV4Swap",
+    "RaydiumAmmV4Deposit",
+    "RaydiumAmmV4Withdraw",
+    "RaydiumAmmV4WithdrawPnl",
+    "RaydiumAmmV4Initialize2",
+];
+const ORCA_WHIRLPOOL_FILTER_TYPES = [
+    "OrcaWhirlpoolSwap",
+    "OrcaWhirlpoolLiquidityIncreased",
+    "OrcaWhirlpoolLiquidityDecreased",
+    "OrcaWhirlpoolPoolInitialized",
+];
+const RAYDIUM_LAUNCHLAB_FILTER_TYPES = [
+    "RaydiumLaunchlabTrade",
+    "RaydiumLaunchlabPoolCreate",
+    "RaydiumLaunchlabMigrateAmm",
+];
+const INSTRUCTION_EVENT_TYPES = [
+    ...PUMPFUN_FILTER_TYPES,
+    ...PUMP_FEES_EVENT_TYPES,
+    ...PUMPSWAP_FILTER_TYPES,
+    ...METEORA_DAMM_V2_FILTER_TYPES,
+    ...METEORA_POOLS_FILTER_TYPES,
+    ...METEORA_DLMM_FILTER_TYPES,
+    ...RAYDIUM_CLMM_FILTER_TYPES,
+    ...RAYDIUM_CPMM_FILTER_TYPES,
+    ...RAYDIUM_AMM_V4_FILTER_TYPES,
+    ...ORCA_WHIRLPOOL_FILTER_TYPES,
+    ...RAYDIUM_LAUNCHLAB_FILTER_TYPES,
+];
+const INSTRUCTION_EVENT_TYPE_SET = new Set(INSTRUCTION_EVENT_TYPES);
+const DEX_EVENT_TYPE_BY_VARIANT = {
+    PumpFunGlobalAccount: "AccountPumpFunGlobal",
+    PumpFunBondingCurveAccount: "AccountPumpFunBondingCurve",
+    PumpFunFeeConfigAccount: "AccountPumpFunFeeConfig",
+    PumpFunSharingConfigAccount: "AccountPumpFunSharingConfig",
+    PumpFunGlobalVolumeAccumulatorAccount: "AccountPumpFunGlobalVolumeAccumulator",
+    PumpFunUserVolumeAccumulatorAccount: "AccountPumpFunUserVolumeAccumulator",
+    PumpSwapGlobalConfigAccount: "AccountPumpSwapGlobalConfig",
+    PumpSwapPoolAccount: "AccountPumpSwapPool",
+};
+function eventTypeFromDexEvent(event) {
+    const variant = Object.keys(event)[0];
+    if (!variant || variant === "Error")
+        return null;
+    const mapped = DEX_EVENT_TYPE_BY_VARIANT[variant];
+    if (mapped)
+        return mapped;
+    return ALL_EVENT_TYPE_SET.has(variant) ? variant : null;
+}
+function eventTypeFilterShouldIncludeDexEvent(filter, event) {
+    const eventType = eventTypeFromDexEvent(event);
+    return eventType === null || filter.shouldInclude(eventType);
+}
 function eventTypeFilterIncludeOnly(types) {
     const include_only = types;
     return {
@@ -204,7 +379,21 @@ function eventTypeFilterIncludeOnly(types) {
             if (include_only.includes(eventType))
                 return true;
             if (eventType === "PumpFunTrade") {
-                return include_only.some((t) => ["PumpFunBuy", "PumpFunSell", "PumpFunBuyExactSolIn"].includes(t));
+                return eventTypesIntersect(include_only, PUMPFUN_TRADE_FAMILY);
+            }
+            if (isPumpfunTradeConcrete(eventType)) {
+                if (include_only.includes("PumpFunTrade"))
+                    return true;
+                if (isPumpfunBuyFamily(eventType)) {
+                    return eventTypesIntersect(include_only, PUMPFUN_BUY_FAMILY);
+                }
+                return false;
+            }
+            if (isPumpfunCreateFamily(eventType)) {
+                return eventTypesIntersect(include_only, PUMPFUN_CREATE_FAMILY);
+            }
+            if (isPumpswapTradeConcrete(eventType)) {
+                return include_only.includes("PumpSwapTrade");
             }
             return false;
         },
@@ -215,181 +404,104 @@ function eventTypeFilterExclude(types) {
     return {
         exclude_types,
         shouldInclude(eventType) {
-            return !exclude_types.includes(eventType);
+            if (exclude_types.includes(eventType))
+                return false;
+            if (isPumpfunTradeConcrete(eventType) && exclude_types.includes("PumpFunTrade")) {
+                return false;
+            }
+            if (isPumpfunBuyFamily(eventType) &&
+                eventTypesIntersect(exclude_types, PUMPFUN_BUY_FAMILY)) {
+                return false;
+            }
+            if (isPumpfunCreateFamily(eventType) &&
+                eventTypesIntersect(exclude_types, PUMPFUN_CREATE_FAMILY)) {
+                return false;
+            }
+            if (isPumpswapTradeConcrete(eventType) && exclude_types.includes("PumpSwapTrade")) {
+                return false;
+            }
+            return true;
         },
     };
 }
-/** 过滤器是否包含 PumpFun 相关类型 */
-function eventTypeFilterIncludesPumpfun(filter) {
+function eventTypesIntersect(types, candidates) {
+    return types.some((t) => candidates.includes(t));
+}
+function isPumpfunTradeConcrete(eventType) {
+    return (eventType === "PumpFunBuy" ||
+        eventType === "PumpFunSell" ||
+        eventType === "PumpFunBuyExactSolIn");
+}
+function isPumpfunBuyFamily(eventType) {
+    return eventType === "PumpFunBuy" || eventType === "PumpFunBuyExactSolIn";
+}
+function isPumpfunCreateFamily(eventType) {
+    return eventType === "PumpFunCreate" || eventType === "PumpFunCreateV2";
+}
+function isPumpswapTradeConcrete(eventType) {
+    return eventType === "PumpSwapBuy" || eventType === "PumpSwapSell";
+}
+function eventTypeFilterIncludesAny(filter, types) {
     if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "PumpFunTrade",
-            "PumpFunBuy",
-            "PumpFunSell",
-            "PumpFunBuyExactSolIn",
-            "PumpFunCreate",
-            "PumpFunCreateV2",
-            "PumpFunComplete",
-            "PumpFunMigrate",
-        ].includes(t));
+        return eventTypesIntersect(filter.include_only, types);
     }
     if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "PumpFunTrade",
-            "PumpFunBuy",
-            "PumpFunSell",
-            "PumpFunBuyExactSolIn",
-            "PumpFunCreate",
-            "PumpFunCreateV2",
-            "PumpFunComplete",
-            "PumpFunMigrate",
-        ].includes(t));
+        return types.some((t) => filter.shouldInclude(t));
     }
-    return true;
+    return types.some((t) => filter.shouldInclude(t));
+}
+/** 过滤器是否包含 PumpFun 相关类型 */
+function eventTypeFilterIncludesPumpfun(filter) {
+    return eventTypeFilterIncludesAny(filter, PUMPFUN_FILTER_TYPES);
+}
+/** 过滤器是否包含 Pump Fees (`pfeeUx...`) 相关类型 */
+function eventTypeFilterIncludesPumpFees(filter) {
+    return eventTypeFilterIncludesAny(filter, PUMP_FEES_EVENT_TYPES);
 }
 /** 过滤器是否包含 PumpSwap 相关类型 */
 function eventTypeFilterIncludesPumpswap(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "PumpSwapBuy",
-            "PumpSwapSell",
-            "PumpSwapCreatePool",
-            "PumpSwapLiquidityAdded",
-            "PumpSwapLiquidityRemoved",
-        ].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "PumpSwapBuy",
-            "PumpSwapSell",
-            "PumpSwapCreatePool",
-            "PumpSwapLiquidityAdded",
-            "PumpSwapLiquidityRemoved",
-        ].includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, PUMPSWAP_FILTER_TYPES);
 }
 /** 过滤器是否包含 Meteora DAMM V2 相关类型 */
 function eventTypeFilterIncludesMeteoraDammV2(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "MeteoraDammV2Swap",
-            "MeteoraDammV2AddLiquidity",
-            "MeteoraDammV2CreatePosition",
-            "MeteoraDammV2InitializePool",
-            "MeteoraDammV2ClosePosition",
-            "MeteoraDammV2RemoveLiquidity",
-            "MeteoraDammV2RemoveAllLiquidity",
-        ].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "MeteoraDammV2Swap",
-            "MeteoraDammV2AddLiquidity",
-            "MeteoraDammV2CreatePosition",
-            "MeteoraDammV2InitializePool",
-            "MeteoraDammV2ClosePosition",
-            "MeteoraDammV2RemoveLiquidity",
-            "MeteoraDammV2RemoveAllLiquidity",
-        ].includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, METEORA_DAMM_V2_FILTER_TYPES);
+}
+/** 过滤器是否包含 Meteora DBC 相关类型 */
+function eventTypeFilterIncludesMeteoraDbc(filter) {
+    return eventTypeFilterIncludesAny(filter, METEORA_DBC_FILTER_TYPES);
+}
+/** 过滤器是否包含 Meteora Pools 相关类型 */
+function eventTypeFilterIncludesMeteoraPools(filter) {
+    return eventTypeFilterIncludesAny(filter, METEORA_POOLS_FILTER_TYPES);
+}
+/** 过滤器是否包含 Meteora DLMM 相关类型 */
+function eventTypeFilterIncludesMeteoraDlmm(filter) {
+    return eventTypeFilterIncludesAny(filter, METEORA_DLMM_FILTER_TYPES);
 }
 /** 过滤器是否包含 Raydium CLMM 相关类型 */
 function eventTypeFilterIncludesRaydiumClmm(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "RaydiumClmmSwap",
-            "RaydiumClmmIncreaseLiquidity",
-            "RaydiumClmmDecreaseLiquidity",
-            "RaydiumClmmCreatePool",
-        ].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "RaydiumClmmSwap",
-            "RaydiumClmmIncreaseLiquidity",
-            "RaydiumClmmDecreaseLiquidity",
-            "RaydiumClmmCreatePool",
-        ].includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_CLMM_FILTER_TYPES);
 }
 /** 过滤器是否包含 Raydium CPMM 相关类型 */
 function eventTypeFilterIncludesRaydiumCpmm(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "RaydiumCpmmSwap",
-            "RaydiumCpmmDeposit",
-            "RaydiumCpmmWithdraw",
-        ].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "RaydiumCpmmSwap",
-            "RaydiumCpmmDeposit",
-            "RaydiumCpmmWithdraw",
-        ].includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_CPMM_FILTER_TYPES);
 }
 /** 过滤器是否包含 Raydium AMM V4 相关类型 */
 function eventTypeFilterIncludesRaydiumAmmV4(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => ["RaydiumAmmV4Swap"].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => ["RaydiumAmmV4Swap"].includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_AMM_V4_FILTER_TYPES);
 }
 /** 过滤器是否包含 Orca Whirlpool 相关类型 */
 function eventTypeFilterIncludesOrcaWhirlpool(filter) {
-    if (filter.include_only) {
-        return filter.include_only.some((t) => [
-            "OrcaWhirlpoolSwap",
-            "OrcaWhirlpoolLiquidityIncreased",
-            "OrcaWhirlpoolLiquidityDecreased",
-        ].includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => [
-            "OrcaWhirlpoolSwap",
-            "OrcaWhirlpoolLiquidityIncreased",
-            "OrcaWhirlpoolLiquidityDecreased",
-        ].includes(t));
-    }
-    return true;
-}
-/** 过滤器是否包含 Bonk Launchpad 相关类型（与 Rust `includes_raydium_launchpad` / Bonk 集合一致） */
-function eventTypeFilterIncludesBonk(filter) {
-    const bonk = ["BonkTrade", "BonkPoolCreate", "BonkMigrateAmm"];
-    if (filter.include_only) {
-        return filter.include_only.some((t) => bonk.includes(t));
-    }
-    if (filter.exclude_types) {
-        return !filter.exclude_types.some((t) => bonk.includes(t));
-    }
-    return true;
+    return eventTypeFilterIncludesAny(filter, ORCA_WHIRLPOOL_FILTER_TYPES);
 }
-/** 与 Rust `EventTypeFilter::includes_raydium_launchpad` 同名语义 */
-function eventTypeFilterIncludesRaydiumLaunchpad(filter) {
-    return eventTypeFilterIncludesBonk(filter);
+/** 过滤器是否包含 Raydium LaunchLab 相关类型（与 Rust `includes_raydium_launchlab` 集合一致） */
+function eventTypeFilterIncludesRaydiumLaunchlab(filter) {
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_LAUNCHLAB_FILTER_TYPES);
 }
 /**
  * `parseInstructionUnified` 前置白名单：仅当 `include_only` 与下列指令相关类型有交集时才解析指令。
  * 若白名单中不含下列任一类型，则整条指令解析入口返回 null。
  */
 function eventTypeFilterAllowsInstructionParsing(includeOnly) {
-    const ix = [
-        "PumpFunMigrate",
-        "MeteoraDammV2Swap",
-        "MeteoraDammV2AddLiquidity",
-        "MeteoraDammV2CreatePosition",
-        "MeteoraDammV2InitializePool",
-        "MeteoraDammV2ClosePosition",
-        "MeteoraDammV2RemoveLiquidity",
-        "MeteoraDammV2RemoveAllLiquidity",
-    ];
-    return includeOnly.some((t) => ix.includes(t));
+    return includeOnly.some((t) => INSTRUCTION_EVENT_TYPE_SET.has(t));
 }

package/dist/grpc/yellowstone_parse.d.ts

@@ -1,5 +1,5 @@
 import type { DexEvent } from "../core/dex_event.js";
-import type { SubscribeUpdateTransactionInfo } from "./types.js";
+import type { EventTypeFilter, SubscribeUpdateTransactionInfo } from "./types.js";
 /**
  * Yellowstone `SubscribeUpdateTransactionInfo.index` → `EventMetadata.tx_index`。
  * 与 Rust `sol-parser-sdk` gRPC 路径中 `let idx = info.index` 传入 `parse_logs(..., idx, ...)` 一致。
@@ -11,4 +11,6 @@ export declare function grpcTxIndexFromInfo(info: Pick<SubscribeUpdateTransactio
  */
 export declare function parseDexEventsFromGrpcTransactionInfo(info: SubscribeUpdateTransactionInfo, slot: string | bigint, options?: {
     blockTimeUs?: number;
+    grpcRecvUs?: number;
+    eventTypeFilter?: EventTypeFilter;
 }): DexEvent[];

package/dist/grpc/yellowstone_parse.js

@@ -6,14 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.grpcTxIndexFromInfo = grpcTxIndexFromInfo;
 exports.parseDexEventsFromGrpcTransactionInfo = parseDexEventsFromGrpcTransactionInfo;
 /**
- * Yellowstone gRPC 单笔交易：日志解析 + 与 Rust `parse_logs` 相同的账户/数据填充。
+ * Yellowstone gRPC 单笔交易：统一交易解析（指令 + 日志 + 与 Rust 相同的账户/数据填充）。
  * 依赖 `@triton-one/yellowstone-grpc` 的 `txEncode`（Binary）得到与 web3 兼容的 meta + 反序列化交易。
  */
 const yellowstone_grpc_1 = require("@triton-one/yellowstone-grpc");
 const yellowstone_grpc_solana_encoding_wasm_js_1 = require("@triton-one/yellowstone-grpc/dist/encoding/yellowstone_grpc_solana_encoding_wasm.js");
 const bs58_1 = __importDefault(require("bs58"));
 const web3_js_1 = require("@solana/web3.js");
-const unified_parser_js_1 = require("../core/unified_parser.js");
 const rpc_transaction_js_1 = require("../rpc_transaction.js");
 /**
  * Yellowstone `SubscribeUpdateTransactionInfo.index` → `EventMetadata.tx_index`。
@@ -45,15 +44,19 @@ function parseDexEventsFromGrpcTransactionInfo(info, slot, options) {
     const enc = yellowstone_grpc_1.txEncode.encode(y, yellowstone_grpc_solana_encoding_wasm_js_1.WasmUiTransactionEncoding.Binary, 0, false);
     const vt = web3_js_1.VersionedTransaction.deserialize(bs58_1.default.decode(enc.transaction));
     const meta = enc.meta;
-    const logs = meta?.logMessages;
-    if (!Array.isArray(logs) || logs.length === 0)
-        return [];
     const slotNum = typeof slot === "bigint" ? Number(slot) : Number(slot);
     const signatureBase58 = bs58_1.default.encode(Uint8Array.from(info.signature));
     const txIndex = grpcTxIndexFromInfo(info);
-    const events = (0, unified_parser_js_1.parseLogsOnly)(logs, signatureBase58, slotNum, options?.blockTimeUs, txIndex);
-    if (events.length === 0)
-        return [];
-    (0, rpc_transaction_js_1.applyAccountFillsToLogEvents)(events, vt.message, meta);
-    return events;
+    const blockTime = options?.blockTimeUs == null ? null : Math.floor(options.blockTimeUs / 1_000_000);
+    const parsed = (0, rpc_transaction_js_1.parseRpcTransaction)({
+        slot: slotNum,
+        blockTime,
+        meta,
+        transaction: vt,
+    }, signatureBase58, options?.eventTypeFilter, {
+        blockTimeUs: options?.blockTimeUs,
+        grpcRecvUs: options?.grpcRecvUs,
+        txIndex,
+    });
+    return parsed.ok ? parsed.events : [];
 }