EthTool运行在Php 7.1+环境下,当前版本1.0.0,主要代码文件清单如下:
<table class="table table-striped">
<thead>
<tr><th>代码文件</th><th>说明</th></tr>
</thead>
<tbody>
<tr><td>ethtool/src/Callback.php</td><td>RPC回调类</td></tr>
<tr><td>ethtool/src/Credential.php</td><td>身份标识类</td></tr>
<tr><td>ethtool/src/KeyStore.php</td><td>Keystore类,V3算法</td></tr>
<tr><td>ethtool/src/EthApi.php</td><td>以太坊交易接口基类</td></tr>
<tr><td>ethtool/src/EthApiEtherscan.php</td><td>Etherscan交易接口类</td></tr>
<tr><td>ethtool/src/EthApiWeb3.php</td><td>Infura/Web3交易接口类</td></tr>
<tr><td>ethtool/src/RawContract.php</td><td>裸交易合约类</td></tr>
<tr><td>ethtool/src/RawTxBuilder.php</td><td>裸交易构造器</td></tr>
<tr><td>test/demo-etherscan.php</td><td>裸交易演示代码,使用etherscan提交</td></tr>
<tr><td>test/demo-infura.php</td><td>裸交易演示代码,使用infura提交</td></tr>
<tr><td>test/demo-keystore.php</td><td>keystore演示代码</td></tr>
<tr><td>vendor</td><td>第三方依赖包目录</td></tr>
<tr><td>composer.json</td><td>composer配置文件</td></tr>
</tbody>
</table>
2. 使用说明
代码包的主要类如下:
RawTxBuilder: 裸交易构造器
Credential: 账户私钥与交易签名封装
EthApi: 以太坊交易接口封装
KeyStore: V3版本的keystore,兼容geth/parity
裸交易构造
使用RawTxBuilder的create()
静态方法获取一个构造器实例,例如:
$rtb = RawTxBuilder::create();
裸交易构造器需要绑定一个账户对象,使用credential()
方法:
$crendetial = Crendetial::fromKey('...'); $rtb->credential($credential);
RawTxBuilder目前支持三种裸交易的构造:
普通裸交易,例如以太币转账交易。使用
getPlaintx()
方法获取。合约部署裸交易,使用
getDeployTx()
方法获取。合约方法调用裸交易,使用
getSendTx()
方法获取。
例如,下面的代码生成合约部署裸交易:
$rawtx = RawTxBuilder::create() ->credential($credential) ->gasLimit('4000000') ->gasPrice('10000000000') ->chainId($chainId) ->nonce($nonce) ->contract($abi) //创建合约对象,一个RawContract实例 ->bytecode($bin) //设置合约对象的字节码 ->getDeployTx(1000000,'HAPPY COIN',0,'HAPY'); //获取部署裸交易码流
裸交易广播
EthApi基类目前定义以下方法,可以根据自己的需要扩充
getTransactionCount
sendRawTransaction
getTransactionReceipt
EthApiEtherscan是基于Etherscan服务的EthApi实现,EthApiWeb3是基于以太坊RPC的EthApi
实现。例如,下面的代码使用Etherscan在rinkeby测试链部署前面获得的裸交易:
$eth = new EthApiEtherscan($your_api_key/*etherscan api key*/,4/*rinkeby*/); $txid = $eth->sendRawTransaction($rawtx);
KeyStore读写
KeyStore类可以读取geth/parity生成的keystore文件,其生成的
keystore文件也可以被geth/parity读取。
使用KeyStore类的静态方法save()
将私钥转化为keystore格式写入指定目录:
$credential = Credential::new(); $prv = $credential->getPrivateKey(); $fileName = KeyStore::save($prv,'123','./keystore')
使用KeyStore类的静态方法load()
载入指定的keystore文件并解密私钥:
$fileName = './keystore/....'$prv = KeyStore::load($fileName,'123');
作者:编程狂魔
链接:https://www.jianshu.com/p/7368f87b979e