本体技术视点 | 关于本体EVM合约开发，你必须知道的事（三）

上周，本体宣布支持 EVM 的测试网正式部署并向全球开发者开放 EVM 兼容公测。同时，与知名代码审计机构慢雾科技合作发布《本体安全漏洞与威胁情报赏金计划》（https://slowmist.io/en/ontology/）正式启动，上报单个有效漏洞奖励最高可达12,000美金。

上一期，我们介绍了在本体上开发和部署 EVM 合约的工具，以及如何使用 MetaMask 插件数据客户端来管理以太坊数据客户端。这一期，我们将为您带来本体 EVM 合约开发流程演示。

第四部分 EVM 合约开发流程演示

下面我们将使用 Hardhat 工具来演示在本体网络中开发部署和测试 EVM 合约的完整流程。

4.1 环境准备

• 安装 nodejs（https://nodejs.org/en/）
• 安装 Hardhat（https://hardhat.org/getting-started/）

4.2 合约设计

4.2.1 合约逻辑

我们将以一个红包合约为例，该合约主要提供以下功能：

• 发红包
• 领红包

每次发红包需要指定红包金额和该红包数量。

例如，红包总金额是100个通证，红包的数量是10，即有10个不同的地址领取红包。为了简单起见，我们设置每个红包金额相等， 也就是每个地址可以领10个通证。

根据以上的逻辑我们可以设置如下的存储结构：

EIP20Interface public Token; // support Token address uint public nextPacketId; // the next redpacket ID // packetId -> Packet, store all the redpacket mapping(uint => Packet) public packets; //packetId -> address -> bool, store receive redpacket record mapping(uint => mapping(address => bool)) public receiveRecords; struct Packet { uint[] assetAmounts;// Number of Tokens per copy uint receivedIndex; // Number of red packets received }

4.2.2 定义合约事件

在合约执行的过程中，我们可以通过添加事件来追溯合约执行流程。

在本例中我们设计以下两个事件：

• 发红包时，合约会生成红包的 ID，该 ID 要通过事件推送给调用者
• 领取红包时，需要推送一个事件用来记录领取的红包 ID 和 Token 数量

event SendRedPacket(uint packetId, uint amount); event ReceiveRedPacket(uint packetId, uint amount);

4.2.3 定义函数

sendRedPacket

1. 发红包。任何人都可以调用该接口，将一定量的通证打给该合约地址，从而其他的地址可以从该合约地址领取红包。

注意： 在调用该方法之前，需要先授权该合约地址能够从用户的地址把通证转移走，所以需要先调用该通证的 approve 方法。

function sendRedPacket(uint amount, uint packetNum) public payable returns (uint) { require(amount >= packetNum, "amount >= packetNum"); require(packetNum > 0 && packetNum < 100, "packetNum>0 && packetNum < 100"); uint before = Token.universalBalanceOf(address(this)); Token.universalTransferFrom(address(msg.sender), address(this), amount); uint afterValue = Token.universalBalanceOf(address(this)); uint delta = afterValue - before; uint id = nextPacketId; uint[] memory assetAmounts = new uint[](packetNum); for (uint i = 0; i < packetNum; i++) { assetAmounts[i] = delta / packetNum; } packets[id] = Packet({assetAmounts : assetAmounts, receivedIndex : 0}); nextPacketId = id + 1; emit SendRedPacket(id, amount); return id; }

receivePacket

2. 领取红包。任何地址都可以通过调用该接口领取红包，调用该接口的时候需要指定红包的 ID，即指定要领取的红包。

function receivePacket(uint packetId) public payable returns (bool) { require(packetId < nextPacketId, "not the redpacket"); Packet memory p = packets[packetId]; if (p.assetAmounts.length < 1) { return false; } require(p.receivedIndex < p.assetAmounts.length - 1, "It's over"); require(receiveRecords[packetId][address(msg.sender)] == false, "has received"); p.receivedIndex = p.receivedIndex + 1; bool res = Token.universalTransfer(msg.sender, p.assetAmounts[p.receivedIndex]); require(res, "Token transfer failed"); packets[packetId] = p; receiveRecords[packetId][address(msg.sender)] == true; emit ReceiveRedPacket(packetId, p.assetAmounts[p.receivedIndex]); return true; }

