diff --git a/README.md b/README.md index 8a46abd..6146ae2 100644 --- a/README.md +++ b/README.md @@ -1,73 +1,146 @@ -## Epusdt (Easy Payment Usdt) +# Epusdt — Easy Payment USDT +

- + Epusdt Logo - USDT Payment Gateway for Crypto Payments

+

-license GPLV3 -Go version 1.16 -Echo Framework v4 -Telebot Framework-v3 -version v0.0.1 + 开源 USDT 支付网关 · Crypto 支付工具实际采用率 Top 1

- - -## 项目简介 -`Epusdt`（全称：Easy Payment Usdt）是一个由`Go语言`编写的私有化部署`Usdt`支付中间件(`Trc20网络`) -站长或开发者可通过`Epusdt`提供的`http api`集成至您的任何系统，无需过多的配置，仅仅依赖`mysql`和`redis` -可实现USDT的在线支付和消息回调，这一切在优雅和顷刻间完成！🎉 -私有化搭建使得无需额外的手续费和签约费用，Usdt代币直接进入您的钱包💰 -`Epusdt` 遵守 [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) 开源协议! - -## 项目特点 -- 支持私有化部署，无需担心钱包被篡改和吞单😁 -- `Go语言`跨平台实现，支持x86和arm芯片架构的win/linux设备 -- 多钱包地址轮询，提高订单并发率 -- 异步队列响应，优雅及高性能 -- 无需额外环境配置，仅运行一个编译后二进制文件即可使用 -- 支持`http api`，其他系统亦可接入 -- `Telegram`机器人接入，便捷使用和支付消息快速通知 - -## 项目结构 + +

+ Official Docs + Telegram Channel + Telegram Group +

+ +

+ GitHub Stars 3000+ + GPLv3 License + Go 1.16+ + Latest Release +

