feat: add Meteora DAMM V2 support and bump to v3.0.1

Add Meteora DAMM V2 trading protocol with instruction builder, type definitions, and fixed_output_token_amount parameter for precise output control. Update all examples and documentation.

src/trading/core/params.rs

@@ -3,6 +3,7 @@ use crate::common::bonding_curve::BondingCurveAccount;
 use crate::common::nonce_cache::DurableNonceInfo;
 use crate::common::spl_associated_token_account::get_associated_token_address_with_program_id;
 use crate::common::SolanaRpcClient;
+use crate::constants::TOKEN_PROGRAM;
 use crate::swqos::{SwqosClient, TradeType};
 use crate::trading::common::get_multi_token_balances;
 use crate::trading::MiddlewareManager;
@@ -36,6 +37,7 @@ pub struct SwapParams {
     pub close_input_mint_ata: bool,
     pub create_output_mint_ata: bool,
     pub close_output_mint_ata: bool,
+    pub fixed_output_amount: Option<u64>,
 }
 
 impl std::fmt::Debug for SwapParams {
@@ -647,3 +649,65 @@ impl ProtocolParams for RaydiumAmmV4Params {
         Box::new(self.clone())
     }
 }
+
+/// MeteoraDammV2 protocol specific parameters
+/// Configuration parameters specific to Meteora Damm V2 trading protocol
+#[derive(Clone)]
+pub struct MeteoraDammV2Params {
+    pub pool: Pubkey,
+    pub token_a_vault: Pubkey,
+    pub token_b_vault: Pubkey,
+    pub token_a_mint: Pubkey,
+    pub token_b_mint: Pubkey,
+    pub token_a_program: Pubkey,
+    pub token_b_program: Pubkey,
+}
+
+impl MeteoraDammV2Params {
+    pub fn new(
+        pool: Pubkey,
+        token_a_vault: Pubkey,
+        token_b_vault: Pubkey,
+        token_a_mint: Pubkey,
+        token_b_mint: Pubkey,
+        token_a_program: Pubkey,
+        token_b_program: Pubkey,
+    ) -> Self {
+        Self {
+            pool,
+            token_a_vault,
+            token_b_vault,
+            token_a_mint,
+            token_b_mint,
+            token_a_program,
+            token_b_program,
+        }
+    }
+
+    pub async fn from_pool_address_by_rpc(
+        rpc: &SolanaRpcClient,
+        pool_address: &Pubkey,
+    ) -> Result<Self, anyhow::Error> {
+        let pool_data =
+            crate::instruction::utils::meteora_damm_v2::fetch_pool(rpc, pool_address).await?;
+        Ok(Self {
+            pool: pool_address.clone(),
+            token_a_vault: pool_data.token_a_vault,
+            token_b_vault: pool_data.token_b_vault,
+            token_a_mint: pool_data.token_a_mint,
+            token_b_mint: pool_data.token_b_mint,
+            token_a_program: TOKEN_PROGRAM,
+            token_b_program: TOKEN_PROGRAM,
+        })
+    }
+}
+
+impl ProtocolParams for MeteoraDammV2Params {
+    fn as_any(&self) -> &dyn std::any::Any {
+        self
+    }
+
+    fn clone_box(&self) -> Box<dyn ProtocolParams> {
+        Box::new(self.clone())
+    }
+}

src/trading/factory.rs

@@ -1,9 +1,9 @@
 use std::sync::Arc;
 
 use crate::instruction::{
-    bonk::BonkInstructionBuilder, pumpfun::PumpFunInstructionBuilder,
-    pumpswap::PumpSwapInstructionBuilder, raydium_amm_v4::RaydiumAmmV4InstructionBuilder,
-    raydium_cpmm::RaydiumCpmmInstructionBuilder,
+    bonk::BonkInstructionBuilder, meteora_damm_v2::MeteoraDammV2InstructionBuilder,
+    pumpfun::PumpFunInstructionBuilder, pumpswap::PumpSwapInstructionBuilder,
+    raydium_amm_v4::RaydiumAmmV4InstructionBuilder, raydium_cpmm::RaydiumCpmmInstructionBuilder,
 };
 
 use super::core::{executor::GenericTradeExecutor, traits::TradeExecutor};
@@ -16,6 +16,7 @@ pub enum DexType {
     Bonk,
     RaydiumCpmm,
     RaydiumAmmV4,
+    MeteoraDammV2,
 }
 
 /// 交易工厂 - 用于创建不同协议的交易执行器
@@ -30,6 +31,7 @@ impl TradeFactory {
             DexType::Bonk => Self::bonk_executor(),
             DexType::RaydiumCpmm => Self::raydium_cpmm_executor(),
             DexType::RaydiumAmmV4 => Self::raydium_amm_v4_executor(),
+            DexType::MeteoraDammV2 => Self::meteora_damm_v2_executor(),
         }
     }
 
@@ -83,4 +85,14 @@ impl TradeFactory {
             });
         INSTANCE.clone()
     }
+
+    #[inline]
+    fn meteora_damm_v2_executor() -> Arc<dyn TradeExecutor> {
+        static INSTANCE: std::sync::LazyLock<Arc<dyn TradeExecutor>> =
+            std::sync::LazyLock::new(|| {
+                let instruction_builder = Arc::new(MeteoraDammV2InstructionBuilder);
+                Arc::new(GenericTradeExecutor::new(instruction_builder, "MeteoraDammV2"))
+            });
+        INSTANCE.clone()
+    }
 }