PHPTronTool开发包有哪些特性

本篇内容主要讲解“PHP TronTool开发包有哪些特性”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“PHP TronTool开发包有哪些特性”吧!

我们提供的服务有:网站制作、成都网站制作、微信公众号开发、网站优化、网站认证、抚顺县ssl等。为数千家企事业单位解决了网站和推广的问题。提供周到的售前咨询和贴心的售后服务,是有科学管理、有技术的抚顺县网站制作公司

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,主要类/接口及关系如下图所示:

PHP TronTool开发包有哪些特性

TronTool的主要代码文件清单参见官网说明:TronTool PHP 。

2、使用示例代码

2.1 创建新地址

在终端进入演示代码目录,执行如下命令:

~$ cd ~/trontool/demo
~/trontool/demo$ php NewAddressDemo.php

执行结果如下:

PHP TronTool开发包有哪些特性

2.2 Trx转账及余额查询

在终端进入演示代码目录,执行如下命令:

~$ cd ~/trontool/demo
~/trontool/demo$ php TrxDemo.php

执行结果如下:

PHP TronTool开发包有哪些特性

2.3 Trc20代币转账、余额查询及事件监听

在终端进入演示代码目录,执行如下命令:

~$ cd ~/trontool/demo
~/trontool/demo$ php Trc20Demo.php

执行结果如下:

PHP TronTool开发包有哪些特性

2.4 Tron智能合约部署

在终端进入演示代码目录,执行如下命令:

~$ cd ~/trontool/demo
~/trontool/demo$ php DeployContractDemo.php

执行结果如下:

PHP TronTool开发包有哪些特性

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('87c12d....d435')              //使用指定私钥
);

2.2 Trx转账及余额查询

使用TronKit的sendTrx()方法进行Trx转账,例如发送1000 TRX:

$to = 'TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx';                 //转账目标地址
$amount = 1000000000;                                       //转账金额,单位:SUN
$ret = $kit->sendTrx($to,$amount);                          //提交Trx转账交易
echo 'txid => ' . $ret->tx->txID .  PHP_EOL;                //显示交易ID
echo 'result => ' . $ret->result . PHP_EOL;                 //显示交易结果

注意:需要将金额单位转换为SUN,1 TRX = 1000000 SUN。

使用getTrxBalance()方法查询指定地址的Trx余额,例如:

$addr = 'TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx';               //要查询的Tron地址
$balance = $kit->getTrxBlanace($addr);                      //查询Trx余额,单位:SUN
echo 'trx balance => ' . $balance . PHP_EOL;                //显示余额

2.3 TRC20代币转账

使用Trc20()方法获取指定TRC20代币合约实例,然后调用合约的transfer()方法进行TRC20代币转账。例如,下面的代码指定地址间转账1315300个最小单位的USDT-TRC20代币,即1.3153 USDT:

$to = 'TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx';                 //转账目标地址
$amount = 1315300;                                          //转账Trc20代币数量
$contractAddress = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'     //USDT-TRC20代币合约的部署地址
$usdt = $kit->Trc20($contractAddress);                      //创建Trc20代币合约实例
$ret = $usdt->transfer($to,$amount);                        //转账Trc20代币
echo 'txid => ' . $ret->tx->txID .  PHP_EOL;                //显示转账交易ID
echo 'result => ' . $ret->result . PHP_EOL;                 //显示转账交易结果

2.4 TRC20代币余额查询

使用Trc20()方法获取指定TRC20代币合约实例,然后调用合约的balanceOf()方法查询指定地址的TRC20代币余额。例如,下面的代码查询指定地址的USDT代币余额:

$usdt = $kit->Trc20('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');          //创建USDT-TRC20代币合约实例
$balance = $usdt->balanceOf('TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx');  //查询Trc20代币余额
echo 'usdt balance => ' . $balance . PHP_EOL;                       //显示代币余额

2.5 TRC20代币事件查询

使用Trc20()方法获取指定TRC20代币合约实例,然后调用合约的events()方法查询指定合约触发事件。

