钱包

钱包是NEO的基础组件，是用户接入NEO网络的载体，负责完成与之相关一系列的工作和任务。

NEO的钱包可以自行设计和修改，但需要满足一定的规则。

格式

私钥

私钥是一个随机生成的位于1和n之间的任何数字（n是⼀个常数，略小于2的256次方），一般用一个256bit(32字节)数表示。

在NEO中私钥主要采用两种编码格式：

• hexstring 格式

  hexstring 格式是将byte[]数据使用16进制字符表示的字符串。

• wif 格式

  wif 格式是在原有32字节数据前后添加前缀0x80和后缀0x01,并做Base58Check编码的字符串

Example:

公钥

公钥是通过ECC算法将私钥运算得到的一个点（X, Y）。该点的X、Y坐标都可以用32字节数据表示。NEO与比特币稍有不同，NEO选取了secp256r1曲线作为其ECC算法的参数。在NEO中公钥有两种编码格式：

• 非压缩型公钥

  0x04 + X坐标（32字节）+ Y坐标（32字节）

• 压缩型公钥

  0x02 + X坐标（32字节）或者 0x03 + X坐标（32字节）

Example:

上面的公钥（非压缩型）因为太长而成为多行，实际数据是连接的。

地址

地址是由公钥经过一系列转换得到的一串由数字和字母构成的字符串。在neo中，公钥到地址的转换步骤如下：

1. 构建地址脚本合约，脚本合约格式：

   0x21 (1字节,代表 OptCode.PUSHBYTES21 指令) + 压缩型公钥(33字节) + 0xac （1字节,代表 OptCode.CHECKSIG 指令)

2. 计算地址脚本合约哈希 (20字节，由地址脚本合约先做一次SHA256再做一次RIPEMD160得到)

3. 在地址脚本合约哈希前添加版本号（目前neo所使用的协议版本是23所以对应字节为 0x17 ）

4. 对字节数据做Base58Check编码

示例：

数字证书

数字证书是一个经证书授权中心数字签名的包含公开密钥拥有者信息以及公开密钥的文件。NEO使用X509格式的证书。

钱包文件

db3 钱包文件

db3钱包文件是neo采用sqlite技术存储数据所使用存储文件，文件尾缀名： .db3 。 文件中主要存储以下四个属性：

• PasswordHash ：密码的哈希，由密码做sha256得到

• IV ：AES的初始向量，随机生成

• MasterKey ：加密密文，由PasswordHash、 IV对私钥做AES256加密得到

• Version ：版本

db3钱包采用对称加密AES相关技术作为钱包的加密和解密方法。

NEP6 钱包文件

NEP6钱包文件是neo满足NEP6标准的钱包存储数据所使用存储文件，文件尾缀名： .json 。 json文件格式如下：

{
    "name": null,
    "version": "1.0",
    "scrypt": {
        "n": 16384,
        "r": 8,
        "p": 8
    },
    "accounts": [{
        "address": "AZ6AsQ42HLkzN1SdwDfWMfNdECN41QGvWP",
        "label": null,
        "isDefault": false,
        "lock": false,
        "key": "6PYKXU9ZkVTkdRzFdHUBH8SL6ESGS5SYx94UeYpeEUnG2z8H2Fvdh47EN9",
        "contract": {
            "script": "210209c86ad123403f7ddaa80f6b4c72e6f46607cabed5b2c297e27812cdd755f2c2ac",
            "parameters": [{
                "name": "signature",
                "type": "Signature"
            }],
            "deployed": false
        },
        "extra": null
    }, {
        "address": "AeiXnh6T47CQ5HwpJ9rE3CrMr6UT6VsGXt",
        "label": null,
        "isDefault": false,
        "lock": false,
        "key": "6PYUdZvc35rD9MetztTCScgwsGV81r167M1rMx5FeG5YLHSkmcTCGEShUh",
        "contract": {
            "script": "2102cb8f7571d8ed87f3a6c8c5af8bc0fbfababf4d9927dc8899af57bc362271c0a0ac",
            "parameters": [{
                "name": "signature",
                "type": "Signature"
            }],
            "deployed": false
        },
        "extra": null
    }],
    "extra": null
}

