跳到主要内容

Telegram 多链钱包地址监控 Bot 使用教程

简介​

本机器人可以轻松监控多个区块链内的虚拟币交易。Telegram内，搜索 @TGWalletMonitorBot 开始使用。

image-20260112144522055

区块链包含：

  • tron
  • polygon
  • bsc

虚拟币包括：

  • trx
  • bnb
  • pol
  • usdt
  • usdc

image-20260112143717047

image-20260112143720308

image-20260112143746116

普通用户教程​

快速开始​

1. 找到 Bot​

在 Telegram 中搜索并打开你的监控 Bot（ @TGWalletMonitorBot ）。

2. 开始使用​

发送命令：

/start

添加监控地址​

命令格式​

/add_address

发送命令后，Bot 会引导你选择网络并输入地址信息。

支持的区块链网络​

  • Tron - 支持 TRX、USDT (TRC20)
  • Polygon - 支持 MATIC、USDT、USDC
  • BSC - 支持 BNB、USDT、USDC

添加步骤​

  1. 发送 /add_address
  2. 选择区块链网络（点击按钮）
  3. 输入地址和备注，格式：地址 备注

示例：

/add_address TCCGdjHXmesGm3fWgAtZCicDepF2QcqCC 测试钱包

备注说明​

  • 备注用于标识地址用途，方便区分
  • 备注会在交易通知中显示，并带 # 标签（如 #交易所充值）
  • 可以在 Telegram 中搜索 #备注 快速找到相关交易

注意事项​

  • 同一个地址不能重复添加
  • EVM 地址（Polygon、BSC）添加后会同时监控两条链
  • 地址格式必须正确：
    • Tron: 以 T 开头，34 个字符
    • EVM: 以 0x 开头，42 个字符

查看监控列表​

命令​

/list

显示内容​

  • 所有监控的地址
  • 地址所在的网络
  • 地址备注
  • 每个地址可以点击删除按钮快速移除

示例输出：

📋 您的监控地址列表

共有 3 个地址：

━━━━━━━━━━━━━━━━
📍 地址：TR7N...j6t
🌐 网络：Tron
📝 备注：交易所充值
[❌ 删除]

━━━━━━━━━━━━━━━━
📍 地址：0x12...7890
🌐 网络：Polygon, BSC
📝 备注：DeFi钱包
[❌ 删除]

删除监控地址​

方法一：通过列表删除​

  1. 发送 /list 查看地址列表
  2. 点击要删除地址下方的 ❌ 删除 按钮
  3. 确认删除

方法二：通过命令删除​

/remove <地址>

示例：

/remove TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

提示：删除 EVM 地址时，会同时从 Polygon 和 BSC 两条链移除。

查看交易统计​

命令​

/stat

使用步骤​

  1. 发送 /stat
  2. 从列表中选择要统计的地址（点击按钮）
  3. 选择统计周期（1天、7天、30天、全部）

统计内容​

  • 各币种的收入、支出金额
  • 交易笔数统计
  • 按钮可切换不同时间范围

image-20260112143846864

示例输出：

📊 地址统计 (最近 7 天)

