2023年区块链职业技能大赛——区块链应用技术(二)模块二

模块二：智能合约开发与测试

   选手完成本模块的任务后，将任务中设计结果、运行代码、运行结果等截图粘贴至客户端桌面【区块链技术应用赛\重命名为工位号\模块二提交结果.docx】中对应的任务序号下。

任务2-1：智能合约设计

  根据区块链供应链金融应用需求分析和方案设计文档的描述，编写该区块链产品的智能合约功能需求文档，以及设计该智能合约UML图，具体要求如下：

  1.编写区块链供应链金融智能合约功能需求文档

  根据区块链供应链金融产品项目背景和需求分析，编写该区块链供应链金融产品的智能合约功能需求文档；

参考答案：略

  2.完成区块链供应链金融智能合约的设计图

  设计区块链供应链金融智能合约接口，画出区块链供应链金融智能合约的角色UML用例图，以及画出区块链供应链金融各角色智能合约关系的时序图。

参考答案：略

任务2-2：智能合约开发

  使用Solidity语言完成智能合约开发、部署和调用，要求如下：

1.供应链金融实体信息编码
（1）编写供应链金融智能合约的实体接口，完成实体通用数据的初始化，实现企业和票据实体信息上链的功能；

表2.2.2.1 SupplyChain实体说明

名称	类型	说明
companyName	string	公司名称
companyAddress	address	公司地址
creditAsset	uint	信用资产
acceptReceiptIndex	uint[]	接收的凭证
sendReceiptIndex	uint[]	发送的凭证
senderAddress	address	发送票据的地址
accepterAddress	address	接收票据的地址
receiptType	uint8	凭证类型
transferType	uint8	交易类型
amount	uint	交易数量

//公司信息结构体

    struct Company {

        //①公司名称

        //②公司地址

        //③信用资产

        //④接收的凭证

        //⑤发送的凭证

    }

//数字发票收据信息

    struct Receipt {

        //⑥发送票据的地址

        //⑦接收票据的地址

        //⑧凭证类型

        //⑨交易类型

        //⑩交易数量

    }

参考答案：

（2）编写企业上链信息接口，实现供应链金融的企业信息上链；

function addCompany(string name, address companyAddress) returns(bool) {

        //①实例化公司

        //②添加公司地址

        //③将实例化的公司添加到公司映射

        //④返回添加成功标识

    }

（3）基于给定的智能合约代码以及注释，完成银行向企业交易的接口函数；

function bankToCompanyReceipt(address senderAddress, address accepterAddress, uint amount, uint8 receiptType) returns(uint) {

①判断接收地址存在

        ②实例化银行

        ③实例化公司

        if (keccak256(bank.bankName) == keccak256("")) {

            return 404001;

        }

        

        //确认公司存在

        if (keccak256(company.companyName) == ④) {

            return 404002;

        }

        

        if (bank.creditAsset < amount) {

            return 500001;

        }

2.供应链金融公司与公司接口编码
（1）编写公司与公司之间进行交易的历史存证上链接口，实现公司与公司之间的交易功能；

function companyToCompanyReceipt(①, address accepterAddress, uint amount, uint8 receiptType) returns(uint) {

        

        //②接收地址判断

        Company memory senderCompany = companyMap[③];

        Company memory ④ = companyMap[accepterAddress];

        //确认发送公司存在

        if (keccak256(senderCompany.⑤) == keccak256("")) {

            return 404001;

        }

        

        //确认接收公司存在

        if (keccak256(accepterCompany.companyName) == ⑥) {

            return 404002;

        }

        

        //如果存证接收的公司资产小于存证数额，那么就不能交易发送存证

        if (accepterCompany.creditAsset ⑦ ⑧) {

            return 500001;

        }
（2）编写创建存证的接口，实现创建存证的功能；

Receipt memory newReceipt = Receipt(①, accepterAddress, receiptType, 2, amount);

        receiptIndex += 1;

        //记录存证（存证Map，公司Map对应地址的发送和接收存证列表）

        receiptMap[receiptIndex] = ②;

        companyMap[③].sendReceiptIndex.push(receiptIndex);

        companyMap[accepterAddress].acceptReceiptIndex.push(④);

（3）编写交易金额数量变化的接口，实现凭证交易双方资金的变化功能；

companyMap[①].creditAsset ② amount;

        companyMap[③].creditAsset ④ amount;

        return 200;

    }

3.供应链金融公司与银行交易的接口编码
（1）编写公司与银行之间进行交易的历史存证上链接口，实现公司与银行之间的交易功能；（2分）

function companyToBankReceipt(address senderAddress, ①, uint amount, uint8 receiptType) returns(uint) {

        ②

        

        Bank memory bank = bankMap[senderAddress];

        Company memory accepterCompany = companyMap[③];

        

        //确认发送公司存在

        if (keccak256(bank.bankName) == ④) {

            return 404001;

        }

        

        //确认接收公司存在

        if (keccak256(accepterCompany.companyName) == keccak256("")) {

            return 404002;

        }

        

        //如果存证接收的公司资产小于存证数额，那么就不能交易发送存证

        if (accepterCompany.creditAsset < amount) {

            return 500001;

        }
（2）编写创建存证的接口，实现创建存证的功能；

//创建存证

        Receipt memory newReceipt = Receipt(senderAddress, accepterAddress, ①, 3, amount);

        receiptIndex ② 1;

        receiptMap[③] = newReceipt;

        bankMap[senderAddress].sendReceiptIndex.push(receiptIndex);

        companyMap[accepterAddress].④;

（3）编写交易金额数量变化的接口，实现凭证交易双方资金的变化功能；

bankMap[senderAddress].① ② amount;

companyMap[accepterAddress].③ ④ amount;

        return 200;

}

1. 合约编译、部署和调用

（1）解决代码错误和警告，正确编译并部署合约，成功获取部署的合约地址和abi。

（2）调用食品溯源智能合约的接口，完整验证业务流程。

任务2-3：智能合约测试

编写智能合约单元测试代码并完成合约功能测试、性能测试，具体要求如下：

1.配置区块链网络

  启动Ganache软件，创建新的Wordspace，配置对外访问的RPC接口为7545，配置项目的truffle-config.js实现与新建Workspace的连接。

2.补充给定基础代码中注释提示的部署逻辑

  基于VSCODE加载的Truffle项目，补全位于test文件夹中HelloWorld.js文件预操作的方法。在测试文件中添加预定义的方法（在其他方法启动前使用）。

3.补充代码中注释提示的测试逻辑

  基于VSCODE加载的Truffle项目，补全位于test文件夹中HelloWorld.js文件，添加测试用例，测试智能合约的get方法。

4.测试hello.get()方法

  基于VSCODE加载的Truffle项目，补全位于test文件夹中HelloWorld.js文件，添加测试用例，测试智能合约的hello.get()方法。

5.测试.should.equal进行对比判断

  基于VSCODE加载的Truffle项目，补全位于test文件夹中HelloWorld.js文件，添加测试用例，测试智能合约的equal字符串比较方法。