SDK推荐:EOS区块链PHP开发包

1. 开发包概述

EosTool的目的是消除使用PHP开发EOS区块链应用的痛苦,例如:

通过Nodeos和Keosd的RPC接口调用其功能

离线生成EOS格式的私钥和公钥

使用本地私钥生成符合EOS要求的交易签名

将交易对象序列化为Nodeos要求的packed_trx格式

可以认为EosTool是PHP版本的eosjs,利用它可以完整地实现EOS官方客户端Cleos的功能, 也可以很方便地在PHP应用中增加对EOS区块链的支持能力,极大地提高开发效率。

EosTool运行在**Php 7.1+**环境下,当前版本1.0.0,主要代码文件清单如下:

2. 访问节点服务器

使用NodeClient类访问nodeos的rpc接口。例如,下面的代码访问本机运行的 Nodeos节点的插件的接口:

2.1 RPC调用分组

Nodeos采用了插件化架构,不同的插件的API也归入不同的分组,EosTool采用了保持一致的 命名方法,根据api即可推断出NodeClient的调用方法:API分组对应于NodeClient的一个同名 属性,API则对应与No的Client的分组同名属性下的一个经过camelCase转化的方法。例如:

RPC API的官方文档:https://developers.eos.io/eosio-nodeos/reference

2.2 RPC调用参数

对于Nodeos而言,有些调用需要传入额外的参数,例如chain插件的get_block接口, 使用EosTool进行调用时,将参数组织为一个关联数组即可,示例代码如下:

2.3 RPC调用返回值

所有RPC调用的返回结果都是一个RpcOutput实例,调用其方法可以 判断是否调用出错,进一步可以利用方法获取错误信息。

RPC调用的响应则可以通过方法获取,它是一个由原始的JSON结果 转化出的StdClass对象,因此可以方便的提取属性信息,例如:

2.4 访问主网/测试网节点

在创建NodeClient实例时,可以传入额外的参数执行来制定要访问的EOS主网或测试网节点。 例如,使用下面的代码访问某个主网节点:

或者访问jungle测试网的某个节点:

3、访问钱包服务器

新版的Keosd已经不提供RPC API文档,这可能意味着它在EOS软件栈中已经开始滑向边缘地位。 不过可以在这个地址访问老版的文档:https://developers.eos.io/eosio-nodeos/v1.1.0/reference

使用WalletClient类访问Keosd的rpc接口。例如,下面的代码访问本机运行的 Keosd的接口:

由于Keosd的API不再分组,因此RPC对应的方法直接挂在WalletClient对象上,这是一个不同之处。 与NodeClient一样的是,WalletClient的调用返回结果也是一个RpcOutput对象。

1.4版的Keosd默认使用UNIX套接字而不是HTTP提供RPC接口,这可能是考虑到绝大多数情况下 Keosd都运行在本机,使用IPC会更安全一些。因此这也是WalletClient的默认实例化选项, 在绝大多数情况下,不需要传入额外的参数来实例化WalletClient。

4. 私钥与公钥

EOS的密钥算法类似于比特币,但做了一些调整,定义了自己的格式。

使用PrivateKey类的静态方法生成随机私钥。例如:

方法用来将私钥对象转换为EOS的自定义格式。

4.1 公钥推导

从私钥可以推导出公钥,例如:

同样,使用方法将公钥转换为EOS的自定义格式。

4.2 导入EOS私钥

可以将一个EOS格式的私钥转化为EosTool的PrivateKey对象,例如,下面的 代码将指定的EOS私钥导入,并显示其对应的EOS公钥:

4.3 权威签名

PrivateKey的方法支持普通签名和EOS节点要求的权威签名。例如下面的代码返回一个 普通签名:

传入额外的参数来获得指定数据的权威签名:

5. 序列化

EOS要求交易在提交节点之前先进行序列化,这也是在PHP中操作EOS交易 绕不过去的一个环节。

在EosTool中,使用Serializer类进行序列化操作。例如,下面的代码将一个EOS转账交易 序列化为可以提交给EOS节点旳16进制码流格式:

Serializer的静态方法用来根据一个指定的abi构造序列化器实例,然后 利用实例的方法对指定类型的数据进行序列化操作,得到16进制码流。

6. 签名

EosTool提供了两种进行交易签名的方法:利用Keosd进行签名,或者使用本地私钥进行签名。

使用KeosdSigner类来利用钱包服务器完成签名。例如:

利用LocalSigner类,则可以避免使用keosd,直接利用离线私钥签名。例如:

7. 交易提交

一个交易数据,需要经过规范化、序列化、签名、打包一系列操作,才可以提交给 Nodeos节点广播出去。EosTool类提供了方法来隔离这些繁琐的操作。

例如,下面的代码使用NodeClient和LocalSigner创建一个EosTool实例,然后提交 一个交易:

可以很方便地将签名器改为KeosdSigner,例如:

8. 调用单个合约动作

使用EosTool的方法调用单个合约动作。例如,下面的代码调用tommy 账户托管合约的方法:

9. 部署合约

使用EosTool的方法部署合约,例如:

对EOS区块链PHP开发包有兴趣的朋友可以访问这个网址:

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20181206G1LP3Y00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券