PHP区块链（币安智能链PHP开发包「BscTool」）

BscTool开发包适用于为PHP应用快速增加对币安智能链BNB/BEP20数字资产的支持能力， 即支持使用自有BSC区块链节点的应用场景，也支持基于BSC区块链官方节点API服务的 轻量级部署场景。官方下载地址：http！//sc。hubwiz。com/codebag/bsctool-php/

1、开发包概述

BscTool开发包主要包含以下特性：

• 支持BSC区块链原生BNB转账交易及余额查询
• 支持BSC链上智能合约的部署与交互，支持BEP20代币转账交易及到账跟踪
• 支持BSC链上交易的离线签名，避免泄露私钥
• 支持使用自有节点或第三方节点，例如BSC官方提供的公共节点

BscTool软件包运行在 Php 7。1+ 环境下，当前版本1。0。0，主要类/接口及关系如下图所示：

BscTool的主要代码文件清单见 http！//sc。hubwiz。com/codebag/bsctool-php/

2、使用示例代码

在使用示例代码之前，请按照实际情况设置demo/config。php中的以下配置信息：

• NETWORK：要接入的区块链网络，可选：mainNet - BSC主链， testNet - BSC测试链
• ALICE_ADDR：demo程序使用的主测试账号，该账号将用于部署代币合约、执行BNB及BEP20代币转账交易等操作，因此 需要有一定数量的BNB余额。
• ALICE_SK：主测试账号对应的私钥

2。1 BSC链上地址创建与回复

demo/credential-demo。php演示了如何使用BscTool创建新的BSC链上地址，或者导入已有私钥重建账号。

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

~$ cd ~/bsctool/demo~/bsctool/demo$ php credential-demo。php

执行结果如下：

2。2 BNB转账及余额查询

demo/bnb-demo。php演示了如何使用BscTool实现BNB转账和余额查询。

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

~$ cd ~/bsctool/demo~/bsctool/demo$ php bnb-demo。php

执行结果如下：

2。3 BSC智能合约部署

demo/deploy-contract-demo。php演示了如何使用BscTool部署EVM智能合约。

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

~$ cd ~/bsctool/demo~/bsctool/demo$ php deploy-contract-demo。php

执行结果如下：

2。4 BEP20代币转账及余额查询

demo/bep20-demo。php演示了如何使用BscTool实现BEP20代币转账和余额查询等操作。

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

~$ cd ~/bsctool/demo~/bsctool/demo$ php bep20-demo。php

执行结果如下：

2。5 BEP20代币到账跟踪

demo/bep20-event-demo。php演示了如何使用BscTool的合约事件查询功能 实现BEP20代币的到账跟踪。

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

~$ cd ~/bsctool/demo~/bsctool/demo$ php bep20-event-demo。php

执行结果如下：

3、使用BscTool

Kit类是BscTool开发包的入口，使用这个类可以快速实现如下功能：

• BNB转账与余额查询
• BEP20代币转账、授权、余额查询等

3。1 Kit的实例化

Kit实例化需要传入NodeClient对象和Credential对象，这两个 参数分别封装了BSC节点提供的API、以及进行交易签名的用户身份信息。

例如，下面的代码创建一个接入BSC主链的Kit实例，并使用 指定的私钥进行交易签名：

//use bsctoolKit；//use bsctoolNodeClient；//use bsctoolCredential；$kit = new Kit( NodeClient！！mainNet()， //接入主链 Credential！！fromKey('；0x87c12d。。。。d435'；) //使用指定私钥)；

3。2 BNB转账及余额查询

使用Kit对象的transfer()方法进行BNB转账，例如发送0。1 BNB：

//use bsctoolKit；$to = '；0x90F8bf6。。。0e7944Ea8c9C1'；； //转账目标地址$amount = bn('；100000000000000000'；)； //转账金额，按最小单位$txid = $kit->；transfer($to，$amount)； //提交BNB转账交易echo '；txid =>； '； 。 $txid 。 PHP_EOL； //显示交易ID

注意：需要将金额转换为最小单位，由于BNB的小数位数是18， 因此 0。1 BNB = 100000000000000000 最小单位。

使用balanceOf()方法查询指定地址的BNB余额，例如：

$addr = '；0x90F8bf6。。。0e7944Ea8c9C1'；； //要查询的BSC链上地址$balance = $kit->；balanceOf($addr)； //查询BNB余额，按最小单位echo '；balance =>； '； 。 $balance 。 PHP_EOL； //显示BNB余额

3。3 BEP20代币转账

使用Kit对象的bep20()方法获取指定BEP20代币合约实例，然后调用合约 的transfer()方法进行BEP20代币转账。例如，下面的代码 指定地址间转账123。4567 BUSD-T（代币合约地址：0x55d398326f99059ff775485246999027b3197955）：