📍 地址：TR7N...j6t (#交易所充值)

━━━━━━━━━━━━━━━━
💎 TRX
收入：1,234.56 TRX (5笔)
支出：500.00 TRX (2笔)

━━━━━━━━━━━━━━━━
💵 USDT
收入：10,000.00 USDT (12笔)
支出：5,000.00 USDT (8笔)

[1天] [7天✓] [30天] [全部] [🔄 刷新]

余额查询​

当收到 Tron 网络的交易通知时，消息下方会显示两个余额查询按钮：

  • 💰 查询出账 - 查询发送方地址余额
  • 💰 查询入账 - 查询接收方地址余额

使用方法​

点击按钮后，会弹出余额信息窗口，显示：

💰 地址余额查询

📍 TR7N...j6t

💎 TRX: 1234.567890
💵 USDT: 5678.123456

注意：

  • 仅 Tron 交易通知有余额查询功能
  • 余额信息以弹窗形式显示，不会产生新消息
  • 查询的是当前实时余额

接收交易通知​

通知类型​

  1. 代币转账通知 - TRX、USDT、MATIC、BNB、USDC 等
  2. 能量代理通知 - Tron 网络的能量代理/回收操作

转账通知示例​

💰 收到转账！#交易所充值 +100.5 USDT

网络：#Tron
币种：#USDT
金额：100.5 USDT
发送方：TXaB...6tKm
接收方：TR7N...j6t (#交易所充值)
方向：外部地址 → #交易所充值
时间：2024-12-26 14:30:22
区块高度：12345678

[💰 查询出账] [💰 查询入账]
[🔗 查看交易详情]

能量代理通知示例​

⚡ 收到能量代理！#矿工钱包 +10.00 TRX

网络：#Tron
操作类型：#能量代理收入
资源类型：#ENERGY
资源数量：10.00 TRX (10000000 ENERGY)
委托方：TXaB...6tKm
接收方：TR7N...j6t
方向：您的地址 ← #矿工钱包
时间：2024-12-26 14:30:22
区块高度：12345678

[🔗 查看交易详情]

通知特点​

  • ✅ 实时通知（无需等待区块确认）
  • ✅ 收入/支出明确标识
  • ✅ 备注带 # 标签，方便搜索
  • ✅ 一键查看区块浏览器详情
  • ✅ Tron 交易支持余额查询

高流动钱包保护​

什么是高流动钱包？​

如果某个地址在 1分钟内产生超过 10 条交易，系统会判定为高流动钱包（如交易所热钱包、高频交易地址等）。

保护机制​

当检测到高流动钱包时，系统会：

  1. 发送警告通知
  2. 自动移除该地址的监控
  3. 避免大量通知刷屏

警告通知示例​

⚠️ 高流动钱包警告

您监控的地址 #交易所充值 在1分钟内产生了 15 条交易记录，
已被判定为高流动钱包。

📍 地址：TR7N...j6t
🌐 网络：#Tron

为避免大量通知刷屏，该地址的监控已被自动移除。
如需继续监控，请重新添加。

注意事项​

  • ⚠️ 高流动钱包会被自动移除
  • ✅ 管理员用户不受此限制
  • ✅ 如需继续监控，可以重新添加地址

管理员教程​

管理员权限​

管理员在配置文件 .env 中设置：

ADMIN_USER_IDS=123456789,987654321

管理员拥有的特殊权限：

  • ✅ 用户管理（延长/缩短/禁用账号）
  • ✅ 查看所有用户列表
  • ✅ 不受高流动钱包限制
  • ✅ 无账号过期限制（永久有效）

用户管理​

打开管理面板​

/admin

功能选项​

  1. 👥 所有用户 - 查看所有注册用户列表
  2. ➕ 延长 XX 天 - 给用户延长使用期限
  3. ➖ 缩短 XX 天 - 缩短用户使用期限
  4. 🚫 禁用用户 - 立即禁用某个用户

用户列表示例​

👥 用户列表

共有 5 个用户

━━━━━━━━━━━━━━━━
👤 用户：张三 (@zhangsan)
🆔 ID：123456789
⏰ 有效期：2025-01-15 10:30:00
📊 状态：正常

[➕30天] [➖7天] [🚫禁用]

━━━━━━━━━━━━━━━━
👤 用户：李四 (@lisi)
🆔 ID：987654321
⏰ 有效期：已过期
📊 状态：已过期

[➕30天] [➕7天] [🚫禁用]

操作说明​

  1. 延长用户 - 点击 ➕XX天 按钮，用户有效期会自动延长
  2. 缩短用户 - 点击 ➖XX天 按钮，用户有效期会缩短
  3. 禁用用户 - 点击 🚫禁用 按钮，用户立即被禁用（有效期设为当前时间）

用户状态管理​

  • 正常 - 账号在有效期内，可以正常使用
  • 即将过期 - 有效期剩余不足 7 天，用户会收到提醒
  • 已过期 - 账号过期，无法使用 Bot（仅能查看过期提示）

常见问题​

1. 如何联系管理员？​

发送 /start 命令后，如果账号未激活，会显示管理员联系方式。

2. 账号有效期是多久？​

  • 普通用户：由管理员设置（默认 30 天）
  • 管理员用户：永久有效

3. 可以监控多少个地址？​

理论上没有限制，但建议不超过 20 个地址，避免通知过多。

4. 交易通知有延迟吗？​

  • Tron：实时监控，通常延迟 1-3 秒
  • Polygon/BSC：区块确认时间约 3-15 秒

5. 为什么收不到通知？​

可能原因：

  • ✅ 地址格式错误
  • ✅ 交易金额低于最小通知阈值
  • ✅ 地址未正确添加（检查 /list）
  • ✅ 账号已过期
  • ✅ Bot 程序未运行

6. 如何搜索历史交易？​

在 Telegram 对话框中：

  1. 点击右上角搜索图标
  2. 输入备注标签（如 #交易所充值）
  3. 即可找到所有相关交易通知

7. 可以修改地址备注吗？​

暂不支持修改。如需修改：

  1. 删除旧地址
  2. 重新添加并设置新备注

8. EVM 地址为什么显示两个网络？​

因为 Polygon 和 BSC 都使用相同的地址格式（以太坊兼容），所以一个地址会同时监控两条链。

9. 能量代理是什么？​

Tron 网络中，用户可以将 TRX 质押后获得的能量委托给其他地址使用，或从其他地址回收能量。这些操作都会收到通知。

10. 高流动钱包判定标准能修改吗？​

当前固定为 1分钟内 > 10 条交易。如需修改，需要联系管理员调整程序配置。

11. 余额查询支持所有网络吗？​

目前仅支持 Tron 网络的 TRX 和 USDT 余额查询。Polygon 和 BSC 暂不支持。

12. 删除地址后，历史交易记录会消失吗？​

不会。交易记录仍然保存在数据库中，但不会再收到新的交易通知。

安全提醒​

  1. 不要分享账号 - 每个 Telegram 账号独立使用
  2. 保护隐私 - 不要将交易通知截图分享给他人
  3. 验证地址 - 添加地址前仔细核对，避免监控错误地址
  4. 定期检查 - 定期使用 /list 检查监控地址列表
  5. 及时联系管理员 - 发现异常及时报告

获取帮助​

如遇到问题，可以：

  1. 查看本教程
  2. 发送 /start 查看基本使用说明
  3. 联系管理员获取支持
  4. 查看程序日志文件（管理员）