教程2

出价信息的数据结构

现在,设计一个新的数据结构来保存买家的密封出价。可以创建一个结构体() 来保存密封出价信息:

注意,结构体里面的字段是竞价者支付给合约的保证金,而不是其真实出价: 真实出价目前是不可知的,我们暂时只知道转入合约的保证金数量,用它来填充 字段。

为了方便在拍卖结束后筛选赢家、返还投标保证金等操作,我们可以在 结构构中加入一个新的成员,用来记录一个商品的所有竞价信息:

状态是一个嵌套的映射表,它将竞价者的账户地址映射到买家对该商品的 密封出价表中。为了便于理解,同样不妨把它视为如下的二维表格:

提交密封出价

在竞价期间,买家调用合约的密封出价方法来提交其出价哈希值。 方法定义如下

由于买家调用方法提交密封出价时,需要同时向合约转入保证金,因此 需要为这个方法声明关键字。

密封出价方法的实现逻辑非常简单直白 —— 检查是否满足执行条件,然后保存密封出价信息:

参考实现代码如下:

注意全局变量,它表示当前块的时间戳。也就是说,当 函数被调用时,一笔交易将被创建, 这笔交易会被矿工打包到一个块里。每个块都有一个对应的时间戳,用来声明这个块被挖出来的时间。 就等同于那个时间戳。

表示买家调用合约的方法出价时支付的保证金数额,显然,我们需要这个保证金 要高于卖家设定的起拍价格才有意义。

揭示真实出价

在拍卖过了截止时间之后,买家需要调用合约的方法来提交之前被密封 (未透露)的真实出价。方法定义如下:

为了验证买家是否虚报其在竞价期间的真实出价,买家除了提交参与竞价的商品编号和 声称的真实出价外,还需要传入提交密封出价时所选用的密文。

与相比,函数的实现稍微要复杂一点,我们先看一下逻辑流程:

依照惯例,我们还是先检查是否满足运行条件。只有在拍卖截止后才可以 揭示真实出价。然后利用买家提交的出价和密文,通过哈希值的重算和比较 来确认买家曾经在竞价期间提交过该出价。 一旦确定了生成的出价有效,就可以更新竞价结果了,这包括选出新的最高出价人、 最高出价和次高出价。 如果买家不可能胜出(不是最高出价人),则将其保证金原路返还。

可供参考的实现代码如下:

在所有情况中,我们会返还保证金与实际出价的差额,也就是,如果 Alice 出价 10 美元,但 是交了15 美元的保证金,在揭示出价以后,将会返回给 Alice 5 美元。

哈希算法

在之前,我们谈到了对出价信息(出价金额、密文)进行哈希计算。 是一个密码学上的哈希函数, 对于任何长度的任意字符串,它都可以生成一个32字节字符串。

让我们来看一下为什么这对我们的场景十分有用(生成密封出价)。为了生成一个密封出价,我们 将在前端使用库的函数。如果 Alice 想要生成一个出价,只需要 在前端调用 函数,传入她的出价和密文即可:

这个输出就是要传入 函数的 字符串。任何看到该字符串的人都不可能知道 Alice 的真实出价是 10.5美元。

字符串转整数

由于在揭示出价时,买家声称的出价是一个字符串,因此我们实现一个简单的函数 将其转换为整型:

嗯,这可能有点让人意外,居然没有内置实现从字符串到整数的转换。 另外一点,由于不需要从合约外部调用这个方法,因此它的可视性声明为。

获取竞价结果

现在我们实现两个简单的方法,分别返回最高出价者信息和出价总人数。 这些信息将会用于在网页显示竞价结果,同时也有助于在 truffle 控制台进行测试。

获取竞价结果

函数用来返回竞价结果,这包括最高价买家的账户地址、 最高出价和次高出价:

我们使用关键字来指定变量的存储位置,是为了在函数执行完毕时 自动清理该变量。

获取参与者总人数

函数用来返回合约记录的竞价参与人数,也就是状态的值:

控制台与脚本交互测试

首先确保在终端1#已经启动了节点仿真器:

然后编译并部署修改后的合约,进入truffle终端:

注意,由于我们要重新部署合约,因此在部署合约时,使用了参数。 由于合约的竞价依赖于历史状态,因此在你尝试运行下面的代码之前,记得一定 要重新启动节点仿真器,或者使用参数。

添加商品测试数据

向区块链插入一个商品,并将拍卖结束时间设置为从现在算起 200 秒:

密封出价

提供了 10 个测试账户,让我们用不同的账户出价。我们使用 包的函数计算哈希值:

检查账户余额

当你对商品出价以后,使用 web3.eth.getBalance 检查 accounts[0] 和 accounts[1] 的余额:

你会注意到它们的余额大概是 97 ETH 和 96 ETH。这两个账户的出价分别 2 ETH 和 3 ETH, 但是各自支付了 3 ETH 和 4 ETH的保证金。如果代码如期工作,当我们揭示出价时,差价应该返还给 这些账户。

揭示出价

前面已经设置拍卖在200 秒后结束,让我们等到拍卖结束,然后揭示真实出价:

查看拍卖结果

现在调用合约的方法来查看是谁赢得了拍卖:

你应该可以看到 为最高出价 3 ETH 的出价者(赢家),次高出价是 2 ETH。

此时,所有失败的出价者将会收到返还的保证金。赢家的出价资金仍然在合约账户里。 在后续的课程中,我们将会使用托管合约来管理赢家的资金。

在预置代码中,是等价的测试验证脚本,你可以拷贝到 项目目录直接运行:

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180505G0Y38F00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券