以太坊助记词PHP开发包

1、开发包概述

以太坊助记词PHP开发包用来为PHP以太坊应用增加助记词和层级确定密钥 支持能力，主要包括以下特性：

• 生成符合BIP39标准的助记词
• 将BIP39助记词转换为符合BIP32标准的层级确定密钥
• 支持BIP44多币种层级确定性钱包规范
• 兼容imtoken、metamask等常见钱包的助记词与密钥/地址转换

以太坊助记词PHP开发包运行在Php 7.1+环境下，当前版本1.0.0，主 要代码文件清单如下：

2、核心类使用说明

Mnemonic类是以太坊助记词PHP开发包的入口类，用于生成符合BIP39标准的助记词， 或者将已有的助记词转化为对应的随机熵值，以便用于私钥的生成。

Mnemonic类提供以下静态方法来进行实例化：

• new()：创建新的Mnemonic对象
• fromWords()：使用已有的助记词实例化Mnemonic对象
• fromEntropy()：使用已有的随机熵实例化Mnemonic对象

Mnemonic实例提供以下方法获取其表征的随机熵和助记词：

• getEntropy()：获取随机熵
• getWords()：获取助记词

HDKey类用来创建支持BIP32/BIP44标准的层级确定密钥，提供以下静态方法实例化：

• fromMnemonic()：使用助记词创建层级确定主密钥
• fromSeed()：使用种子数据创建层级确定主密钥

HDKey实例对象提供以下方法派生后代HDKey：

• deriveChild()：派生指定序号的子密钥
• derivePath()：派生指定层级路径的后代密钥

3、示例代码：生成新的助记词

下面的代码使用Mnemonic类的静态方法new()生成新的助记词，然后输出显示 所生成的助记词及其对应的随机熵：

use EthTool\Mnemonic;

$mnemonic = Mnemonic::new();                            /*创建新的助记词*/
echo 'mnemonic => ' . $mnemonic->getWords() . PHP_EOL;  /*显示助记词*/
echo 'entropy => ' . $mnemonic->getEntropy() . PHP_EOL; /*显示对应的随机熵*/

使用助记词生成层级主密钥并按照BIP44约定生成层级确定钱包的 第一个以太坊密钥及地址：

$master = HDKey::fromMnemonic($mnemonic->getWords());   /*利用助记词生成BIP32层级主密钥*/
$key0 = $master->derivePath("m/44'/60'/0'/0/0");        /*生成BIP44约定的第一个以太坊密钥路径对应的层级密钥*/
echo 'private key => ' . $key0->privateKey . PHP_EOL;   /*显示层级密钥对应的私钥，16进制字符串*/
echo 'address => ' . $key0->address . PHP_EOL;          /*显示层级密钥对应的以太坊地址*/

4、示例代码：导入已有的助记词

下面的代码使用Menmonic类的静态方法fromWords()导入已有的助记词，然后利用助记词 生成对应的层级密钥及BIP44以太坊钱包地址：

use EthTool\HDKey;

//助记词
$words = 'moral predict wash pledge hybrid box virtual length clap volcano shadow notice';

$master = HDKey::fromMnemonic($words);                  /*利用助记词生成BIP32层级主密钥*/
$key0 = $master->derivePath("m/44'/60'/0'/0/0");        /*生成BIP44约定的第一个以太坊密钥路径对应的层级密钥*/
echo 'private key => ' . $key0->privateKey . PHP_EOL;   /*显示层级密钥对应的私钥，16进制字符串*/
echo 'address => ' . $key0->address . PHP_EOL;          /*显示层级密钥对应的以太坊地址*/