sol_parser_sdk/logs/

pump_amm.rs

//! PumpSwap (Pump AMM) 极限优化解析器 - 纳秒/微秒级性能
//!
//! 优化策略:
//! - 零拷贝解析 (zero-copy)
//! - 栈分配替代堆分配
//! - unsafe 消除边界检查
//! - 编译器自动向量化 (target-cpu=native)
//! - 内联所有热路径
//! - 编译时计算
//! - 预计算查找表
//! - L1 cache 优化 (1KB 栈缓冲区)

use crate::core::events::*;
use memchr::memmem;
use once_cell::sync::Lazy;
use solana_sdk::{pubkey::Pubkey, signature::Signature};

#[cfg(feature = "perf-stats")]
use std::sync::atomic::{AtomicUsize, Ordering};

// ============================================================================
// 性能计数器 (可选，用于性能分析)
// ============================================================================

#[cfg(feature = "perf-stats")]
pub static PARSE_COUNT: AtomicUsize = AtomicUsize::new(0);
#[cfg(feature = "perf-stats")]
pub static PARSE_TIME_NS: AtomicUsize = AtomicUsize::new(0);

// ============================================================================
// 编译时常量和查找表
// ============================================================================

/// PumpSwap discriminator constants (compile-time computed)
pub mod discriminators {
    // Use u64 direct comparison to avoid array comparison
    // Event discriminators from pump_amm.json
    pub const BUY: u64 = u64::from_le_bytes([103, 244, 82, 31, 44, 245, 119, 119]); // BuyEvent
    pub const SELL: u64 = u64::from_le_bytes([62, 47, 55, 10, 165, 3, 220, 42]); // SellEvent
    pub const CREATE_POOL: u64 = u64::from_le_bytes([177, 49, 12, 210, 160, 118, 167, 116]); // CreatePoolEvent
    pub const ADD_LIQUIDITY: u64 = u64::from_le_bytes([120, 248, 61, 83, 31, 142, 107, 144]); // DepositEvent
    pub const REMOVE_LIQUIDITY: u64 = u64::from_le_bytes([22, 9, 133, 26, 160, 44, 71, 192]);
    // WithdrawEvent
}

/// Base64 查找器预计算 (用于快速定位)
static BASE64_FINDER: Lazy<memmem::Finder> = Lazy::new(|| memmem::Finder::new(b"Program data: "));

/// 跳过 ASCII 空白后拷贝 base64 前缀（Explorer / 部分日志会在 base64 中插空格）
#[inline(always)]
fn copy_b64_skip_ws_prefix(src: &[u8], out: &mut [u8], max_copy: usize) -> Option<usize> {
    let cap = max_copy.min(out.len());
    let mut j = 0usize;
    for &b in src {
        if b.is_ascii_whitespace() {
            continue;
        }
        if j >= cap {
            break;
        }
        out[j] = b;
        j += 1;
    }
    if j < 12 {
        return None;
    }
    Some(j)
}

// ============================================================================
// 零拷贝解析核心 - 使用栈分配
// ============================================================================

/// 零拷贝提取 program data (栈分配，无堆分配)
///
/// 优化: 使用固定大小栈缓冲区，避免 Vec 分配
/// 缓冲区大小增加到 2KB 以防止 base64-simd 缓冲区溢出panic
#[inline(always)]
fn extract_program_data_zero_copy<'a>(log: &'a str, buf: &'a mut [u8; 2048]) -> Option<&'a [u8]> {
    let log_bytes = log.as_bytes();
    let pos = BASE64_FINDER.find(log_bytes)?;

    let data_part = &log[pos + 14..];
    let trimmed = data_part.trim();
    let body = trimmed.as_bytes();

    if body.len() > 2700 {
        return None;
    }

    use base64_simd::AsOut;
    const COMPACT_CAP: usize = 2730;
    let decoded_slice = if body.iter().any(|&b| b.is_ascii_whitespace()) {
        let mut compact = [0u8; COMPACT_CAP];
        let n = copy_b64_skip_ws_prefix(body, &mut compact, COMPACT_CAP)?;
        base64_simd::STANDARD.decode(&compact[..n], buf.as_mut().as_out()).ok()?
    } else {
        base64_simd::STANDARD.decode(body, buf.as_mut().as_out()).ok()?
    };

    Some(decoded_slice)
}

/// 快速 discriminator 提取 (SIMD 优化)
#[inline(always)]
fn extract_discriminator_simd(log: &str) -> Option<u64> {
    let log_bytes = log.as_bytes();
    let pos = BASE64_FINDER.find(log_bytes)?;

    let data_part = &log[pos + 14..];
    let body = data_part.trim().as_bytes();

    use base64_simd::AsOut;
    let mut compact = [0u8; 24];
    let n = copy_b64_skip_ws_prefix(body, &mut compact, 16)?;
    let mut dec = [0u8; 12];
    base64_simd::STANDARD.decode(&compact[..n], dec.as_mut().as_out()).ok()?;

    unsafe {
        let ptr = dec.as_ptr() as *const u64;
        Some(ptr.read_unaligned())
    }
}

// ============================================================================
// Unsafe 读取函数 - 消除边界检查
// ============================================================================

/// 读取 u64 (unsafe, 无边界检查)
#[inline(always)]
unsafe fn read_u64_unchecked(data: &[u8], offset: usize) -> u64 {
    let ptr = data.as_ptr().add(offset) as *const u64;
    u64::from_le(ptr.read_unaligned())
}

/// 读取 i64 (unsafe, 无边界检查)
#[inline(always)]
unsafe fn read_i64_unchecked(data: &[u8], offset: usize) -> i64 {
    let ptr = data.as_ptr().add(offset) as *const i64;
    i64::from_le(ptr.read_unaligned())
}

#[derive(Default)]
struct PumpSwapTradeTail {
    cashback_fee_basis_points: u64,
    cashback: u64,
    buyback_fee_basis_points: u64,
    buyback_fee: u64,
    virtual_quote_reserves: i128,
    can_boost: bool,
    base_supply: u64,
    holder_rewards_bps: u64,
    holder_rewards: u64,
}

#[inline(always)]
fn read_u64_le_at(data: &[u8], offset: usize) -> Option<u64> {
    let bytes = data.get(offset..offset.checked_add(8)?)?;
    Some(u64::from_le_bytes(bytes.try_into().ok()?))
}

#[inline(always)]
fn read_i128_le_at(data: &[u8], offset: usize) -> Option<i128> {
    let bytes = data.get(offset..offset.checked_add(16)?)?;
    Some(i128::from_le_bytes(bytes.try_into().ok()?))
}

