Download the PHP package zhifu/tron-api without Composer
On this page you can find all versions of the php package zhifu/tron-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package tron-api
Zhifu Tron API
基于 iexbase/tron-api 二次开发的增强版波场（TRON）API接口库。提供更完善的功能和更稳定的表现，简化TRON区块链应用开发。
功能特性
- 完整的波场API支持 - 支持波场网络上的所有主要操作
- 增强的代币支持 - 全面支持TRC10和TRC20代币操作
- 能量和带宽管理 - 质押TRX获取能量和带宽的完整解决方案
- 高级交易功能 - 支持批量转账、能量估算等高级功能
- 钱包管理工具 - 提供完整的钱包创建、导入和验证功能
- 交易监控机制 - 实现自动充值检测和通知
- 完善的错误处理 - 提供更详细的错误信息和异常处理
- 丰富的示例代码 - 提供多种场景的实际应用示例
- 内存优化管理 - 自动清理缓存，适合高频调用和长时间运行的应用
- 底层库优化 - 自动修补底层库的内存泄漏问题
安装
底层库内存优化
从v1.0.6版本开始，我们添加了自动修补脚本来解决底层iexbase/tron-api库的内存泄漏问题：
- 安装或更新时会自动修补底层库
-
如果没有自动修补，可以手动运行修补脚本：
- 如果仍然遇到内存问题，可以尝试增加PHP内存限制：
如果遇到依赖问题，有以下几种解决方案：
GMP扩展问题
方案1：安装GMP扩展（推荐）
这是最佳方案，可以使用所有功能：
方案2：在项目中绕过GMP扩展检查
如果无法安装GMP扩展，可以在项目的composer.json中添加如下配置：
PHP版本兼容性问题
本库支持PHP 7.4及以上版本。对于底层依赖iexbase/tron-api，我们兼容3.x, 4.x和5.x版本：
- 使用PHP 7.4：会自动选择兼容的3.x或4.x版本
- 使用PHP 8.0+：会优先使用最新的5.x版本
如果安装时遇到PHP版本兼容性问题，可以尝试以下方案：
注意：方案2会影响所有依赖的安装，确保这符合您的项目需求。
要求
支持以下PHP版本：
- PHP 7.4 及以上
- 必须安装BCMath扩展（用于高精度计算）
- 使用钱包功能时需要安装GMP扩展（用于私钥生成和地址验证）
安装GMP扩展（可选，仅用于钱包功能）
如果您需要使用钱包创建、导入和验证功能，则需要安装GMP扩展：
对于Ubuntu/Debian：
对于CentOS/RHEL：
对于macOS (使用Homebrew)：
跳过GMP扩展检查（不推荐）
如果您确定不会使用钱包功能，可以在composer.json中添加以下配置来绕过GMP扩展检查：
内存优化和性能管理
本库针对高频调用和长时间运行的场景进行了内存优化，特别是TRC20合约操作。
自动缓存清理
从v1.0.5版本开始，TRC20合约转账操作会自动清理不需要的缓存数据：
禁用自动清理
在某些特殊场景下，您可能希望禁用自动清理功能：
分批处理大批量操作
对于大批量转账或查询，库已内置分批处理机制：
长时间运行的应用
对于长时间运行的脚本或应用（如充值监控服务），建议定期手动清理：
基本用法
API密钥支持
当使用公共节点进行大量请求时，您可能需要使用API密钥来避免请求限制。
获取API密钥
在 TRON Grid 官网 注册账户并获取API密钥。
设置API密钥
详细示例请参考 examples/api_key_demo.php。
钱包管理
创建新钱包
从私钥导入钱包
验证私钥与地址
详细示例请参考 examples/wallet_demo.php。
TRC20代币操作
查询代币余额
转账TRC20代币
详细转账示例请参考 examples/transfer_demo.php。
查询TRC20代币交易历史
详细示例请参考 examples/trc20_transactions_demo.php。
自动充值检测
质押TRX获取资源
波场网络上的交易需要消耗能量和带宽资源，可以通过质押TRX获取这些资源。
质押获取能量
质押获取带宽
解除质押
详细质押示例请参考 examples/stake_energy_demo.php。
能量估算
在转账前，可以估算交易所需的能量，避免因能量不足导致交易失败。
查询账户资源
批量操作
批量查询余额
批量转账TRC20代币
详细的批量转账示例请参考 examples/batch_transfer_usdt_demo.php。
示例文件说明
本库提供了多个示例文件，位于 examples/ 目录下：
- basic_usage.php - 基本用法示例
- wallet_demo.php - 钱包管理示例
- balance_demo.php - 余额查询示例
- transfer_demo.php - TRC20代币转账示例
- batch_transfer_usdt_demo.php - TRC20代币批量转账示例
- trc20_transactions_demo.php - TRC20交易记录查询示例
- api_key_demo.php - API密钥使用示例
- stake_energy_demo.php - 质押TRX获取能量示例
- energy_guide.php - 能量使用指南
- staking_guide.md - 质押指南文档
- check_balance.php - 余额检查工具
- trx_balance.php - TRX余额查询工具
- production_balance.php - 生产环境余额查询示例
错误处理
本库提供了详细的错误信息和异常处理，使用 try-catch 捕获异常：
注意事项
- 节点选择 - 建议使用私有节点或付费API服务，公共节点可能会有请求限制和稳定性问题
- 费用设置 - TRC20转账时，确保设置适当的费用限制，避免因能量不足导致交易失败
- API密钥 - 在生产环境中，强烈建议使用API密钥
- 质押操作 - 质押和解除质押操作在某些公共节点上可能受限，建议使用私有节点
- 能量管理 - 在进行TRC20交易前，确保账户有足够的能量或TRX余额
赞助
如果您觉得这个项目有帮助，可以给予赞助：
Tron(TRX): TJoq53NiXhrgC9G2KNvpKv2s6UkcdNRgFP
许可证
本项目采用 MIT 许可证
All versions of tron-api with dependencies
guzzlehttp/guzzle Version ^7.0
comely-io/data-types Version ^1.0
kornrunner/secp256k1 Version ^0.2
simplito/elliptic-php Version ^1.0
iexbase/web3.php Version ^2.0.1
ext-json Version *
ext-bcmath Version *