bepusdt 0.2.0__tar.gz

bepusdt-0.2.0/.gitignore

@@ -0,0 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Version file
+bepusdt/_version.py
+
+# Internal docs (not for public)
+IMPORTANT_NOTES.md
+CONTRIBUTING.md
+Makefile
+.github/

bepusdt-0.2.0/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2024-12-23
+
+### Added
+- 新增 `query_order()` 方法，支持查询订单状态
+- 新增查询订单示例代码 `examples/query_order_example.py`
+- 新增 `_get()` 内部方法支持 GET 请求
+
+### Changed
+- 更新 README 文档，添加查询订单使用说明
+
+## [0.1.0] - 2024-12-23
+
+### Added
+- 初始版本发布
+- 支持创建支付订单（USDT/TRX/USDC）
+- 支持 10+ 区块链网络
+- 自动签名验证
+- 完整的类型提示
+- 订单取消功能
+- 回调签名验证
+- 自定义汇率支持
+- Flask 和 FastAPI 集成示例
+
+### Fixed
+- 修复 redirect_url 必需参数问题
+- 修复 amount 参数类型导致的签名错误
+- 优化签名算法，正确处理空值
+
+[0.2.0]: https://github.com/luoyanglang/bepusdt-python-sdk/releases/tag/v0.2.0
+[0.1.0]: https://github.com/luoyanglang/bepusdt-python-sdk/releases/tag/v0.1.0

bepusdt-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BEpusdt Python SDK Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bepusdt-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include bepusdt *.py
+prune tests
+prune examples

