.env.example

# ========== RPC ROLE SEPARATION ==========

# Listener mode: hybrid (WS head + HTTP logs) or http_only (HTTP polling only)
LISTENER_MODE=hybrid

# Listener WebSocket endpoint (required in hybrid mode)
BSC_WSS_URL=wss://bsc-rpc.publicnode.com

# Listener get_logs HTTP pool (comma-separated, primary first)
BSC_LOG_HTTP_ENDPOINTS=https://four.rpc.48.club,https://bsc-rpc.publicnode.com

# Trade executor HTTP RPC (trade tx only; first endpoint is used)
BSC_TRADE_HTTP_RPC=https://four.rpc.48.club

# Deprecated legacy combined HTTP RPC (fallback only; prefer role-separated keys above)
BSC_HTTP_RPC=

# Optional local HTTP proxy for outbound HTTP RPC calls. Leave empty by default.
LOCAL_PROXY_URL=

# Historical scan switch (default disabled for realtime mode)
SCAN_HISTORICAL=false

# Listener lag-skip safety (0 disables skipping backlog; recommended for completeness)
LISTENER_MAX_LAG_SKIP_BLOCKS=0
LISTENER_LAG_SKIP_KEEP_RECENT_BLOCKS=200

# HTTP provider cooldown after transient failure (seconds)
LOG_PROVIDER_COOLDOWN_SECONDS=45

# Listener head polling interval (seconds); lower improves discovery latency but raises RPC load
LISTENER_POLL_INTERVAL_SECONDS=0.25

# FourMeme Contract Address - TokenManager2
FOURMEME_CONTRACT=0x5c952063c7fc8610FFDB798152D69F0B9550762b

# Contract ABI file path
CONTRACT_ABI_PATH=config/TokenManager.lite.abi

# Output Settings
OUTPUT_DIR=data/events
LOG_LEVEL=INFO
LOG_FILE=logs/monitor.log

# Connection Settings
MAX_RETRY_DELAY=60
HEARTBEAT_INTERVAL=60

# Event Filtering
MONITOR_EVENTS=all

# ========== 交易配置 (TRADING CONFIGURATION) ==========

# 钱包私钥 (务必保密! Never commit this!)
PRIVATE_KEY=your_private_key_here

# 交易开关 (Trading switches)
ENABLE_TRADING=false
ENABLE_BACKTEST=true

# Live model path. Keep pinned during candidate training; only switch to reviewed artifacts.
MODEL_DIR=data/models/20260519_v95_v84_selective_nearmiss_gate

BASE_GAS_PRICE_GWEI=0.08  # BSC固定gas price
MAX_GAS_PRICE_GWEI=0.1    # 最高不超过0.1 Gwei
GAS_MULTIPLIER=1.0   # 不加价,直接使用固定值
BUY_CONFIRM_POLL_INTERVAL_SECONDS=0.25 # 买入发出后查询 token 到账的轮询间隔
BUY_CONFIRM_TIMEOUT_SECONDS=120        # 买入到账确认最长等待时间
BUY_USE_LIFECYCLE_FAST_STATUS=true     # 新鲜 lifecycle 已有价格/未毕业时跳过 helper 入场查询
BUY_FAST_STATUS_MAX_STALENESS_SECONDS=3 # lifecycle 入场快路径允许的最大数据陈旧秒数
BUY_FAST_STATUS_MAX_CHAIN_LAG_SECONDS=8 # lifecycle 链上事件时间允许落后本机时间的最大秒数，防止追块时误用快路径
TX_RECEIPT_POLL_LATENCY_SECONDS=0.25   # 卖出/授权交易 receipt 轮询间隔
MAX_CONCURRENT_POSITIONS=8  # 默认与当前模型 manifest 的 max_open_positions 对齐
POSITION_SIZE=0.10          # 每次开仓使用当前余额的 10%
FIXED_STAKE_BNB=            # 留空表示不用固定 BNB 仓位，避免覆盖 10% 仓位模式
MAX_ENTRY_SIZE_BNB=         # 留空表示使用模型 manifest 的 max_position_fraction 训练上限；手动填值会覆盖模型
MIN_ENTRY_UNIQUE_BUYERS=3   # 买入前最低独立买家数，需与训练 min-entry-unique-buyers 保持一致
MIN_ENTRY_BUY_COUNT=5       # 买入前最低买入笔数，需与训练 min-entry-buy-count 保持一致
MIN_ENTRY_VOLUME_30S=1.5    # 默认与当前模型 manifest 的 min-entry-volume-30s 对齐
MIN_ENTRY_PRICE_VOLATILITY=0.1 # 默认与当前模型 manifest 的 min-entry-price-volatility 对齐
BUY_NEAR_THRESHOLD_MIN_PROB= # 留空表示使用模型 manifest；手动覆盖时必须大于 0 且不超过 1
BUY_NEAR_MIN_PRED_RETURN= # 留空表示使用模型 manifest；近阈值救援门最低预测收益
BUY_NEAR_MIN_ENTRY_VOLUME_30S= # 留空表示使用模型 manifest；近阈值救援门最低 30 秒入场成交量
BUY_NEAR_MIN_ENTRY_PRICE_VOLATILITY= # 留空表示使用模型 manifest；近阈值救援门最低入场价格波动
BUY_NEAR_MIN_AGE_SECONDS= # 留空表示使用模型 manifest；近阈值救援门最低 token 年龄秒数
BUY_PRIMARY_SCORE_RESCUE_MIN_PROB= # 留空表示跟随模型 manifest；若当前模型未带该参数则关闭主阈值救援门
BUY_PRIMARY_SCORE_RESCUE_MIN_PRED_RETURN= # 留空表示跟随模型 manifest；主阈值救援门最低预测收益
BUY_PRIMARY_SCORE_RESCUE_MIN_ENTRY_VOLUME_30S= # 留空表示跟随模型 manifest；主阈值救援门最低 30 秒入场成交量
BUY_PRIMARY_SCORE_RESCUE_MIN_ENTRY_PRICE_VOLATILITY= # 留空表示跟随模型 manifest；主阈值救援门最低入场价格波动
BUY_PRIMARY_SCORE_RESCUE_MIN_AGE_SECONDS= # 留空表示跟随模型 manifest；主阈值救援门最低 token 年龄秒数

# Dataset / replay live-cost alignment
DATASET_LABEL_ENTRY_FIXED_COST_BNB=0
DATASET_LABEL_EXIT_FIXED_COST_BNB=0
DATASET_LABEL_FIXED_STAKE_BNB=
DATASET_LABEL_ENTRY_PRICE_PROTECTION_PCT=
DATASET_INCLUDE_FLOW_FEATURES=false