#[inline(always)]
fn read_borsh_string(data: &[u8], offset: usize) -> Option<(String, usize)> {
    let content_offset = offset.checked_add(4)?;
    let len = u32::from_le_bytes(data.get(offset..content_offset)?.try_into().ok()?) as usize;
    let end = content_offset.checked_add(len)?;
    let value = std::str::from_utf8(data.get(content_offset..end)?).ok()?.to_owned();
    Some((value, end))
}

/// Decode the append-only PumpSwap trade-event tail across released layouts.
#[inline(always)]
fn parse_trade_tail(data: &[u8]) -> Option<PumpSwapTradeTail> {
    const CASHBACK_LEN: usize = 16;
    const BUYBACK_LEN: usize = 32;
    const BOOST_LEN: usize = 57;
    const HOLDER_REWARDS_LEN: usize = 73;

    if data.is_empty() {
        return Some(PumpSwapTradeTail::default());
    }
    if data.len() < CASHBACK_LEN {
        return None;
    }

    let mut tail = PumpSwapTradeTail {
        cashback_fee_basis_points: read_u64_le_at(data, 0)?,
        cashback: read_u64_le_at(data, 8)?,
        ..Default::default()
    };
    if data.len() == CASHBACK_LEN {
        return Some(tail);
    }
    if data.len() < BUYBACK_LEN {
        return None;
    }

    tail.buyback_fee_basis_points = read_u64_le_at(data, 16)?;
    tail.buyback_fee = read_u64_le_at(data, 24)?;
    if data.len() == BUYBACK_LEN {
        return Some(tail);
    }
    if data.len() < BOOST_LEN {
        return None;
    }

    tail.virtual_quote_reserves = read_i128_le_at(data, 32)?;
    tail.can_boost = match data[48] {
        0 => false,
        1 => true,
        _ => return None,
    };
    tail.base_supply = read_u64_le_at(data, 49)?;
    if data.len() != BOOST_LEN && data.len() < HOLDER_REWARDS_LEN {
        return None;
    }
    if data.len() >= HOLDER_REWARDS_LEN {
        tail.holder_rewards_bps = read_u64_le_at(data, 57)?;
        tail.holder_rewards = read_u64_le_at(data, 65)?;
    }
    Some(tail)
}

/// Read u16 (unsafe, no bounds check)
#[inline(always)]
unsafe fn read_u16_unchecked(data: &[u8], offset: usize) -> u16 {
    let ptr = data.as_ptr().add(offset) as *const u16;
    u16::from_le(ptr.read_unaligned())
}

/// Read u8 (unsafe, no bounds check)
#[inline(always)]
unsafe fn read_u8_unchecked(data: &[u8], offset: usize) -> u8 {
    *data.get_unchecked(offset)
}

/// 读取 bool (unsafe, 无边界检查)
#[inline(always)]
unsafe fn read_bool_unchecked(data: &[u8], offset: usize) -> bool {
    *data.get_unchecked(offset) == 1
}

/// 读取 Pubkey (unsafe, 无边界检查)
///
/// 优化: 添加内存预取，假设连续读取多个 Pubkey
#[inline(always)]
unsafe fn read_pubkey_unchecked(data: &[u8], offset: usize) -> Pubkey {
    // 预取下一个可能的 Pubkey 位置 (假设连续读取)
    // 使用 T0 提示 (最高优先级) 将数据预取到 L1 cache
    #[cfg(target_arch = "x86_64")]
    {
        use std::arch::x86_64::_mm_prefetch;
        use std::arch::x86_64::_MM_HINT_T0;
        if offset + 64 < data.len() {
            _mm_prefetch((data.as_ptr().add(offset + 32)) as *const i8, _MM_HINT_T0);
        }
    }

    let ptr = data.as_ptr().add(offset);
    let mut bytes = [0u8; 32];
    std::ptr::copy_nonoverlapping(ptr, bytes.as_mut_ptr(), 32);
    Pubkey::new_from_array(bytes)
}

// ============================================================================
// Optimized event parsing functions
// ============================================================================

/// Main parse function (optimized)
///
/// Performance target: <100ns
#[inline(always)]
pub fn parse_log(
    log: &str,
    signature: Signature,
    slot: u64,
    tx_index: u64,
    block_time_us: Option<i64>,
    grpc_recv_us: i64,
) -> Option<DexEvent> {
    #[cfg(feature = "perf-stats")]
    let start = std::time::Instant::now();

    // Stack-allocated buffer (增加到 2KB 以防止 base64-simd 缓冲区溢出)
    let mut buf = [0u8; 2048];
    let program_data = extract_program_data_zero_copy(log, &mut buf)?;

    if program_data.len() < 8 {
        return None;
    }

    // Read discriminator using unsafe (SIMD optimized)
    let discriminator = unsafe { read_u64_unchecked(program_data, 0) };
    let data = &program_data[8..];

    let result = match discriminator {
        discriminators::BUY => parse_buy_from_data(
            data,
            EventMetadata {
                signature,
                slot,
                tx_index,
                block_time_us: block_time_us.unwrap_or(0),
                grpc_recv_us,
                recent_blockhash: None,
            },
        ),
        discriminators::SELL => parse_sell_from_data(
            data,
            EventMetadata {
                signature,
                slot,
                tx_index,
                block_time_us: block_time_us.unwrap_or(0),
                grpc_recv_us,
                recent_blockhash: None,
            },
        ),
        discriminators::CREATE_POOL => parse_create_pool_event_optimized(
            data,
            signature,
            slot,
            tx_index,
            block_time_us,
            grpc_recv_us,
        ),
        discriminators::ADD_LIQUIDITY => parse_add_liquidity_event_optimized(
            data,
            signature,
            slot,
            tx_index,
            block_time_us,
            grpc_recv_us,
        ),
        discriminators::REMOVE_LIQUIDITY => parse_remove_liquidity_event_optimized(
            data,
            signature,
            slot,
            tx_index,
            block_time_us,
            grpc_recv_us,
        ),
        _ => None,
    };

    #[cfg(feature = "perf-stats")]
    {
        PARSE_COUNT.fetch_add(1, Ordering::Relaxed);
        PARSE_TIME_NS.fetch_add(start.elapsed().as_nanos() as usize, Ordering::Relaxed);
    }

    result
}