合约完整的代码请参考此链接：（https://github.com/ontio/ontology/tree/master/docs/specifications/evm_refernce/contract-demo/hardhatdemo/contracts）。

4.3 使用 Hardhat 编译和测试合约

4.3.1 创建 Hardhat 项目

mkdir hardhatdemo cd hardhatdemo npm init npm install --save-dev hardhat npx hardhat

4.3.2 修改 hardhat.config.js 文件

添加测试网节点配置信息

module.exports = {

defaultNetwork: "ontology_testnet",

networks: {

hardhat: {},

ontology_testnet: {

url: "http://polaris2.ont.io:20339",

chainId: 5851,

gasPrice:500,

gas:2000000,

timeout:10000000,

accounts: ["用户私钥1",

"用户私钥2"]

}

},

solidity: {

version: "0.8.0",

settings: {

optimizer: {

enabled: true,

runs: 200

}

}

},

};

accounts 字段指定的私钥数组，对应的地址需要有测试网的 ONG 来支付交易的手续费，可以在这里（https://developer.ont.io/）领取测试网 ONG。

4.3.3 文件准备

把红包合约代码文件放到 contracts 文件夹下，为了支持 ERC-20 数字资产的转账，我们还需要 EIP20Interface.sol，UniversalERC20.sol 和 TokenDemo.sol 文件，可以从此处（https://github.com/ontio/ontology/tree/master/docs/specifications/evm_refernce/contract-demo/hardhatdemo）下载相关文件。

4.3.4 在 test 文件夹下添加测试代码

describe("RedPacket", function () {

let TokenDemo, redPacket, owner, acct1, assetAmount, packetAmount; beforeEach(async function () { const TokenDemo = await ethers.getContractFactory("TokenDemo"); TokenDemo = await TokenDemo.deploy(10000000, "L Token", 18, "LT"); await TokenDemo.deployed(); const RedPacket = await ethers.getContractFactory("RedPacket"); redPacket = await RedPacket.deploy(TokenDemo.address); await redPacket.deployed(); [owner, acct1] = await ethers.getSigners(); assetAmount = 1000; packetAmount = 10; }); it("Token", async function () { expect(await redPacket.Token()).to.equal(TokenDemo.address); }); it("sendRedPacket", async function () { const approveTx = await TokenDemo.approve(redPacket.address, assetAmount); await approveTx.wait(); const sendRedPacketTx = await redPacket.sendRedPacket(assetAmount, packetAmount); await sendRedPacketTx.wait(); let balance = await TokenDemo.balanceOf(redPacket.address); expect(balance.toString()).to.equal(assetAmount.toString()); res = await redPacket.nextPacketId(); expect(res.toString()).to.equal("1"); await redPacket.connect(acct1).receivePacket(0); balance = await TokenDemo.balanceOf(acct1.address); expect(balance.toString()).to.equal((assetAmount / packetAmount).toString()); }); });

4.3.5 编译合约

在项目根目录执行如下命令编译合约

$ npx hardhat compile Compiling 5 files with 0.8.0 Compilation finished successfully

该命令执行完成后会生成如下的文件夹

├── artifacts ├── cache ├── contracts ├── hardhat.config.js ├── node_modules ├── package-lock.json ├── package.json ├── scripts └── test

4.3.6 测试合约

$ npx hardhat test

执行结果如下

$ npx hardhat test RedPacket ✓ Token ✓ sendRedPacket (16159ms) 2 passing (41s)

以上便是本体 EVM 合约开发的完整演示流程，希望我们提供的教程能够帮助到您。下期，我们将为您提供 Web3 API 参考，并教您如何使用 Ontology Bridge 本体跨链桥实现本体数字资产与以太坊数字资产的一键互跨，敬请期待。