sol-parser-sdk 0.5.9

package/dist/grpc/types.js

@@ -0,0 +1,551 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_EVENT_TYPES = void 0;
+exports.defaultClientConfig = defaultClientConfig;
+exports.lowLatencyClientConfig = lowLatencyClientConfig;
+exports.highThroughputClientConfig = highThroughputClientConfig;
+exports.newTransactionFilter = newTransactionFilter;
+exports.transactionFilterFromProgramIds = transactionFilterFromProgramIds;
+exports.newAccountFilter = newAccountFilter;
+exports.newSlotFilter = newSlotFilter;
+exports.slotFilterMinSlot = slotFilterMinSlot;
+exports.slotFilterMaxSlot = slotFilterMaxSlot;
+exports.accountFilterFromProgramOwners = accountFilterFromProgramOwners;
+exports.accountFilterMemcmp = accountFilterMemcmp;
+exports.eventTypeFromDexEvent = eventTypeFromDexEvent;
+exports.eventTypeFilterShouldIncludeDexEvent = eventTypeFilterShouldIncludeDexEvent;
+exports.eventTypeFilterNormalizeDexEvent = eventTypeFilterNormalizeDexEvent;
+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.eventTypeFilterIncludesRaydiumLaunchlab = eventTypeFilterIncludesRaydiumLaunchlab;
+exports.eventTypeFilterAllowsInstructionParsing = eventTypeFilterAllowsInstructionParsing;
+function defaultClientConfig() {
+    return {
+        enable_metrics: false,
+        connection_timeout_ms: 8000,
+        request_timeout_ms: 15000,
+        enable_tls: true,
+        max_retries: 3,
+        retry_delay_ms: 1000,
+        max_concurrent_streams: 100,
+        keep_alive_interval_ms: 30000,
+        keep_alive_timeout_ms: 5000,
+        buffer_size: 8192,
+        order_mode: "Unordered",
+        order_timeout_ms: 100,
+        micro_batch_us: 100,
+    };
+}
+/** 与 Rust `ClientConfig::low_latency` 一致 */
+function lowLatencyClientConfig() {
+    return {
+        enable_metrics: false,
+        connection_timeout_ms: 5000,
+        request_timeout_ms: 10_000,
+        enable_tls: true,
+        max_retries: 1,
+        retry_delay_ms: 100,
+        max_concurrent_streams: 200,
+        keep_alive_interval_ms: 10_000,
+        keep_alive_timeout_ms: 2000,
+        buffer_size: 16384,
+        order_mode: "Unordered",
+        order_timeout_ms: 50,
+        micro_batch_us: 50,
+    };
+}
+/** 与 Rust `ClientConfig::high_throughput` 一致 */
+function highThroughputClientConfig() {
+    return {
+        enable_metrics: true,
+        connection_timeout_ms: 10_000,
+        request_timeout_ms: 30_000,
+        enable_tls: true,
+        max_retries: 5,
+        retry_delay_ms: 2000,
+        max_concurrent_streams: 500,
+        keep_alive_interval_ms: 60_000,
+        keep_alive_timeout_ms: 10_000,
+        buffer_size: 32768,
+        order_mode: "Unordered",
+        order_timeout_ms: 200,
+        micro_batch_us: 200,
+    };
+}
+function newTransactionFilter() {
+    return { account_include: [], account_exclude: [], account_required: [] };
+}
+/** 与 Rust `TransactionFilter::from_program_ids` 一致 */
+function transactionFilterFromProgramIds(programIds) {
+    return {
+        account_include: [...programIds],
+        account_exclude: [],
+        account_required: [],
+    };
+}
+function newAccountFilter() {
+    return { account: [], owner: [], filters: [] };
+}
+function newSlotFilter() {
+    return {};
+}
+function slotFilterMinSlot(filter, slot) {
+    return { ...filter, min_slot: slot };
+}
+function slotFilterMaxSlot(filter, slot) {
+    return { ...filter, max_slot: slot };
+}
+/** 与 Rust `AccountFilter::from_program_owners` 一致 */
+function accountFilterFromProgramOwners(programIds) {
+    return { account: [], owner: [...programIds], filters: [] };
+}
+/**
+ * 构造 memcmp 账户过滤器（与 Rust `account_filter_memcmp` 一致）。
+ * ATA 常在 offset 0 放 mint；PumpSwap 池子等常在 offset 32。
+ */
+function accountFilterMemcmp(offset, bytes) {
+    return {
+        memcmp: {
+            offset: String(offset),
+            bytes,
+        },
+    };
+}
+/** 所有事件类型列表 */
+exports.ALL_EVENT_TYPES = [
+    // Block
+    "BlockMeta",
+    // RaydiumLaunchlab
+    "RaydiumLaunchlabTrade",
+    "RaydiumLaunchlabPoolCreate",
+    "RaydiumLaunchlabMigrateAmm",
+    // PumpFun
+    "PumpFunTrade",
+    "PumpFunBuy",
+    "PumpFunSell",
+    "PumpFunBuyExactSolIn",
+    "PumpFunCreate",
+    "PumpFunCreateV2",
+    "PumpFunComplete",
+    "PumpFunMigrate",
+    "PumpFeesCreateFeeSharingConfig",
+    "PumpFeesInitializeFeeConfig",
+    "PumpFeesResetFeeSharingConfig",
+    "PumpFeesRevokeFeeSharingAuthority",
+    "PumpFeesTransferFeeSharingAuthority",
+    "PumpFeesUpdateAdmin",
+    "PumpFeesUpdateFeeConfig",
+    "PumpFeesUpdateFeeShares",
+    "PumpFeesUpsertFeeTiers",
+    "PumpFunMigrateBondingCurveCreator",
+    // PumpSwap
+    "PumpSwapTrade",
+    "PumpSwapBuy",
+    "PumpSwapSell",
+    "PumpSwapCreatePool",
+    "PumpSwapLiquidityAdded",
+    "PumpSwapLiquidityRemoved",
+    // Raydium CPMM
+    "RaydiumCpmmSwap",
+    "RaydiumCpmmDeposit",
+    "RaydiumCpmmWithdraw",
+    "RaydiumCpmmInitialize",
+    // Raydium CLMM
+    "RaydiumClmmSwap",
+    "RaydiumClmmCreatePool",
+    "RaydiumClmmOpenPosition",
+    "RaydiumClmmClosePosition",
+    "RaydiumClmmIncreaseLiquidity",
+    "RaydiumClmmDecreaseLiquidity",
+    "RaydiumClmmLiquidityChange",
+    "RaydiumClmmConfigChange",
+    "RaydiumClmmCreatePersonalPosition",
+    "RaydiumClmmLiquidityCalculate",
+    "RaydiumClmmOpenLimitOrder",
+    "RaydiumClmmIncreaseLimitOrder",
+    "RaydiumClmmDecreaseLimitOrder",
+    "RaydiumClmmSettleLimitOrder",
+    "RaydiumClmmUpdateRewardInfos",
+    "RaydiumClmmOpenPositionWithTokenExtNft",
+    "RaydiumClmmCollectFee",
+    // Raydium AMM V4
+    "RaydiumAmmV4Swap",
+    "RaydiumAmmV4Deposit",
+    "RaydiumAmmV4Withdraw",
+    "RaydiumAmmV4Initialize2",
+    "RaydiumAmmV4WithdrawPnl",
+    // Orca Whirlpool
+    "OrcaWhirlpoolSwap",
+    "OrcaWhirlpoolLiquidityIncreased",
+    "OrcaWhirlpoolLiquidityDecreased",
+    "OrcaWhirlpoolPoolInitialized",
+    // Meteora Pools
+    "MeteoraPoolsSwap",
+    "MeteoraPoolsAddLiquidity",
+    "MeteoraPoolsRemoveLiquidity",
+    "MeteoraPoolsBootstrapLiquidity",
+    "MeteoraPoolsPoolCreated",
+    "MeteoraPoolsSetPoolFees",
+    // Meteora DAMM V2
+    "MeteoraDammV2Swap",
+    "MeteoraDammV2AddLiquidity",
+    "MeteoraDammV2RemoveLiquidity",
+    "MeteoraDammV2InitializePool",
+    "MeteoraDammV2CreatePosition",
+    "MeteoraDammV2ClosePosition",
+    // Meteora DBC
+    "MeteoraDbcSwap",
+    "MeteoraDbcInitializePool",
+    "MeteoraDbcCurveComplete",
+    // Meteora DLMM
+    "MeteoraDlmmSwap",
+    "MeteoraDlmmAddLiquidity",
+    "MeteoraDlmmRemoveLiquidity",
+    "MeteoraDlmmInitializePool",
+    "MeteoraDlmmInitializeBinArray",
+    "MeteoraDlmmCreatePosition",
+    "MeteoraDlmmClosePosition",
+    "MeteoraDlmmClaimFee",
+    // 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",
+    "RaydiumClmmLiquidityChange",
+    "RaydiumClmmConfigChange",
+    "RaydiumClmmCreatePersonalPosition",
+    "RaydiumClmmLiquidityCalculate",
+    "RaydiumClmmOpenLimitOrder",
+    "RaydiumClmmIncreaseLimitOrder",
+    "RaydiumClmmDecreaseLimitOrder",
+    "RaydiumClmmSettleLimitOrder",
+    "RaydiumClmmUpdateRewardInfos",
+    "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",
+    RaydiumClmmAmmConfigAccount: "AccountRaydiumClmmAmmConfig",
+    RaydiumClmmPoolStateAccount: "AccountRaydiumClmmPoolState",
+    RaydiumClmmTickArrayStateAccount: "AccountRaydiumClmmTickArrayState",
+    RaydiumCpmmAmmConfigAccount: "AccountRaydiumCpmmAmmConfig",
+    RaydiumCpmmPoolStateAccount: "AccountRaydiumCpmmPoolState",
+    OrcaWhirlpoolAccount: "AccountOrcaWhirlpool",
+    OrcaPositionAccount: "AccountOrcaPosition",
+    OrcaTickArrayAccount: "AccountOrcaTickArray",
+    OrcaFeeTierAccount: "AccountOrcaFeeTier",
+    OrcaWhirlpoolsConfigAccount: "AccountOrcaWhirlpoolsConfig",
+};
+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 eventTypeFilterNormalizeDexEvent(filter, event) {
+    const includeOnly = filter.include_only;
+    if (!includeOnly || !includeOnly.includes("PumpFunTrade"))
+        return event;
+    const hasSpecificTradeFilter = includeOnly.some((t) => isPumpfunTradeConcrete(t));
+    if (hasSpecificTradeFilter)
+        return event;
+    if ("PumpFunBuy" in event)
+        return { PumpFunTrade: event.PumpFunBuy };
+    if ("PumpFunSell" in event)
+        return { PumpFunTrade: event.PumpFunSell };
+    if ("PumpFunBuyExactSolIn" in event)
+        return { PumpFunTrade: event.PumpFunBuyExactSolIn };
+    return event;
+}
+function eventTypeFilterIncludeOnly(types) {
+    const include_only = types;
+    return {
+        include_only,
+        shouldInclude(eventType) {
+            if (include_only.includes(eventType))
+                return true;
+            if (eventType === "PumpFunTrade") {
+                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;
+        },
+    };
+}
+function eventTypeFilterExclude(types) {
+    const exclude_types = types;
+    return {
+        exclude_types,
+        shouldInclude(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;
+        },
+    };
+}
+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 eventTypesIntersect(filter.include_only, types);
+    }
+    if (filter.exclude_types) {
+        return types.some((t) => filter.shouldInclude(t));
+    }
+    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) {
+    return eventTypeFilterIncludesAny(filter, PUMPSWAP_FILTER_TYPES);
+}
+/** 过滤器是否包含 Meteora DAMM V2 相关类型 */
+function eventTypeFilterIncludesMeteoraDammV2(filter) {
+    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) {
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_CLMM_FILTER_TYPES);
+}
+/** 过滤器是否包含 Raydium CPMM 相关类型 */
+function eventTypeFilterIncludesRaydiumCpmm(filter) {
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_CPMM_FILTER_TYPES);
+}
+/** 过滤器是否包含 Raydium AMM V4 相关类型 */
+function eventTypeFilterIncludesRaydiumAmmV4(filter) {
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_AMM_V4_FILTER_TYPES);
+}
+/** 过滤器是否包含 Orca Whirlpool 相关类型 */
+function eventTypeFilterIncludesOrcaWhirlpool(filter) {
+    return eventTypeFilterIncludesAny(filter, ORCA_WHIRLPOOL_FILTER_TYPES);
+}
+/** 过滤器是否包含 Raydium LaunchLab 相关类型（与 Rust `includes_raydium_launchlab` 集合一致） */
+function eventTypeFilterIncludesRaydiumLaunchlab(filter) {
+    return eventTypeFilterIncludesAny(filter, RAYDIUM_LAUNCHLAB_FILTER_TYPES);
+}
+/**
+ * `parseInstructionUnified` 前置白名单：仅当 `include_only` 与下列指令相关类型有交集时才解析指令。
+ * 若白名单中不含下列任一类型，则整条指令解析入口返回 null。
+ */
+function eventTypeFilterAllowsInstructionParsing(includeOnly) {
+    return includeOnly.some((t) => INSTRUCTION_EVENT_TYPE_SET.has(t));
+}