/// 解析池创建事件 (极限优化)
#[inline(always)]
fn parse_create_pool_event_optimized(
    data: &[u8],
    signature: Signature,
    slot: u64,
    tx_index: u64,
    block_time_us: Option<i64>,
    grpc_recv_us: i64,
) -> Option<DexEvent> {
    // 一次性边界检查 (含 IDL 最后一列 is_mayhem_mode: bool)
    const CREATE_POOL_EVENT_LEN: usize = 326;
    const CREATOR_FEE_EVENT_LEN: usize = 335;
    const REQUIRED_LEN: usize = CREATE_POOL_EVENT_LEN;
    if data.len() < REQUIRED_LEN
        || (data.len() != CREATE_POOL_EVENT_LEN && data.len() < CREATOR_FEE_EVENT_LEN)
    {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let index = read_u16_unchecked(data, 8);

        let creator = read_pubkey_unchecked(data, 10);
        let base_mint = read_pubkey_unchecked(data, 42);
        let quote_mint = read_pubkey_unchecked(data, 74);

        let base_mint_decimals = read_u8_unchecked(data, 106);
        let quote_mint_decimals = read_u8_unchecked(data, 107);

        let base_amount_in = read_u64_unchecked(data, 108);
        let quote_amount_in = read_u64_unchecked(data, 116);
        let pool_base_amount = read_u64_unchecked(data, 124);
        let pool_quote_amount = read_u64_unchecked(data, 132);
        let minimum_liquidity = read_u64_unchecked(data, 140);
        let initial_liquidity = read_u64_unchecked(data, 148);
        let lp_token_amount_out = read_u64_unchecked(data, 156);

        let pool_bump = read_u8_unchecked(data, 164);

        let pool = read_pubkey_unchecked(data, 165);
        let lp_mint = read_pubkey_unchecked(data, 197);
        let user_base_token_account = read_pubkey_unchecked(data, 229);
        let user_quote_token_account = read_pubkey_unchecked(data, 261);
        let coin_creator = read_pubkey_unchecked(data, 293);
        let is_mayhem_mode = read_bool_unchecked(data, 325);
        let creator_fee_bps = if data.len() >= 334 { read_u64_unchecked(data, 326) } else { 0 };
        let can_edit_creator_fee = data.len() > 334 && read_bool_unchecked(data, 334);
        let is_holder_reward = data.len() > 335 && read_bool_unchecked(data, 335);

        let metadata = EventMetadata {
            signature,
            slot,
            tx_index,
            block_time_us: block_time_us.unwrap_or(0),
            grpc_recv_us,
            recent_blockhash: None,
        };

        Some(DexEvent::PumpSwapCreatePool(PumpSwapCreatePoolEvent {
            metadata,
            timestamp,
            index,
            creator,
            base_mint,
            quote_mint,
            base_mint_decimals,
            quote_mint_decimals,
            base_amount_in,
            quote_amount_in,
            pool_base_amount,
            pool_quote_amount,
            minimum_liquidity,
            initial_liquidity,
            lp_token_amount_out,
            pool_bump,
            pool,
            lp_mint,
            user_base_token_account,
            user_quote_token_account,
            coin_creator,
            is_mayhem_mode,
            is_cashback_coin: false,
            creator_fee_bps,
            can_edit_creator_fee,
            is_holder_reward,
        }))
    }
}

/// 解析添加流动性事件 (极限优化)
#[inline(always)]
fn parse_add_liquidity_event_optimized(
    data: &[u8],
    signature: Signature,
    slot: u64,
    tx_index: u64,
    block_time_us: Option<i64>,
    grpc_recv_us: i64,
) -> Option<DexEvent> {
    const REQUIRED_LEN: usize = 10 * 8 + 5 * 32;
    if data.len() < REQUIRED_LEN {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let lp_token_amount_out = read_u64_unchecked(data, 8);
        let max_base_amount_in = read_u64_unchecked(data, 16);
        let max_quote_amount_in = read_u64_unchecked(data, 24);
        let user_base_token_reserves = read_u64_unchecked(data, 32);
        let user_quote_token_reserves = read_u64_unchecked(data, 40);
        let pool_base_token_reserves = read_u64_unchecked(data, 48);
        let pool_quote_token_reserves = read_u64_unchecked(data, 56);
        let base_amount_in = read_u64_unchecked(data, 64);
        let quote_amount_in = read_u64_unchecked(data, 72);
        let lp_mint_supply = read_u64_unchecked(data, 80);

        let pool = read_pubkey_unchecked(data, 88);
        let user = read_pubkey_unchecked(data, 120);
        let user_base_token_account = read_pubkey_unchecked(data, 152);
        let user_quote_token_account = read_pubkey_unchecked(data, 184);
        let user_pool_token_account = read_pubkey_unchecked(data, 216);

        let metadata = EventMetadata {
            signature,
            slot,
            tx_index,
            block_time_us: block_time_us.unwrap_or(0),
            grpc_recv_us,
            recent_blockhash: None,
        };

        Some(DexEvent::PumpSwapLiquidityAdded(PumpSwapLiquidityAdded {
            metadata,
            timestamp,
            lp_token_amount_out,
            max_base_amount_in,
            max_quote_amount_in,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            base_amount_in,
            quote_amount_in,
            lp_mint_supply,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            user_pool_token_account,
        }))
    }
}

/// 解析移除流动性事件 (极限优化)
#[inline(always)]
fn parse_remove_liquidity_event_optimized(
    data: &[u8],
    signature: Signature,
    slot: u64,
    tx_index: u64,
    block_time_us: Option<i64>,
    grpc_recv_us: i64,
) -> Option<DexEvent> {
    const REQUIRED_LEN: usize = 10 * 8 + 5 * 32;
    if data.len() < REQUIRED_LEN {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let lp_token_amount_in = read_u64_unchecked(data, 8);
        let min_base_amount_out = read_u64_unchecked(data, 16);
        let min_quote_amount_out = read_u64_unchecked(data, 24);
        let user_base_token_reserves = read_u64_unchecked(data, 32);
        let user_quote_token_reserves = read_u64_unchecked(data, 40);
        let pool_base_token_reserves = read_u64_unchecked(data, 48);
        let pool_quote_token_reserves = read_u64_unchecked(data, 56);
        let base_amount_out = read_u64_unchecked(data, 64);
        let quote_amount_out = read_u64_unchecked(data, 72);
        let lp_mint_supply = read_u64_unchecked(data, 80);

        let pool = read_pubkey_unchecked(data, 88);
        let user = read_pubkey_unchecked(data, 120);
        let user_base_token_account = read_pubkey_unchecked(data, 152);
        let user_quote_token_account = read_pubkey_unchecked(data, 184);
        let user_pool_token_account = read_pubkey_unchecked(data, 216);

        let metadata = EventMetadata {
            signature,
            slot,
            tx_index,
            block_time_us: block_time_us.unwrap_or(0),
            grpc_recv_us,
            recent_blockhash: None,
        };

        Some(DexEvent::PumpSwapLiquidityRemoved(PumpSwapLiquidityRemoved {
            metadata,
            timestamp,
            lp_token_amount_in,
            min_base_amount_out,
            min_quote_amount_out,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            base_amount_out,
            quote_amount_out,
            lp_mint_supply,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            user_pool_token_account,
        }))
    }
}

