Bianace区块链PHP对接开发包
BnbTool开发包适用于为PHP应用快速增加对 币安链 / Binance Chain 数字资产的支持能力,
即支持使用自有部署区块链节点的应用场景,也支持基于第三方节点开放API服务的轻量级部署场景。
官方下载地址:http://sc.hubwiz.com/codebag/bnbtool/。
1、开发包概述
BnbTool开发包是一个完整的币安链PHP开发包,可以极大地提升区块链钱包、交易平台或区块链应用开发过程中与币安链的对接实现效率。BnbTool主要包含以下特性:
- 完善的币安链节点RPC API与Rest API封装
- 完善的Tendermint Amino编解码器PHP实现
- 离线管理私钥,离线签名交易,离线序列化/反序列化交易
- 透明支持自有节点或第三方节点访问币安链,例如查询数据或广播交易
BnbTool软件包运行在Php 7.1+环境下,当前版本1.0.0,主要实现类/接口及相互之间的关系如下图所示:
BnbTool的主要代码文件清单见官网:http://sc.hubwiz.com/codebag/bnbtool/
2、使用演示代码
下载开发包并解压后,进入demo目录运行演示代码。
2.1 CryotoDemo
CryptoDemo.php演示了如何使用BnbTool的Crypto封装类实现币安链账户的创建与恢复,签名的生成与验证。
在终端执行如下命令启动CryptoDemo:
~$ php CryptoDemo.php
运行结果类似下图:
2.2 RpcClientDemo
RpcClientDemo.php演示了如何使用BnbTool的RpcClient调用币安链节点的RPC API。
在终端执行如下命令启动RpcClientDemo:
~$ php RpcClientDemo.php
运行结果类似下图:
2.3 RestClientDemo
RestClientDemo.php演示了如何使用BnbTool的RestClient调用
币安链的Rest API。
在终端执行如下命令启动RestClientDemo:
~$ php RestClientDemo.php
运行结果类似下图:
2.4 ToolKitDemo
ToolKitDemo.php演示了如何使用BnbTool的ToolKit入口类实现币安链账户的创建、转账、余额查询与历史交易查询。
在终端执行如下命令启动ToolKitDemo:
~$ php ToolKitDemo.php
运行结果类似下图:
3、ToolKit类使用说明
ToolKit是BnbTool的入口类,利用它可以快速完成币安链账户的创建、转账、DEX挂单等操作。ToolKit的主要属性与方法如下:
-
属性
- keyStore:密钥库实例
- restClient:币安链Rest API客户端实例
-
方法
- newAddress():创建新账户并返回生成的地址,新的私钥/地址自动加入密钥库
- importKey():导入指定的私钥并返回对应的地址,该私钥/地址自动加入密钥库
- transfer():执行代币转账交易
- placeOrder():在DEX委托挂单
- cancleOrder():取消DEX上的委托单
- freezeToken():冻结指定数量的代币
- unfreezeToken():解冻指定数量的代币
- dexList():在DEX上市交易对
3.1 ToolKit的实例化
实例化ToolKit需要传入两个参数:币安链节点Rest API服务地址,以及该节点接入的网络。例如,使用本机的Rest API服务器接入Binance Chain的测试网:
use BnbTool\ToolKit; $kit = new ToolKit( 'http://localhost:8080', //Rest API访问基地址 'testnet' //测试链,可选:mainnet | testnet );
ToolKit也提供了两个静态方法用来快速创建接入主网或测试网的实例:
$kit = ToolKit::mainnet(); //使用 https://dex.binance.org接入主网 $kit = ToolKit::testnet(); //使用 https://testnet-dex.binance.org接入测试网
容易理解,ToolKit::mainnet()
等价于如下的代码:
new ToolKit('https://dex.binance.org','mainnet');
3.2 账户创建与恢复
使用ToolKit的newAddress()
方法创建新账户,该方法将生成随机私钥并返回该私钥对应的地址,同时将私钥信息存入ToolKit的密钥库。例如下面的代码创建一个新的币安链账户并显示该账户的地址:
$address = $kit->newAddress(); //创建新账户并返回地址 echo "new address: $address" . PHP_EOL; //显示新账户的地址
也可以使用importKey()
方法导入已有的私钥,该方法将返回所导入私钥对应的地址。例如下面代码导入指定的私钥并显示该账户的地址:
$prv = '49bd38a8...5af84709670fd'; //要导入ToolKit的私钥 $address = $kit->importKey($prv); //导入私钥并返回地址 echo "restored: $address" . PHP_EOL; //显示恢复的地址
3.3 使用密钥库
ToolKit使用密钥库来保存账户信息,密钥库遵从IKeyStore接口的4个方法:
- add():添加账户信息
- getAll():返回所有账户的列表
- getByKey():查询指定私钥的账户
- getByAddress():查询指定地址的账户
使用ToolKit的keyStore
属性就可以访问当前使用的密钥库对象。例如,下面的代码列表显示当前密钥库中的所有账户:
$items = $kit->keyStore->getAll(); //返回密钥库全部账户 foreach($items as $item){ //逐行显示账户私钥和地址 echo "key:{$item->key}, address: {$item->address}" . PHP_EOL; }
可以使用密钥的getByKey()
方法查询指定密钥的账户地址,例如:
$prv = '49bd38a8...5af84709670fd'; //要查询的私钥 $item = $kit->keyStore->getByKey($prv); //返回该私钥对应的账户记录 if(!is_null($item)) //如果找到的话 echo "address => {$item->address}\n"; //显示账户地址
3.4 转账交易
使用ToolKit的tranfer()
方法执行代币转账交易。例如下面的代码在两个指定账号间转账1.234个BNB代币,并附备注信息:
$kit->importKey('....'); //导入转账发起账号的私钥 $ret = $kit->transfer( 'tbnb1hfw...x3kh9d7p5ryya', //转账发起账号 'tbnb1l5f...xcyt0ec40avsp', //转账接收账号 'BNB', //代币符号 1.234, //代币数量 'rent' //备注信息 ) echo "tx hash => {$ret[0]->hash}\n"; //显示交易哈希
注意,由于交易需要发起账号签名,因此在调用transfer()
方法之前,务必保证ToolKit的密钥库中已有该发起账号的私钥。
3.5 查询账户余额
由于币安链的Rest API更容易使用,ToolKit使用RestClient而不是RpcClient来与币安链交互,可以通过ToolKit的restClient
属性来访问预创建的RestClient实例。
例如,下面的代码使用RestClient的getAccount()
方法来查询
指定账户的所有种类代币的余额并逐行显示:
$ret = $kit->restClient->getAccount('tbnb1hfw...x3kh9d7p5ryya'); //查询账户信息 foreach($ret->balances as $b){ //遍历全部币种 echo "symbol: {$b->symbol}, free: {$b->free}\n"; //显示币种符号与可用余额 }
3.6 查询账户的历史交易
类似的,使用RestClient的getTransactions()
方法,可以查询指定账户的历史交易。例如下面的代码:
$ret = $kit->restClient->getTransactions('tbnb1hfw...x37p5ryya'); //查询历史交易 foreach($ret->tx as $tx){ //遍历全部交易 echo json_encode($tx) . PHP_EOL; //显示交易内容 }
getTransactions()
方法支持分页处理,例如,下面的代码使用offset
和limit
选项声明需要返回从100#开始的20个交易:
$ret = $kit->restClient->getTransactions( 'tbnb1hfw...x3kh9d7p5ryya', //要查询的账户地址 [ 'offset'=>100, //记录起始位置 'limit'=>20 //返回记录数量 ] );
getTransactions()
对应于Rest API中的 /v1/api/transactions ,可以参考该文档了解更多可用的查询过滤参数。
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
2020前端发展趋势 -
迅速发展的前端开发,在每⼀年,都为开发者带来了新的关键词。2019 年已步⼊尾声,2020 年前端发展的关键词⼜将有哪些呢?发展的方向又会是什么呢?参考2019年大前端的发展,不出意外,前端依旧会围绕⼩程序、超级APP、跨端开发、前端⼯程化以及新技术运用等几个方面进行展开(可以参考2019年大前端技术趋势深度解读)。 小程序在⼩程序⽅⾯,今年仍然是⼩程序突⻜猛进的⼀年,各⼤主流的 App 都上线了⼩程序能⼒的⽀持,各前端团队也都有了专⻔的⼩程序开发团队,以适应更快的⼩程序开发需求。同时App 中很多关键的功能都被⼩程序所替代,甚⾄有些 App 已经变成 Native ⼩程序壳,上层的应⽤实现全部是⼩程序。 在微信小程序出现以前,大家在谈 Hybird、ReactNative,但终归只是技术层面的狂欢,始终没有业务属性的注入。小程序的出现,一方面告诉业界在当前设备上 Webview 也没差到哪去,另外一方面告诉业界如何让有能力的商家在超级 APP上进行私域运营。 另一方面,从技术角度说,在上层 DSL 的严格限制下,超级 APP 就可定义符合自己诉求的 Web 标准,弥补当前 Web 标...
- 下一篇
第423期 Python 周刊
文章,教程和讲座 MicroPython 为我的房屋供暖 链接: https://www.youtube.com/watch?v=P5nOGKVLIYo 2018年,我从美国搬到爱尔兰,虽然我租的房子有一个联网控制的供暖器,我租的房屋却仍然非常冷。在本次演讲中,我想告诉大家我是如何“调试”这个问题的,以及如何使用几个运行在 MicroPython 的微控制器来改善供暖方式,而这些都没有对不属于我的这座房子进行任何物理修改。 Dijkstra 最短路径算法 链接: https://t.co/QnBi3m7S1Z 从 GPS 导航到网络层链路状态路由,Dijkstra 算法为一些备受关注的现代服务提供了理论支持。只需利用一些基本的数据结构,让我们一起了解它的功能,它的实现原理, 以及如何在Python中实现 理解卷积神经网络:制作一个手写数字计算器 链接: https://www.youtube.com/watch?v=eyKwPyOqMg4 在此视频中,我借助 Tensorflow 和 Keras , 用 Python 编写卷积神经网络制作一个手写数字计算器, 并且我将深入解释卷积神经网...
相关文章
文章评论
共有0条评论来说两句吧...