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开发包有兴趣的朋友可以访问这个网址：