feat: enhance event filtering and monitoring system

- Add EventTypeFilter for precise event type filtering
- Refactor metrics to track events by type (tx/account/block)
- Add parser caching for improved performance
- Enhance gRPC subscription management
- Update examples and type definitions

README_CN.md

@@ -44,14 +44,14 @@ git clone https://github.com/0xfnzero/solana-streamer
 
 ```toml
 # 添加到您的 Cargo.toml
-solana-streamer-sdk = { path = "./solana-streamer", version = "0.3.1" }
+solana-streamer-sdk = { path = "./solana-streamer", version = "0.3.2" }
 ```
 
 ### 使用 crates.io
 
 ```toml
 # 添加到您的 Cargo.toml
-solana-streamer-sdk = "0.3.1"
+solana-streamer-sdk = "0.3.2"
 ```
 
 ## 使用示例
@@ -71,13 +71,14 @@ cargo run --example parse_tx_events
 
 该示例使用预定义的交易签名，展示如何从交易数据中提取协议特定的事件。
 
-### 高级用法示例
+### 高级用法 - 完整示例
 
 ```rust
 use solana_streamer_sdk::{
     match_event,
     streaming::{
         event_parser::{
+            common::{filter::EventTypeFilter, EventType},
             protocols::{
                 bonk::{
                     parser::BONK_PROGRAM_ID, BonkGlobalConfigAccountEvent, BonkMigrateToAmmEvent,
@@ -173,11 +174,6 @@ async fn test_grpc() -> Result<(), Box<dyn std::error::Error>> {
     let account_exclude = vec![];
     let account_required = vec![];
 
-    println!("Starting to listen for events, press Ctrl+C to stop...");
-    println!("Monitoring programs: {:?}", account_include);
-
-    println!("Starting subscription...");
-
     // 监听交易数据
     let transaction_filter = TransactionFilter {
         account_include: account_include.clone(),
@@ -188,11 +184,23 @@ async fn test_grpc() -> Result<(), Box<dyn std::error::Error>> {
     // 监听属于owner程序的账号数据 -> 账号事件监听
     let account_filter = AccountFilter { account: vec![], owner: account_include.clone() };
 
+    // 事件过滤 - 可选
+    // 不进行事件过滤，包含所有事件
+    let event_type_filter = None;
+    // 只包含PumpSwapBuy事件、PumpSwapSell事件
+    // let event_type_filter = Some(EventTypeFilter { include: vec![EventType::PumpSwapBuy, EventType::PumpSwapSell] });
+
+    println!("Starting to listen for events, press Ctrl+C to stop...");
+    println!("Monitoring programs: {:?}", account_include);
+
+    println!("Starting subscription...");
+
     grpc.subscribe_events_immediate(
         protocols,
         None,
         transaction_filter,
         account_filter,
+        event_type_filter,
         None,
         callback,
     )
@@ -231,11 +239,11 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
     |event: Box<dyn UnifiedEvent>| {
         println!("🎉 Event received! Type: {:?}, ID: {}", event.event_type(), event.id());
         match_event!(event, {
-            // block meta
+            // -------------------------- block meta -----------------------
             BlockMetaEvent => |e: BlockMetaEvent| {
                 println!("BlockMetaEvent: {e:?}");
             },
-            // bonk
+            // -------------------------- bonk -----------------------
             BonkPoolCreateEvent => |e: BonkPoolCreateEvent| {
                 // 使用grpc的时候，可以从每个事件中获取到block_time
                 println!("block_time: {:?}, block_time_ms: {:?}", e.metadata.block_time, e.metadata.block_time_ms);
@@ -250,7 +258,7 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
             BonkMigrateToCpswapEvent => |e: BonkMigrateToCpswapEvent| {
                 println!("BonkMigrateToCpswapEvent: {e:?}");
             },
-            // pumpfun
+            // -------------------------- pumpfun -----------------------
             PumpFunTradeEvent => |e: PumpFunTradeEvent| {
                 println!("PumpFunTradeEvent: {e:?}");
             },
@@ -260,7 +268,7 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
             PumpFunCreateTokenEvent => |e: PumpFunCreateTokenEvent| {
                 println!("PumpFunCreateTokenEvent: {e:?}");
             },
-            // pumpswap
+            // -------------------------- pumpswap -----------------------
             PumpSwapBuyEvent => |e: PumpSwapBuyEvent| {
                 println!("Buy event: {e:?}");
             },
@@ -276,7 +284,7 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
             PumpSwapWithdrawEvent => |e: PumpSwapWithdrawEvent| {
                 println!("Withdraw event: {e:?}");
             },
-            // raydium_cpmm
+            // -------------------------- raydium_cpmm -----------------------
             RaydiumCpmmSwapEvent => |e: RaydiumCpmmSwapEvent| {
                 println!("RaydiumCpmmSwapEvent: {e:?}");
             },
@@ -289,7 +297,7 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
             RaydiumCpmmWithdrawEvent => |e: RaydiumCpmmWithdrawEvent| {
                 println!("RaydiumCpmmWithdrawEvent: {e:?}");
             },
-            // raydium_clmm
+            // -------------------------- raydium_clmm -----------------------
             RaydiumClmmSwapEvent => |e: RaydiumClmmSwapEvent| {
                 println!("RaydiumClmmSwapEvent: {e:?}");
             },
@@ -314,7 +322,7 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
             RaydiumClmmOpenPositionV2Event => |e: RaydiumClmmOpenPositionV2Event| {
                 println!("RaydiumClmmOpenPositionV2Event: {e:?}");
             },
-            // raydium_amm_v4
+            // -------------------------- raydium_amm_v4 -----------------------
             RaydiumAmmV4SwapEvent => |e: RaydiumAmmV4SwapEvent| {
                 println!("RaydiumAmmV4SwapEvent: {e:?}");
             },
@@ -375,6 +383,22 @@ fn create_event_callback() -> impl Fn(Box<dyn UnifiedEvent>) {
 }
 ```
 
+### 事件过滤
+
+库支持灵活的事件过滤以减少处理开销：
+
+```rust
+use solana_streamer_sdk::streaming::event_parser::common::{filter::EventTypeFilter, EventType};
+
+// 无过滤 - 接收所有事件
+let event_type_filter = None;
+
+// 过滤特定事件类型 - 只接收 PumpSwap 买入/卖出事件
+let event_type_filter = Some(EventTypeFilter { 
+    include: vec![EventType::PumpSwapBuy, EventType::PumpSwapSell] 
+});
+```
+
 ## 支持的协议
 
 - **PumpFun**: 主要迷因币交易平台