• 学历认证
    • 功能描述
    • 数据结构设计
    • function及各自实现的功能
    • 接口设计
    • 测试

    学历认证

    功能描述

    该 智能合约 实现了一个简单的征信管理的案例。针对于学历认证领域,由于条约公开,在条约外无法随意篡改的特性,天然具备稳定性和中立性。

    该智能合约中三种角色如下:

    • 学校
    • 个人
    • 需要学历认证的机构或公司

    学校可以根据相关信息在区块链上为某位个人授予学历,相关机构可以查询某人的学历信息,由于使用私钥签名,确保了信息的真实有效。为了简单,尽量简化相关的业务,另未完成学业的学生因违纪或外出创业退学,学校可以修改其相应的学历信息。

    账户私钥应该由安装在本地的客户端生成,本例中为了简便,使用模拟私钥和公钥。

    数据结构设计

    • 学校
      • 名称
      • 所在位置
      • 账号地址
      • 账号公钥
      • 账户私钥
      • 学校学生
    • 个人
      • 姓名
      • 账号地址
      • 过往学历
    • 学历信息
      • 学历信息编号
      • 就读学校
      • 就读年份
      • 完成就读年份
      • 就读状态 // 0:毕业 1:退学
    • 修改记录(入学也相当于一种修改记录)
      • 编号
      • 学校账户地址(一般根据账户地址可以算出公钥地址,然后可以进行校验)
      • 学校签名
      • 个人账户地址
      • 个人公钥地址(个人不需要公钥地址)
      • 修改时间
      • 修改操作// 0:正常毕业 1:退学 2:入学

    对学历操作信息所有的操作都归为记录。

    function及各自实现的功能

    • init 初始化函数
    • invoke 调用合约内部的函数

    • updateDiploma 由学校更新学生学历信息,并签名(返回记录信息)

    • enrollStudent 学校招生(返回学校信息)
    • createSchool 添加一名新学校
    • createStudent 添加一名新学生
    • getStudentByAddress 通过学生的账号地址访问学生的学历信息
    • getRecordById 通过Id获取记录
    • getRecords 获取全部记录(如果记录数大于 10,返回前 10 个)
    • getSchoolByAddress 通过学校账号地址获取学校的信息
    • getBackgroundById 通过学历 Id 获取所存储的学历信息

    • writeRecord 写入记录

    • writeSchool 写入新创建的学校
    • writeStudent 写入新创建的学生

    接口设计

    createSchool

    request参数:

    1. args[0] 学校名称
    2. args[1] 学校所在位置

    response参数:

    1. 学校信息的字节数组,当创建一所新学校时,该学校学生账户地址列表为空

    createStudent

    request参数:

    1. args[0] 学生的姓名

    response参数:

    1. 学生信息的字节数组表示,刚创建过往学历信息列表为空

    updateDiploma

    request参数

    1. args[0] 学校账户地址
    2. args[1] 学校签名
    3. args[2] 待修改学生的账户地址
    4. args[3] //对该学生的学历进行怎样的修改,0:正常毕业 1:退学

    response参数

    1. 返回修改记录的字节数组表示

    enrollStudent

    request参数:

    1. args[0] 学校账户地址
    2. args[1] 学校签名
    3. args[2] 学生账户地址

    response参数

    1. 返回修改记录的字节数组表示

    getStudentByAddress

    request参数

    1. args[0] address

    response参数

    1. 学生信息的字节数组表示

    getRecordById

    request参数

    1. args[0] 修改记录的ID

    response参数

    1. 修改记录的字节数组表示

    getRecords

    response参数

    1. 获取修改记录数组(如果个数大于10,返回前10个)

    getSchoolByAddress

    request参数

    1. args[0] address

    response参数

    1. 学校信息的字节数组表示

    getBackgroundById

    request参数

    1. args[0] ID

    response参数

    1. 学历信息的字节数组表示

    测试