源码介绍
TRX/TRC20波场钱包PHP开发版 是一个面向开发者的示例项目（非完整商用支付网关）。它演示了常见的波场链上交互流程：离线地址生成/激活、TRX 转账、TRC20 转账、离线签名、账户归集、充值回调监听。源码集成到 FastAdmin 后台，便于管理与二次开发；监听与归集使用 Workerman + think-queue 提升并发与稳定性。
主要功能亮点
离线钱包生成与激活
可以在离线环境生成私钥/公钥/地址并导出离线签名数据，支持激活流程示例（链上广播激活交易）。
TRX 与 TRC20 转账（含离线签名）
提供 TRX 和 TRC20（合约代币）转账接口示例，支持离线签名与离线广播流程，利于冷钱包安全实践。
账户归集（汇总）
批量归集小额地址到热钱包流程，示例代码集成队列处理以避免并发冲突与链上重复提交。
充值/转账监听
使用 Workerman 常驻进程 + think-queue 做区块/交易监听（监听每地址最后确认的区块高度，以增量方式查询并处理新交易）。
后台管理（FastAdmin）与 API 示例
集成 FastAdmin 管理后台、示例 SQL、以及 application/api/controller/Address.php 等 API 调用示例，方便二次开发与接口测试。
技术栈与工具
-
PHP (适配 PHP7.4+)
-
FastAdmin / ThinkPHP5 框架
-
Workerman（常驻进程监听）
-
think-queue（任务队列处理归集/转账）
-
MySQL（示例 SQL）
-
支持 Linux/Windows（注意大小写差异）
环境要求与依赖
运行环境（建议）
-
PHP 7.2–7.4（源码测试以 PHP7.4 为准）
-
MySQL 5.6+
-
Composer（依赖管理）
-
Workerman（常驻进程）
-
Redis（可选，用于队列/缓存）
-
可选：MongoDB（若源码使用）
主要 PHP 扩展
-
curl、openssl、bcmath、gd、mbstring、json、sockets（若 Workerman 需要）
目录与关键文件说明
常用代码位置（源码内示例位置）
-
TRON 逻辑封装：
application/common/logic/TronLogic.php—— 所有转账、地址生成、签名等核心函数封装处。 -
转账与监听入口：
application/push/controller/Worker.php—— Workerman 常驻进程入口，处理区块/交易监听与队列推送。 -
API 调用示例：
application/api/controller/Address.php—— 地址相关接口测试示例（充值查询、地址余额、签名请求等）。 -
Workerman 启动脚本：
server.php根目录 —— 启动监听与归集服务的入口脚本。 -
队列消费： 使用
php think queue:work {队列名}启动对应队列的消费进程（归集任务、转账任务等）。 -
后台管理： FastAdmin 后台路径可能自定义（示例：
/PWcRgnIzQK.php），后台帐号密码请务必修改并妥善保管。
快速安装与部署
1. 基础准备
-
部署 PHP 与 MySQL 环境（Linux 推荐），安装 Composer。
-
下载源码并解压到站点目录。
2. 安装依赖
3. 配置数据库
-
在 MySQL 创建数据库，导入源码附带的 SQL 文件（示例
.sql）。 -
修改数据库配置（
application/database.php或/config/database.php）。
4. 配置节点与RPC
-
在配置文件中填写波场节点（TRON fullnode / solidity node / event node）与 API key（若使用第三方服务）。
-
确保节点可用并能响应 RPC 请求。
5. 设置伪静态与运行目录（FastAdmin）
-
配置 Nginx/Apache 指向
public（或源码要求）并设置伪静态规则。
6. 启动监听与归集服务
-
启动 Workerman（或用 screen/tmux 后台常驻）：
-
启动队列消费者（归集队列示例）：
7. 测试接口
-
访问
application/api/controller/Address.php提供的测试方法，验证地址生成、余额查询、签名与转账流程。
8. 安全配置
-
变更后台默认路径与默认密码；
-
对私钥文件进行严格权限控制并考虑冷/热钱包分离；
-
关闭未使用的 RPC 接口；
-
生产环境请使用 HTTPS。
使用与开发注意事项（重要）
非完整支付网关
该示例为开发与学习用例，并非完整商用支付系统。上线前请务必进行代码审计、风控与合规评估。
链上确认与重试策略
-
监听时请记录最后处理的区块高度或交易哈希，增量查询新块以避免重复处理。
-
设计合理的确认数与重试机制，避免因节点重组造成误判。
私钥与冷/热钱包管理
-
强烈建议将私钥存放在离线环境或 HSM 中，仅在需要签名时导入临时签名。
-
采用冷钱包（离线签名）+ 热钱包（少量流动资金）分离策略。
并发与幂等
-
归集与转账任务必须保证幂等性（避免重复划转）。
-
使用队列 + 分布式锁控制并发。
合约与 TRC20 注意事项
-
TRC20 代币转账为合约调用（触发合约 transfer），请确保 gas/带宽/能量配置与调用方式正确。
-
对不同 TRC20 合约做兼容测试，注意小数位与代币精度。
权限与安全建议（上线前必做）
-
修改并强固 FastAdmin 管理员密码与 salt；
-
关闭非必要的管理 URL；
-
为关键操作添加二次校验（短信/邮件/谷歌验证）——虽然你提到去除短信注册，但对敏感操作应有额外验证；
-
日志与审计：记录所有转账请求、签名事件与队列执行记录；
-
灰度发布：先在测试网或小额度热钱包做充分测试再切换主网。
警告与法律合规声明
重要提醒： 本源码仅供 开发学习、技术研究与功能验证。
-
严禁将示例代码直接用于未经许可的商业化支付服务或任何违法活动。
-
区块链金融涉及资金与合规风险，上线前请咨询合规/法律顾问并完成必要资质与风控流程。
-
对因使用源码导致的任何法律、经济或安全后果，使用者自行承担全部责任。
