安全三层防线

01三道防线整体架构

任何交易请求（无论来自用户还是 AI）都必须依次穿越三道防线，任一环节拒绝即终止：

02第 1 道防线：TradeAuthManager

TradeAuthManager 控制 AI 交易功能本身能否启动。不满足条件时，AI 无法开启自动交易，从源头避免「小额账户被高频交易磨损」。

启动条件（满足任一即可）

检查方式

检查在后台线程执行（checkInBackground），避免主线程网络请求阻塞 UI。使用 getAllTokenBalances 批量查询（比单查更稳定），查询失败时用 0 兜底而非直接拒绝，结果缓存后主线程通过 canEnableAITrade() 直接读取。

TradeAuthManager tam = new TradeAuthManager(context);
tam.checkInBackground(context, result -> {
    if (result.allowed) {
        // 启动 AI 交易
    } else {
        Toast.show(result.reason); // 显示原因，提示用户加仓
    }
});

检查结果示例

// 通过
{
  "allowed": true,
  "nativeBalance": 0.003376,
  "nativeValueUsd": 1.91,
  "rmabBalance": 20998.0,
  "reason": null
}

// 拒绝
{
  "allowed": false,
  "nativeBalance": 0.001,
  "nativeValueUsd": 0.57,
  "rmabBalance": 5000.0,
  "reason": "资产不足：主流币 $0.57（需≥$200）且 R-MAB 5000（需≥20000），请加仓后重试"
}

03第 2 道防线：SafetyGate

SafetyGate 是所有写入操作（交易 / 转账 / 授权）的前置安全检查，共五步，任一失败即拒绝：

熔断规则表

白名单机制与豁免

默认所有代币为黑名单，AI 买入前必须通过白名单检查。检查目标是传入真实的 toToken 合约地址（非固定字符串）。

• 豁免规则：原生币（NATIVE / DEX_ROUTER / null）豁免白名单检查，无需用户确认。
• 确认弹窗选项：① 加入白名单并继续（永久加入）② 仅本次允许 ③ 拒绝（取消交易）。
• 超时处理：60 秒无操作自动拒绝。
• 存储位置：SharedPreferences 的 safety_gate_state.xml 文件 contract_whitelist 字段。

安全检查结果统一返回 JSON，便于 AI 与 UI 解析：

// 通过
{ "allowed": true, "reason": null }

// 拒绝
{ "allowed": false, "reason": "安全网关拦截: 已熔断，剩余 15 分钟" }

04第 3 道防线：RiskManager

RiskManager 在交易执行过程中做风控，确保单笔风险和总体暴露都在可控范围。

风控规则表

止损止盈监控

持仓数据结构示例：

{
  "token": "ETH", "contract": "0x...", "chain": "BNB",
  "amount": 0.1, "avgCost": 3200.0, "currentPrice": 3210.0,
  "stopLoss": 3040.0, "takeProfit": 3680.0,
  "unrealizedPnl": 1.0, "unrealizedPnlPercent": 0.31,
  "boughtAt": 1721484000000
}

05审计日志与脱敏

审计日志

每次工具调用都会记录到 Logger，格式 [时间] [级别] [模块] 消息：

[22:05:01] [ACTION] [AgentSwap] swap_tokens chain=BNB target=0x92cb...->NATIVE desc=卖出R-MAB换BNB
[22:05:02] [INFO] [SafetyGate] 检查通过: 白名单命中, 未熔断, 限额正常
[22:05:03] [SUCCESS] [DexTrader] 交易广播成功: txHash=0xabc...
[22:05:04] [INFO] [SafetyGate] onTradeSuccess: 今日第3笔, 累计$150

敏感信息保护

06异常处理