myxtype/ethereum-client

ethereum rpc client

注意

此仓库很久之前已不再维护，建议使用以下仓库进行替代：

• https://github.com/web3p/web3.php

ethereum-client

ethereum rpc client, offline sign, php

PHP版的以太坊RPC客户端，支持离线交易、生成私钥与地址。你不用专门购买一台服务器来运行以太坊客户端。

你可以使用以太坊公共节点，比如：https://infura.io 你可以将你用户的私钥加密存储在数据库中，使用的时候取出解密，直接发送交易。

这样不仅高效率且安全（如果你执意要使用服务器来运行以太坊客户端，这个项目也支持）。

安装

composer.json

{
    "require": {
        "myxtype/ethereum-client": "dev-master"
    }
}

然后composer update即可。

或者直接 composer require myxtype/ethereum-client:dev-master

使用

详细使用请参考examples文件夹

你可以在这里：https://infura.io/docs 看到更多可使用的RPC方法。

初始化

初始化你可以直接给一个RPC的连接地址，或者参考GuzzleHttp Options给出一些自定义的选项。

use xtype\Ethereum\Client as EthereumClient;

$client = new EthereumClient('https://kovan.infura.io/v3/a0d810fdff64493baba47278f3ebad27');
// or
// $client = new EthereumClient('http://127.0.0.1:8545');

GuzzleHttp Options.

$client = new EthereumClient([
    'base_uri' => 'https://kovan.infura.io/v3/a0d810fdff64493baba47278f3ebad27',
    'timeout' => 20,
]);

RPC

使用RPC接口非常简单，你直接参考 https://ethereum.gitbooks.io/frontier-guide/content/rpc.html 这里列出的接口使用。

你需要根据RPC文档设置参数，注意数字一般都需要转为十六进制。

// net_version
print_r($client->net_version());
// eth_getBlockByNumber
print_r($client->eth_getBlockByNumber('0x' . dechex(2), false));

你也可以使用额外的RPC方法，当然这需要你的私有节点，如果你用的公共节点则没有此方法。

print_r($client->personal_newAccount());

你可以直接使用这个类提供的离节点创建地址与私钥。

// You can to create an address offline
list($address, $privateKey) = $client->newAccount();

离线创建交易并用节点广播

你可以在你本地直接发送交易，而不需要私有节点，你只需要连接到公共节点就行。

// 1. Fill in the private key you want to use
// Like 'C34ADB7969999FE9FF327ED73E8A7CD58BF712CA12CC489DD533839229E567EB'
$client->addPrivateKeys(['C34ADB79691CBFE9FF327ED73E8A7CD58BF712C012CC489DD533839119E567EB']);
// 2. Build Your Transaction
$trans = [
    "from" => '0x69A34E519D9944CA7E3B55278a4EaF744769198C',
    "to" => '0x69A34E519D9944CA7E3B55278a4EaF744769198C',
    "value" => Utils::ethToWei('0.01', true),
    "data" => '0x',
];
// And you can set gas, nonce, gasPrice
$trans['gas'] = dechex(hexdec($client->eth_estimateGas($trans)) * 1.5);
$trans['gasPrice'] = $client->eth_gasPrice();
$trans['nonce'] = $client->eth_getTransactionCount('0x69A34E519D9944CA7E3B55278a4EaF744769198C', 'pending');

// 3. Send Your Transaction
// or use eth_sendTransaction if you need your server.
$txid = $client->sendTransaction($trans);

// 4. If there is no mistake
// you will see txid here. Like string(66) "0x1adcb80b413bcde285f93f0274e6cf04bc016e8813c8390ff31a6ccb43e75f51"
var_dump($txid);

// 5. And you will ...
// https://ethereum.gitbooks.io/frontier-guide/content/rpc.html#eth_gettransactionreceipt
var_dump($client->eth_getTransactionReceipt($txid));

ethereum-client's Issues

可以更新到支持eip1559嗎？

Utils类109行花括号7.4不支持了，可以修复下么

如何解决超过9个eth后，单位转换未wet后，超过php_int_max的问题

建议把ERC20代币的交易也能集成进来

如题，有个不错的库：
https://github.com/furqansiddiqui/erc20-php

请问如何生成keystore文件

请问作者如何生成keystore文件。JRC接口中貌似也没有看到相关接口或者形式。

生成了62位私钥 以及 对应的地址

while(true) { list($addr, $priv) = $client->newAccount(); if(strlen($priv)!=64) { echo $addr . ' , ' . $priv."\n"; break; } }

0x55bb178d9691f02afb4d6b897604d90aecaf95a9 , 35bb8f57473de5dd0a64bd11ce4ef9fe3208fee3511098aa7fc31c672e6a4b

发现在某些情况下， 会生成62位的私钥， 这样还能操作对应地址的账户吗？ 62位私钥在myetherwallet里是不认的。

老哥离线生成的地址有撞车的存在！

在生产环境中，发现用户并未充值，而且上账了，倒并未造成损失，只不过同一时间别人也使用此库，生成的地址和私钥撞车了，这个如何解决？可以在加密算法中自定义一个秘钥来防止此类问题么？