Skip to content

QUICKSTART.md

Latest commit

 

History

History
181 lines (126 loc) · 3.68 KB

QUICKSTART.md

File metadata and controls

181 lines (126 loc) · 3.68 KB

SmartMoney Tracker 快速开始

1. 安装

git clone https://github.com/goingforstudying-ctrl/smartmoney-tracker.git
cd smartmoney-tracker
pip install -r requirements.txt

2. 配置

复制环境变量模板：

cp .env.example .env

编辑 .env 文件：

ETHERSCAN_API_KEY=你的API密钥（从 https://etherscan.io/apis 免费获取）
TELEGRAM_BOT_TOKEN=你的Bot Token（从 @BotFather 获取）
TELEGRAM_CHAT_ID=你的Telegram ID
MERCHANT_ADDRESS=0xd49536C908fa29c103501ed17b568628b16C8cE2

3. 免费版使用（立即开始）

# 添加最多3个监控地址
python main.py add 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  --name "测试鲸鱼" \
  --threshold 5000 \
  --user-id myuser

# 开始监控（5分钟检查一次）
python main.py monitor --user-id myuser

4. 升级到付费版

步骤1：付款

向以下地址转账 0.01 BNB 或等值 USDC：

0xd49536C908fa29c103501ed17b568628b16C8cE2

支持的链：

  • BNB：BSC 主网
  • USDC：Base 主网（推荐，手续费低）

步骤2：获取交易哈希

转账后，在区块链浏览器（BscScan/BaseScan）找到交易哈希 (Tx Hash)，格式如：

0x1234567890abcdef...

步骤3：激活付费版

python main.py status \
  --user-id myuser \
  --tx-hash 你的交易哈希 \
  --user-address 你的付款地址

示例：

python main.py status \
  --user-id myuser \
  --tx-hash 0x8a93c9a6ed5347ac0d0f9c9e57993d2b17de8e5c4ba67f3e2d9 \
  --user-address 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

步骤4：享受付费版

# 现在可以添加无限地址
python main.py add 0x... --name "鲸鱼2" --threshold 10000 --user-id myuser
python main.py add 0x... --name "鲸鱼3" --threshold 10000 --user-id myuser
# ... 无限添加

# 实时监控（1分钟间隔）
python main.py monitor --user-id myuser

5. 查看状态

# 检查付费状态
python main.py status --user-id myuser

# 输出示例：
# 用户ID: myuser
# 状态: premium
# 消息: ✅ 付费版已激活，有效期至 2026-04-05

6. 后台运行

# 使用 nohup 后台运行
nohup python main.py monitor --user-id myuser > tracker.log 2>&1 &

# 查看日志
tail -f tracker.log

# 停止运行
ps aux | grep "main.py monitor"
kill 进程ID

7. 多用户支持

每个 --user-id 是独立的：

# 用户 A（免费版）
python main.py monitor --user-id user_a

# 用户 B（付费版）
python main.py monitor --user-id user_b

付费状态按 user_id 保存，互不影响。

8. 常见问题

Q: 免费版和付费版有什么区别？

功能 免费版 付费版
地址数 3个 无限
检查间隔 5分钟 1分钟
价格 免费 0.01 BNB/USDC/月

Q: 付款后多久激活？

付款后立即激活，运行 python main.py status 命令验证。

Q: 可以退款吗？

区块链转账不可逆，付款前请确认。

Q: 付费版到期后会怎样？

自动降级为免费版（保留3个地址，其他地址暂停监控）。

Q: 如何续费？

再次付款并运行 status 命令，会自动延长30天有效期。

9. 获取帮助

# 查看所有命令
python main.py --help

# 查看具体命令帮助
python main.py add --help
python main.py monitor --help
python main.py status --help

10. 安全提示

⚠️ 重要：

  • 你的私钥和 API Key 只保存在本地 .env 文件
  • 不要将 .env 文件提交到 GitHub（已加入 .gitignore）
  • 付款地址已内置，请勿修改
  • 定期检查交易记录确保付款到账

准备好开始了吗？ 按照步骤1-3即可开始使用免费版！