bepusdt-0.2.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: bepusdt
+Version: 0.2.0
+Summary: BEpusdt 支付网关 Python SDK - 支持 USDT/TRX/USDC 多链支付
+Home-page: https://github.com/luoyanglang/bepusdt-python-sdk
+Author: luoyanglang
+Author-email: luoyanglang <luoyanglang@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/luoyanglang/bepusdt-python-sdk
+Project-URL: Documentation, https://github.com/luoyanglang/bepusdt-python-sdk#readme
+Project-URL: Repository, https://github.com/luoyanglang/bepusdt-python-sdk
+Project-URL: Issues, https://github.com/luoyanglang/bepusdt-python-sdk/issues
+Keywords: bepusdt,payment,usdt,trx,cryptocurrency,blockchain
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+**❗️声明：本 SDK 为 BEpusdt 支付网关的非官方 Python 客户端库，仅供学习研究使用。使用本项目请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。**
+
+---
+
+# BEpusdt Python SDK
+
+<p align="center">
+<a href="https://pypi.org/project/bepusdt/"><img src="https://badge.fury.io/py/bepusdt.svg" alt="PyPI version"></a>
+<a href="https://pypi.org/project/bepusdt/"><img src="https://img.shields.io/pypi/pyversions/bepusdt.svg" alt="Python Support"></a>
+<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+<a href="https://github.com/v03413/bepusdt"><img src="https://img.shields.io/badge/BEpusdt-v1.22+-blue" alt="BEpusdt"></a>
+</p>
+
+## 🪧 介绍
+
+BEpusdt 支付网关的 Python SDK，让 Python 开发者能够快速集成 USDT/TRX/USDC 加密货币支付功能。
+
+## ✨ 特性
+
+- 🎯 **简单易用** - 几行代码即可集成
+- 🔐 **自动签名** - 内置签名生成和验证
+- 🌐 **多链支持** - 支持 10+ 区块链网络
+- 💰 **多币种** - USDT、USDC、TRX
+- 📝 **类型提示** - 完整的 IDE 智能提示
+- ✅ **生产就绪** - 经过真实环境测试
+- 🔄 **完全兼容** - 完整支持 BEpusdt API
+
+## 🌟 支持的网络
+
+### USDT
+🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon  
+⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Plasma
+
+### USDC  
+🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon  
+⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Base
+
+### 其他
+💎 TRX (Tron)
+
+## 📦 安装
+
+```bash
+pip install bepusdt
+```
+
+## 🚀 快速开始
+
+```python
+from bepusdt import BEpusdtClient, TradeType
+
+# 初始化客户端
+client = BEpusdtClient(
+    api_url="https://your-bepusdt-server.com",
+    api_token="your-api-token"
+)
+
+# 创建订单
+order = client.create_order(
+    order_id="ORDER_001",
+    amount=10.0,
+    notify_url="https://your-domain.com/notify",
+    trade_type=TradeType.USDT_TRC20
+)
+
+print(f"💰 支付金额: {order.actual_amount} USDT")
+print(f"📍 收款地址: {order.token}")
+print(f"🔗 支付链接: {order.payment_url}")
+```
+
+## 📖 文档
+
+- 📚 [完整文档](./docs/README.md)
+- 📖 [API 参考](./docs/api.md)
+- 💡 [使用示例](./docs/examples.md)
+- ❓ [常见问题](./docs/faq.md)
+
+## 🔧 核心功能
+
+### 创建订单
+
+```python
+order = client.create_order(
+    order_id="ORDER_001",
+    amount=10.0,
+    notify_url="https://your-domain.com/notify",
+    redirect_url="https://your-domain.com/success",
+    trade_type=TradeType.USDT_TRC20
+)
+```
+
+### 查询订单
+
+```python
+order = client.query_order(trade_id="xxx")
+if order.status == OrderStatus.SUCCESS:
+    print("✅ 支付成功")
+```
+
+### 验证回调
+
+```python
+@app.route('/notify', methods=['POST'])
+def notify():
+    data = request.get_json()
+    if client.verify_callback(data):
+        # 处理支付成功
+        return "ok", 200
+    return "fail", 400
+```
+
+## 🏝️ 交流反馈
+
+- 💬 Telegram: [@luoyanglang](https://t.me/luoyanglang)
+- 📝 [提交 Issue](https://github.com/luoyanglang/bepusdt-python-sdk/issues)
+- 🔗 [BEpusdt 官方群组](https://t.me/BEpusdtChat)
+
+## 🙏 感谢
+
+- [BEpusdt](https://github.com/v03413/bepusdt) - 优秀的 USDT 支付网关
+- [Epusdt](https://github.com/assimon/epusdt) - BEpusdt 的前身
+
+## 🔗 相关链接
+
+- 🏠 [BEpusdt 官方](https://github.com/v03413/bepusdt)
+- 📦 [PyPI 页面](https://pypi.org/project/bepusdt/)
+- 💻 [GitHub 仓库](https://github.com/luoyanglang/bepusdt-python-sdk)
+- 📋 [更新日志](./CHANGELOG.md)
+
+## 📄 许可证
+
+[MIT License](LICENSE)
+
+## 📢 声明
+
+本项目仅供学习研究使用，使用过程中请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。
+
+---
+
+Made with ❤️ for BEpusdt community

bepusdt-0.2.0/README.md

@@ -0,0 +1,140 @@
+**❗️声明：本 SDK 为 BEpusdt 支付网关的非官方 Python 客户端库，仅供学习研究使用。使用本项目请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。**
+
+---
+
+# BEpusdt Python SDK
+
+<p align="center">
+<a href="https://pypi.org/project/bepusdt/"><img src="https://badge.fury.io/py/bepusdt.svg" alt="PyPI version"></a>
+<a href="https://pypi.org/project/bepusdt/"><img src="https://img.shields.io/pypi/pyversions/bepusdt.svg" alt="Python Support"></a>
+<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+<a href="https://github.com/v03413/bepusdt"><img src="https://img.shields.io/badge/BEpusdt-v1.22+-blue" alt="BEpusdt"></a>
+</p>
+
+## 🪧 介绍
+
+BEpusdt 支付网关的 Python SDK，让 Python 开发者能够快速集成 USDT/TRX/USDC 加密货币支付功能。
+
+## ✨ 特性
+
+- 🎯 **简单易用** - 几行代码即可集成
+- 🔐 **自动签名** - 内置签名生成和验证
+- 🌐 **多链支持** - 支持 10+ 区块链网络
+- 💰 **多币种** - USDT、USDC、TRX
+- 📝 **类型提示** - 完整的 IDE 智能提示
+- ✅ **生产就绪** - 经过真实环境测试
+- 🔄 **完全兼容** - 完整支持 BEpusdt API
+
+## 🌟 支持的网络
+
+### USDT
+🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon  
+⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Plasma
+
+### USDC  
+🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon  
+⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Base
+
+### 其他
+💎 TRX (Tron)
+
+## 📦 安装
+
+```bash
+pip install bepusdt
+```
+
+## 🚀 快速开始
+
+```python
+from bepusdt import BEpusdtClient, TradeType
+
+# 初始化客户端
+client = BEpusdtClient(
+    api_url="https://your-bepusdt-server.com",
+    api_token="your-api-token"
+)
+
+# 创建订单
+order = client.create_order(
+    order_id="ORDER_001",
+    amount=10.0,
+    notify_url="https://your-domain.com/notify",
+    trade_type=TradeType.USDT_TRC20
+)
+
+print(f"💰 支付金额: {order.actual_amount} USDT")
+print(f"📍 收款地址: {order.token}")
+print(f"🔗 支付链接: {order.payment_url}")
+```
+
+## 📖 文档
+
+- 📚 [完整文档](./docs/README.md)
+- 📖 [API 参考](./docs/api.md)
+- 💡 [使用示例](./docs/examples.md)
+- ❓ [常见问题](./docs/faq.md)
+
+## 🔧 核心功能
+
+### 创建订单
+
+```python
+order = client.create_order(
+    order_id="ORDER_001",
+    amount=10.0,
+    notify_url="https://your-domain.com/notify",
+    redirect_url="https://your-domain.com/success",
+    trade_type=TradeType.USDT_TRC20
+)
+```
+
+### 查询订单
+
+```python
+order = client.query_order(trade_id="xxx")
+if order.status == OrderStatus.SUCCESS:
+    print("✅ 支付成功")
+```
+
+### 验证回调
+
+```python
+@app.route('/notify', methods=['POST'])
+def notify():
+    data = request.get_json()
+    if client.verify_callback(data):
+        # 处理支付成功
+        return "ok", 200
+    return "fail", 400
+```
+
+## 🏝️ 交流反馈
+
+- 💬 Telegram: [@luoyanglang](https://t.me/luoyanglang)
+- 📝 [提交 Issue](https://github.com/luoyanglang/bepusdt-python-sdk/issues)
+- 🔗 [BEpusdt 官方群组](https://t.me/BEpusdtChat)
+
+## 🙏 感谢
+
+- [BEpusdt](https://github.com/v03413/bepusdt) - 优秀的 USDT 支付网关
+- [Epusdt](https://github.com/assimon/epusdt) - BEpusdt 的前身
+
+## 🔗 相关链接
+
+- 🏠 [BEpusdt 官方](https://github.com/v03413/bepusdt)
+- 📦 [PyPI 页面](https://pypi.org/project/bepusdt/)
+- 💻 [GitHub 仓库](https://github.com/luoyanglang/bepusdt-python-sdk)
+- 📋 [更新日志](./CHANGELOG.md)
+
+## 📄 许可证
+
+[MIT License](LICENSE)
+
+## 📢 声明
+
+本项目仅供学习研究使用，使用过程中请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。
+
+---
+
+Made with ❤️ for BEpusdt community

bepusdt-0.2.0/bepusdt/__init__.py

@@ -0,0 +1,8 @@
+"""BEpusdt Python SDK - USDT/TRX/USDC 支付网关客户端"""
+
+from .client import BEpusdtClient
+from .exceptions import BEpusdtError, SignatureError, APIError
+from .models import Order, OrderStatus, TradeType
+
+__version__ = "0.2.0"
+__all__ = ["BEpusdtClient", "BEpusdtError", "SignatureError", "APIError", "Order", "OrderStatus", "TradeType"]