//use bsctoolKit；$to = '；TDN3QY85Jft3RwgyatjRNmrwRmwkn8qwqx'；； //转账目标地址$amount = bn('；123456700000000000000'；)； //转账BEP20代币数量$contractAddr = '；0x55d398326f99059ff775485246999027b3197955'； //BUSD-T代币合约的部署地址$txid = $kit->；bep20($contractAddr) ->；transfer($to，$amount)； //转账BEP20代币echo '；txid =>； '； 。 $txid 。 PHP_EOL； //显示转账交易ID

3。4 BEP20代币余额查询

使用bep20()方法获取指定的BEP20代币合约实例，然后调用合约 的balanceOf()方法查询代币余额。例如，下面的代码查询指定地址 的BUSD-T代币余额：

//use bsctoolKit；$contractAddr = '；0x55d398326f99059ff775485246999027b3197955'； //BUSD-T代币合约的部署地址$balance = $kit->；bep20($contractAddr) ->；balanceOf('；0x90F8bf6。。。0e7944Ea8c9C1'；)； //查询地址0x90F8。。。的代币余额echo '；balance =>； '； 。 $balance 。 PHP_EOL； //显示代币余额

3。5 BEP20代币到账跟踪

使用bep20()方法获取指定BEP20代币合约实例，然后调用 合约实例的getTransferEvents()方法查询指定条件的转账事件。比特币期货

可以使用getTransferEvents()方法跟踪指定地址的到账状态。 例如查询地址0x90F8。。。在最新区块的BUSD-T代币到账事件：

//use bsctoolKit；$contractAddr = '；0x55d398326f99059ff775485246999027b3197955'； //BUSD-T代币合约的部署地址$events = $kit->；bep20($contractAddr) ->；getTransferEvents( //查询到账事件 []， //转出账号，空数组表示不要求特定的转出账号 ['；0x90F8bf6。。。0e7944Ea8c9C1'；]， //接收账号，仅查询地址0x90F8。。。的到账事件 '；latest'；， //查询起始区块号，latest表示使用最新区块 '；latest'； //查询结束区块号，latest表示使用最新区块 )； foreach($events as $event){ echo '；block =>； '； 。 $event->；blockNumber 。 PHP_EOL； //事件发生区块号 echo '；from =>； '； 。 $event->；params['；from'；] 。 PHP_EOL； //转出账号 echo '；to =>； '； 。 $event->；params['；to'；] 。 PHP_EOL； //转入账号 echo '；value =>； '； 。 $event->；params['；value'；] 。 PHP_EOL； //转账金额}

getTransferEvents()方法返回的结果是一个事件对象数组，每个成员对象的主要字段 说明如下：

• blockHash：事件触发的区块哈希
• blockNumber：事件触发的区块号
• transactionHash：触发事件的交易ID
• address：事件触发的合约地址
• name：事件名称，例如转账事件的名称为：Transfer
• params：事件参数数组，例如转账事件包含以下三个参数：
• from：转出账号
• to：转入账号
• value：转账数量

4、BSC区块链身份与地址表示

在BscTool中，使用Credential对象表征BSC区块链中的一个用户身份，使用普通的 字符串表征BSC区块链中的一个地址，这两者的区别在于Credential包含了用户 的私钥信息，可以用来签名交易，因此需要保护。

使用Credential类的静态方法create()创建新账户。例如，下面的代码创建一个 新的账户并显示其私钥、公钥和地址：

//use bsctoolCredential；$credential = Credential！！create()； //创建新账号echo '；private key =>； '； 。 $credential->；getPrivateKey() 。 PHP_EOL； //显示私钥echo '；public key =>； '； 。 $credential->；getPublicKey() 。 PHP_EOL； //显示公钥echo '；address =>； '； 。 $credential->；getAddress() 。 PHP_EOL； //显示地址

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

//use bsctoolCredential；$credential = Credential！！fromKey('；0x7889。。。023a'；)； //导入已有私钥echo '；address =>； '； 。 $credential->；getAddress() 。 PHP_EOL； //显示相应地址

5、使用NodeClient

NodeClient类封装了BSC节点的RPC访问协议。实例化NodeClient时，需要指定要连接 的节点URL，例如使用本地的全节点：

//use bscNodeClient；$client = new NodeClient('；http！//localhost！8545'；)；

当使用BSC官方节点时，NodeClient类也提供列两个静态函数mainNet()和testNet()，分别 用于接入官方提供的主链节点和测试链节点。

例如，下面的代码是等效的：

//use bsctoolNodeClient；$client = new NodeClient('；https！//bsc-dataseed。binance。org/'；)；$tc = NodeClient！！mainNet()； //与上面等效$tc = new NodeClient('；https！//data-seed-prebsc-1-s1。binance。org！8545/'；)；$tc = NodeClient！！testNet()； //与上面等效

原文链接：http！//sc。hubwiz。com/codebag/bsctool-php/

　　
"，"content_hash"！"bee99f20