// ============================================================================
// 快速过滤 API (用于事件过滤场景)
// ============================================================================

/// 快速判断事件类型 (只解析 discriminator)
///
/// 性能: <50ns
#[inline(always)]
pub fn get_event_type_fast(log: &str) -> Option<u64> {
    extract_discriminator_simd(log)
}

/// 检查是否为特定事件类型 (SIMD 优化)
#[inline(always)]
pub fn is_event_type(log: &str, discriminator: u64) -> bool {
    extract_discriminator_simd(log) == Some(discriminator)
}

// ============================================================================
// Public API for optimized parsing from pre-decoded data
// These functions accept already-decoded data (without discriminator)
// ============================================================================

/// Parse PumpSwap Buy event from pre-decoded data
#[inline(always)]
pub fn parse_buy_from_data(data: &[u8], metadata: EventMetadata) -> Option<DexEvent> {
    // Historical events end after last_update_timestamp. Newer layouts append
    // min_base_amount_out, ix_name, and complete trade-tail schema versions.
    const LEGACY_LEN: usize = 16 * 8 + 7 * 32 + 1 + 4 * 8;
    const MIN_REQUIRED_LEN: usize = LEGACY_LEN + 8 + 4;
    if data.len() != LEGACY_LEN && data.len() < MIN_REQUIRED_LEN {
        return None;
    }
    let track_volume = match data[352] {
        0 => false,
        1 => true,
        _ => return None,
    };

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let base_amount_out = read_u64_unchecked(data, 8);
        let max_quote_amount_in = read_u64_unchecked(data, 16);
        let user_base_token_reserves = read_u64_unchecked(data, 24);
        let user_quote_token_reserves = read_u64_unchecked(data, 32);
        let pool_base_token_reserves = read_u64_unchecked(data, 40);
        let pool_quote_token_reserves = read_u64_unchecked(data, 48);
        let quote_amount_in = read_u64_unchecked(data, 56);
        let lp_fee_basis_points = read_u64_unchecked(data, 64);
        let lp_fee = read_u64_unchecked(data, 72);
        let protocol_fee_basis_points = read_u64_unchecked(data, 80);
        let protocol_fee = read_u64_unchecked(data, 88);
        let quote_amount_in_with_lp_fee = read_u64_unchecked(data, 96);
        let user_quote_amount_in = read_u64_unchecked(data, 104);

        let pool = read_pubkey_unchecked(data, 112);
        let user = read_pubkey_unchecked(data, 144);
        let user_base_token_account = read_pubkey_unchecked(data, 176);
        let user_quote_token_account = read_pubkey_unchecked(data, 208);
        let protocol_fee_recipient = read_pubkey_unchecked(data, 240);
        let protocol_fee_recipient_token_account = read_pubkey_unchecked(data, 272);
        let coin_creator = read_pubkey_unchecked(data, 304);

        let coin_creator_fee_basis_points = read_u64_unchecked(data, 336);
        let coin_creator_fee = read_u64_unchecked(data, 344);
        let total_unclaimed_tokens = read_u64_unchecked(data, 353);
        let total_claimed_tokens = read_u64_unchecked(data, 361);
        let current_sol_volume = read_u64_unchecked(data, 369);
        let last_update_timestamp = read_i64_unchecked(data, 377);

        let (min_base_amount_out, ix_name, tail) = if data.len() == LEGACY_LEN {
            (0, String::new(), PumpSwapTradeTail::default())
        } else {
            let min_base_amount_out = read_u64_unchecked(data, LEGACY_LEN);
            let (ix_name, tail_offset) = read_borsh_string(data, LEGACY_LEN + 8)?;
            let tail = parse_trade_tail(&data[tail_offset..])?;
            (min_base_amount_out, ix_name, tail)
        };

        Some(DexEvent::PumpSwapBuy(PumpSwapBuyEvent {
            metadata,
            timestamp,
            base_amount_out,
            max_quote_amount_in,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            quote_amount_in,
            lp_fee_basis_points,
            lp_fee,
            protocol_fee_basis_points,
            protocol_fee,
            quote_amount_in_with_lp_fee,
            user_quote_amount_in,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            protocol_fee_recipient,
            protocol_fee_recipient_token_account,
            coin_creator,
            coin_creator_fee_basis_points,
            coin_creator_fee,
            track_volume,
            total_unclaimed_tokens,
            total_claimed_tokens,
            current_sol_volume,
            last_update_timestamp,
            min_base_amount_out,
            ix_name,
            cashback_fee_basis_points: tail.cashback_fee_basis_points,
            cashback: tail.cashback,
            buyback_fee_basis_points: tail.buyback_fee_basis_points,
            buyback_fee: tail.buyback_fee,
            virtual_quote_reserves: tail.virtual_quote_reserves,
            can_boost: tail.can_boost,
            base_supply: tail.base_supply,
            holder_rewards_bps: tail.holder_rewards_bps,
            holder_rewards: tail.holder_rewards,
            ..Default::default()
        }))
    }
}

