# USDTMan

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

## 功能

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

## API 使用方式

```go
// 创建监听器（配置对象方式）
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("旧地址")
```

## 运行

```bash
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 时触发回调
- 自动去重，避免重复处理