+ +--- + +## 🌍 What is Epusdt? + +**Epusdt** (Easy Payment USDT) is a self-hosted **USDT payment gateway** built with Go, enabling any website or application to accept **crypto payments** via the **TRC20 network**. No third-party fees, no custodial risk — USDT goes directly into your wallet. + +> **GitHub Star 3000+** · **已支持站点解决方案 10+** · **Crypto 支付工具实际采用率 Top 1** + +Deploy it privately, integrate via HTTP API, and start receiving **USDT payments** in minutes. That's it. 🎉 + +--- + +## 🔌 广泛兼容，即插即用 + +无论你运营的是哪类系统，Epusdt 均可基于现有接口方案，**无需重构业务逻辑**，快速接入，立即获得 Crypto 收款能力，低成本扩展全球支付场景： + +| 领域 | 已支持系统 | +|------|-----------| +| **AI 分发** | OneAPI、NewAPI | +| **发卡系统** | 独角数卡（Dujiaoka）、异次元发卡 | +| **代理面板** | V2Board、XBoard、SSPanel | +| **建站生态** | WordPress、WHMCS | +| **更多** | 任何支持 HTTP Callback 的系统均可接入 | + +👉 查看完整集成列表与插件：[plugins/](plugins/) + +--- + +## ✨ 核心特性 + +- **私有化部署** — 无需担心钱包被篡改、吞单，资金完全自主掌控 +- **零依赖运行** — 单个二进制文件即可启动，仅需 MySQL + Redis +- **跨平台** — 支持 x86 / ARM 架构的 Windows / Linux 设备 +- **多钱包轮询** — 自动轮换收款地址，提高订单并发处理能力 +- **异步队列** — 高性能消息回调，优雅处理高并发场景 +- **HTTP API** — 标准化接口，任何语言 / 框架均可快速集成 +- **Telegram Bot** — 实时支付通知，便捷管理与监控 + +--- + +## 📖 文档与教程 + +完整文档请访问 👉 **[epusdt.com](https://epusdt.com)** + +快速入门： + +| 教程 | 说明 | +|------|------| +| [Docker 部署](wiki/docker-RUN.md) | 推荐方式，一键启动 | +| [宝塔面板部署](wiki/BT_RUN.md) | 适合宝塔用户 | +| [手动部署](wiki/manual_RUN.md) | 完全手动控制 | +| [开发者 API 文档](wiki/API.md) | 接口集成指南 | +| [自定义汇率接口](wiki/LEGACY_API_MIGRATION.md) | API 进阶用法 | +| [PHP 极速接入](https://github.com/BlueSkyXN/PHPAPI-for-epusdt) | HTML + PHP 快速集成 | + +--- + +## 🏗️ 项目结构 + ``` Epusdt - ├── plugins ---> (已集成的插件库，例如dujiaoka) - ├── src ---> (项目核心目录） - ├── sdk ---> (接入SDK) - ├── sql ---> (安装sql文件或更新sql文件) - └── wiki ---> (知识库) +├── plugins/ → 已集成的系统插件（独角数卡等） +├── src/ → 项目核心代码 +├── sdk/ → 接入 SDK +├── sql/ → 数据库安装 / 升级脚本 +└── wiki/ → 文档与知识库 ``` - -## 教程： -- docker 运行教程 [docker-RUN](wiki/docker-RUN.md) -- API 文档( 自定义汇率接口 ) [API](wiki/LEGACY_API_MIGRATION.md) -- 宝塔运行`epusdt`教程👉🏻[宝塔运行epusdt](wiki/BT_RUN.md) -- 不好意思我有洁癖，手动运行`epusdt`教程👉🏻[手动运行epusdt](wiki/manual_RUN.md) -- 开发者接入`epusdt`文档👉🏻[开发者接入epusdt](wiki/API.md) -- HTML+PHP极速运行`epusdt`教程👉🏻[使用PHPAPI-for-epusdt极速接入epusdt](https://github.com/BlueSkyXN/PHPAPI-for-epusdt) - -## 已适配系统插件 -- 独角数卡[插件地址](plugins/dujiaoka) - -## 加入交流/意见反馈 -- `Epusdt`频道[https://t.me/epusdt](https://t.me/epusdt) -- `Epusdt`交流群组[https://t.me/epusdt_group](https://t.me/epusdt_group) - -## 设计实现 -`Epusdt`的实现方式与其他项目原理类似，都是通过监听`trc20`网络的api或节点， -监听钱包地址`usdt`代币入账事件，通过`金额差异`和`时效性`来判定交易归属信息， -可参考下方`流程图` + +--- + +## 🔧 实现原理 + +Epusdt 通过监听 TRC20 网络 API，实时捕获钱包地址的 USDT 入账事件，利用**金额差异**与**时效性**精确匹配交易归属： + ``` -简单的原理： -1.客户需要支付20.05usdt -2.服务器有一个hash表存储钱包地址对应的待支付金额 例如:address_1 : 20.05 -3.发起支付的时候，我们可以判定钱包address_1的20.05金额是否被占用，如果没有被占用那么可以直接返回这个钱包地址和金额给客户，告知客户需按规定金额20.05准确支付，少一分都不行。且将钱包地址和金额 address_1:20.05锁起来，有效期10分钟。 -4.如果订单并发下，又有一个20.05元需要支付，但是在第3步的时候上一个客户已经锁定了该金额，还在等待支付中...，那么我们将待支付金额加上0.0001，再次尝试判断address_1:20.0501金额是否被占用？如果没有则重复第三步，如果还是被占用就继续累加尝试，直到加了100次后都失败 -5.新开一个线程去监听所有钱包的USDT入账事件，网上有公开的api或rpc节点。如果发现有入账金额与待支付的金额相等。则判断该笔订单支付成功！ +工作流程： +1. 客户发起支付，需支付 20.05 USDT +2. 系统在哈希表中查找可用的 钱包地址 + 金额 组合 +3. 若 address_1:20.05 未被占用 → 锁定该组合（有效期 10 分钟），返回给客户 +4. 若已被占用 → 自动累加 0.0001 尝试下一个金额组合（最多 100 次） +5. 后台线程持续监听所有钱包的入账事件，金额匹配则确认支付成功 ``` -### 流程图： -![Implementation principle](wiki/img/implementation_principle.jpg) - - -## 声明 -本项目仅供学习与技术交流使用，用户在使用过程中需自行遵守所在地法律法规。由于涉及加密资产及资金安全，用户应自行审查相关代码与风险。加密资产属于高风险新兴资产（包括稳定币），其价值可能波动甚至归零，GMwallet不对任何资产或使用结果作出保证。本内容不构成任何投资、税务、法律或金融建议，仅供教育用途，相关决策请咨询专业人士。 - + +![Epusdt 支付流程图](wiki/img/implementation_principle.jpg) + +--- + +## 💬 社区与支持 + +**遇到问题？** 请优先在 GitHub 提交 [Issue](https://github.com/assimon/epusdt/issues)，我们会**优先处理** Issue 中的反馈。 + +加入 Telegram 社区，获取最新动态、交流使用经验： + +| 渠道 | 链接 | +|------|------| +| 📢 **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) | + +--- + +## 📜 开源协议 + +Epusdt 遵守 [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) 开源协议。 + +--- + +## ⚠️ 免责声明 + +本项目仅供学习与技术交流使用，用户在使用过程中需自行遵守所在地法律法规。由于涉及加密资产及资金安全，用户应自行审查相关代码与风险。加密资产属于高风险新兴资产（包括稳定币），其价值可能波动甚至归零，GMwallet 不对任何资产或使用结果作出保证。本内容不构成任何投资、税务、法律或金融建议，仅供教育用途，相关决策请咨询专业人士。 + +--- + +

+ + Keywords: USDT Payment Gateway · Crypto Payment · TRC20 Payment · Self-hosted USDT · + OneAPI Payment · NewAPI Payment · 独角数卡支付 · 异次元发卡支付方式 · + V2Board Payment · XBoard Payment · SSPanel 支付接口 · + WordPress Crypto Payment · WHMCS USDT Payment · + Epusdt · Easy Payment USDT · Open Source Payment Gateway + +

+