例如查询USDT代币合约最近10秒的事件:

$usdt = $kit->Trc20('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');    //创建Trc20代币合约实例
$since = time() - 10000;                                      //计算检查时间点
$events = $usdt->events($since);                              //提取合约事件
foreach($events as $event){                                   
  echo 'block height => ' . $event->block_number . PHP_EOL;   //显示事件触发的区块高度
  echo 'event name => ' . $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 'private key => ' . $credential->privateKey() . PHP_EOL; //显示私钥
echo 'public key => ' . $credential->publicKey() . PHP_EOL;   //显示公钥
echo 'address => ' . $credential->address() . PHP_EOL;        //显示地址

可以使用静态方法fromPrivateKey()导入已有的私钥来实例化Credential。例如下面的代码导入已有私钥并显示地址:

use TronTool\Credential;

$credential = Credential::fromPrivateKey('7889...023a');      //导入已有私钥
echo 'address => ' . $credential->address() . PHP_EOL;        //显示相应地址

在Tron区块链中,地址有两种表示:16进制和base58表示,例如下面是同一个地址的两种表示:

  • base58:TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx

  • 16进制: 412539EF4F3EB733C105A957EEBB20FD60AD8C9A43

Address类包含了相应的编解码逻辑,可以方面的利用不同形式的地址实例化Address。例如:

$a1 = Address::fromBase58('TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx');
echo $a1->hex() . PHP_EOL;        //输出:412539EF4F3EB733C105A957EEBB20FD60AD8C9A43

$a2 = Address::fromHex('412539EF4F3EB733C105A957EEBB20FD60AD8C9A43');
echo $a2->base58() . PHP_EOL;     //输出:TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx

有时我们只需要简单的在base58和16进制之间转换地址,这时并不需要中间的Address对象,可以直接使用静态方法encode()和decode()。例如:

$a1 = Address::decode('TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx');
echo $a1 . PHP_EOL;             //输出:412539EF4F3EB733C105A957EEBB20FD60AD8C9A43

$a2 = Address::encode('412539EF4F3EB733C105A957EEBB20FD60AD8C9A43');
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(
  'https://api.trongrid.io',       //全节点URL
  'https://api.trongrid.io',       //合约节点URL
  'https://api.trongrid.io'        //事件节点URL
);

当上述三个节点的URL相同时,可以简写为:

$tc = new TronApi('https://api.trongrid.io');

如果用的是Tron官方提供的TronGrid节点,那么可以直接使用TronApi提供的两个静态函数mainNet()和testNet(),分别接入主链和shasta测试链。

例如,下面的代码是等效的:

$tc = new TronApi('https://api.trongrid.io');
$tc = TronApi::mainNet();                       //与上面等效

$tc = new TronApi('https://api.shasta.trongrid.io');
$tc = TronApi::testNet();                       //与上面等效

TronApi封装了Tron官方多种节点提供的API,并基本保持了对应关系以便于查找利用。例如查询账户的TRX余额:

$info = $tc->getAccount('TEgM5CPeqowkKUXoKrFrpvB7vcBgVkD4tP');  //查询账户信息
echo 'balance -> ' . $info->balance . PHP_EOL;                  //显示账户余额

到此,相信大家对“PHP TronTool开发包有哪些特性”有了更深的了解,不妨来实际操作一番吧!这里是创新互联网站,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!


当前题目:PHPTronTool开发包有哪些特性
URL分享:http://bzwzjz.com/article/peodcs.html

其他资讯

Copyright © 2007-2020 广东宝晨空调科技有限公司 All Rights Reserved 粤ICP备2022107769号
友情链接: 外贸网站建设 定制网站建设 成都企业网站制作 成都网站建设 网站设计 手机网站制作 成都网站建设 四川成都网站设计 网站制作 重庆网站建设 手机网站制作 营销型网站建设 成都定制网站建设 成都网站建设 成都品牌网站建设 四川成都网站建设 成都网站设计 成都网站制作 成都网站制作 成都网站建设 成都网站设计 网站建设公司