Files
sol-trade-sdk/docs/GAS_FEE_STRATEGY_CN.md
T
ysq 9ba8e3b3e7 refactor(gas-fee): Refactor Gas Fee Strategy API
- Rename add_* methods to set_* for clarity
- Simplify normal strategy API (remove TradeType param)
- Expose set/del methods for flexible strategy management
- Update docs and examples to match new API

BREAKING CHANGE: Method names changed for Gas Fee Strategy
2025-09-21 21:34:19 +08:00

1.7 KiB

📊 Gas Fee 策略指南

本文档介绍 Sol Trade SDK 中的 Gas Fee 策略配置和使用方法。

基础使用

1. 说明

该模块支持用户配置 SwqosType 在不同 TradeType(buy/sell) 下的策略。

  • normal 策略: 一个 SwqosType 发送一笔交易,指定 cu_limit、cu_price 和小费。
  • 高低费率策略: 一个 SwqosType 同时发送两笔交易,一笔低小费高优先费,一笔高小费低优先费。

每个 (SwqosType, TradeType) 的组合仅可配置一个策略。后续配置的策略会覆盖之前的策略。

2. 设置全局策略(也可以不设置,单独去配置单个策略)

use sol_trade_sdk::common::{gas_fee_strategy::GasFeeStrategy};
// 设置全局策略(normal 策略)
GasFeeStrategy::set_global_fee_strategy(
    150000, // cu_limit
    500000, // cu_price
    0.001,  // buy tip
    0.001   // sell tip
);

3. 配置单个策略

// 为 SwqosType::Jito 在 Buy 时配置 normal 策略
GasFeeStrategy::set_normal_fee_strategy(
    SwqosType::Jito,
    xxxxx, // cu_limit
    xxxx,  // cu_price
    xxxxx, // buy_tip
    xxxxx  // sell_tip
);

4. 配置高低费率策略

// 为 SwqosType::Jito 在 Buy 时配置高低费率策略
GasFeeStrategy::set_high_low_fee_strategy(
    SwqosType::Jito,
    TradeType::Buy,
    xxxxx, // cu_limit
    xxxxx, // low cu_price
    xxxxx, // high cu_price
    xxxxx, // low tip
    xxxxx  // high tip
);

5. 查看和清理

// 移除某个策略
GasFeeStrategy::del(SwqosType::Jito, TradeType::Buy);
// 查看所有策略
GasFeeStrategy::print_all_strategies();
// 清空所有策略
GasFeeStrategy::clear();

🔗 相关文档