夏雨全链矩阵 · USDT 收款监控系统完全免费

基于 Cloudflare Workers 边缘网络构建的全链 USDT 收款监控矩阵。覆盖 20+ 主流公链，按需唤醒扫块，秒级触发回调，为发卡网/商户系统提供企业级收款能力。内置 BEpusdt 兼容网关，支持独角数卡、彩虹易支付等主流发卡系统一键对接。

✨ 核心特性

工作流程：

1. 用户在发卡网下单 → 发卡网调用 POST /api/watch 登记（地址 + 金额 + 订单号）
2. 系统立即启动后台扫块循环（持续 N 分钟，每 M 秒扫一次）
3. 扫到匹配金额入账 → 写入 orders 表 → 遍历所有匹配的 webhook 广播回调
4. 发卡网收到回调 → 验签 → 执行发货/充值逻辑

🚀 部署指南

前置准备：

• 一个 Cloudflare 账号（免费注册）
• 本仓库代码（worker.js + public/ 文件夹）

方式一：浏览器界面部署（推荐新手）

全程在 Cloudflare 网页后台操作，不需要安装任何软件。

命名空间 ID 示例：6af7f7a56e9341edb03883c67e01781c

数据库 ID 示例：be97c23d-c895-4596-a876-b9b84c79bdd1

CREATE TABLE IF NOT EXISTS orders (
    tx_hash TEXT,
    network TEXT NOT NULL,
    amount TEXT NOT NULL,
    from_address TEXT NOT NULL,
    to_address TEXT,
    status TEXT DEFAULT 'pending',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (tx_hash, network)
);

