一、文章结构

本文将通过上、中、下三篇文章带领大家一步步开发实现一个中心化的Oracle服务，并通过一个抽奖合约演示如何使用我们的Oracle服务。文章内容安排如下：

• 上篇：Oracle简介及合约实现
• 中篇：使用go语言开发Oracle服务
• 下篇：抽奖合约调用Oracle服务示例

前两篇文章中，我们实现了Oracle合约，开发了Oracle服务，在这边文章中，我们以一个抽奖合约为例，介绍在抽奖合约中，怎么通过Oracle服务获取一个随机数（中奖数）。

二、联调准备

首先我们需要搭建测试环境、部署合约、运行服务。我是在本地进行联调测试的，可以参考我的环境。

1、区块链网络

我使用的是ganache，在本地创建了一个以太坊私链。
ganache的按照和使用详见官方文档：https://www.trufflesuite.com/ganache

2、部署合约

区块链网络创建好后，需要把我们的Oracle合约和抽奖合约部署到网络上。我用的是Remix，链接到本地网络进行部署的。

如下图所示。

image.png

大家也可以使用Truffle工具进行合约的自动化部署

2.1 部署Oracle合约

Oracle合约源码地址：https://github.com/six-days/ethereum-contracts/blob/master/oracle/Oracle.sol

这里我部署后的合约地址为：0xcb6a9baeb203a19d391d5f3db7040fe2ac4f8b82

2.2 部署抽奖合约

抽奖合约源码地址：https://github.com/six-days/ethereum-contracts/blob/master/oracle/Lottery.sol

这里我部署后的合约地址为：0x7058f4f12ba53a13617de57d2271f64f2621e503

2.3 初始化抽奖合约

调用setOracle方法，将我们的Oracle合约地址配置到抽奖合约中。

image.png

3、 运行Oracle服务

合约部署完成后，就可以配置我们的Oracle服务并启动了。

Oracle服务源码地址：https://github.com/six-days/ethereum-oracle-service

将源码下载下来后，按照说明进行编译。

3.1 修改服务配置文件

配置文件需要有三项，分别是：

• OracleContractAddress Oracle合约地址
• NetworkWS 以太坊网络的ws地址
• PrivateKey Oracle合约的部署（owner）以太坊账户私钥

编辑好配置信息后，保存到文件中。如下图所示。

image.png

3.2 运行Oracle服务

服务启动命令：

./oracle-service -c ./conf/app.conf -l logs/

其中：

• -c表示配置文件地址
• -l表示日志存储目录

启动后如下图所示。

image.png

此时我们的Oracle服务已经开始监控Oracle合约的事件了。

三、抽奖合约

在联调前，我先简单介绍下抽奖合约。

玩法是每个用户向合约提交一个数字（默认>=0，<=30，根据每轮中运行的下注个数决定），调用enterNumber投注。

当下注的数字个数超过每一轮允许的个数后（默认3个），管理员就可以调用runRound方法进行开奖。

    /**
     * @dev 开奖
     */
    function runRound(uint256 _roundTimes) public onlyOwner {
        require(oracleRequests[_roundTimes] == -3, "oracle random request has send or not ready!");
        bytes memory requestData = bytes("{\"url\":\"https://www.random.org/integers/?num=1&min=0&max=30&col=1&base=10&format=plain&rnd=new\",\"responseParams\":[]}");
        oracle.query.value(ORACLE_FEE)(bytes32(_roundTimes), address(this), "getOracelRandom(bytes32,uint64,uint256)", requestData);
        oracleRequests[_roundTimes] = -2; // 表示已请求oracle服务，等待返回结果
    }

在runRound方法中，会调用Oracle合约，请求一个随机数。这里随机数是通过www.random.org网站获取。

Oracle服务获取到随机数后，回调抽奖合约的getOracelRandom方法。代码如下。

/**
     * @dev oracle服务回调函数
     */   
    function getOracelRandom(bytes32 _reqId, uint64 _stateCode, uint256 _randomNum) external onlyOracle returns(bool) {
        emit OracleResponse(_reqId, _stateCode, _randomNum);
        uint256 _roundTimes = uint256(_reqId);
        require(numbers.length >= _roundTimes*oneRoundPlayers, "invalid reqId!");
        require(oracleRequests[_roundTimes] == -2, "not ready to get oracle random response!");
        if (_stateCode == 1) {
            oracleRequests[_roundTimes] = int256(_randomNum);
            for (uint256 i = (_roundTimes-1)*oneRoundPlayers; i < _roundTimes*oneRoundPlayers; i++) {
                if (numbers[i] == _randomNum) {
                    roundWinner[_roundTimes].push(i);
                }
            }
        } else {
            oracleRequests[_roundTimes] = -1;
        }
    }

getOracelRandom方法会根据Oracle服务返回的随机数，判断中奖者。这里我只是标识了中奖者，并没有给中奖者发奖。

四、联调

1、向抽奖合约提交数字

在remix里调用抽奖合约的enterNumber方法，提交时除了数字外，需要最少100 szabo的以太币。
如下图所示。

image.png

2、调用Oracle合约

当向抽奖合约发送至少3个数字后，查看roundTimes(表示第几轮)已经大于0。这时调用runRound方法进行开奖。

3、查看Oracle服务

调用开奖方法后，会向我们的Oracle合约请求一个随机数。这时回到Oracle服务中，可以看到请求日志。如下图所示。

image.png

从上图可以看到，我们的Oracle服务已经获取到Oracle合约中的事件，并且根据用户查询信息查询到一个随机数11，并且把这个随机数回调给了用户，交易hash是0x3060d0ebcb61666199379dc7f8ad7cf06e6b306fbf172d7d0d44871b02ce73c8 。

4、抽奖合约中验证

抽奖合约的oracleRequests变量中保存这Oracle合约的请求id和对应的结果。我们通过调用该方法进行验证，如下图所示。

image.png

至此，我们抽奖合约和Oracle服务联调完毕，可以愉快的使用了。

相关的代码都已放到github上，如有需要请自取。自取时记得点个star，感谢！

Oracle服务代码：https://github.com/six-days/ethereum-oracle-service

Oracle合约代码：https://github.com/six-days/ethereum-contracts