本篇内容主要讲解“PHP TronTool开发包有哪些特性”，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习“PHP TronTool开发包有哪些特性”吧!
TronTool开发包适用于为PHP应用快速增加对Tron/USDT-TRC20数字资产的支持能力，即支持使用自有Tron区块链节点的应用场景，也支持基于Tron官方公共API服务的轻量级部署场景。
1、开发包概述
TronTool开发包主要包含以下特性：
支持Tron区块链原生Trx交易
支持Tron智能合约以及TRC20代币，例如USDT-TRC20等
支持交易的离线签名，避免泄露私钥
完善的Tron节点API封装，支持全节点、Solidity节点和事件节点提供的API
支持使用自有节点或第三方节点，例如Tron官方提供的公共节点
TronTool软件包运行在**Php 7.1+**环境下，当前版本1.0.0，主要类/接口及关系如下图所示：
TronTool的主要代码文件清单参见官网说明：TronTool PHP 。
2、使用示例代码
2.1 创建新地址
在终端进入演示代码目录，执行如下命令：
~$ cd ~/trontool/demo
~/trontool/demo$ php NewAddressDemo.php
执行结果如下：
2.2 Trx转账及余额查询
在终端进入演示代码目录，执行如下命令：
~$ cd ~/trontool/demo
~/trontool/demo$ php TrxDemo.php
执行结果如下：
2.3 Trc20代币转账、余额查询及事件监听
在终端进入演示代码目录，执行如下命令：
~$ cd ~/trontool/demo
~/trontool/demo$ php Trc20Demo.php
执行结果如下：
2.4 Tron智能合约部署
在终端进入演示代码目录，执行如下命令：
~$ cd ~/trontool/demo
~/trontool/demo$ php DeployContractDemo.php
执行结果如下：
2、使用TronKit
TronKit是开发包的入口，使用这个类可以快速实现如下功能：
Trx转账与余额查询
Trc20代币转账、授权、余额查询等
2.1 实例化TronKit
TronKit实例化需要传入TronApi对象和Credential对象，这两个参数分别封装了Tron节点提供的API，以及进行交易签名的用户身份信息。
例如，下面的代码创建一个接入Tron主链的TronKit实例，并使用指定的私钥进行交易签名：
use TronTool\TronKit;
use TronTool\TronApi;
use TronTool\Credential;
$kit = new TronKit(
TronApi::mainNet(), //接入主链
Credential::fromPrivateKey(&＃39;87c12d....d435&＃39;) //使用指定私钥
);
2.2 Trx转账及余额查询
使用TronKit的sendTrx()方法进行Trx转账，例如发送1000 TRX：
$to = &＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;; //转账目标地址
$amount = 1000000000; //转账金额，单位：SUN
$ret = $kit->sendTrx($to,$amount); //提交Trx转账交易
echo &＃39;txid => &＃39; . $ret->tx->txID . PHP_EOL; //显示交易ID
echo &＃39;result => &＃39; . $ret->result . PHP_EOL; //显示交易结果
注意：需要将金额单位转换为SUN，1 TRX = 1000000 SUN。
使用getTrxBalance()方法查询指定地址的Trx余额，例如：
$addr = &＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;; //要查询的Tron地址
$balance = $kit->getTrxBlanace($addr); //查询Trx余额，单位：SUN
echo &＃39;trx balance => &＃39; . $balance . PHP_EOL; //显示余额
2.3 TRC20代币转账
使用Trc20()方法获取指定TRC20代币合约实例，然后调用合约的transfer()方法进行TRC20代币转账。例如，下面的代码指定地址间转账1315300个最小单位的USDT-TRC20代币，即1.3153 USDT：
$to = &＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;; //转账目标地址
$amount = 1315300; //转账Trc20代币数量
$contractAddress = &＃39;TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&＃39; //USDT-TRC20代币合约的部署地址
$usdt = $kit->Trc20($contractAddress); //创建Trc20代币合约实例
$ret = $usdt->transfer($to,$amount); //转账Trc20代币
echo &＃39;txid => &＃39; . $ret->tx->txID . PHP_EOL; //显示转账交易ID
echo &＃39;result => &＃39; . $ret->result . PHP_EOL; //显示转账交易结果
2.4 TRC20代币余额查询
使用Trc20()方法获取指定TRC20代币合约实例，然后调用合约的balanceOf()方法查询指定地址的TRC20代币余额。例如，下面的代码查询指定地址的USDT代币余额：
$usdt = $kit->Trc20(&＃39;TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&＃39;); //创建USDT-TRC20代币合约实例
$balance = $usdt->balanceOf(&＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;); //查询Trc20代币余额
echo &＃39;usdt balance => &＃39; . $balance . PHP_EOL; //显示代币余额
2.5 TRC20代币事件查询
使用Trc20()方法获取指定TRC20代币合约实例，然后调用合约的events()方法查询指定合约触发事件。
例如查询USDT代币合约最近10秒的事件：
$usdt = $kit->Trc20(&＃39;TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&＃39;); //创建Trc20代币合约实例
$since = time() - 10000; //计算检查时间点
$events = $usdt->events($since); //提取合约事件
foreach($events as $event){
echo &＃39;block height => &＃39; . $event->block_number . PHP_EOL; //显示事件触发的区块高度
echo &＃39;event name => &＃39; . $event->event_name . PHP_EOL; //显示事件名称
}events()返回的结果是一个事件对象数组，每个成员对象的主要字段说明如下：
caller_contract_address：调用合约地址，base58格式
transaction_id：触发合约事件的交易ID，16进制字符串
result：合约事件参数列表，数组
result_type：合约事件参数类型列表，数组
block_timestamp：事件所在区块时间戳，整数
block_number：事件所在区块号，整数
event_name：事件名称，字符串
contract_address：合约地址，base58格式
event_index：事件索引序号，整数
例如，下面是一个TRC20代币合约的Transfer事件对象的JSON表示，在event_name字段给出了事件名称，在result字段则给出了两种索引形式的事件参数：
{
"caller_contract_address": "TS2Hzo6KpAc8Ym2nGb3idpMtUpM2GiK2gL",
"transaction_id": "265cf378f4943b7c77b7a294f533d4b8c718c297dd28a664848d77cd3f3a0af0",
"result": {
"0": "0x2539ef4f3eb733c105a957eebb20fd60ad8c9a43", //事件参数0
"1": "0x6f6794f3904ff51f9fa81e928afdec91f6744a50", //事件参数1
"2": "8", //事件参数2
"_from": "0x2539ef4f3eb733c105a957eebb20fd60ad8c9a43", //事件参数_from
"_value": "8", //事件参数_value
"_to": "0x6f6794f3904ff51f9fa81e928afdec91f6744a50" //事件参数_to
},
"result_type": {
"_from": "address",
"_value": "uint256",
"_to": "address"
},
"block_timestamp": 1586263455000,
"block_number": 3539438,
"event_name": "Transfer", //事件名称
"contract_address": "TS2Hzo6KpAc8Ym2nGb3idpMtUpM2GiK2gL",
"event_index": 0
}3、Tron区块链身份与地址表示
在TronTool中，使用Credential表征Tron区块链中的一个用户身份，使用Address表征Tron区块链中的一个地址。两者的区别在于Credential包含了用户的私钥信息，可以用来签名交易，因此需要保护，而Address则是可以公开的信息。
使用Credential类的静态方法create()创建新账户。例如，下面的代码创建一个新的账户并显示其私钥、公钥和地址：
use TronTool\Credential;
$credential = Credential::create(); //创建新账号
echo &＃39;private key => &＃39; . $credential->privateKey() . PHP_EOL; //显示私钥
echo &＃39;public key => &＃39; . $credential->publicKey() . PHP_EOL; //显示公钥
echo &＃39;address => &＃39; . $credential->address() . PHP_EOL; //显示地址
可以使用静态方法fromPrivateKey()导入已有的私钥来实例化Credential。例如下面的代码导入已有私钥并显示地址：
use TronTool\Credential;
$credential = Credential::fromPrivateKey(&＃39;7889...023a&＃39;); //导入已有私钥
echo &＃39;address => &＃39; . $credential->address() . PHP_EOL; //显示相应地址
在Tron区块链中，地址有两种表示：16进制和base58表示，例如下面是同一个地址的两种表示：
Address类包含了相应的编解码逻辑，可以方面的利用不同形式的地址实例化Address。例如：
$a1 = Address::fromBase58(&＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;);
echo $a1->hex() . PHP_EOL; //输出：412539EF4F3EB733C105A957EEBB20FD60AD8C9A43
$a2 = Address::fromHex(&＃39;412539EF4F3EB733C105A957EEBB20FD60AD8C9A43&＃39;);
echo $a2->base58() . PHP_EOL; //输出：TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx
有时我们只需要简单的在base58和16进制之间转换地址，这时并不需要中间的Address对象，可以直接使用静态方法encode()和decode()。例如：
$a1 = Address::decode(&＃39;TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx&＃39;);
echo $a1 . PHP_EOL; //输出：412539EF4F3EB733C105A957EEBB20FD60AD8C9A43
$a2 = Address::encode(&＃39;412539EF4F3EB733C105A957EEBB20FD60AD8C9A43&＃39;);
echo $a2 . PHP_EOL; //输出：TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx
4、使用TronApi访问Tron节点API
使用TronApi访问Tron的各种节点API。TronApi聚合了多种Tron节点提供的API，例如tron全节点、solidity节点和事件服务节点的API。
实例化TronApi时，可以分别为不同类型的Tron节点指定不同的连接URL，例如：
use TronTool\TronApi;
$tc = new TronApi(
&＃39;https://api.trongrid.io&＃39;, //全节点URL
&＃39;https://api.trongrid.io&＃39;, //合约节点URL
&＃39;https://api.trongrid.io&＃39; //事件节点URL
);
当上述三个节点的URL相同时，可以简写为：
$tc = new TronApi(&＃39;https://api.trongrid.io&＃39;);
如果用的是Tron官方提供的TronGrid节点，那么可以直接使用TronApi提供的两个静态函数mainNet()和testNet()，分别接入主链和shasta测试链。
例如，下面的代码是等效的：
$tc = new TronApi(&＃39;https://api.trongrid.io&＃39;);
$tc = TronApi::mainNet(); //与上面等效
$tc = new TronApi(&＃39;https://api.shasta.trongrid.io&＃39;);
$tc = TronApi::testNet(); //与上面等效
TronApi封装了Tron官方多种节点提供的API，并基本保持了对应关系以便于查找利用。例如查询账户的TRX余额：
$info = $tc->getAccount(&＃39;TEgM5CPeqowkKUXoKrFrpvB7vcBgVkD4tP&＃39;); //查询账户信息
echo &＃39;balance -> &＃39; . $info->balance . PHP_EOL; //显示账户余额
到此，相信大家对“PHP TronTool开发包有哪些特性”有了更深的了解，不妨来实际操作一番吧！这里是编程笔记网站，更多相关内容可以进入相关频道进行查询，关注我们，继续学习！
京公网安备 11010802041100号