package/dist/grpc/yellowstone_parse.d.ts

@@ -0,0 +1,16 @@
+import type { DexEvent } from "../core/dex_event.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, ...)` 一致。
+ */
+export declare function grpcTxIndexFromInfo(info: Pick<SubscribeUpdateTransactionInfo, "index">): number;
+/**
+ * 从 gRPC 回调中的 `SubscribeUpdateTransactionInfo`（须含 `transactionRaw` + `metaRaw` 原始 proto）
+ * 解析 `DexEvent[]`，并对 PumpSwap/PumpFun 等补齐 mint、池子 ATA 等（与 Rust 订阅路径一致）。
+ */
+export declare function parseDexEventsFromGrpcTransactionInfo(info: SubscribeUpdateTransactionInfo, slot: string | bigint, options?: {
+    blockTimeUs?: number;
+    grpcRecvUs?: number;
+    eventTypeFilter?: EventTypeFilter;
+}): DexEvent[];

package/dist/grpc/yellowstone_parse.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.grpcTxIndexFromInfo = grpcTxIndexFromInfo;
+exports.parseDexEventsFromGrpcTransactionInfo = parseDexEventsFromGrpcTransactionInfo;
+/**
+ * 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 rpc_transaction_js_1 = require("../rpc_transaction.js");
+/**
+ * Yellowstone `SubscribeUpdateTransactionInfo.index` → `EventMetadata.tx_index`。
+ * 与 Rust `sol-parser-sdk` gRPC 路径中 `let idx = info.index` 传入 `parse_logs(..., idx, ...)` 一致。
+ */
+function grpcTxIndexFromInfo(info) {
+    const index = info.index;
+    if (index === undefined)
+        return 0;
+    const n = typeof index === "bigint" ? Number(index) : Number(index);
+    return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 0;
+}
+/**
+ * 从 gRPC 回调中的 `SubscribeUpdateTransactionInfo`（须含 `transactionRaw` + `metaRaw` 原始 proto）
+ * 解析 `DexEvent[]`，并对 PumpSwap/PumpFun 等补齐 mint、池子 ATA 等（与 Rust 订阅路径一致）。
+ */
+function parseDexEventsFromGrpcTransactionInfo(info, slot, options) {
+    const tr = info.transactionRaw;
+    const mr = info.metaRaw;
+    if (!tr || !mr)
+        return [];
+    const y = {
+        signature: info.signature,
+        isVote: info.isVote,
+        transaction: tr,
+        meta: mr,
+        index: String(info.index),
+    };
+    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 slotNum = typeof slot === "bigint" ? Number(slot) : Number(slot);
+    const signatureBase58 = bs58_1.default.encode(Uint8Array.from(info.signature));
+    const txIndex = grpcTxIndexFromInfo(info);
+    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 : [];
+}