/// Parse PumpSwap Sell event from pre-decoded data
#[inline(always)]
pub fn parse_sell_from_data(data: &[u8], metadata: EventMetadata) -> Option<DexEvent> {
    // 14 numeric fields, 7 pubkeys, and the two coin-creator fee fields.
    const REQUIRED_LEN: usize = 14 * 8 + 7 * 32 + 2 * 8;
    if data.len() < REQUIRED_LEN {
        return None;
    }

    let tail = parse_trade_tail(&data[REQUIRED_LEN..])?;

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let base_amount_in = read_u64_unchecked(data, 8);
        let min_quote_amount_out = read_u64_unchecked(data, 16);
        let user_base_token_reserves = read_u64_unchecked(data, 24);
        let user_quote_token_reserves = read_u64_unchecked(data, 32);
        let pool_base_token_reserves = read_u64_unchecked(data, 40);
        let pool_quote_token_reserves = read_u64_unchecked(data, 48);
        let quote_amount_out = read_u64_unchecked(data, 56);
        let lp_fee_basis_points = read_u64_unchecked(data, 64);
        let lp_fee = read_u64_unchecked(data, 72);
        let protocol_fee_basis_points = read_u64_unchecked(data, 80);
        let protocol_fee = read_u64_unchecked(data, 88);
        let quote_amount_out_without_lp_fee = read_u64_unchecked(data, 96);
        let user_quote_amount_out = read_u64_unchecked(data, 104);

        let pool = read_pubkey_unchecked(data, 112);
        let user = read_pubkey_unchecked(data, 144);
        let user_base_token_account = read_pubkey_unchecked(data, 176);
        let user_quote_token_account = read_pubkey_unchecked(data, 208);
        let protocol_fee_recipient = read_pubkey_unchecked(data, 240);
        let protocol_fee_recipient_token_account = read_pubkey_unchecked(data, 272);
        let coin_creator = read_pubkey_unchecked(data, 304);

        let coin_creator_fee_basis_points = read_u64_unchecked(data, 336);
        let coin_creator_fee = read_u64_unchecked(data, 344);

        Some(DexEvent::PumpSwapSell(PumpSwapSellEvent {
            metadata,
            timestamp,
            base_amount_in,
            min_quote_amount_out,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            quote_amount_out,
            lp_fee_basis_points,
            lp_fee,
            protocol_fee_basis_points,
            protocol_fee,
            quote_amount_out_without_lp_fee,
            user_quote_amount_out,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            protocol_fee_recipient,
            protocol_fee_recipient_token_account,
            coin_creator,
            coin_creator_fee_basis_points,
            coin_creator_fee,
            cashback_fee_basis_points: tail.cashback_fee_basis_points,
            cashback: tail.cashback,
            buyback_fee_basis_points: tail.buyback_fee_basis_points,
            buyback_fee: tail.buyback_fee,
            virtual_quote_reserves: tail.virtual_quote_reserves,
            can_boost: tail.can_boost,
            base_supply: tail.base_supply,
            holder_rewards_bps: tail.holder_rewards_bps,
            holder_rewards: tail.holder_rewards,
            ..Default::default()
        }))
    }
}

/// Parse PumpSwap CreatePool event from pre-decoded data
#[inline(always)]
pub fn parse_create_pool_from_data(data: &[u8], metadata: EventMetadata) -> Option<DexEvent> {
    const CREATE_POOL_EVENT_LEN: usize = 326;
    const CREATOR_FEE_EVENT_LEN: usize = 335;
    const REQUIRED_LEN: usize = CREATE_POOL_EVENT_LEN;
    if data.len() < REQUIRED_LEN
        || (data.len() != CREATE_POOL_EVENT_LEN && data.len() < CREATOR_FEE_EVENT_LEN)
    {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let index = read_u16_unchecked(data, 8);

        let creator = read_pubkey_unchecked(data, 10);
        let base_mint = read_pubkey_unchecked(data, 42);
        let quote_mint = read_pubkey_unchecked(data, 74);

        let base_mint_decimals = read_u8_unchecked(data, 106);
        let quote_mint_decimals = read_u8_unchecked(data, 107);

        let base_amount_in = read_u64_unchecked(data, 108);
        let quote_amount_in = read_u64_unchecked(data, 116);
        let pool_base_amount = read_u64_unchecked(data, 124);
        let pool_quote_amount = read_u64_unchecked(data, 132);
        let minimum_liquidity = read_u64_unchecked(data, 140);
        let initial_liquidity = read_u64_unchecked(data, 148);
        let lp_token_amount_out = read_u64_unchecked(data, 156);

        let pool_bump = read_u8_unchecked(data, 164);

        let pool = read_pubkey_unchecked(data, 165);
        let lp_mint = read_pubkey_unchecked(data, 197);
        let user_base_token_account = read_pubkey_unchecked(data, 229);
        let user_quote_token_account = read_pubkey_unchecked(data, 261);
        let coin_creator = read_pubkey_unchecked(data, 293);
        let is_mayhem_mode = data.len() > 325 && read_bool_unchecked(data, 325);
        let creator_fee_bps = if data.len() >= 334 { read_u64_unchecked(data, 326) } else { 0 };
        let can_edit_creator_fee = data.len() > 334 && read_bool_unchecked(data, 334);
        let is_holder_reward = data.len() > 335 && read_bool_unchecked(data, 335);

        Some(DexEvent::PumpSwapCreatePool(PumpSwapCreatePoolEvent {
            metadata,
            timestamp,
            index,
            creator,
            base_mint,
            quote_mint,
            base_mint_decimals,
            quote_mint_decimals,
            base_amount_in,
            quote_amount_in,
            pool_base_amount,
            pool_quote_amount,
            minimum_liquidity,
            initial_liquidity,
            lp_token_amount_out,
            pool_bump,
            pool,
            lp_mint,
            user_base_token_account,
            user_quote_token_account,
            coin_creator,
            is_mayhem_mode,
            is_cashback_coin: false,
            creator_fee_bps,
            can_edit_creator_fee,
            is_holder_reward,
        }))
    }
}

/// Parse PumpSwap AddLiquidity event from pre-decoded data
#[inline(always)]
pub fn parse_add_liquidity_from_data(data: &[u8], metadata: EventMetadata) -> Option<DexEvent> {
    const REQUIRED_LEN: usize = 10 * 8 + 5 * 32;
    if data.len() < REQUIRED_LEN {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let lp_token_amount_out = read_u64_unchecked(data, 8);
        let max_base_amount_in = read_u64_unchecked(data, 16);
        let max_quote_amount_in = read_u64_unchecked(data, 24);
        let user_base_token_reserves = read_u64_unchecked(data, 32);
        let user_quote_token_reserves = read_u64_unchecked(data, 40);
        let pool_base_token_reserves = read_u64_unchecked(data, 48);
        let pool_quote_token_reserves = read_u64_unchecked(data, 56);
        let base_amount_in = read_u64_unchecked(data, 64);
        let quote_amount_in = read_u64_unchecked(data, 72);
        let lp_mint_supply = read_u64_unchecked(data, 80);

        let pool = read_pubkey_unchecked(data, 88);
        let user = read_pubkey_unchecked(data, 120);
        let user_base_token_account = read_pubkey_unchecked(data, 152);
        let user_quote_token_account = read_pubkey_unchecked(data, 184);
        let user_pool_token_account = read_pubkey_unchecked(data, 216);

        Some(DexEvent::PumpSwapLiquidityAdded(PumpSwapLiquidityAdded {
            metadata,
            timestamp,
            lp_token_amount_out,
            max_base_amount_in,
            max_quote_amount_in,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            base_amount_in,
            quote_amount_in,
            lp_mint_supply,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            user_pool_token_account,
        }))
    }
}

