介绍一个EOS Chain/Wallet RPC API的PHP开发包。
如果你在寻找一个完备的PHP开发包,而不局限于RPC调用的封装,建议使用EosTool。
开始
你可以查看EOS的RPC API参考,但要注意缺少一些较新的方法。Wallet RPC API实现EOS v1.1.0 of RPC API reference。此外,这些文档中的一些示例也使用了过时的语法。
安装
1 | composer require manamine/php-eos-rpc-sdk |
配置
使用你最喜欢的RPC API主机和KEOSD在项目根目录中创建一个dotenv.env
文件。你可以使用env.example
作为模板:
1 | cp .env.example .env |
有一个漂亮的工厂方法来自动化实例所有依赖项:
1 | $api = (new ChainFactory)->api(); |
示例
为了帮助你入门,运行一个简单的示例,它涵盖了所有API命令。
只需通过cli运行此命令即可查看所有命令的示例输出:
1 | cd examples |
API方法
涵盖了几乎所有区块链和钱包API方法。
区块链API
Get Info
获取与节点相关的最新信息
1 | echo $api->getInfo(); |
Get Block
获取与区块相关的信息
1 | echo $api->getBlock("1337"); |
Get Block Header State
获取与块头状态相关的信息
1 | echo $api->getBlockHeaderState("0016e48707b181d93117b07451d9837526eba34a9a37125689fb5a73a5d28a38"); |
Get Account
获取与帐户相关的信息
1 | $api->getAccount("blockmatrix1"); |
Get Code
获取智能合约代码
1 | echo $api->getCode("eosio.token"); |
Get Table Rows
从帐户中获取智能合约数据
1 | echo $api->getTableRows("eosio", "eosio", "producers", ["limit" => 10]); |
Get Currency Balance
获取帐户的货币余额
1 | echo $api->getCurrencyBalance("eosio.token", "eosdacserver"); |
Get Currency Stats
获取货币状态
1 | echo $api->getCurrencyStats("eosio.token", "EOS"); |
Get ABI
获取账户ABI
1 | echo $api->getAbi("eosio.token"); |
Get Raw Code and ABI
获取原生代码和ABI
1 | echo $api->getRawCodeAndAbi("eosio.token"); |
Get Producers
列出生产者
1 | echo $api->getProducers(10); |
ABI JSON To Bin
将json序列化为二进制十六进制
1 | echo $api->abiJsonToBin("eosio.token", "transfer", ["blockmatrix1", "blockmatrix1", "7.0000 EOS", "Testy McTest"]); |
ABI Bin To JSON
将二进制十六进制序列化为json
1 | echo $api->abiBinToJson("eosio.token", "transfer", "10babbd94888683c10babbd94888683c701101000000000004454f53000000000c5465737479204d6354657374"); |
Get Required Keys
获取签署交易所需的密钥
1 | echo $api->getRequiredKeys( |
Push Transaction
提交推送一个交易
1 | echo $api->pushTransaction("2018-08-23T05:29:39", "15780", "90170226", |
Push transactions
提交推送一些交易
1 | echo $api->pushTransactions( |
钱包 Wallet APIs
Create
创建具有给定名称的新钱包
1 | echo $walapi->create("testwallet"); |
Open
打开给定名称的现有钱包
1 | echo $walapi->open("testwallet"); |
Lock
锁定给定名称的现有钱包
1 | echo $walapi->lock("testwallet"); |
Lock All
锁定所有现有钱包
1 | echo $walapi->lockAll(); |
Unlock
使用给定的名称和密码解锁钱包
1 | echo $ walapi-> unlock([“testwallet”,“PW5Jb8RAZP6CBjjMLPser3T8i8k9hZXZkMBJ8kb1p6f6hAg2n68jY”]); |
Import Key
将私钥导入给定名称的钱包
1 | echo $walapi->importKey(["testwallet", "5Jmsawgsp1tQ3GD6JyGCwy1dcvqKZgX6ugMVMdjirx85iv5VyPR"]); |
Remove Key
从给定名称的钱包中删除密钥对
1 | echo $walapi->removeKey(["testwallet", "PW5Jb8RAZP6CBjjMLPser3T8i8k9hZXZkMBJ8kb1p6f6hAg2n68jY", "EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4"]); |
Create Key
创建密钥对并导入
1 | echo $walapi->createKey(["testwallet", "K1"]); |
List Wallets
列出所有钱包
1 | echo $walapi->listWallets(); |
List Keys
列出给定名称和密码的钱包中的所有密钥对
1 | echo $walapi->listKeys(["testwallet", "PW5Jb8RAZP6CBjjMLPser3T8i8k9hZXZkMBJ8kb1p6f6hAg2n68jY"]); |
Get Public Keys
列出所有钱包中的所有公钥
1 | echo $walapi->getPublicKeys(); |
Set Timeout
设置钱包自动锁定超时(以秒为单位)
1 | echo $walapi->setTimeout(60); |
Sign Transaction
签署交易
1 | echo $walapi->signTransaction( |
EOS Wrapper APIs
Prerequisites
需要设置钱包名称和密码
1 | $eos->setWalletInfo("testwallet", "PW5Jb8RAZP6CBjjMLPser3T8i8k9hZXZkMBJ8kb1p6f6hAg2n68jY"); |
Push Transaction
推送交易
1 | echo $eos->pushTransaction( |
Make Transaction
进行交易(对pushTransactions有用)
1 | $trx = $eos->makeTransaction( |
Push Transactions
推送一些交易
1 | $trx_ids = $eos->pushTransactions( |
Push Action
推动一个操作
1 | echo $eos->pushAction("eosio", "buyram", ["payer"=>"tester","receiver"=>"tester","quant"=>"1.0000 EOS"], ["actor"=>"tester","permission"=>"active"]); |
Transfer
交易支付
1 | echo $eos->transfer("user", "tester", "1.0000 EOS", "memo"); |
Create Key Pair
创建密钥对并返回
1 | $keyPair = $eos->createKeyPair("K1"); |
Tests
要运行测试套件,只需执行:
1 | vendor/bin/phpunit |
如果您想获得想象并检查代码覆盖率:
1 | vendor/bin/phpunit --coverage-html tests/coverage |
如果你真的很无聊,你可能想要运行一些静态分析:
1 | vendor/bin/phpmetrics --report-html="tests/static" . |
======================================================================
分享一些以太坊、EOS、比特币等区块链相关的交互式在线编程实战教程:
- java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
- python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
- php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
- 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
- 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
- C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
- EOS教程,本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。
- java比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Java代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Java工程师不可多得的比特币开发学习课程。
- php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。
- tendermint区块链开发详解,本课程适合希望使用tendermint进行区块链开发的工程师,课程内容即包括tendermint应用开发模型中的核心概念,例如ABCI接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是go语言工程师快速入门区块链开发的最佳选择。