NEO改进协议提案6(NEP-6)

135 阅读3分钟

文章目录

  • 摘要
  • 动机
  • 基本原理
  • 详述
    • 钱包
    • Scrypt参数
    • 账户
    • 合约
  • 向后兼容性
  • 实现

摘要

本NEP描述了一个钱包标准用于钱包文件在NEO多种实现间的兼容。

动机

目前,不同的客户端程序生成不同的钱包文件。它们具有不同的文件格式,不同的存储方式以及不同的加密方式。用户很难在不同的客户端程序之间进行迁移,因为钱包文件的格式不同。尽管可以通过导出私钥来实现迁移,但是对于具有多个私钥的钱包来说是很麻烦的。我们需要一种通用钱包格式,允许用户安全轻松地跨所有平台迁移,而无需更改钱包文件或导出私钥。

基本原理

钱包标准应考虑安全性和跨平台兼容性。为了安全起见,我们要求实现使用NEP-2机制来加密或解密私钥。对于跨平台,我们使用JSON格式来描述钱包文件,以便可以在每个平台上轻松识别钱包文件的内容。

详述

钱包

Json格式的钱包文件具有以下的基础结构:
{
“name”: “MyWallet”,
“version”: “1.0”,
“scrypt”: {},
“accounts”: [],
“extra”: null
}
name是用户对钱包文件所做的标签。
version目前固定为1.0,将来用于功能性升级。
scrypt是一个ScryptParameters对象,用于描述钱包私钥加密解密用的SCrypt算法的参数。
accounts是一个Account对象数组,用于描述钱包中每个帐户的详细信息。
extra是由客户端的实现者定义,用于存储额外的数据。该字段可以为null。

Scrypt参数

ScryptParameters 对象具有一下结构:
{
“n”: 16384,
“r”: 8,
“p”: 8
}
n是定义CPU /内存开销的参数。必须是2 ^ N的值。
r是调整参数。
p是调整参数(并行参数)。大的p值可以在不增加内存使用量的情况下增加SCrypt的计算成本。

账户

账户对象具有以下结构:
{
“address”: “AQLASLtT6pWbThcSCYU1biVqhMnzhTgLFq”,
“label”: “MyAddress”,
“isDefault”: true,
“lock”: false,
“key”: “6PYWB8m1bCnu5bQkRUKAwbZp2BHNvQ3BQRLbpLdTuizpyLkQPSZbtZfoxx”,
“contract”: {},
“extra”: null
}
address 是账户的base58编码地址
label是用户对钱包做的标签
isDefault 代表账户是否是默认找零地址
lock表示帐户是否被用户锁定。客户端不能花费锁定帐户中的资金。
key是帐户私钥的NEP-2格式。此字段可以为空(仅限观察地址或非标准地址)。
contract是一个Contract对象,用于描述合约的细节。该字段可以为null(仅限监视地址)。
extra是由客户端的实现者定义的用于存储额外数据的对象。该字段可以为null。

合约

合约对象有以下结构:
{
“script”: “21036dc4bf8f0405dcf5d12a38487b359cb4bd693357a387d74fc438ffc7757948b0ac”,
“parameters”: [],
“deployed”: false
}
script是合约的脚本代码。如果合约已经被部署在区块链上,则该值可以为null。
parameters是参数对象数组,用于描述合约函数中每个参数的细节。需要更多参数对象的信息,可以查看NEP-3:NeoContractABI中的描述。

向后兼容性

所有旧格式的钱包必需可以轻易转换成这种新的JSON格式。如果这些钱包文件包含额外的数据,可以被存储在extra值中。

实现

• neo-project/neo: github.com/neo-project…
• CityOfZion/neon-js: github.com/CityOfZion/…

原文链接:github.com/neo-project…