CREATE TABLE IF NOT EXISTS webhooks (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    url TEXT NOT NULL,
    secret TEXT NOT NULL,
    binds TEXT DEFAULT '*',
    callback_type TEXT DEFAULT 'default',
    icon TEXT,
    remark TEXT,
    enabled INTEGER DEFAULT 1,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE IF NOT EXISTS addresses (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    address TEXT NOT NULL,
    icon TEXT,
    remark TEXT,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE IF NOT EXISTS sys_state (
    key_name TEXT PRIMARY KEY,
    key_value TEXT
);

CREATE TABLE IF NOT EXISTS active_watches (
    order_id TEXT PRIMARY KEY,
    address TEXT NOT NULL,
    network TEXT NOT NULL,
    expected_amount TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

后续更新：

1. 进入 Worker → 编辑代码
2. 替换 worker.js 内容
3. 点击 保存并部署

方式二：命令行部署（推荐有经验者）

前置条件：

• Node.js >= 18
• Wrangler CLI
• Cloudflare 账号

git clone https://github.com/xyusdtpro/xyusdt-pro.git
cd xyusdt-pro

npm install -g wrangler
wrangler login

wrangler d1 create xy-usdt

✅ Successfully created DB 'xy-usdt'
database_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

wrangler kv namespace create kv

{ binding = "kv", id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }

name = "xy-usdt"
main = "worker.js"
compatibility_date = "2026-05-20"

[triggers]
crons = ["* * * * *"]

[[kv_namespaces]]
binding = "kv"
id = "你的KV命名空间ID"

[[d1_databases]]
binding = "db"
database_name = "xy-usdt"
database_id = "你的D1数据库ID"

[[rules]]
type = "Text"
globs = ["**/*.html"]
fallthrough = true

[assets]
binding = "assets"
directory = "public"
run_worker_first = true

wrangler d1 execute xy-usdt --file=./schema.sql

wrangler deploy

Published xy-usdt (x.xx sec)
  https://xy-usdt.你的子域.workers.dev

wrangler routes add "your-domain.com/*" xy-usdt

⚙️ 后台设置详解

首次登录：

默认账号：admin
默认密码：123456

⚠️ 登录后第一件事：进入「基础配置」修改密码！

1. 基础配置

进入 基础配置 页面：

扫块参数说明：

• 持续时长：用户下单后系统持续扫块的时间。超时后自动停止，不浪费资源。建议 3~10 分钟。
• 扫块间隔：每次查链的间隔。太频繁可能被公共 RPC 限流，太慢会延迟到账通知。建议 15~60 秒。
• 随机模式：每次间隔在设定值的 50%~150% 之间波动，有效降低被限流概率。

2. 收款地址

进入 收款地址 页面，点击 + 增加地址：

智能网络识别规则：

💡 同一地址可以添加多次（绑定不同网络），系统会按绑定关系精准扫描。

3. 网络节点

进入 网络节点 页面，查看/编辑已接入的区块链网络。系统预置了 20+ 常用网络，点击 + 新增网络 可添加自定义链：

常用公链 USDT 参数速查表：

4. 回调路由

进入 回调路由 页面，点击 + 增加回调节点：

回调类型选择指南：

💡 如果你不确定选哪个，先选「默认格式」。如果对接的发卡系统支持 BEpusdt，就选「BEpusdt」。

绑定号池格式：

• * — 接收所有地址的所有网络回调
• Txxxxx — 仅接收该地址的通知
• Txxxxx@@TRONTRC20 — 仅接收该地址在 TRON 网络的通知
• Txxxxx@@TRONTRC20,0xYYYY@@BSC — 多个地址用逗号分隔

5. 数据导入导出

三个管理页面（回调路由、收款地址、网络节点）都支持：

• 📥 导出 — 将当前数据导出为 TXT 文件（制表符分隔，兼容 Excel）
• 📤 导入 — 弹窗支持批量粘贴或选择 TXT 文件导入

导出格式（TXT，每行一条，Tab 分隔）：

回调路由：名称\tURL\t密钥\t回调类型\t绑定号池\t图标\t备注
收款地址：绑定网络\t名称\t地址\t图标\t备注
网络节点：标识\t内核\tRPC\t合约\t精度\t颜色\t名称

💡 空字段保留制表符占位，确保列对齐。每行末尾不需要制表符。

🔌 对接发卡网

默认回调格式

适用于自建发卡系统或通用接口。

{
  "network": "TRON",
  "tx_hash": "abc123def456...",
  "amount": "100.50",
  "from_address": "T付款方地址",
  "to_address": "T收款方地址",
  "sign": "sha256签名字符串",
  "timestamp": 1723094400
}

签名原文 = network + tx_hash + amount + APP_SECRET
签名结果 = SHA-256(签名原文)

PHP 验签示例：

<?php
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);

$appSecret = '你的APP_SECRET';
$stringToSign = $data['network'] . $data['tx_hash'] . $data['amount'] . $appSecret;
$calculated = hash('sha256', $stringToSign);

if ($calculated !== $data['sign']) {
    http_response_code(403);
    die(json_encode(['code' => 403, 'msg' => '签名验证失败']));
}
echo json_encode(['code' => 200, 'msg' => 'SUCCESS']);

Node.js 验签：

const crypto = require('crypto');
const stringToSign = network + txHash + amount + appSecret;
const calculated = crypto.createHash('sha256').update(stringToSign).digest('hex');
if (calculated !== sign) { /* 签名非法 */ }

Python 验签：

import hashlib
string_to_sign = network + tx_hash + amount + app_secret
calculated = hashlib.sha256(string_to_sign.encode()).hexdigest()
if calculated != sign:
    # 签名非法
    pass

BEpusdt 回调格式

适用于支持 BEpusdt/Epusdt 协议的发卡系统（独角数卡、彩虹易支付、WHMCS 等）。

{
  "trade_id": "XYT1723094400000a8b3c",
  "order_id": "ORDER_20260808_001",
  "amount": 100.50,
  "actual_amount": 100.50,
  "token": "Tf863N…g888",
  "block_transaction_id": "abc123def456...",
  "status": 2,
  "signature": "md5签名字符串"
}

签名规则（BEpusdt 标准）：

1. 将所有参数（除 signature）按 key 的 ASCII 码排序
2. 拼接为 key1=value1&key2=value2 格式
3. 末尾追加 APP_SECRET（无 & 符号）
4. 对整个字符串做 MD5，结果转小写

签名原文示例：

actual_amount=100.50&amount=100.50&block_transaction_id=abc123&order_id=ORDER_001&status=2&token=***&trade_id=XYTxxxmy_secret_key

 签名结果 = MD5(上述原文)

支持的发卡系统

独角数卡 (Dujiao-Next) 对接教程

彩虹易支付对接教程

📡 API 参考

认证方式

登记订单（默认方式）

POST /api/watch
Authorization: Bearer <APP_SECRET>
Content-Type: application/json

{
  "address": "Txxxxx收款地址",
  "network": "TRON",
  "amount": "100.50",
  "order_id": "ORDER_001",
  "scan_duration": 5,      // 可选，分钟
  "scan_interval": 30,     // 可选，秒
  "scan_mode": "random"    // 可选，fixed/random
}

响应：

{
  "success": true,
  "scan_started": true,
  "scan_config": {
    "duration_min": 5,
    "interval_sec": 30,
    "mode": "random"
  }
}

创建订单（BEpusdt 兼容）

POST /api/v1/order/create-order
Content-Type: application/json

{
  "order_id": "ORDER_001",
  "amount": "100.50",
  "notify_url": "https://发卡网/api/v1/payments/callback",
  "signature": "md5签名"
}

响应：

{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "XYT...",
    "order_id": "ORDER_001",
    "amount": "100.50",
    "expiration_time": 1800,
    "payment_url": "https://你的域名/pay?trade_id=..."
  }
}

管理接口

# 流水
GET    /api/orders                          获取最近 100 条
DELETE /api/orders?tx_hash=xx&network=xx    删除单条
DELETE /api/orders                          批量删除 { items: [...] }

# 回调路由
GET    /api/webhooks                        获取全部
POST   /api/webhooks                        新增
PUT    /api/webhooks?id=xx                  更新
PUT    /api/webhooks?id=xx&status=1         启用/禁用
DELETE /api/webhooks?id=xx                  删除

# 收款地址
GET    /api/addresses                       获取全部
POST   /api/addresses                       新增
PUT    /api/addresses                       更新
DELETE /api/addresses?id=xx                 删除

# 网络节点
GET    /api/networks                        获取全部
POST   /api/networks                        更新全量

# 扫块配置
GET    /api/scan-config                     获取
POST   /api/scan-config                     保存

# 手动同步
POST   /api/sync                            触发全链扫描

❓ 常见问题

部署相关

Q: 部署报错 KV namespace not found？

A: wrangler.toml 中的 KV namespace ID 不正确。在 Cloudflare Dashboard → KV 中复制正确的 ID，填入 wrangler.toml。

Q: 部署后访问 500 错误？

A: 检查是否正确绑定了 D1 和 KV 变量。变量名称必须是小写的 db 和 kv。

Q: 如何更新代码？

A: 命令行：git pull && wrangler deploy。浏览器：进入 Worker → 编辑代码 → 替换 worker.js → 保存并部署。

扫块相关

Q: 部署后无法自动扫块？

A: 确认 Cron 触发器已配置：Workers → 设置 → 触发器 → Cron 表达式：* * * * *。同时确认回调路由中有已启用的记录。

Q: 扫块会不会被 RPC 限流？

A: 系统默认使用「随机间隔」模式，有效降低限流概率。建议使用私有 RPC 节点。按需唤醒架构下，平时不扫块，只有下单时才触发。

Q: 如何添加新的 EVM 兼容链？

A: 在「网络节点」页面点击 + 新增网络，填入标识、架构(evm)、RPC、USDT 合约、精度即可。

回调相关

Q: 多个发卡网用同一个钱包怎么配置？

A: 在「回调路由」中为每个发卡网各添加一条记录，绑定号池填 *。到账后系统会广播通知所有匹配的路由。

Q: 如何避免多发卡网串单？

A: 发卡网生成订单时使用带随机小数的金额（如 100.37、100.82），降低碰撞概率。或不同发卡网绑定不同收款地址。

Q: 回调后发卡网订单没有变「已支付」？

A: 排查顺序：

1. 确认 APP_SECRET 与发卡网密钥完全一致（无多余空格）
2. 确认回调类型选择正确（BEpusdt 系统选 BEpusdt）
3. 确认 CALLBACK_URL 填写正确
4. 在发卡网后台查看是否有回调到达记录

额度相关

Q: Cloudflare 免费额度够用吗？

💡 系统已内置内存缓存 + D1 降维方案，KV 写入压力极低。

📄 许可证

MIT License