diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..715e25b --- /dev/null +++ b/README.en.md @@ -0,0 +1,181 @@ +# Epusdt — Easy Payment USDT + +
+
+
+ Open-source multi-chain crypto payment gateway · Top real-world adoption +
+ + + + + + + +--- + +## What is Epusdt? + +**Epusdt** (Easy Payment USDT) is a self-hosted **multi-chain, multi-token crypto payment gateway** built with Go. It started as a TRC20-only solution and evolved into a broader **multi-chain receiving platform**, allowing websites and applications to accept crypto payments across multiple networks and token types. No third-party custody, no platform fees — funds go directly into your wallet. + +> **GitHub Star 3000+** · **10+ supported platform integrations** · **Top real-world adoption among crypto payment tools** + +Deploy it privately, integrate with the HTTP API, and start receiving crypto payments in minutes. + +### Supported Networks and Tokens + +| Network | Tokens | +|---------|--------| +| **TRC20** (Tron) | USDT, TRX | +| **ERC20** (Ethereum) | USDT, USDC, ETH | +| **Solana** | USDT, USDC | +| **BEP20** (BSC) | USDT, USDC, BNB | +| **Polygon** | USDT, USDC | +| **More** | Expanding continuously | + +> Actual support depends on the [latest release](https://github.com/GMWalletApp/epusdt/releases) and the [official docs](https://epusdt.com). + +--- + +## Broad Compatibility, Plug and Play + +No matter what kind of platform you operate, Epusdt can fit into existing payment integration patterns with **minimal or no business logic refactor**, giving you a fast path to crypto payments for global use cases: + +| Category | Supported Systems | +|----------|-------------------| +| **AI Distribution** | [OneAPI](https://github.com/songquanpeng/one-api), [NewAPI](https://github.com/QuantumNous/new-api) | +| **Card/Voucher Platforms** | [Dujiaoka](https://dujiao-next.com/), [ACG Faka](https://github.com/lizhipay/acg-faka) | +| **Proxy Panels** | [V2Board](https://github.com/v2board/v2board), [XBoard](https://github.com/cedar2025/Xboard), [xiaoV2board](https://github.com/wyx2685/v2board/), [SSPanel](https://github.com/anankke/sspanel-uim) | +| **Website Ecosystem** | [WordPress](https://wordpress.com/), [WHMCS](https://www.whmcs.com/) | +| **Epay-Compatible Flow** | Works with platforms already using Epay-style payment interfaces | +| **More** | Simple HTTP API, often integrated within 10 minutes | + +See more integrations and plugins here: [plugins/](./plugins/) + +--- + +## Core Features + +- **Multi-chain and multi-token** — TRC20, ERC20, BEP20, Polygon, and more +- **Self-hosted** — full control of funds and wallet infrastructure +- **Low-dependency runtime** — a single binary can run the service; low-traffic setups do not require MySQL + Redis +- **Cross-platform** — supports x86 / ARM on Windows / Linux / Mac +- **Multi-wallet rotation** — rotates receiving addresses to improve concurrency handling +- **Async callback queue** — handles merchant notifications efficiently +- **HTTP API** — easy integration from any language or framework +- **Telegram Bot** — instant payment notifications and lightweight operations + +--- + +## Documentation and Guides + +Full documentation: **[epusdt.com](https://epusdt.com)** + +Quick-start links: + +| Guide | Description | +|-------|-------------| +| [Docker Deployment](https://epusdt.com/guide/installation/docker) | Recommended one-command setup | +| [aaPanel Deployment](https://epusdt.com/guide/installation/aapanel) | Great for aaPanel users | +| [Manual Deployment](https://epusdt.com/guide/installation/manual.html) | Full manual control | +| [Developer API Docs](https://epusdt.com) | Integration reference | + +--- + +## Project Structure + +```text +Epusdt +├── plugins/ Integrated plugins and platform adapters +├── src/ Core project source code +├── sdk/ Integration SDKs +├── sql/ Database install / upgrade scripts +└── wiki/ Documentation assets and knowledge base +``` + +--- + +## How It Works + +Epusdt listens to supported blockchain APIs or RPC nodes across multiple networks such as TRC20, ERC20, BEP20, and Polygon. It captures incoming token transfers in real time and matches ownership using **amount differentiation** and **time-bounded locks**: + +```text +Workflow: +1. A customer initiates payment and needs to send 20.05 USDT +2. The system searches for an available wallet-address + amount combination +3. If address_1:20.05 is free -> lock it for 10 minutes and return it +4. If already occupied -> add 0.0001 and try the next amount combination +5. Background listeners keep watching wallet deposits and mark the order paid once the amount matches +``` + + + +--- + +## Community and Support + +If you hit an issue, please open a [GitHub Issue](https://github.com/GMWalletApp/epusdt/issues) first. That is the best way to get attention and help. + +| Channel | Link | +|---------|------| +| Telegram Channel | [https://t.me/epusdt](https://t.me/epusdt) | +| Telegram Group | [https://t.me/epusdt_group](https://t.me/epusdt_group) | +| Official Docs | [https://epusdt.com](https://epusdt.com) | + +--- + +## Star History + + ++ + Keywords: USDT Payment Gateway · Crypto Payment · Multi-chain Payment · TRC20 Payment · ERC20 Payment · BEP20 Payment · + Self-hosted Crypto Gateway · OneAPI Payment · NewAPI Payment · Dujiaoka Payment · ACG Faka Payment · + V2Board Payment · XBoard Payment · SSPanel Payment Interface · + WordPress Crypto Payment · WHMCS USDT Payment · Polygon USDT · + Epusdt · Easy Payment USDT · Open Source Payment Gateway · Multi-chain Collection + +
diff --git a/README.md b/README.md index 50a0405..a718a4a 100644 --- a/README.md +++ b/README.md @@ -1,177 +1,29 @@ -# Epusdt — Easy Payment USDT +# Epusdt
- 开源多链多币种 Crypto 支付网关 · 实际采用率 Top 1 + Open-source multi-chain crypto payment gateway
- - --- -## 🌍 What is Epusdt? +Choose your preferred language: -**Epusdt** (Easy Payment USDT) is a self-hosted **multi-chain, multi-token crypto payment gateway** built with Go. It has evolved from a TRC20-only solution into a comprehensive **multi-chain receiving platform**, enabling any website or application to accept crypto payments across multiple blockchain networks and token types. No third-party fees, no custodial risk — funds go directly into your wallet. +- [English Documentation](./README.en.md) +- [简体中文文档](./README.zh-CN.md) -> **⭐ GitHub Star 3000+** · **🔌 已支持站点解决方案 10+** · **🏆 Crypto 支付工具实际采用率 Top 1** +Quick links: -Deploy it privately, integrate via HTTP API, and start receiving **crypto payments** in minutes. That's it. 🎉 +- [Official Docs](https://epusdt.com) +- [Telegram Channel](https://t.me/epusdt) +- [Telegram Group](https://t.me/epusdt_group) +- [Plugins](./plugins/) -### 🔗 已支持网络与代币 - -| 网络 | 代币 | -|------|------| -| **TRC20** (Tron) | USDT、TRX| -| **ERC20** (Ethereum) | USDT、USDC、ETH | -| **Solana** | USDT、USDC | -| **BEP20** (BSC) | USDT、USDC、BNB | -| **Polygon** | USDT、USDC | -| **更多** | 持续扩展中… | - -> 💡 具体支持的链与代币以 [最新版本](https://github.com/GMWalletApp/epusdt/releases) 及 [官方文档](https://epusdt.com) 为准。 - ---- - -## 🔌 广泛兼容,即插即用 - -无论你运营的是哪类系统,Epusdt 均可基于现有接口方案,**无需重构业务逻辑**,快速接入,立即获得 Crypto 收款能力,低成本扩展全球支付场景: - -| 领域 | 已支持系统 | -|------|-----------| -| **AI 分发** | [OneAPI](https://github.com/songquanpeng/one-api)、[NewAPI](https://github.com/QuantumNous/new-api) | -| **发卡系统** | [独角数卡(Dujiaoka)](https://dujiao-next.com/)、[异次元发卡](https://github.com/lizhipay/acg-faka) | -| **代理面板** | [V2Board](https://github.com/v2board/v2board)、[XBoard](https://github.com/cedar2025/Xboard)、[xiaoV2board](https://github.com/wyx2685/v2board/)、[SSPanel](https://github.com/anankke/sspanel-uim) | -| **建站生态** | [WordPress](https://wordpress.com/)、[WHMCS](https://www.whmcs.com/) | -| **Epay兼容** | 兼容各类支持Epay易支付接口的平台 | -| **更多** | 简易HTTP API 10分钟内接入 | - -👉 查看更多集成列表与插件:[plugins/](plugins/) - ---- - -## ✨ 核心特性 - -- **多链多币种** — 支持 TRC20、ERC20、BEP20、Polygon 等主流网络,不再局限于单一链 -- **私有化部署** — 无需担心钱包被篡改、吞单,资金完全自主掌控 -- **零依赖运行** — 单个二进制文件即可启动,低并发场景无需安装 MySQL + Redis,一键部署零成本维护 -- **跨平台** — 支持 x86 / ARM 架构的 Windows / Linux / Mac 设备 -- **多钱包轮询** — 自动轮换收款地址,提高订单并发处理能力 -- **异步队列** — 高性能消息回调,优雅处理高并发场景 -- **HTTP API** — 标准化接口,任何语言 / 框架均可10min内集成 -- **Telegram Bot** — 实时支付通知,快捷管理与监控 - ---- - -## 📖 文档与教程 - -完整文档请访问 👉 **[epusdt.com](https://epusdt.com)** - -快速入门: - -| 教程 | 说明 | -|------|------| -| [Docker 部署](https://epusdt.com/guide/installation/docker) | 推荐方式,一键启动 | -| [宝塔面板部署](https://epusdt.com/guide/installation/aapanel) | 适合宝塔用户 | -| [手动部署](https://epusdt.com/guide/installation/manual.html) | 完全手动控制 | -| [开发者 API 文档](https://epusdt.com/zh/guide/integration/gmpay.html) | 接口集成指南 | - ---- - -## 🏗️ 项目结构 - -``` -Epusdt -├── plugins/ → 已集成的系统插件(独角数卡等) -├── src/ → 项目核心代码 -├── sdk/ → 接入 SDK -├── sql/ → 数据库安装 / 升级脚本 -└── wiki/ → 文档与知识库 -``` - ---- - -## 🔧 实现原理 - -Epusdt 通过监听多条区块链网络(TRC20、ERC20、BEP20、Polygon 等)的 API 或RPC节点,实时捕获钱包地址的代币入账事件,利用**金额差异**与**时效性**精确匹配交易归属: - -``` -工作流程: -1. 客户发起支付,需支付 20.05 USDT -2. 系统在哈希表中查找可用的 钱包地址 + 金额 组合 -3. 若 address_1:20.05 未被占用 → 锁定该组合(有效期 10 分钟),返回给客户 -4. 若已被占用 → 自动累加 0.0001 尝试下一个金额组合(最多 100 次) -5. 后台线程持续监听所有钱包的入账事件,金额匹配则确认支付成功 -``` - - - ---- - -## 💬 社区与支持 - -**遇到问题?** 请优先在 GitHub 提交 [Issue](https://github.com/GMWalletApp/epusdt/issues),我们会**优先处理** Issue 中的反馈。 - -加入 Telegram 社区,获取最新开发动态,参与需求调研,与超过5000名活跃用户交流使用经验,对接商业资源: - -| 渠道 | 链接 | -|------|------| -| 📢 **Epusdt 频道** | [https://t.me/epusdt](https://t.me/epusdt) | -| 💬 **Epusdt 交流群** | [https://t.me/epusdt_group](https://t.me/epusdt_group) | -| 📚 **官方文档站** | [https://epusdt.com](https://epusdt.com) | - ---- - -## Star History - - -- - Keywords: USDT Payment Gateway · Crypto Payment · Multi-chain Payment · TRC20 Payment · ERC20 Payment · BEP20 Payment · - Self-hosted Crypto Gateway · OneAPI Payment · NewAPI Payment · 独角数卡支付 · 异次元发卡支付方式 · - V2Board Payment · XBoard Payment · SSPanel 支付接口 · - WordPress Crypto Payment · WHMCS USDT Payment · Polygon USDT · - Epusdt · Easy Payment USDT · Open Source Payment Gateway · 多链收款 - -
diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..46c7c9b --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,182 @@ +# Epusdt — Easy Payment USDT + +
+
+
+ 开源多链多币种 Crypto 支付网关 · 实际采用率 Top 1 +
+ + + + + + + +--- + +## What is Epusdt? + +**Epusdt** (Easy Payment USDT) 是一个基于 Go 构建、支持私有化部署的 **多链多币种 Crypto 支付网关**。它从最初的 TRC20 单链方案逐步演进为完整的 **多链收款平台**,让任意网站或应用都能快速接入多条链、多种代币的加密支付能力。没有第三方托管,没有平台抽成,资金直接进入你的钱包。 + +> **GitHub Star 3000+** · **已支持站点解决方案 10+** · **Crypto 支付工具实际采用率 Top 1** + +私有部署,按 HTTP API 接入,几分钟内就可以开始接收 **Crypto Payments**。 + +### 已支持网络与代币 + +| 网络 | 代币 | +|------|------| +| **TRC20** (Tron) | USDT、TRX | +| **ERC20** (Ethereum) | USDT、USDC、ETH | +| **Solana** | USDT、USDC | +| **BEP20** (BSC) | USDT、USDC、BNB | +| **Polygon** | USDT、USDC | +| **更多** | 持续扩展中… | + +> 具体支持的链与代币以 [最新版本](https://github.com/GMWalletApp/epusdt/releases) 及 [官方文档](https://epusdt.com) 为准。 + +--- + +## 广泛兼容,即插即用 + +无论你运营的是哪类系统,Epusdt 均可基于现有接口方案,**无需重构业务逻辑**,快速接入,立即获得 Crypto 收款能力,低成本扩展全球支付场景: + +| 领域 | 已支持系统 | +|------|-----------| +| **AI 分发** | [OneAPI](https://github.com/songquanpeng/one-api)、[NewAPI](https://github.com/QuantumNous/new-api) | +| **发卡系统** | [独角数卡(Dujiaoka)](https://dujiao-next.com/)、[异次元发卡](https://github.com/lizhipay/acg-faka) | +| **代理面板** | [V2Board](https://github.com/v2board/v2board)、[XBoard](https://github.com/cedar2025/Xboard)、[xiaoV2board](https://github.com/wyx2685/v2board/)、[SSPanel](https://github.com/anankke/sspanel-uim) | +| **建站生态** | [WordPress](https://wordpress.com/)、[WHMCS](https://www.whmcs.com/) | +| **Epay 兼容** | 兼容各类支持 Epay 易支付接口的平台 | +| **更多** | 简易 HTTP API,10 分钟内接入 | + +查看更多集成列表与插件:[plugins/](./plugins/) + +--- + +## 核心特性 + +- **多链多币种** — 支持 TRC20、ERC20、BEP20、Polygon 等主流网络 +- **私有化部署** — 资金完全自主掌控 +- **零依赖运行** — 单个二进制即可启动,低并发场景无需 MySQL + Redis +- **跨平台** — 支持 x86 / ARM 架构的 Windows / Linux / Mac +- **多钱包轮询** — 自动轮换收款地址,提高并发处理能力 +- **异步队列** — 高性能消息回调,适配高并发场景 +- **HTTP API** — 标准化接口,任何语言 / 框架都能快速集成 +- **Telegram Bot** — 实时支付通知,快捷管理与监控 + +--- + +## 文档与教程 + +完整文档请访问:**[epusdt.com](https://epusdt.com)** + +快速入门: + +| 教程 | 说明 | +|------|------| +| [Docker 部署](https://epusdt.com/guide/installation/docker) | 推荐方式,一键启动 | +| [宝塔面板部署](https://epusdt.com/guide/installation/aapanel) | 适合宝塔用户 | +| [手动部署](https://epusdt.com/guide/installation/manual.html) | 完全手动控制 | +| [开发者 API 文档](https://epusdt.com/zh/guide/integration/gmpay.html) | 接口集成指南 | + +--- + +## 项目结构 + +```text +Epusdt +├── plugins/ 已集成的系统插件(独角数卡等) +├── src/ 项目核心代码 +├── sdk/ 接入 SDK +├── sql/ 数据库安装 / 升级脚本 +└── wiki/ 文档与知识库 +``` + +--- + +## 实现原理 + +Epusdt 通过监听多条区块链网络(TRC20、ERC20、BEP20、Polygon 等)的 API 或 RPC 节点,实时捕获钱包地址的代币入账事件,利用**金额差异**与**时效性**精确匹配交易归属: + +```text +工作流程: +1. 客户发起支付,需支付 20.05 USDT +2. 系统在哈希表中查找可用的钱包地址 + 金额组合 +3. 若 address_1:20.05 未被占用 -> 锁定该组合(有效期 10 分钟),返回给客户 +4. 若已被占用 -> 自动累加 0.0001 尝试下一个金额组合(最多 100 次) +5. 后台线程持续监听所有钱包的入账事件,金额匹配则确认支付成功 +``` + + + +--- + +## 社区与支持 + +**遇到问题?** 请优先在 GitHub 提交 [Issue](https://github.com/GMWalletApp/epusdt/issues),我们会优先处理反馈。 + +| 渠道 | 链接 | +|------|------| +| Epusdt 频道 | [https://t.me/epusdt](https://t.me/epusdt) | +| Epusdt 交流群 | [https://t.me/epusdt_group](https://t.me/epusdt_group) | +| 官方文档站 | [https://epusdt.com](https://epusdt.com) | + +--- + +## Star History + + ++ + Keywords: USDT Payment Gateway · Crypto Payment · Multi-chain Payment · TRC20 Payment · ERC20 Payment · BEP20 Payment · + Self-hosted Crypto Gateway · OneAPI Payment · NewAPI Payment · 独角数卡支付 · 异次元发卡支付方式 · + V2Board Payment · XBoard Payment · SSPanel 支付接口 · + WordPress Crypto Payment · WHMCS USDT Payment · Polygon USDT · + Epusdt · Easy Payment USDT · Open Source Payment Gateway · 多链收款 + +
+