/// Parse PumpSwap RemoveLiquidity event from pre-decoded data
#[inline(always)]
pub fn parse_remove_liquidity_from_data(data: &[u8], metadata: EventMetadata) -> Option<DexEvent> {
    const REQUIRED_LEN: usize = 10 * 8 + 5 * 32;
    if data.len() < REQUIRED_LEN {
        return None;
    }

    unsafe {
        let timestamp = read_i64_unchecked(data, 0);
        let lp_token_amount_in = read_u64_unchecked(data, 8);
        let min_base_amount_out = read_u64_unchecked(data, 16);
        let min_quote_amount_out = read_u64_unchecked(data, 24);
        let user_base_token_reserves = read_u64_unchecked(data, 32);
        let user_quote_token_reserves = read_u64_unchecked(data, 40);
        let pool_base_token_reserves = read_u64_unchecked(data, 48);
        let pool_quote_token_reserves = read_u64_unchecked(data, 56);
        let base_amount_out = read_u64_unchecked(data, 64);
        let quote_amount_out = read_u64_unchecked(data, 72);
        let lp_mint_supply = read_u64_unchecked(data, 80);

        let pool = read_pubkey_unchecked(data, 88);
        let user = read_pubkey_unchecked(data, 120);
        let user_base_token_account = read_pubkey_unchecked(data, 152);
        let user_quote_token_account = read_pubkey_unchecked(data, 184);
        let user_pool_token_account = read_pubkey_unchecked(data, 216);

        Some(DexEvent::PumpSwapLiquidityRemoved(PumpSwapLiquidityRemoved {
            metadata,
            timestamp,
            lp_token_amount_in,
            min_base_amount_out,
            min_quote_amount_out,
            user_base_token_reserves,
            user_quote_token_reserves,
            pool_base_token_reserves,
            pool_quote_token_reserves,
            base_amount_out,
            quote_amount_out,
            lp_mint_supply,
            pool,
            user,
            user_base_token_account,
            user_quote_token_account,
            user_pool_token_account,
        }))
    }
}

// ============================================================================
// 性能统计 API (可选)
// ============================================================================

#[cfg(feature = "perf-stats")]
pub fn get_perf_stats() -> (usize, usize) {
    let count = PARSE_COUNT.load(Ordering::Relaxed);
    let total_ns = PARSE_TIME_NS.load(Ordering::Relaxed);
    (count, total_ns)
}

#[cfg(feature = "perf-stats")]
pub fn reset_perf_stats() {
    PARSE_COUNT.store(0, Ordering::Relaxed);
    PARSE_TIME_NS.store(0, Ordering::Relaxed);
}

#[cfg(test)]
mod tests {
    use super::*;
    use base64::{engine::general_purpose::STANDARD, Engine as _};
    use solana_sdk::{pubkey::Pubkey, signature::Signature};

    fn metadata() -> EventMetadata {
        EventMetadata {
            signature: Signature::default(),
            slot: 0,
            tx_index: 0,
            block_time_us: 0,
            grpc_recv_us: 0,
            recent_blockhash: None,
        }
    }

    fn write_u64(buf: &mut [u8], offset: usize, value: u64) {
        buf[offset..offset + 8].copy_from_slice(&value.to_le_bytes());
    }

    fn write_i64(buf: &mut [u8], offset: usize, value: i64) {
        buf[offset..offset + 8].copy_from_slice(&value.to_le_bytes());
    }

    fn write_pubkey(buf: &mut [u8], offset: usize, value: Pubkey) {
        buf[offset..offset + 32].copy_from_slice(value.as_ref());
    }

    fn append_current_trade_tail(data: &mut Vec<u8>) {
        data.extend_from_slice(&177u64.to_le_bytes()); // cashback_fee_basis_points
        data.extend_from_slice(&188u64.to_le_bytes()); // cashback
        data.extend_from_slice(&199u64.to_le_bytes()); // buyback_fee_basis_points
        data.extend_from_slice(&211u64.to_le_bytes()); // buyback_fee
        data.extend_from_slice(&(-987_654_321i128).to_le_bytes());
        data.push(1); // can_boost
        data.extend_from_slice(&222u64.to_le_bytes()); // base_supply
        data.extend_from_slice(&233u64.to_le_bytes()); // holder_rewards_bps
        data.extend_from_slice(&244u64.to_le_bytes()); // holder_rewards
    }

    fn append_buyback_trade_tail(data: &mut Vec<u8>) {
        data.extend_from_slice(&177u64.to_le_bytes()); // cashback_fee_basis_points
        data.extend_from_slice(&188u64.to_le_bytes()); // cashback
        data.extend_from_slice(&199u64.to_le_bytes()); // buyback_fee_basis_points
        data.extend_from_slice(&211u64.to_le_bytes()); // buyback_fee
    }

    fn build_buy_payload(include_current_tail: bool) -> Vec<u8> {
        let mut data = vec![0u8; 393];
        write_i64(&mut data, 0, 1_713_498_953);
        write_u64(&mut data, 8, 11);
        write_u64(&mut data, 385, 22);
        data.extend_from_slice(&3u32.to_le_bytes());
        data.extend_from_slice(b"buy");
        if include_current_tail {
            append_current_trade_tail(&mut data);
        }
        data
    }

    fn build_sell_payload(include_cashback: bool) -> Vec<u8> {
        let len = if include_cashback { 368 } else { 352 };
        let mut data = vec![0u8; len];

        write_i64(&mut data, 0, 1_713_498_953);
        write_u64(&mut data, 8, 11);
        write_u64(&mut data, 16, 22);
        write_u64(&mut data, 24, 33);
        write_u64(&mut data, 32, 44);
        write_u64(&mut data, 40, 55);
        write_u64(&mut data, 48, 66);
        write_u64(&mut data, 56, 77);
        write_u64(&mut data, 64, 88);
        write_u64(&mut data, 72, 99);
        write_u64(&mut data, 80, 111);
        write_u64(&mut data, 88, 122);
        write_u64(&mut data, 96, 133);
        write_u64(&mut data, 104, 144);

        write_pubkey(&mut data, 112, Pubkey::new_from_array([1; 32]));
        write_pubkey(&mut data, 144, Pubkey::new_from_array([2; 32]));
        write_pubkey(&mut data, 176, Pubkey::new_from_array([3; 32]));
        write_pubkey(&mut data, 208, Pubkey::new_from_array([4; 32]));
        write_pubkey(&mut data, 240, Pubkey::new_from_array([5; 32]));
        write_pubkey(&mut data, 272, Pubkey::new_from_array([6; 32]));
        write_pubkey(&mut data, 304, Pubkey::new_from_array([7; 32]));

        write_u64(&mut data, 336, 155);
        write_u64(&mut data, 344, 166);

        if include_cashback {
            write_u64(&mut data, 352, 177);
            write_u64(&mut data, 360, 188);
        }

        data
    }