属性说明：

• name ：用户给该钱包添加的名称

• version ：钱包版本，目前固定为1.0，在以后功能升级时可能会改变

• scrypt （n/r/p）：scrypt算法设置计算性能的三个参数

• accounts ：钱包所包含的账户的集合

• address :账户地址

• label ：标题

• isDefault ：是否默认账户

• lock ：是否打开

• key ：按照NEP2标准加密的密钥nep2Key

• contract ：地址脚本合约的详细内容

• script ：地址脚本合约的字节

• parameters ：地址脚本合约的参数表

• parameters.name ：地址脚本合约参数的名称

• type ：地址脚本合约参数的类型

• deployed ：是否部署

• accounts.extra ：账户其他扩展属性

• extra ：钱包其他扩展属性

NEP6钱包采用了以scrypt为核心算法的相关技术作为钱包的加密和解密方法。

加密过程：

1. 由公钥计算地址，并获取 SHA256(SHA256(Address)) 的前四个字节作为地址哈希

2. 使用Scrypt算法算出一个 derivedkey ，并将其64个字节数据分成2半，作为 derivedhalf1 和 derivedhalf2 。Scrypt所使用参数如下：

   • 明文：输入的密码（UTF-8格式）

   • 盐：地址哈希

   • n：16384

   • r：8

   • p：8

   • length：64

3. 把私钥和derivedhalf1做异或，然后用derivedhalf2对其做AES256加密得到encryptedkey

4. 按照以下格式拼接数据，并对其做Base58Check编码得到NEP2Key：

   0x01 + 0x42 + 0xe0 + 地址哈希 + encryptedkey

解密过程：

1. 对NEP2key做Base58Check解码

2. 验证解码后数据长度为39，以及前3个字节（data[0-2]是否为0x01、0x42、0xe0）

3. 取data[3-6]作为 addresshash

4. 把密码、addresshash代入Scrypt算法，指定结果长度为64，求出 derivedkey

5. 把 derivedkey 前32字节作为 derivedhalf1 ，后32字节作为 derivedhalf2

6. 取data[7-38]作为 encryptedkey （32字节），并用derivedhalf2作为初始向量对其进行AES256解密

7. 把解密结果与Derivedhalf1做异或处理求得私钥

8. 把该私钥做ECC求出公钥，并生成地址，对该地址做2次Sha256然后取结果的前四字节判断其是否与addresshash相同，相同则是正确的私钥（参考NEP2）

相关详细技术请参照neo文档中的NEP2和NEP6提案。

NEP2提案： https://github.com/neo-project/proposals/blob/master/nep-2.mediawiki

NEP6提案： https://github.com/neo-project/proposals/blob/master/nep-6.mediawiki

钱包功能

钱包软件

全节点钱包

全节点钱包包含所有区块数据的备份，保存了所有链上数据，并且参与p2p网络通信，所以占用存储空间较大。

NEO-CLI 和 NEO-GUI 都是全节点钱包。

SPV钱包

SPV (Simplified Payment Verification, 简单支付验证)钱包不同于全节点钱包，它不会存储所有的区块数据，仅存储区块头数据，并使用布隆过滤器和梅克尔树算法。它主要在移动端App或者轻节点中使用，因为它能有效得节省存储空间。

如果要开发SPV钱包，请参考NEO网络协议接口。

使用：

1. SPV钱包发送一个布隆过滤器到全节点，全节点加载该布隆过滤器。

2. SPV钱包发送布隆过滤器的参数到全节点，全节点加载该布隆过滤器的参数。（可选）

3. SPV钱包从全节点查询交易，全节点在使用布隆过滤器过滤后返回交易数据和构造的梅克尔树路径。

4. SPV钱包使用梅尔克树路径来验证交易数据。

5. SPV钱包发送`clear the bloom filter`指令给全节点，全节点清楚该布隆过滤器。