Why it is worth attention

It provides a complete, functional reference implementation of an HD wallet-based stablecoin payment system with address derivation, on-chain monitoring, automatic collection, and multiple EVM chain support, all in a single PHP project.

Who it is for

PHP developers learning Webman framework
Blockchain developers exploring EVM payments
Businesses evaluating crypto payment solutions
Students studying HD wallets and ERC20 integration

Use cases

Run a demo for accepting USDC/USDT payments on multiple EVM chains
Learn how to implement HD wallet address derivation and monitoring
Integrate an OpenAPI or compatible EasyPay gateway for crypto checkout
Test automatic token collection and gas management processes

Strengths

Supports 4 EVM networks: Ethereum, Base, Celo, Polygon
Uses random_bytes-based encryption for sensitive data (mnemonics, secrets)
Provides both an admin dashboard and a public payment page with QR code
Built on high-performance PHP framework Webman with Swoole coroutine support

Considerations

Limited to EVM networks only; non-EVM like Tron/Solana not supported
Explicitly intended for learning/demo, not production-ready without security audit
Requires manual setup of RPC endpoints and environment key (WALLET_ENCRYPTION_KEY)

README quick start

⚠️ 重要声明 / 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	敏感信息加密

前端

技术	用途
�

Description

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

Related repositories

Similar projects matched by category, topics, and programming language.

Wren-CMS

wren-cms

Wren CMS is a minimal, single-file content management system using PHP and SQLite that lets you create a whole website with no dependencies, no build step, and a one-minute setup.

PHP

islam-re

Algeria-wilayas

A dataset of all 69 Algerian wilayas (provinces) following the 2026 administrative reform, provided in multiple data formats.

Data & DatabasesDatabases & Storage

ideaseek-zh

trading-studio

An event-driven research and analysis platform for Chinese A-share stock traders, integrating real market data, news, announcements, and AI-powered analysis without simulated data or automated trading.

PHP