solana-streamer-sdk 0.3.5

A lightweight Rust library for real-time event streaming from Solana DEX trading programs. Supports PumpFun, PumpSwap, Bonk, and Raydium protocols with Yellowstone gRPC and ShredStream.
Documentation
use solana_sdk::pubkey::Pubkey;

use crate::common::AnyResult;
use crate::streaming::common::EventBatchProcessor;
use crate::streaming::event_parser::common::filter::EventTypeFilter;
use crate::streaming::event_parser::{Protocol, UnifiedEvent};
use crate::streaming::shred::{ShredEventProcessor, ShredStreamHandler, TransactionWithSlot};

use super::ShredStreamGrpc;

impl ShredStreamGrpc {
    /// 订阅ShredStream事件(支持批处理和即时处理)
    pub async fn shredstream_subscribe<F>(
        &self,
        protocols: Vec<Protocol>,
        bot_wallet: Option<Pubkey>,
        event_type_filter: Option<EventTypeFilter>,
        callback: F,
    ) -> AnyResult<()>
    where
        F: Fn(Box<dyn UnifiedEvent>) + Send + Sync + 'static,
    {
        // 启动自动性能监控(如果启用)
        if self.config.enable_metrics {
            self.metrics_manager.start_auto_monitoring().await;
        }

        // 启动流处理
        let client = (*self.shredstream_client).clone();
        let (_stream_task, rx) = ShredStreamHandler::start_stream_processing(
            client,
            self.config.backpressure.channel_size,
        )
        .await?;

        // 根据配置选择处理模式
        if self.config.batch.enabled {
            // 批处理模式
            self.process_with_batch(rx, protocols, bot_wallet, event_type_filter, callback).await
        } else {
            // 即时处理模式
            self.process_immediate(rx, protocols, bot_wallet, event_type_filter, callback).await
        }
    }

    /// 批处理模式
    async fn process_with_batch<F>(
        &self,
        mut rx: futures::channel::mpsc::Receiver<TransactionWithSlot>,
        protocols: Vec<Protocol>,
        bot_wallet: Option<Pubkey>,
        event_type_filter: Option<EventTypeFilter>,
        callback: F,
    ) -> AnyResult<()>
    where
        F: Fn(Box<dyn UnifiedEvent>) + Send + Sync + 'static,
    {
        use futures::StreamExt;

        // 创建批处理器,将单个事件回调转换为批量回调
        let batch_callback = move |events: Vec<Box<dyn UnifiedEvent>>| {
            for event in events {
                callback(event);
            }
        };

        let mut batch_processor = EventBatchProcessor::new(
            batch_callback,
            self.config.batch.batch_size,
            self.config.batch.batch_timeout_ms,
        );

        // 创建事件处理器
        let event_processor =
            ShredEventProcessor::new(self.metrics_manager.clone(), self.config.clone());

        while let Some(transaction_with_slot) = rx.next().await {
            if let Err(e) = event_processor
                .process_transaction_with_batch(
                    transaction_with_slot,
                    protocols.clone(),
                    bot_wallet,
                    &mut batch_processor,
                    event_type_filter.clone(),
                )
                .await
            {
                log::error!("Error processing transaction: {e:?}");
            }
        }

        // 处理剩余的事件
        batch_processor.flush();

        Ok(())
    }

    /// 即时处理模式
    async fn process_immediate<F>(
        &self,
        mut rx: futures::channel::mpsc::Receiver<TransactionWithSlot>,
        protocols: Vec<Protocol>,
        bot_wallet: Option<Pubkey>,
        event_type_filter: Option<EventTypeFilter>,
        callback: F,
    ) -> AnyResult<()>
    where
        F: Fn(Box<dyn UnifiedEvent>) + Send + Sync + 'static,
    {
        use futures::StreamExt;

        // 创建事件处理器
        let event_processor =
            ShredEventProcessor::new(self.metrics_manager.clone(), self.config.clone());

        while let Some(transaction_with_slot) = rx.next().await {
            if let Err(e) = event_processor
                .process_transaction_immediate(
                    transaction_with_slot,
                    protocols.clone(),
                    bot_wallet,
                    event_type_filter.clone(),
                    &callback,
                )
                .await
            {
                log::error!("Error processing transaction: {e:?}");
            }
        }

        Ok(())
    }
}