AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

该项目提供了一个完整的功能参考实现，涵盖 HD 钱包地址派生、链上日志扫描、多网络支持、自动归集任务和 OpenAPI 接口，对学习区块链支付和 Webman 开发极具参考价值。

适合谁使用

学习 Webman 框架的 PHP 开发者
探索 EVM 稳定币支付的区块链开发者
评估加密货币收款解决方案的企业/商户
研究 HD 钱包和 ERC20 集成的学生

典型使用场景

在多条 EVM 链上演示 USDC/USDT 收款流程
学习实现 HD 钱包地址派生和链上监听
集成 OpenAPI 或易支付兼容网关进行加密货币结算
测试自动归集和 Gas 管理机制

项目优势

支持以太坊、Base、Celo、Polygon 四条 EVM 网络
使用随机字节加密敏感数据（助记词、API Secret）
提供管理后台和公共支付页面，含二维码展示
基于高性能 PHP 框架 Webman，支持 Swoole 协程

使用前须知

仅支持 EVM 网络，不包含 Tron、Solana 等非 EVM 链
明确声明为学习/演示用途，未经安全审计不适合生产
需要手动配置 RPC 节点和环境密钥（WALLET_ENCRYPTION_KEY）

README 快速开始

⚠️ 重要声明 / Disclaimer

本项目仅用于开发者学习区块链、HD 钱包、EVM 稳定币收款与 Webman 项目开发实践。
本开源项目不构成任何投资建议、支付牌照建议、金融业务建议或生产环境安全承诺。使用者基于本项目进行部署、改造、二次开发、收款、转账、归集、对接第三方系统等任何行为，均由使用者自行承担全部责任，与本项目作者、维护者及贡献者无关。请勿将本项目用于任何违法违规用途。涉及真实资产前，请务必完成代码审计、安全加固、权限隔离、私钥管理、风控合规与小额充分测试。

💎 HDupay

HDupay 是一个基于 Webman + Vue3 + Naive UI 的开源加密货币稳定币收款平台示例项目，核心目标是演示：

🧠 基于助记词的 HD 钱包体系
🔗 EVM 多网络收款地址派生
💵 USDC / USDT 稳定币订单收款
📡 RPC 扫块监听与确认进度
🧾 OpenAPI / 易支付兼容接口
🏦 归集钱包、Gas 钱包与自动归集任务
🎛️ 后台管理端的完整业务闭环

✨ 项目亮点 🌍 支持网络 💵 支持货币 🧱 技术栈 🧩 系统模块 🖥️ 运行环境 🚀 快速安装

🔗 访问入口 📡 RPC 与代理 🔌 OpenAPI 🧩 易支付 🔗 New-Api 接入 🏦 安全建议 📁 项目结构 🛠️ 常见问题

✨ 项目亮点

模块	能力
🔐 HD 钱包	支持助记词初始化根钱包、网络账户派生、收款子地址派生
🌐 多网络	当前支持 Ethereum、Base、Celo、Polygon 四条 EVM 主网
💰 稳定币	当前支持 USDC、USDT
📦 地址池	用户下单后动态分配一次性收款地址，超时冻结
📡 链上监听	通过 EVM RPC `eth_getLogs` 扫描 ERC20 Transfer 日志
✅ 区块确认	按网络配置确认块数，前端显示确认进度
🏦 自动归集	支持归集任务、Gas 补充、归集失败原因与重试次数
🔌 OpenAPI	提供 API Key / API Secret 鉴权的开放接口
🧩 易支付兼容	提供 `/submit.php` 兼容易支付协议风格的跳转入口
🧭 RPC 管理	支持 Infura、Dwellir、OnFinality，支持分组、轮询与重试
🧦 代理池	支持 HTTP / HTTPS / SOCKS5 代理，并可强制绑定 RPC 请求
📈 汇率同步	通过 CoinGecko 同步 USDC / USDT 对多法币价格
🎨 后台 UI	Vue3 + Naive UI，提供管理后台、支付页、二维码展示

🌍 支持网络

网络	Chain ID	Gas 原生币	当前状态	支持稳定币
🔷 Ethereum Mainnet	`1`	ETH	✅ 已支持	🔵 USDC / 🟢 USDT
🔵 Base Mainnet	`8453`	ETH	✅ 已支持	🔵 USDC / 🟢 USDT
🟡 Celo Mainnet	`42220`	CELO	✅ 已支持	🔵 USDC / 🟢 USDT
🟣 Polygon PoS Mainnet	`137`	POL	✅ 已支持	🔵 USDC / 🟢 USDT

当前项目主要面向 EVM 网络。如果需要接入 Tron、Solana 等非 EVM 网络，需要额外实现地址派生、签名、扫描与归集逻辑。

💵 支持货币

加密货币

代币	名称	说明
🔵 USDC	USD Coin	当前默认稳定币之一
🟢 USDT	Tether USD	当前默认稳定币之一

法币汇率

当前汇率模块支持常见法币，例如：

CNY、USD、EUR、CAD、AUD、JPY、HKD、GBP、SGD

下单时系统会根据后台同步的稳定币价格计算应付稳定币数量，并按稳定币最小颗粒度向上取整。

🧱 技术栈

后端

技术	用途
🐘 PHP 8.4+	运行环境
⚡ Webman 2.x	HTTP 框架
🚀 Workerman 5.x	常驻进程与高性能网络服务
🌀 Swoole Event Loop	协程事件循环支持
🗄️ webman/database	MySQL 数据访问
📡 Hyperf Guzzle	协程友好的 HTTP 客户端
🔐 BitWasp Bitcoin	BIP39 / BIP32 相关能力
🧮 web3p/ethereum-*	EVM 地址、签名、交易相关能力
🧂 Sodium	敏感信息加密

前端

技术	用途
�

项目描述

HD自托管USDT/USDC收款系统，兼容epay易支付接口

HDupay