usdtman/README.md

USDTMan

TRON USDT TRC20 收款监听服务 - 基于交易记录扫描 + 区块确认数验证

功能

• 实时监听多个 TRON 地址的 USDT 收款
• 区块确认数验证（默认6个确认）
• WebSocket 实时推送收款通知
• HTTP API 管理监听地址

API 使用方式

// 创建监听器（配置对象方式）
uman := usdtman.NewUSDTMan(usdtman.Config{
    Addresses:        []string{"地址1", "地址2"},
    APIKey:           "YOUR_API_KEY",
    QueryInterval:    5 * time.Second,  // 查询间隔（可选，默认 5 秒）
    MinConfirmations: 6,                 // 最小确认数（可选，默认 6）
    MaxHistoryTxns:   20,                // 查询历史交易数（可选，默认 20）
    ProxyURL:         "http://127.0.0.1:7890", // HTTP/SOCKS5 代理（可选）
})

// 或者使用自定义 Transport
uman := usdtman.NewUSDTMan(usdtman.Config{
    Addresses: []string{"地址1"},
    APIKey:    "YOUR_API_KEY",
    Transport: &http.Transport{
        Proxy: http.ProxyURL(proxyURL),
        // 其他自定义配置...
    },
})

// 设置收款回调
uman.OnPaymentComplete(func(payment *usdtman.USDTPayment) {
    fmt.Printf("收到 %.6f USDT，确认数: %d\n", payment.Amount, payment.Confirmations)
})

// 启动监听
uman.Start()

// 停止监听
uman.Stop()

// 动态添加/移除地址
uman.AddAddress("新地址")
uman.RemoveAddress("旧地址")

运行

cd cmd/server
go run main.go

访问 http://localhost:8084

接口

• POST /start - 启动监听
• POST /stop - 停止监听
• POST /add-address - 添加监听地址
• POST /remove-address - 移除地址
• GET /list-addresses - 列出所有地址
• GET /payments - 获取收款历史
• WS /ws - WebSocket 连接

确认机制

• 扫描地址的最近交易记录
• 计算区块确认数（当前区块 - 交易区块）
• 仅在确认数 >= 6 时触发回调
• 自动去重，避免重复处理