自定义信息规则

存证合约的写入存证记录接口中，有2个参数用于向区块链写入数据：

  1. 存证信息，用于写入需要存证的业务数据的摘要值，推荐用密文；
  2. 自定义信息，可以写入800字节以内的任何数据，我们推荐写入对存证信息的属性描述等补充说明存证信息的扩展字段，推荐用明文。

本节是对自定义信息字段的使用建议，按照建议编写的信息，能够在区块链浏览器上更好的被解析和展示出来。

  • 首先，我们建议使用JSON格式拼接多个扩展字段；
  • 其次，我们考虑了常用的扩展字段，对其JSON属性名进行了标准化，请见下方“标准扩展字段”。

这是一个按照建议编写的自定义信息字段例子，业务背景是电子合同存证：

{
    "type":"file",
    "fileId":"201802030198",
    "URL":"https://www.business.com/file/201700045.pdf",
    "algorithm":"SHA256"
}

字段说明：

  • type: 存证类型
  • fileId: 文件编号
  • URL: 合同原文件存放路径
  • algorithm: 计算存证信息所使用的摘要算法

标准扩展字段

下表是常用扩展字段，请参考。

扩展字段属性 中文描述 扩展字段值格式
type 存证类型 file; dataHosting(数据托管);food; finance;goods
锚定模板
blockHeight 区块高度 最长10位整数
blockHash 区块哈希 String
txNum 交易数量 最长10位整数
电子合同存证模板
signatory 合同签约方 String
name 姓名 String
file 合同文件名 String
fileId 文件ID 最长10位整数
URL 文件存放路径 String
algorithm 摘要算法 String
date 日期 年月日，例：20170901
time 时间 年月日时分秒，格式为yyyymmddhhmmss,例： 20170901150000
溯源模板
date 日期 年月日，例：20170901
startDate 开始日期 年月日
endDate 结束日期 年月日
time 时间 年月日时分秒，例：20170901150000
startTime 开始时间 年月日时分秒
endTime 结束时间 年月日时分秒
place 地点 String
startPlace 出发地点 String
endPlace 到达地点 String
traceType 溯源步骤类别 String
Id ID、编码、序号
摇号模板
number 参与人数 最长10位整数
lotteryNo 期号 String
quota 配额 最长10位整数
name 姓名 String
慈善公示模板
name 慈善项目名称 String
totalAmount 捐款总额 最长8位整数加小数点及后2位
number 捐款用户数 最长10位整数
网贷信用查询模板
loantime 放贷时间 年月日
Loanperiod1 贷款期限（月） 最长3位数字
Loanperiod2 贷款期限（日） 最长4位数字
overdue 逾期 true/false
npl 不良贷款 true/false
其它字段
score 分数 最长3位数字
weight 重量 String
value 面值 String
material 材质 String
year 年份 4位数字
price 金额 String
operator 操作员 String
gHash 通用hash String
mHash 默克尔树根哈希 String
mHashStatus 世界状态默克尔树根哈希 String
mHashTx 交易默克尔树根哈希 String
mHashNum 余额类默克尔树根哈希 String
bankInfo 银行信息 String
bizId 业务流水号 最长10位整数
fee 费用 最长8位整数加小数点及后2位

数据托管扩展字段

数据托管是络谱提供的增值服务，合作方可以将区块链存证数据相关联的文件(如图片、视频等)保存在络谱运营方提供的云端存储空间。

使用数据托管服务对存证自定义信息的扩展字段有严格的要求，这是为了确保将托管文件和区块链存证信息关联起来，无法关联的文件将定期被统计出来。

以下是对数据托管及信息存证的扩展字段要求：

  1. 必须包含以下字段：type=dataHosting、URL=文件下载路径
  2. 可选择包含其他字段，如：algorithm（摘要算法）

results matching ""

    No results matching ""