    fn build_create_pool_payload(is_mayhem_mode: bool) -> Vec<u8> {
        let mut data = vec![0u8; 326];

        write_i64(&mut data, 0, 1_713_498_953);
        data[8..10].copy_from_slice(&42u16.to_le_bytes());
        write_pubkey(&mut data, 10, Pubkey::new_from_array([1; 32]));
        write_pubkey(&mut data, 42, Pubkey::new_from_array([2; 32]));
        write_pubkey(&mut data, 74, Pubkey::new_from_array([3; 32]));
        data[106] = 6;
        data[107] = 9;
        write_u64(&mut data, 108, 11);
        write_u64(&mut data, 116, 22);
        write_u64(&mut data, 124, 33);
        write_u64(&mut data, 132, 44);
        write_u64(&mut data, 140, 55);
        write_u64(&mut data, 148, 66);
        write_u64(&mut data, 156, 77);
        data[164] = 8;
        write_pubkey(&mut data, 165, Pubkey::new_from_array([4; 32]));
        write_pubkey(&mut data, 197, Pubkey::new_from_array([5; 32]));
        write_pubkey(&mut data, 229, Pubkey::new_from_array([6; 32]));
        write_pubkey(&mut data, 261, Pubkey::new_from_array([7; 32]));
        write_pubkey(&mut data, 293, Pubkey::new_from_array([8; 32]));
        data[325] = u8::from(is_mayhem_mode);
        data.extend_from_slice(&250u64.to_le_bytes());
        data.push(1);
        data.push(1);

        data
    }

    #[test]
    fn test_discriminator_simd() {
        // 测试 SIMD discriminator 提取
        let log = "Program data: Z/RS H8v1d3cAAAAAAAAAAA=";
        let disc = extract_discriminator_simd(log);
        assert!(disc.is_some());
    }

    #[test]
    fn test_parse_performance() {
        // 性能测试
        let log = "Program data: Z/RS H8v1d3cAAAAAAAAAAA=";
        let sig = Signature::default();

        let start = std::time::Instant::now();
        for _ in 0..1000 {
            let _ = parse_log(log, sig, 0, 0, Some(0), 0);
        }
        let elapsed = start.elapsed();

        println!("Average parse time: {} ns", elapsed.as_nanos() / 1000);
    }

    #[test]
    fn parse_sell_from_data_preserves_cashback_fields() {
        let event = parse_sell_from_data(&build_sell_payload(true), metadata())
            .expect("expected pumpswap sell event");

        let DexEvent::PumpSwapSell(event) = event else {
            panic!("expected PumpSwapSell event");
        };

        assert_eq!(event.cashback_fee_basis_points, 177);
        assert_eq!(event.cashback, 188);
        assert_eq!(event.coin_creator_fee_basis_points, 155);
        assert_eq!(event.coin_creator_fee, 166);
    }

    #[test]
    fn parse_current_buy_from_data_reads_virtual_reserves() {
        let event = parse_buy_from_data(&build_buy_payload(true), metadata())
            .expect("expected current pumpswap buy event");

        let DexEvent::PumpSwapBuy(event) = event else {
            panic!("expected PumpSwapBuy event");
        };

        assert_eq!(event.min_base_amount_out, 22);
        assert_eq!(event.ix_name, "buy");
        assert_eq!(event.cashback_fee_basis_points, 177);
        assert_eq!(event.cashback, 188);
        assert_eq!(event.buyback_fee_basis_points, 199);
        assert_eq!(event.buyback_fee, 211);
        assert_eq!(event.virtual_quote_reserves, -987_654_321);
        assert!(event.can_boost);
        assert_eq!(event.holder_rewards_bps, 233);
        assert_eq!(event.holder_rewards, 244);
        assert_eq!(event.base_supply, 222);
        assert_eq!(event.holder_rewards_bps, 233);
        assert_eq!(event.holder_rewards, 244);
    }

    #[test]
    fn parse_log_uses_current_buy_layout() {
        let mut program_data = discriminators::BUY.to_le_bytes().to_vec();
        program_data.extend_from_slice(&build_buy_payload(true));
        let log = format!("Program data: {}", STANDARD.encode(program_data));

        let event = parse_log(&log, Signature::default(), 7, 8, Some(9), 10)
            .expect("expected current pumpswap buy log");
        let DexEvent::PumpSwapBuy(event) = event else {
            panic!("expected PumpSwapBuy event");
        };

        assert_eq!(event.metadata.slot, 7);
        assert_eq!(event.virtual_quote_reserves, -987_654_321);
        assert!(event.can_boost);
    }

    #[test]
    fn parse_log_uses_current_sell_layout() {
        let mut payload = build_sell_payload(false);
        append_current_trade_tail(&mut payload);
        let mut program_data = discriminators::SELL.to_le_bytes().to_vec();
        program_data.extend_from_slice(&payload);
        let log = format!("Program data: {}", STANDARD.encode(program_data));

        let event = parse_log(&log, Signature::default(), 17, 18, Some(19), 20)
            .expect("expected current pumpswap sell log");
        let DexEvent::PumpSwapSell(event) = event else {
            panic!("expected PumpSwapSell event");
        };

        assert_eq!(event.metadata.slot, 17);
        assert_eq!(event.virtual_quote_reserves, -987_654_321);
        assert!(event.can_boost);
        assert_eq!(event.base_supply, 222);
    }

    #[test]
    fn parse_current_sell_from_data_reads_virtual_reserves() {
        let mut data = build_sell_payload(false);
        append_current_trade_tail(&mut data);
        let event =
            parse_sell_from_data(&data, metadata()).expect("expected current pumpswap sell event");

        let DexEvent::PumpSwapSell(event) = event else {
            panic!("expected PumpSwapSell event");
        };

        assert_eq!(event.cashback_fee_basis_points, 177);
        assert_eq!(event.cashback, 188);
        assert_eq!(event.buyback_fee_basis_points, 199);
        assert_eq!(event.buyback_fee, 211);
        assert_eq!(event.virtual_quote_reserves, -987_654_321);
        assert!(event.can_boost);
        assert_eq!(event.base_supply, 222);
    }

