1use serde::{Deserialize, Serialize};
2use yellowstone_grpc_proto::geyser::{
3 subscribe_request_filter_accounts_filter::Filter as AccountsFilterOneof,
4 subscribe_request_filter_accounts_filter_memcmp::Data as MemcmpDataOneof,
5 SubscribeRequestFilterAccountsFilter, SubscribeRequestFilterAccountsFilterMemcmp,
6};
7
8#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
10pub enum OrderMode {
11 #[default]
13 Unordered,
14 Ordered,
19 StreamingOrdered,
23 MicroBatch,
27}
28
29#[derive(Debug, Clone, Serialize, Deserialize)]
30pub struct ClientConfig {
31 pub enable_metrics: bool,
33 pub connection_timeout_ms: u64,
35 pub request_timeout_ms: u64,
37 pub enable_tls: bool,
39 pub max_retries: u32,
40 pub retry_delay_ms: u64,
43 pub max_concurrent_streams: u32,
44 pub keep_alive_interval_ms: u64,
45 pub keep_alive_timeout_ms: u64,
46 pub buffer_size: usize,
47 pub order_mode: OrderMode,
49 pub order_timeout_ms: u64,
52 pub micro_batch_us: u64,
55}
56
57impl Default for ClientConfig {
58 fn default() -> Self {
59 Self {
60 enable_metrics: false,
61 connection_timeout_ms: 8000,
62 request_timeout_ms: 15000,
63 enable_tls: true,
64 max_retries: 3,
65 retry_delay_ms: 1000,
66 max_concurrent_streams: 100,
67 keep_alive_interval_ms: 30000,
68 keep_alive_timeout_ms: 5000,
69 buffer_size: 100_000,
70 order_mode: OrderMode::Unordered,
71 order_timeout_ms: 100,
72 micro_batch_us: 100, }
74 }
75}
76
77impl ClientConfig {
78 pub fn low_latency() -> Self {
79 Self {
80 enable_metrics: false,
81 connection_timeout_ms: 5000,
82 request_timeout_ms: 10000,
83 enable_tls: true,
84 max_retries: 1,
85 retry_delay_ms: 100,
86 max_concurrent_streams: 200,
87 keep_alive_interval_ms: 10000,
88 keep_alive_timeout_ms: 2000,
89 buffer_size: 100_000,
90 order_mode: OrderMode::Unordered,
91 order_timeout_ms: 50,
92 micro_batch_us: 50, }
94 }
95
96 pub fn high_throughput() -> Self {
97 Self {
98 enable_metrics: true,
99 connection_timeout_ms: 10000,
100 request_timeout_ms: 30000,
101 enable_tls: true,
102 max_retries: 5,
103 retry_delay_ms: 2000,
104 max_concurrent_streams: 500,
105 keep_alive_interval_ms: 60000,
106 keep_alive_timeout_ms: 10000,
107 buffer_size: 200_000,
108 order_mode: OrderMode::Unordered,
109 order_timeout_ms: 200,
110 micro_batch_us: 200, }
112 }
113}
114
115#[derive(Debug, Clone)]
116pub struct TransactionFilter {
117 pub account_include: Vec<String>,
118 pub account_exclude: Vec<String>,
119 pub account_required: Vec<String>,
120}
121
122impl TransactionFilter {
123 pub fn new() -> Self {
124 Self {
125 account_include: Vec::new(),
126 account_exclude: Vec::new(),
127 account_required: Vec::new(),
128 }
129 }
130
131 pub fn include_account(mut self, account: impl Into<String>) -> Self {
132 self.account_include.push(account.into());
133 self
134 }
135
136 pub fn exclude_account(mut self, account: impl Into<String>) -> Self {
137 self.account_exclude.push(account.into());
138 self
139 }
140
141 pub fn require_account(mut self, account: impl Into<String>) -> Self {
142 self.account_required.push(account.into());
143 self
144 }
145
146 pub fn from_program_ids(program_ids: Vec<String>) -> Self {
148 Self {
149 account_include: program_ids,
150 account_exclude: Vec::new(),
151 account_required: Vec::new(),
152 }
153 }
154}
155
156impl Default for TransactionFilter {
157 fn default() -> Self {
158 Self::new()
159 }
160}
161
162#[derive(Debug, Clone)]
163pub struct AccountFilter {
164 pub account: Vec<String>,
165 pub owner: Vec<String>,
166 pub filters: Vec<SubscribeRequestFilterAccountsFilter>,
167}
168
169impl AccountFilter {
170 pub fn new() -> Self {
171 Self { account: Vec::new(), owner: Vec::new(), filters: Vec::new() }
172 }
173
174 pub fn add_account(mut self, account: impl Into<String>) -> Self {
175 self.account.push(account.into());
176 self
177 }
178
179 pub fn add_owner(mut self, owner: impl Into<String>) -> Self {
180 self.owner.push(owner.into());
181 self
182 }
183
184 pub fn add_filter(mut self, filter: SubscribeRequestFilterAccountsFilter) -> Self {
185 self.filters.push(filter);
186 self
187 }
188
189 pub fn from_program_owners(program_ids: Vec<String>) -> Self {
191 Self { account: Vec::new(), owner: program_ids, filters: Vec::new() }
192 }
193}
194
195impl Default for AccountFilter {
196 fn default() -> Self {
197 Self::new()
198 }
199}
200
201#[inline]
204pub fn account_filter_memcmp(offset: u64, bytes: Vec<u8>) -> SubscribeRequestFilterAccountsFilter {
205 SubscribeRequestFilterAccountsFilter {
206 filter: Some(AccountsFilterOneof::Memcmp(SubscribeRequestFilterAccountsFilterMemcmp {
207 offset,
208 data: Some(MemcmpDataOneof::Bytes(bytes)),
209 })),
210 }
211}
212
213#[derive(Debug, Clone)]
214pub struct AccountFilterData {
215 pub memcmp: Option<AccountFilterMemcmp>,
216 pub datasize: Option<u64>,
217}
218
219#[derive(Debug, Clone)]
220pub struct AccountFilterMemcmp {
221 pub offset: u64,
222 pub bytes: Vec<u8>,
223}
224
225#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
226pub enum Protocol {
227 PumpFun,
228 PumpSwap,
229 PumpFees,
230 LaunchLab,
232 StonkFun,
234 RaydiumLaunchlab,
236 RaydiumCpmm,
237 RaydiumClmm,
238 RaydiumAmmV4,
239 OrcaWhirlpool,
240 MeteoraPools,
241 MeteoraDammV2,
242 MeteoraDlmm,
243 MeteoraDbc,
244}
245
246#[derive(Debug, Clone, Copy, PartialEq, Eq)]
247#[non_exhaustive]
248pub enum EventType {
249 BlockMeta,
251
252 RaydiumLaunchlabTrade,
254 RaydiumLaunchlabPoolCreate,
255 RaydiumLaunchlabMigrateAmm,
256
257 PumpFunTrade, PumpFunBuy, PumpFunSell, PumpFunBuyExactSolIn, PumpFunCreate,
263 PumpFunCreateV2, PumpFunComplete,
265 PumpFunMigrate,
266 PumpFeesCreateFeeSharingConfig,
268 PumpFeesInitializeFeeConfig,
269 PumpFeesResetFeeSharingConfig,
270 PumpFeesRevokeFeeSharingAuthority,
271 PumpFeesTransferFeeSharingAuthority,
272 PumpFeesUpdateAdmin,
273 PumpFeesUpdateFeeConfig,
274 PumpFeesUpdateFeeShares,
275 PumpFeesUpsertFeeTiers,
276 PumpFunMigrateBondingCurveCreator,
278
279 PumpSwapTrade,
281 PumpSwapBuy,
282 PumpSwapSell,
283 PumpSwapCreatePool,
284 PumpSwapLiquidityAdded,
285 PumpSwapLiquidityRemoved,
286 RaydiumCpmmSwap,
291 RaydiumCpmmDeposit,
292 RaydiumCpmmWithdraw,
293 RaydiumCpmmInitialize,
294
295 RaydiumClmmSwap,
297 RaydiumClmmCreatePool,
298 RaydiumClmmOpenPosition,
299 RaydiumClmmClosePosition,
300 RaydiumClmmIncreaseLiquidity,
301 RaydiumClmmDecreaseLiquidity,
302 RaydiumClmmLiquidityChange,
303 RaydiumClmmConfigChange,
304 RaydiumClmmCreatePersonalPosition,
305 RaydiumClmmLiquidityCalculate,
306 RaydiumClmmOpenLimitOrder,
307 RaydiumClmmIncreaseLimitOrder,
308 RaydiumClmmDecreaseLimitOrder,
309 RaydiumClmmSettleLimitOrder,
310 RaydiumClmmUpdateRewardInfos,
311 RaydiumClmmOpenPositionWithTokenExtNft,
312 RaydiumClmmCollectFee,
313
314 RaydiumAmmV4Swap,
316 RaydiumAmmV4Deposit,
317 RaydiumAmmV4Withdraw,
318 RaydiumAmmV4Initialize2,
319 RaydiumAmmV4WithdrawPnl,
320
321 OrcaWhirlpoolSwap,
323 OrcaWhirlpoolLiquidityIncreased,
324 OrcaWhirlpoolLiquidityDecreased,
325 OrcaWhirlpoolPoolInitialized,
326
327 MeteoraPoolsSwap,
329 MeteoraPoolsAddLiquidity,
330 MeteoraPoolsRemoveLiquidity,
331 MeteoraPoolsBootstrapLiquidity,
332 MeteoraPoolsPoolCreated,
333 MeteoraPoolsSetPoolFees,
334
335 MeteoraDammV2Swap,
337 MeteoraDammV2AddLiquidity,
338 MeteoraDammV2RemoveLiquidity,
339 MeteoraDammV2InitializePool,
340 MeteoraDammV2CreatePosition,
341 MeteoraDammV2ClaimPositionFee,
342 MeteoraDammV2ClaimReward,
343 MeteoraDlmmClaimReward,
344 MeteoraDammV2ClosePosition,
345 MeteoraDammV2UpdateDelegatePermission,
346 MeteoraDammV2WithdrawDeadLiquidityReward,
347 MeteoraDammV2WithdrawIneligibleReward,
348 MeteoraDammV2UpdateRewardFunder,
349 MeteoraDammV2UpdateRewardDuration,
350 MeteoraDammV2InitializeReward,
351 MeteoraDammV2FundReward,
352 MeteoraDammV2CreateConfig,
353 MeteoraDammV2CreateDynamicConfig,
354 MeteoraDbcSwap,
361 MeteoraDbcInitializePool,
362 MeteoraDbcCurveComplete,
363
364 MeteoraDlmmSwap,
366 MeteoraDlmmAddLiquidity,
367 MeteoraDlmmRemoveLiquidity,
368 MeteoraDlmmInitializePool,
369 MeteoraDlmmInitializeBinArray,
370 MeteoraDlmmCreatePosition,
371 MeteoraDlmmClosePosition,
372 MeteoraDlmmClaimFee,
373
374 TokenAccount,
376 TokenInfo,
377 NonceAccount,
378 AccountPumpFunGlobal,
379 AccountPumpFunBondingCurve,
380 AccountPumpFunFeeConfig,
381 AccountPumpFunSharingConfig,
382 AccountPumpFunGlobalVolumeAccumulator,
383 AccountPumpFunUserVolumeAccumulator,
384
385 AccountPumpSwapGlobalConfig,
386 AccountPumpSwapPool,
387 AccountRaydiumClmmAmmConfig,
388 AccountRaydiumClmmPoolState,
389 AccountRaydiumClmmTickArrayState,
390 AccountRaydiumCpmmAmmConfig,
391 AccountRaydiumCpmmPoolState,
392 RaydiumCpmmCollectCreatorFee,
393 AccountRaydiumCpmmCreatorFeeShare,
394 AccountOrcaWhirlpool,
395 AccountOrcaPosition,
396 AccountOrcaTickArray,
397 AccountLiquiditySnapshot,
398 AccountRawSnapshot,
400 AccountOrcaFeeTier,
401 AccountOrcaWhirlpoolsConfig,
402 PumpFunPostCompleteBuy,
403 PumpFunSweepBondingCurveFee,
404 PumpSwapSweepPoolFee,
405 PumpRouteIntent,
407 RawInstruction,
408}
409
410#[derive(Debug, Clone)]
411pub struct EventTypeFilter {
412 pub include_only: Option<Vec<EventType>>,
413 pub exclude_types: Option<Vec<EventType>>,
414}
415
416impl EventTypeFilter {
417 pub fn include_only(types: Vec<EventType>) -> Self {
418 Self { include_only: Some(types), exclude_types: None }
419 }
420
421 pub fn exclude_types(types: Vec<EventType>) -> Self {
422 Self { include_only: None, exclude_types: Some(types) }
423 }
424
425 #[inline]
426 fn includes_any(&self, event_types: &[EventType]) -> bool {
427 event_types.iter().any(|event_type| self.should_include(*event_type))
428 }
429
430 pub fn should_include(&self, event_type: EventType) -> bool {
431 if event_type == EventType::RawInstruction
432 && self.exclude_types.as_ref().is_some_and(|types| types.contains(&event_type))
433 {
434 return false;
435 }
436 if let Some(ref include_only) = self.include_only {
437 if include_only.contains(&event_type) {
439 return true;
440 }
441 if matches!(
442 event_type,
443 EventType::PumpFunBuy | EventType::PumpFunSell | EventType::PumpFunBuyExactSolIn
444 ) {
445 if pumpfun_trade_filter_is_generic(include_only) {
446 return true;
447 }
448 if event_type == EventType::PumpFunBuyExactSolIn
449 && pumpfun_buy_filter_is_generic(include_only)
450 {
451 return true;
452 }
453 return false;
454 }
455 if is_pumpfun_create_family(event_type) {
456 return include_only.iter().any(|t| is_pumpfun_create_family(*t));
457 }
458 if matches!(event_type, EventType::PumpSwapBuy | EventType::PumpSwapSell) {
459 return include_only.contains(&EventType::PumpSwapTrade);
460 }
461 return false;
462 }
463
464 if let Some(ref exclude_types) = self.exclude_types {
465 if exclude_types.contains(&event_type) {
466 return false;
467 }
468 if matches!(
469 event_type,
470 EventType::PumpFunBuy | EventType::PumpFunSell | EventType::PumpFunBuyExactSolIn
471 ) && exclude_types.contains(&EventType::PumpFunTrade)
472 {
473 return false;
474 }
475 if event_type == EventType::PumpFunBuyExactSolIn
476 && exclude_types.contains(&EventType::PumpFunBuy)
477 {
478 return false;
479 }
480 if is_pumpfun_create_family(event_type)
481 && exclude_types.iter().any(|t| is_pumpfun_create_family(*t))
482 {
483 return false;
484 }
485 if matches!(event_type, EventType::PumpSwapBuy | EventType::PumpSwapSell)
486 && exclude_types.contains(&EventType::PumpSwapTrade)
487 {
488 return false;
489 }
490 return true;
491 }
492
493 true
494 }
495
496 pub(crate) fn includes_pump_route(&self, kind: crate::core::events::PumpRouteKind) -> bool {
500 if self
501 .exclude_types
502 .as_ref()
503 .is_some_and(|types| types.contains(&EventType::PumpRouteIntent))
504 {
505 return false;
506 }
507 self.include_only.as_ref().is_some_and(|types| types.contains(&EventType::PumpRouteIntent))
508 || self.should_include(EventType::PumpFunTrade)
509 || (kind == crate::core::events::PumpRouteKind::MultiHopSwap
510 && self.should_include(EventType::PumpSwapTrade))
511 }
512
513 pub fn should_include_dex_event(&self, event: &crate::core::events::DexEvent) -> bool {
514 if let crate::core::events::DexEvent::RawInstruction(raw) = event {
515 return crate::core::events::raw_instruction_matches_filter(&raw.dexes, self);
516 }
517 if let crate::core::events::DexEvent::PumpRouteIntent(intent) = event {
518 return self.includes_pump_route(intent.kind);
519 }
520 let Some(event_type) = event_type_from_dex_event(event) else { return true };
521 self.should_include(event_type)
522 }
523
524 #[inline]
525 pub fn includes_block_meta(&self) -> bool {
526 if let Some(ref include_only) = self.include_only {
527 return include_only.contains(&EventType::BlockMeta);
528 }
529 false
530 }
531
532 #[inline]
533 pub fn normalize_dex_event(
534 &self,
535 event: crate::core::events::DexEvent,
536 ) -> crate::core::events::DexEvent {
537 use crate::core::events::DexEvent;
538
539 let Some(ref include_only) = self.include_only else { return event };
540 if pumpfun_trade_filter_is_generic(include_only) {
541 return match event {
542 DexEvent::PumpFunBuy(t)
543 | DexEvent::PumpFunSell(t)
544 | DexEvent::PumpFunBuyExactSolIn(t) => DexEvent::PumpFunTrade(t),
545 other => other,
546 };
547 }
548 if pumpfun_buy_filter_is_generic(include_only) {
549 return match event {
550 DexEvent::PumpFunBuyExactSolIn(t) => DexEvent::PumpFunBuy(t),
551 other => other,
552 };
553 }
554
555 event
556 }
557
558 #[inline]
559 pub fn includes_pumpfun(&self) -> bool {
560 self.includes_any(&[
561 EventType::PumpFunTrade,
562 EventType::PumpFunBuy,
563 EventType::PumpFunSell,
564 EventType::PumpFunBuyExactSolIn,
565 EventType::PumpFunCreate,
566 EventType::PumpFunCreateV2,
567 EventType::PumpFunComplete,
568 EventType::PumpFunMigrate,
569 EventType::PumpFunMigrateBondingCurveCreator,
570 EventType::PumpFunPostCompleteBuy,
571 EventType::PumpFunSweepBondingCurveFee,
572 ])
573 }
574
575 #[inline]
576 pub fn includes_meteora_damm_v2(&self) -> bool {
577 self.includes_any(&[
578 EventType::MeteoraDammV2Swap,
579 EventType::MeteoraDammV2AddLiquidity,
580 EventType::MeteoraDammV2CreatePosition,
581 EventType::MeteoraDammV2ClaimPositionFee,
582 EventType::MeteoraDammV2ClaimReward,
583 EventType::MeteoraDammV2ClosePosition,
584 EventType::MeteoraDammV2InitializePool,
585 EventType::MeteoraDammV2RemoveLiquidity,
586 EventType::MeteoraDammV2UpdateDelegatePermission,
587 EventType::MeteoraDammV2WithdrawDeadLiquidityReward,
588 EventType::MeteoraDammV2WithdrawIneligibleReward,
589 EventType::MeteoraDammV2UpdateRewardFunder,
590 EventType::MeteoraDammV2UpdateRewardDuration,
591 EventType::MeteoraDammV2InitializeReward,
592 EventType::MeteoraDammV2FundReward,
593 EventType::MeteoraDammV2CreateConfig,
594 EventType::MeteoraDammV2CreateDynamicConfig,
595 ])
596 }
597
598 #[inline]
599 pub fn includes_pump_fees(&self) -> bool {
600 self.includes_any(&[
601 EventType::PumpFeesCreateFeeSharingConfig,
602 EventType::PumpFeesInitializeFeeConfig,
603 EventType::PumpFeesResetFeeSharingConfig,
604 EventType::PumpFeesRevokeFeeSharingAuthority,
605 EventType::PumpFeesTransferFeeSharingAuthority,
606 EventType::PumpFeesUpdateAdmin,
607 EventType::PumpFeesUpdateFeeConfig,
608 EventType::PumpFeesUpdateFeeShares,
609 EventType::PumpFeesUpsertFeeTiers,
610 ])
611 }
612
613 #[inline]
615 pub fn includes_pumpswap(&self) -> bool {
616 self.includes_any(&[
617 EventType::PumpSwapTrade,
618 EventType::PumpSwapBuy,
619 EventType::PumpSwapSell,
620 EventType::PumpSwapCreatePool,
621 EventType::PumpSwapSweepPoolFee,
622 EventType::PumpSwapLiquidityAdded,
623 EventType::PumpSwapLiquidityRemoved,
624 ])
625 }
626
627 #[inline]
629 pub fn includes_raydium_launchlab(&self) -> bool {
630 self.includes_any(&[
631 EventType::RaydiumLaunchlabTrade,
632 EventType::RaydiumLaunchlabPoolCreate,
633 EventType::RaydiumLaunchlabMigrateAmm,
634 ])
635 }
636
637 #[inline]
638 pub fn includes_raydium_cpmm(&self) -> bool {
639 self.includes_any(&[
640 EventType::RaydiumCpmmSwap,
641 EventType::RaydiumCpmmDeposit,
642 EventType::RaydiumCpmmWithdraw,
643 EventType::RaydiumCpmmInitialize,
644 EventType::RaydiumCpmmCollectCreatorFee,
645 ])
646 }
647
648 #[inline]
649 pub fn includes_raydium_clmm(&self) -> bool {
650 self.includes_any(&[
651 EventType::RaydiumClmmSwap,
652 EventType::RaydiumClmmCreatePool,
653 EventType::RaydiumClmmOpenPosition,
654 EventType::RaydiumClmmClosePosition,
655 EventType::RaydiumClmmIncreaseLiquidity,
656 EventType::RaydiumClmmDecreaseLiquidity,
657 EventType::RaydiumClmmLiquidityChange,
658 EventType::RaydiumClmmConfigChange,
659 EventType::RaydiumClmmCreatePersonalPosition,
660 EventType::RaydiumClmmLiquidityCalculate,
661 EventType::RaydiumClmmOpenLimitOrder,
662 EventType::RaydiumClmmIncreaseLimitOrder,
663 EventType::RaydiumClmmDecreaseLimitOrder,
664 EventType::RaydiumClmmSettleLimitOrder,
665 EventType::RaydiumClmmUpdateRewardInfos,
666 EventType::RaydiumClmmOpenPositionWithTokenExtNft,
667 EventType::RaydiumClmmCollectFee,
668 ])
669 }
670
671 #[inline]
672 pub fn includes_raydium_amm_v4(&self) -> bool {
673 self.includes_any(&[
674 EventType::RaydiumAmmV4Swap,
675 EventType::RaydiumAmmV4Deposit,
676 EventType::RaydiumAmmV4Withdraw,
677 EventType::RaydiumAmmV4Initialize2,
678 EventType::RaydiumAmmV4WithdrawPnl,
679 ])
680 }
681
682 #[inline]
683 pub fn includes_orca_whirlpool(&self) -> bool {
684 self.includes_any(&[
685 EventType::OrcaWhirlpoolSwap,
686 EventType::OrcaWhirlpoolLiquidityIncreased,
687 EventType::OrcaWhirlpoolLiquidityDecreased,
688 EventType::OrcaWhirlpoolPoolInitialized,
689 ])
690 }
691
692 #[inline]
693 pub fn includes_meteora_pools(&self) -> bool {
694 self.includes_any(&[
695 EventType::MeteoraPoolsSwap,
696 EventType::MeteoraPoolsAddLiquidity,
697 EventType::MeteoraPoolsRemoveLiquidity,
698 EventType::MeteoraPoolsBootstrapLiquidity,
699 EventType::MeteoraPoolsPoolCreated,
700 EventType::MeteoraPoolsSetPoolFees,
701 ])
702 }
703
704 #[inline]
705 pub fn includes_meteora_dlmm(&self) -> bool {
706 self.includes_any(&[
707 EventType::MeteoraDlmmSwap,
708 EventType::MeteoraDlmmAddLiquidity,
709 EventType::MeteoraDlmmRemoveLiquidity,
710 EventType::MeteoraDlmmInitializePool,
711 EventType::MeteoraDlmmInitializeBinArray,
712 EventType::MeteoraDlmmCreatePosition,
713 EventType::MeteoraDlmmClosePosition,
714 EventType::MeteoraDlmmClaimFee,
715 EventType::MeteoraDlmmClaimReward,
716 ])
717 }
718
719 #[inline]
720 pub fn includes_meteora_dbc(&self) -> bool {
721 self.includes_any(&[
722 EventType::MeteoraDbcSwap,
723 EventType::MeteoraDbcInitializePool,
724 EventType::MeteoraDbcCurveComplete,
725 ])
726 }
727}
728
729#[inline]
730fn pumpfun_trade_filter_is_generic(include_only: &[EventType]) -> bool {
731 include_only.contains(&EventType::PumpFunTrade)
732 && !include_only.iter().any(|t| {
733 matches!(
734 t,
735 EventType::PumpFunBuy | EventType::PumpFunSell | EventType::PumpFunBuyExactSolIn
736 )
737 })
738}
739
740#[inline]
741fn pumpfun_buy_filter_is_generic(include_only: &[EventType]) -> bool {
742 include_only.contains(&EventType::PumpFunBuy)
743 && !include_only.contains(&EventType::PumpFunBuyExactSolIn)
744}
745
746#[inline]
747fn is_pumpfun_create_family(event_type: EventType) -> bool {
748 matches!(event_type, EventType::PumpFunCreate | EventType::PumpFunCreateV2)
749}
750
751#[inline]
752pub fn event_type_from_dex_event(event: &crate::core::events::DexEvent) -> Option<EventType> {
753 use crate::core::events::DexEvent;
754 match event {
755 DexEvent::PumpRouteIntent(_) => Some(EventType::PumpRouteIntent),
756 DexEvent::RawInstruction(_) => Some(EventType::RawInstruction),
757 DexEvent::PumpFunCreate(_) => Some(EventType::PumpFunCreate),
758 DexEvent::PumpFunCreateV2(_) => Some(EventType::PumpFunCreateV2),
759 DexEvent::PumpFunTrade(_) => Some(EventType::PumpFunTrade),
760 DexEvent::PumpFunBuy(_) => Some(EventType::PumpFunBuy),
761 DexEvent::PumpFunSell(_) => Some(EventType::PumpFunSell),
762 DexEvent::PumpFunBuyExactSolIn(_) => Some(EventType::PumpFunBuyExactSolIn),
763 DexEvent::PumpFunMigrate(_) => Some(EventType::PumpFunMigrate),
764 DexEvent::PumpFeesCreateFeeSharingConfig(_) => {
765 Some(EventType::PumpFeesCreateFeeSharingConfig)
766 }
767 DexEvent::PumpFeesInitializeFeeConfig(_) => Some(EventType::PumpFeesInitializeFeeConfig),
768 DexEvent::PumpFeesResetFeeSharingConfig(_) => {
769 Some(EventType::PumpFeesResetFeeSharingConfig)
770 }
771 DexEvent::PumpFeesRevokeFeeSharingAuthority(_) => {
772 Some(EventType::PumpFeesRevokeFeeSharingAuthority)
773 }
774 DexEvent::PumpFeesTransferFeeSharingAuthority(_) => {
775 Some(EventType::PumpFeesTransferFeeSharingAuthority)
776 }
777 DexEvent::PumpFeesUpdateAdmin(_) => Some(EventType::PumpFeesUpdateAdmin),
778 DexEvent::PumpFeesUpdateFeeConfig(_) => Some(EventType::PumpFeesUpdateFeeConfig),
779 DexEvent::PumpFeesUpdateFeeShares(_) => Some(EventType::PumpFeesUpdateFeeShares),
780 DexEvent::PumpFeesUpsertFeeTiers(_) => Some(EventType::PumpFeesUpsertFeeTiers),
781 DexEvent::PumpFunPostCompleteBuy(_) => Some(EventType::PumpFunPostCompleteBuy),
782 DexEvent::PumpFunSweepBondingCurveFee(_) => Some(EventType::PumpFunSweepBondingCurveFee),
783 DexEvent::PumpFunComplete(_) => Some(EventType::PumpFunComplete),
784 DexEvent::PumpSwapSweepPoolFee(_) => Some(EventType::PumpSwapSweepPoolFee),
785 DexEvent::PumpFunMigrateBondingCurveCreator(_) => {
786 Some(EventType::PumpFunMigrateBondingCurveCreator)
787 }
788 DexEvent::PumpFunGlobalAccount(_) => Some(EventType::AccountPumpFunGlobal),
789 DexEvent::PumpFunBondingCurveAccount(_) => Some(EventType::AccountPumpFunBondingCurve),
790 DexEvent::PumpFunFeeConfigAccount(_) => Some(EventType::AccountPumpFunFeeConfig),
791 DexEvent::PumpFunSharingConfigAccount(_) => Some(EventType::AccountPumpFunSharingConfig),
792 DexEvent::PumpFunGlobalVolumeAccumulatorAccount(_) => {
793 Some(EventType::AccountPumpFunGlobalVolumeAccumulator)
794 }
795 DexEvent::PumpFunUserVolumeAccumulatorAccount(_) => {
796 Some(EventType::AccountPumpFunUserVolumeAccumulator)
797 }
798 DexEvent::PumpSwapTrade(_) => Some(EventType::PumpSwapTrade),
799 DexEvent::PumpSwapBuy(_) => Some(EventType::PumpSwapBuy),
800 DexEvent::PumpSwapSell(_) => Some(EventType::PumpSwapSell),
801 DexEvent::PumpSwapCreatePool(_) => Some(EventType::PumpSwapCreatePool),
802 DexEvent::PumpSwapLiquidityAdded(_) => Some(EventType::PumpSwapLiquidityAdded),
803 DexEvent::PumpSwapLiquidityRemoved(_) => Some(EventType::PumpSwapLiquidityRemoved),
804 DexEvent::MeteoraDammV2Swap(_) => Some(EventType::MeteoraDammV2Swap),
805 DexEvent::MeteoraDammV2ClaimPositionFee(_) => {
806 Some(EventType::MeteoraDammV2ClaimPositionFee)
807 }
808 DexEvent::MeteoraDammV2ClaimReward(_) => Some(EventType::MeteoraDammV2ClaimReward),
809 DexEvent::MeteoraDlmmClaimReward(_) => Some(EventType::MeteoraDlmmClaimReward),
810 DexEvent::MeteoraDammV2CreatePosition(_) => Some(EventType::MeteoraDammV2CreatePosition),
811 DexEvent::MeteoraDammV2ClosePosition(_) => Some(EventType::MeteoraDammV2ClosePosition),
812 DexEvent::MeteoraDammV2AddLiquidity(_) => Some(EventType::MeteoraDammV2AddLiquidity),
813 DexEvent::MeteoraDammV2RemoveLiquidity(_) => Some(EventType::MeteoraDammV2RemoveLiquidity),
814 DexEvent::MeteoraDammV2InitializePool(_) => Some(EventType::MeteoraDammV2InitializePool),
815 DexEvent::MeteoraDammV2UpdateDelegatePermission(_) => {
816 Some(EventType::MeteoraDammV2UpdateDelegatePermission)
817 }
818 DexEvent::MeteoraDammV2WithdrawDeadLiquidityReward(_) => {
819 Some(EventType::MeteoraDammV2WithdrawDeadLiquidityReward)
820 }
821 DexEvent::MeteoraDammV2WithdrawIneligibleReward(_) => {
822 Some(EventType::MeteoraDammV2WithdrawIneligibleReward)
823 }
824 DexEvent::MeteoraDammV2UpdateRewardFunder(_) => {
825 Some(EventType::MeteoraDammV2UpdateRewardFunder)
826 }
827 DexEvent::MeteoraDammV2UpdateRewardDuration(_) => {
828 Some(EventType::MeteoraDammV2UpdateRewardDuration)
829 }
830 DexEvent::MeteoraDammV2InitializeReward(_) => {
831 Some(EventType::MeteoraDammV2InitializeReward)
832 }
833 DexEvent::MeteoraDammV2FundReward(_) => Some(EventType::MeteoraDammV2FundReward),
834 DexEvent::MeteoraDammV2CreateConfig(_) => Some(EventType::MeteoraDammV2CreateConfig),
835 DexEvent::MeteoraDammV2CreateDynamicConfig(_) => {
836 Some(EventType::MeteoraDammV2CreateDynamicConfig)
837 }
838 DexEvent::MeteoraDbcSwap(_) => Some(EventType::MeteoraDbcSwap),
839 DexEvent::MeteoraDbcInitializePool(_) => Some(EventType::MeteoraDbcInitializePool),
840 DexEvent::MeteoraDbcCurveComplete(_) => Some(EventType::MeteoraDbcCurveComplete),
841 DexEvent::RaydiumLaunchlabTrade(_) => Some(EventType::RaydiumLaunchlabTrade),
842 DexEvent::RaydiumLaunchlabPoolCreate(_) => Some(EventType::RaydiumLaunchlabPoolCreate),
843 DexEvent::RaydiumLaunchlabMigrateAmm(_) => Some(EventType::RaydiumLaunchlabMigrateAmm),
844 DexEvent::RaydiumClmmSwap(_) => Some(EventType::RaydiumClmmSwap),
845 DexEvent::RaydiumClmmCreatePool(_) => Some(EventType::RaydiumClmmCreatePool),
846 DexEvent::RaydiumClmmOpenPosition(_) => Some(EventType::RaydiumClmmOpenPosition),
847 DexEvent::RaydiumClmmOpenPositionWithTokenExtNft(_) => {
848 Some(EventType::RaydiumClmmOpenPositionWithTokenExtNft)
849 }
850 DexEvent::RaydiumClmmClosePosition(_) => Some(EventType::RaydiumClmmClosePosition),
851 DexEvent::RaydiumClmmIncreaseLiquidity(_) => Some(EventType::RaydiumClmmIncreaseLiquidity),
852 DexEvent::RaydiumClmmDecreaseLiquidity(_) => Some(EventType::RaydiumClmmDecreaseLiquidity),
853 DexEvent::RaydiumClmmLiquidityChange(_) => Some(EventType::RaydiumClmmLiquidityChange),
854 DexEvent::RaydiumClmmConfigChange(_) => Some(EventType::RaydiumClmmConfigChange),
855 DexEvent::RaydiumClmmCreatePersonalPosition(_) => {
856 Some(EventType::RaydiumClmmCreatePersonalPosition)
857 }
858 DexEvent::RaydiumClmmLiquidityCalculate(_) => {
859 Some(EventType::RaydiumClmmLiquidityCalculate)
860 }
861 DexEvent::RaydiumClmmOpenLimitOrder(_) => Some(EventType::RaydiumClmmOpenLimitOrder),
862 DexEvent::RaydiumClmmIncreaseLimitOrder(_) => {
863 Some(EventType::RaydiumClmmIncreaseLimitOrder)
864 }
865 DexEvent::RaydiumClmmDecreaseLimitOrder(_) => {
866 Some(EventType::RaydiumClmmDecreaseLimitOrder)
867 }
868 DexEvent::RaydiumClmmSettleLimitOrder(_) => Some(EventType::RaydiumClmmSettleLimitOrder),
869 DexEvent::RaydiumClmmUpdateRewardInfos(_) => Some(EventType::RaydiumClmmUpdateRewardInfos),
870 DexEvent::RaydiumClmmCollectFee(_) => Some(EventType::RaydiumClmmCollectFee),
871 DexEvent::RaydiumClmmAmmConfigAccount(_) => Some(EventType::AccountRaydiumClmmAmmConfig),
872 DexEvent::RaydiumClmmPoolStateAccount(_) => Some(EventType::AccountRaydiumClmmPoolState),
873 DexEvent::RaydiumClmmTickArrayStateAccount(_) => {
874 Some(EventType::AccountRaydiumClmmTickArrayState)
875 }
876 DexEvent::RaydiumCpmmSwap(_) => Some(EventType::RaydiumCpmmSwap),
877 DexEvent::RaydiumCpmmDeposit(_) => Some(EventType::RaydiumCpmmDeposit),
878 DexEvent::RaydiumCpmmWithdraw(_) => Some(EventType::RaydiumCpmmWithdraw),
879 DexEvent::RaydiumCpmmInitialize(_) => Some(EventType::RaydiumCpmmInitialize),
880 DexEvent::RaydiumCpmmAmmConfigAccount(_) => Some(EventType::AccountRaydiumCpmmAmmConfig),
881 DexEvent::RaydiumCpmmPoolStateAccount(_) => Some(EventType::AccountRaydiumCpmmPoolState),
882 DexEvent::RaydiumCpmmCollectCreatorFee(_) => Some(EventType::RaydiumCpmmCollectCreatorFee),
883 DexEvent::RaydiumCpmmCreatorFeeShareAccount(_) => {
884 Some(EventType::AccountRaydiumCpmmCreatorFeeShare)
885 }
886 DexEvent::RaydiumAmmV4Swap(_) => Some(EventType::RaydiumAmmV4Swap),
887 DexEvent::RaydiumAmmV4Deposit(_) => Some(EventType::RaydiumAmmV4Deposit),
888 DexEvent::RaydiumAmmV4Initialize2(_) => Some(EventType::RaydiumAmmV4Initialize2),
889 DexEvent::RaydiumAmmV4Withdraw(_) => Some(EventType::RaydiumAmmV4Withdraw),
890 DexEvent::RaydiumAmmV4WithdrawPnl(_) => Some(EventType::RaydiumAmmV4WithdrawPnl),
891 DexEvent::OrcaWhirlpoolSwap(_) => Some(EventType::OrcaWhirlpoolSwap),
892 DexEvent::OrcaWhirlpoolLiquidityIncreased(_) => {
893 Some(EventType::OrcaWhirlpoolLiquidityIncreased)
894 }
895 DexEvent::OrcaWhirlpoolLiquidityDecreased(_) => {
896 Some(EventType::OrcaWhirlpoolLiquidityDecreased)
897 }
898 DexEvent::OrcaWhirlpoolPoolInitialized(_) => Some(EventType::OrcaWhirlpoolPoolInitialized),
899 DexEvent::OrcaWhirlpoolAccount(_) => Some(EventType::AccountOrcaWhirlpool),
900 DexEvent::OrcaPositionAccount(_) => Some(EventType::AccountOrcaPosition),
901 DexEvent::OrcaTickArrayAccount(_) => Some(EventType::AccountOrcaTickArray),
902 DexEvent::LiquidityAccountSnapshot(_) => Some(EventType::AccountLiquiditySnapshot),
903 DexEvent::RawAccountSnapshot(_) => Some(EventType::AccountRawSnapshot),
904 DexEvent::OrcaFeeTierAccount(_) => Some(EventType::AccountOrcaFeeTier),
905 DexEvent::OrcaWhirlpoolsConfigAccount(_) => Some(EventType::AccountOrcaWhirlpoolsConfig),
906 DexEvent::MeteoraPoolsSwap(_) => Some(EventType::MeteoraPoolsSwap),
907 DexEvent::MeteoraPoolsAddLiquidity(_) => Some(EventType::MeteoraPoolsAddLiquidity),
908 DexEvent::MeteoraPoolsRemoveLiquidity(_) => Some(EventType::MeteoraPoolsRemoveLiquidity),
909 DexEvent::MeteoraPoolsBootstrapLiquidity(_) => {
910 Some(EventType::MeteoraPoolsBootstrapLiquidity)
911 }
912 DexEvent::MeteoraPoolsPoolCreated(_) => Some(EventType::MeteoraPoolsPoolCreated),
913 DexEvent::MeteoraPoolsSetPoolFees(_) => Some(EventType::MeteoraPoolsSetPoolFees),
914 DexEvent::MeteoraDlmmSwap(_) => Some(EventType::MeteoraDlmmSwap),
915 DexEvent::MeteoraDlmmAddLiquidity(_) => Some(EventType::MeteoraDlmmAddLiquidity),
916 DexEvent::MeteoraDlmmRemoveLiquidity(_) => Some(EventType::MeteoraDlmmRemoveLiquidity),
917 DexEvent::MeteoraDlmmInitializePool(_) => Some(EventType::MeteoraDlmmInitializePool),
918 DexEvent::MeteoraDlmmInitializeBinArray(_) => {
919 Some(EventType::MeteoraDlmmInitializeBinArray)
920 }
921 DexEvent::MeteoraDlmmCreatePosition(_) => Some(EventType::MeteoraDlmmCreatePosition),
922 DexEvent::MeteoraDlmmClosePosition(_) => Some(EventType::MeteoraDlmmClosePosition),
923 DexEvent::MeteoraDlmmClaimFee(_) => Some(EventType::MeteoraDlmmClaimFee),
924 DexEvent::TokenAccount(_) => Some(EventType::TokenAccount),
925 DexEvent::TokenInfo(_) => Some(EventType::TokenInfo),
926 DexEvent::NonceAccount(_) => Some(EventType::NonceAccount),
927 DexEvent::PumpSwapGlobalConfigAccount(_) => Some(EventType::AccountPumpSwapGlobalConfig),
928 DexEvent::PumpSwapPoolAccount(_) => Some(EventType::AccountPumpSwapPool),
929 DexEvent::BlockMeta(_) => Some(EventType::BlockMeta),
930 DexEvent::Error(_) => None,
931 }
932}
933
934#[cfg(test)]
935mod event_type_filter_tests {
936 use super::*;
937
938 #[test]
939 fn generic_trade_filters_cover_specific_trade_variants() {
940 let pump = EventTypeFilter::include_only(vec![EventType::PumpFunTrade]);
941 assert!(pump.should_include(EventType::PumpFunTrade));
942 assert!(pump.should_include(EventType::PumpFunBuy));
943 assert!(pump.should_include(EventType::PumpFunSell));
944 assert!(pump.should_include(EventType::PumpFunBuyExactSolIn));
945
946 let pump_specific = EventTypeFilter::include_only(vec![EventType::PumpFunBuy]);
947 assert!(!pump_specific.should_include(EventType::PumpFunTrade));
948 assert!(pump_specific.should_include(EventType::PumpFunBuy));
949 assert!(!pump_specific.should_include(EventType::PumpFunSell));
950 assert!(pump_specific.should_include(EventType::PumpFunBuyExactSolIn));
951
952 let pump_exact_buy = EventTypeFilter::include_only(vec![EventType::PumpFunBuyExactSolIn]);
953 assert!(!pump_exact_buy.should_include(EventType::PumpFunTrade));
954 assert!(!pump_exact_buy.should_include(EventType::PumpFunBuy));
955 assert!(!pump_exact_buy.should_include(EventType::PumpFunSell));
956 assert!(pump_exact_buy.should_include(EventType::PumpFunBuyExactSolIn));
957
958 let pumpswap = EventTypeFilter::include_only(vec![EventType::PumpSwapTrade]);
959 assert!(pumpswap.should_include(EventType::PumpSwapBuy));
960 assert!(pumpswap.should_include(EventType::PumpSwapSell));
961
962 let exclude_pumpswap = EventTypeFilter::exclude_types(vec![EventType::PumpSwapTrade]);
963 assert!(!exclude_pumpswap.should_include(EventType::PumpSwapBuy));
964 assert!(!exclude_pumpswap.should_include(EventType::PumpSwapSell));
965 }
966
967 #[test]
968 fn generic_pumpfun_trade_filter_normalizes_specific_variants() {
969 use crate::core::events::{DexEvent, PumpFunTradeEvent};
970
971 let filter = EventTypeFilter::include_only(vec![EventType::PumpFunTrade]);
972 let event = DexEvent::PumpFunBuy(PumpFunTradeEvent { is_buy: true, ..Default::default() });
973 assert!(matches!(filter.normalize_dex_event(event), DexEvent::PumpFunTrade(_)));
974
975 let specific_filter =
976 EventTypeFilter::include_only(vec![EventType::PumpFunTrade, EventType::PumpFunBuy]);
977 let event = DexEvent::PumpFunBuy(PumpFunTradeEvent { is_buy: true, ..Default::default() });
978 assert!(matches!(specific_filter.normalize_dex_event(event), DexEvent::PumpFunBuy(_)));
979
980 let buy_filter = EventTypeFilter::include_only(vec![EventType::PumpFunBuy]);
981 let event = DexEvent::PumpFunBuyExactSolIn(PumpFunTradeEvent {
982 is_buy: true,
983 ..Default::default()
984 });
985 assert!(matches!(buy_filter.normalize_dex_event(event), DexEvent::PumpFunBuy(_)));
986
987 let exact_filter = EventTypeFilter::include_only(vec![EventType::PumpFunBuyExactSolIn]);
988 let event = DexEvent::PumpFunBuyExactSolIn(PumpFunTradeEvent {
989 is_buy: true,
990 ..Default::default()
991 });
992 assert!(matches!(
993 exact_filter.normalize_dex_event(event),
994 DexEvent::PumpFunBuyExactSolIn(_)
995 ));
996
997 let create_and_trade_filter =
998 EventTypeFilter::include_only(vec![EventType::PumpFunCreate, EventType::PumpFunTrade]);
999 let event =
1000 DexEvent::PumpFunSell(PumpFunTradeEvent { is_buy: false, ..Default::default() });
1001 assert!(matches!(
1002 create_and_trade_filter.normalize_dex_event(event),
1003 DexEvent::PumpFunTrade(_)
1004 ));
1005 }
1006
1007 #[test]
1008 fn all_protocol_groups_are_filterable() {
1009 assert!(EventTypeFilter::include_only(vec![EventType::PumpFunTrade]).includes_pumpfun());
1010 assert!(!EventTypeFilter::include_only(vec![EventType::AccountPumpFunGlobal])
1011 .includes_pumpfun());
1012 assert!(
1013 !EventTypeFilter::include_only(vec![EventType::PumpFeesUpdateAdmin]).includes_pumpfun()
1014 );
1015 assert!(EventTypeFilter::include_only(vec![EventType::PumpSwapTrade]).includes_pumpswap());
1016 assert!(EventTypeFilter::include_only(vec![EventType::PumpFeesUpdateFeeShares])
1017 .includes_pump_fees());
1018 assert!(EventTypeFilter::include_only(vec![EventType::RaydiumLaunchlabTrade])
1019 .includes_raydium_launchlab());
1020 assert!(
1021 EventTypeFilter::include_only(vec![EventType::RaydiumCpmmSwap]).includes_raydium_cpmm()
1022 );
1023 assert!(
1024 EventTypeFilter::include_only(vec![EventType::RaydiumClmmSwap]).includes_raydium_clmm()
1025 );
1026 assert!(!EventTypeFilter::include_only(vec![EventType::AccountRaydiumClmmPoolState])
1027 .includes_raydium_clmm());
1028 assert!(EventTypeFilter::include_only(vec![EventType::RaydiumAmmV4Swap])
1029 .includes_raydium_amm_v4());
1030 assert!(EventTypeFilter::include_only(vec![EventType::OrcaWhirlpoolSwap])
1031 .includes_orca_whirlpool());
1032 assert!(EventTypeFilter::include_only(vec![EventType::MeteoraPoolsSwap])
1033 .includes_meteora_pools());
1034 assert!(EventTypeFilter::include_only(vec![EventType::MeteoraDammV2Swap])
1035 .includes_meteora_damm_v2());
1036 assert!(EventTypeFilter::include_only(vec![EventType::MeteoraDammV2InitializePool])
1037 .includes_meteora_damm_v2());
1038 assert!(
1039 EventTypeFilter::include_only(vec![EventType::MeteoraDlmmSwap]).includes_meteora_dlmm()
1040 );
1041 assert!(
1042 EventTypeFilter::include_only(vec![EventType::MeteoraDbcSwap]).includes_meteora_dbc()
1043 );
1044 }
1045
1046 #[test]
1047 fn exclude_filters_do_not_skip_whole_protocol_groups() {
1048 let raydium = EventTypeFilter::exclude_types(vec![EventType::RaydiumCpmmSwap]);
1049 assert!(raydium.includes_raydium_cpmm());
1050 assert!(!raydium.should_include(EventType::RaydiumCpmmSwap));
1051 assert!(raydium.should_include(EventType::RaydiumCpmmDeposit));
1052
1053 let all_cpmm = EventTypeFilter::exclude_types(vec![
1054 EventType::RaydiumCpmmSwap,
1055 EventType::RaydiumCpmmDeposit,
1056 EventType::RaydiumCpmmWithdraw,
1057 EventType::RaydiumCpmmInitialize,
1058 EventType::RaydiumCpmmCollectCreatorFee,
1059 ]);
1060 assert!(!all_cpmm.includes_raydium_cpmm());
1061
1062 let all_launchlab = EventTypeFilter::exclude_types(vec![
1063 EventType::RaydiumLaunchlabTrade,
1064 EventType::RaydiumLaunchlabPoolCreate,
1065 EventType::RaydiumLaunchlabMigrateAmm,
1066 ]);
1067 assert!(!all_launchlab.includes_raydium_launchlab());
1068
1069 let pump = EventTypeFilter::exclude_types(vec![EventType::PumpFunBuy]);
1070 assert!(pump.includes_pumpfun());
1071 assert!(!pump.should_include(EventType::PumpFunBuy));
1072 assert!(!pump.should_include(EventType::PumpFunBuyExactSolIn));
1073 assert!(pump.should_include(EventType::PumpFunSell));
1074 }
1075}
1076
1077#[derive(Debug, Clone)]
1078pub struct SlotFilter {
1079 pub min_slot: Option<u64>,
1080 pub max_slot: Option<u64>,
1081}
1082
1083impl SlotFilter {
1084 pub fn new() -> Self {
1085 Self { min_slot: None, max_slot: None }
1086 }
1087
1088 pub fn min_slot(mut self, slot: u64) -> Self {
1089 self.min_slot = Some(slot);
1090 self
1091 }
1092
1093 pub fn max_slot(mut self, slot: u64) -> Self {
1094 self.max_slot = Some(slot);
1095 self
1096 }
1097}
1098
1099impl Default for SlotFilter {
1100 fn default() -> Self {
1101 Self::new()
1102 }
1103}