作为我们Block Producer对社区利益的承诺的一部分,我们希望专注于构建有助于提高EOS平台采用率的工具/应用程序。与大多数大型应用程序一样,当你只有少量或过时的文档并且缺乏工具来帮助你进行入门学习时,可能就会存在很高的进入门槛。
为了节省刚入门的EOS开发人员一些时间,我们整理了一个PHP SDK,它涵盖了大部分EOS的API方法。在文档中,每个调用都有一些示例,其中包含API的实际输出。
无论你是否使用PHP,我们都希望这将是一个有用的参考点,可以开始构建你的第一个应用程序,或者只是了解EOS区块链API提供的内容也好。
你可以查看EOS官方文档,但要注意缺少一些较新的方法。此外,这些文档中的一些示例使用了过时的语法。
安装
composer require block-matrix-network/php-eos-rpc-sdk
设置
使用你喜欢的RPC API主机在项目根目录中创建一个dotenv .env
文件。你可以使用.env.example
作为模板:
cp .env.example .env
用法
有一个工厂方法来自动实例化所有依赖项:
$api = (new ChainFactory)->api();
示例
为了帮助你入门,有一个简单的示例运行器,它涵盖了所有API命令。
只需通过cli运行此命令即可查看所有命令的示例输出:
cd examples
php chain.php
API方法
涵盖了所有只读的EOS区块链API方法。下面举几个例子:
getInfo 获取信息
获取与节点相关的最新信息。
echo $api->getInfo();
{
"server_version": "db031363",
"chain_id": "aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906",
"head_block_num": 1380988,
"last_irreversible_block_num": 1380657,
"last_irreversible_block_id": "0015113163cbe7676c4e56d1758a1ce95e47fa645827b9202de5753031d36b8b",
"head_block_id": "0015127c94676db3da55ec66210952db7f4db35b0e731abefff1562c201a0666",
"head_block_time": "2018-06-18T15:38:45.000",
"head_block_producer": "eoscannonchn",
"virtual_block_cpu_limit": 200000000,
"virtual_block_net_limit": 1048576000,
"block_cpu_limit": 199900,
"block_net_limit": 1048576
}
getBlock 获取块信息
获取与块相关的信息。
echo $api->getBlock("1337");
{
"timestamp": "2018-06-09T12:09:21.500",
"producer": "eosio",
"confirmed": 0,
"previous": "00000538b374c1cbfaeed7253ad3075ddc72a28f0a0515301fc1bbed675f2316",
"transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
"action_mroot": "bcb9763baa3bbf98ed36379b4be0ecb2d9cd21c75df01729c63b2b021001c10c",
"schedule_version": 0,
"new_producers": null,
"header_extensions": [
],
"producer_signature": "SIG_K1_K5jWf36t6j454Hb2fGuV37YTwMTvuQ51ZPBtpru8Ud2axtMTEauWyvtpJuTpnvqzReUndDgEDXvoeEP4jdj2bpnYKBt6g2",
"transactions": [
],
"block_ex