    #[test]
    fn trade_parsers_preserve_i128_extremes() {
        let mut buy = build_buy_payload(true);
        buy[432..448].copy_from_slice(&i128::MIN.to_le_bytes());
        let DexEvent::PumpSwapBuy(buy) =
            parse_buy_from_data(&buy, metadata()).expect("expected current buy")
        else {
            panic!("expected PumpSwapBuy event");
        };
        assert_eq!(buy.virtual_quote_reserves, i128::MIN);

        let mut sell = build_sell_payload(false);
        append_current_trade_tail(&mut sell);
        sell[384..400].copy_from_slice(&i128::MAX.to_le_bytes());
        let DexEvent::PumpSwapSell(sell) =
            parse_sell_from_data(&sell, metadata()).expect("expected current sell")
        else {
            panic!("expected PumpSwapSell event");
        };
        assert_eq!(sell.virtual_quote_reserves, i128::MAX);
    }

    #[test]
    fn parse_sell_from_data_keeps_legacy_payload_compatible() {
        let event = parse_sell_from_data(&build_sell_payload(false), metadata())
            .expect("expected legacy pumpswap sell event");

        let DexEvent::PumpSwapSell(event) = event else {
            panic!("expected PumpSwapSell event");
        };

        assert_eq!(event.cashback_fee_basis_points, 0);
        assert_eq!(event.cashback, 0);
        assert_eq!(event.coin_creator_fee_basis_points, 155);
        assert_eq!(event.coin_creator_fee, 166);
        assert_eq!(event.virtual_quote_reserves, 0);
        assert!(!event.can_boost);
        assert_eq!(event.base_supply, 0);
    }

    #[test]
    fn parse_buyback_layouts_without_boost_fields() {
        let mut buy = build_buy_payload(false);
        append_buyback_trade_tail(&mut buy);
        let DexEvent::PumpSwapBuy(buy) =
            parse_buy_from_data(&buy, metadata()).expect("expected buyback buy event")
        else {
            panic!("expected PumpSwapBuy event");
        };
        assert_eq!(buy.cashback_fee_basis_points, 177);
        assert_eq!(buy.buyback_fee_basis_points, 199);
        assert_eq!(buy.buyback_fee, 211);
        assert_eq!(buy.virtual_quote_reserves, 0);

        let mut sell = build_sell_payload(false);
        append_buyback_trade_tail(&mut sell);
        let DexEvent::PumpSwapSell(sell) =
            parse_sell_from_data(&sell, metadata()).expect("expected buyback sell event")
        else {
            panic!("expected PumpSwapSell event");
        };
        assert_eq!(sell.cashback_fee_basis_points, 177);
        assert_eq!(sell.buyback_fee_basis_points, 199);
        assert_eq!(sell.buyback_fee, 211);
        assert_eq!(sell.virtual_quote_reserves, 0);
    }

    #[test]
    fn trade_tail_accepts_only_complete_layouts() {
        for len in 0..=80 {
            let tail = vec![0u8; len];
            let expected = matches!(len, 0 | 16 | 32 | 57 | 73..=80);
            assert_eq!(parse_trade_tail(&tail).is_some(), expected, "tail length {len}");
        }

        for invalid_bool in 2..=u8::MAX {
            let mut tail = vec![0u8; 57];
            tail[48] = invalid_bool;
            assert!(parse_trade_tail(&tail).is_none(), "bool value {invalid_bool}");
        }
    }

    #[test]
    fn parse_buy_from_data_rejects_truncated_min_base_payload() {
        assert!(parse_buy_from_data(&vec![0u8; 385], metadata()).is_some());
        for len in 386..397 {
            assert!(parse_buy_from_data(&vec![0u8; len], metadata()).is_none());
        }
        assert!(parse_buy_from_data(&vec![0u8; 397], metadata()).is_some());
    }

    #[test]
    fn parse_buy_from_data_rejects_malformed_string_and_partial_tails() {
        let mut invalid_track_volume = build_buy_payload(false);
        invalid_track_volume[352] = 2;
        assert!(parse_buy_from_data(&invalid_track_volume, metadata()).is_none());

        let mut invalid_utf8 = build_buy_payload(false);
        invalid_utf8[397] = 0xff;
        assert!(parse_buy_from_data(&invalid_utf8, metadata()).is_none());

        let legacy = build_buy_payload(false);
        for partial_len in [1, 15, 17, 31, 33, 56] {
            let mut partial = legacy.clone();
            partial.resize(legacy.len() + partial_len, 0);
            assert!(parse_buy_from_data(&partial, metadata()).is_none());
        }

        let mut oversized_name = vec![0u8; 397];
        oversized_name[393..397].copy_from_slice(&u32::MAX.to_le_bytes());
        assert!(parse_buy_from_data(&oversized_name, metadata()).is_none());
    }

    #[test]
    fn parse_sell_from_data_rejects_partial_or_invalid_boost_tails() {
        for truncated_len in 336..352 {
            assert!(parse_sell_from_data(&vec![0u8; truncated_len], metadata()).is_none());
        }

        let legacy = build_sell_payload(false);
        for partial_len in [1, 15, 17, 31, 33, 56] {
            let mut partial = legacy.clone();
            partial.resize(legacy.len() + partial_len, 0);
            assert!(parse_sell_from_data(&partial, metadata()).is_none());
        }

        let mut invalid_bool = legacy;
        append_current_trade_tail(&mut invalid_bool);
        invalid_bool[352 + 48] = 2;
        assert!(parse_sell_from_data(&invalid_bool, metadata()).is_none());
    }

    #[test]
    fn parse_create_pool_from_data_reads_current_fields() {
        let event = parse_create_pool_from_data(&build_create_pool_payload(true), metadata())
            .expect("expected pumpswap create pool event");

        let DexEvent::PumpSwapCreatePool(event) = event else {
            panic!("expected PumpSwapCreatePool event");
        };

        assert_eq!(event.index, 42);
        assert!(event.is_mayhem_mode);
        assert!(!event.is_cashback_coin);
        assert_eq!(event.creator_fee_bps, 250);
        assert!(event.can_edit_creator_fee);
        assert!(event.is_holder_reward);
    }

    #[test]
    fn parse_create_pool_accepts_only_complete_layouts() {
        for len in 326..=336 {
            let expected = len == 326 || len >= 335;
            assert_eq!(
                parse_create_pool_from_data(&vec![0u8; len], metadata()).is_some(),
                expected,
                "create pool length {len}"
            );
        }
    }
}