在Moonbeam上运行Chainlink预言机节点¶
概览¶
作为一个开放、无许可的网络，任何人都可以在Moonbeam上运行预言机，为智能合约提供数据。
本文概述了在Moonbase Alpha上设置Chainlink预言机的流程。
注意事项
文中所用示例仅作演示用途。请务必妥善管理密码，请勿将密码储存在纯文本中。文中示例均在Ubuntu 18.04环境下运行，但也有包含了MacOs的调用。本教程仅适用于开发设置，并不适用于生产环境。
此处提供的信息仅供参考，由第三方提供。 Moonbeam文档网站(https://docs.moonbeam.network/)上列出和描述的任何项目与Moonbeam立场无关。
基本请求模型¶
在开始获取数据本身之前，您必须先了解“基本请求模型”的基础信息。从Chainlink预言机请求和接收数据的一般流程如下所示：
-
客户合约创建并向Chainlink预言机发出数据请求
-
请求通过LINK Token合约的
transferAndCall函数发出。LINK Token是一个符合ERC-677的Token，即允许转移Token并将请求传输给预言机合约 -
转移Token后，LINK合约将调用预言机合约的
onTokenTransfer函数 -
预言机合约由预言机节点运营者管理，负责处理通过LINK Token发出的链上请求。预言机合约收到请求后，将会向节点发出一个事件，并由该节点执行操作
-
预言机节点完成请求后，节点使用预言机合约的
fulfillOracleRequest函数，通过在原始请求中定义的回调函数将结果返回给客户合约
当通过客户合约创建数据请求后，需要传入以下参数以确保交易能够进行并返回正确信息：
- Oracle address —— 预言机节点部署合约的地址
- Job ID —— 要执行的任务。一个预言机节点有一组Job ID，其中每个Job对应一个用户可以请求的任务，例如：获取喂价
- Payment —— 预言机为完成请求而收到的LINK Token款项
高级用户¶
如果您已经熟悉如何运行Chainlink预言机节点，可以通过以下信息快速进行Moonbase Alpha测试网部署：
- Chainlink文档：运行一个Chainlink节点
- Moonbase Alpha WSS EndPoint:
wss://wss.api.moonbase.moonbeam.network - Moonbase Alpha ChainId:
1287(hex:0x507) - Moonbase Alpha上的LINK Token地址:
0xa36085F69e2889c224210F603D836748e7dC0088 - 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试
查看先决条件¶
请先准备以下条件后再按照本教程进行操作：
- 为运行Postgres DB和Chainlink节点容器安装Docker
- 带资金的账户。您可以在MetaMask创建一个账户。 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试
- 访问Remix IDE，如您想要使用该程序部署预言机合约。更多信息，请查阅使用Remix部署至Moonbeam教程
如何操作¶
本教程将介绍设置预言机节点的步骤，简单概括如下：
- 设置一个与Moonbase Alpha连接的Chainlink节点
- 给节点注入资金
- 部署预言机合约
- 在节点上创建Job
- 绑定节点与预言机
- 使用客户端合约进行测试
节点设置¶
请执行以下步骤开始设置节点：
-
创建一个新目录，将所有必要文档放入目录内
mkdir -p ~/.chainlink-moonbeam && cd ~/.chainlink-moonbeam -
用Docker创建Postgres DB (MacOS users请将
--network host \替换为-p 5432:5432)docker run -d --name chainlink_postgres_db \ --volume chainlink_postgres_data:/var/lib/postgresql/data \ -e 'POSTGRES_PASSWORD={YOUR-PASSWORD-HERE}' \ -e 'POSTGRES_USER=chainlink' \ --network host \ -t postgres:11请确保将
{YOUR_PASSWORD_HERE}替换为真实的密码。如果尚未下载必要的镜像，Docker将继续下载 -
在
chainlink-moonbeam目录下创建Chainlink环境文档。该文档将在Chainlink容器创建过程中被读取。MacOS用户请将localhost替换成host.docker.internalecho "ROOT=/chainlink LOG_LEVEL=debug ETH_CHAIN_ID=1287 MIN_OUTGOING_CONFIRMATIONS=2 LINK_CONTRACT_ADDRESS={LINK-TOKEN-CONTRACT-ADDRESS} CHAINLINK_TLS_PORT=0 SECURE_COOKIES=false GAS_UPDATER_ENABLED=false ALLOW_ORIGINS=* ETH_URL=wss://wss.api.moonbase.moonbeam.network DATABASE_URL=postgresql://chainlink:{YOUR-PASSWORD-HERE}@localhost:5432/chainlink?sslmode=disable MINIMUM_CONTRACT_PAYMENT=0" > ~/.chainlink-moonbeam/.env除了密码（
{YOUR_PASSWORD_HERE}）以外，还需要提供LINK Token合约（{LINK TOKEN CONTRACT ADDRESS}）。 -
创建
.api文档来储存用户和密码，用于进入节点API、节点运营用户界面以及Chainlink命令模式touch .api -
设置一个邮件地址和另一个密码
echo "{AN-EMAIL-ADDRESS}" > ~/.chainlink-moonbeam/.api echo "{ANOTHER-PASSWORD}" >> ~/.chainlink-moonbeam/.api -
最后，还需要另一个文档来储存节点地址的钱包密码
touch .password -
Set the third password
设置第三个密码
echo "{THIRD-PASSWORD}" > ~/.chainlink-moonbeam/.password -
激活容器（MacOS用户请将
--network host \替换成-p 6688:6688）docker run -d --name chainlink_oracle_node \ --volume $(pwd):/chainlink \ --env-file=.env \ --network host \ -t smartcontract/chainlink:0.9.2 \ local n \ -p /chainlink/.password \ -a /chainlink/.api
注意事项
请记住，请勿将真实密码储存在纯文本中。以上示例仅作演示用途。
通过以下命令来验证运行是否正常，以及日志是否持续记录：
docker ps #Containers Running
docker logs --tail 50 {CONTAINER-ID} #Logs progressing
合约设置¶
预言机节点运行后，您可以开始配置智能合约。首先，请执行以下步骤为预言机节点注入资金：
-
通过登录Chainlink节点用户界面 (位于
http://localhost:6688/)获取预言机节点地址，用于发送交易和写入链上数据。您将需要使用.api文档中的证书来获取地址。
-
进入Configuration Page页面，并复制节点地址
-
注入资金。 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试
下一步，部署预言机合约，它是区块链和节点之间的中间件。合约将发送包含所有必要信息的事件信息，并被预言机节点读取。然后节点将完成请求，并将所请求的数据写入调用者的合约。
预言机合约的源代码可以在Chainlink的官方GitHub repository中找到。在本示例中，您将使用Remix来与Moonbase Alpha交互并部署合约。在Remix环境下，可以复制以下代码：
pragma solidity ^0.6.6;
import "@chainlink/contracts/src/v0.6/Oracle.sol";
编译合约后，您可以通过以下步骤部署并与合约进行交互：
- 进入Deploy and Run Transactions标签
- 请确保已经选择Injected Web3，并将MetaMask连接至Moonbase Alpha
- 验证您的地址被选择
- 输入LINK Token地址，并点击Deploy以部署合约。MetaMask将弹出弹窗，您可以确认交易
- 部署完成后，在Deployed Contracts板块复制合约地址。
最后，绑定预言机节点和预言机智能合约。节点可以捕获发送到特定预言机合约的请求，但只有被授权（即绑定）的节点才能完成这一任务。请执行以下步骤以绑定预言机节点和智能合约：
- 使用预言机合约中的
setFulfillmentPermission()函数进行授权，输入您想要与合约绑定的节点地址 - 在
_allowed字段中您可以设置绑定状态下的布尔值逻辑，本例输入true - 点击transact发送请求。MetaMask将弹出弹窗，您可以确认交易
- 通过视图函数
getAuthorizationStatus()检查预言机节点是否获得授权，传入预言机节点地址
创建Job¶
Chainlink预言机配置的最后一步就是创建Job。请参阅Chainlink官方文档：
任务参数包含了一系列任务，节点必须执行这些任务才能获得最终结果。一条参数包含至少一个启动程序和一个任务（此前已详细讨论）。参数使用标准化JSON进行定义，实现人类可读，并能够轻易被Chainlink节点所分析。
如果将预言机看作API服务，那么Job就是其中一个函数，您可以调用这个函数并获得返回结果。请执行以下步骤创建您的第一个Job：
- 进入您节点的Job板块
- 点击New Job
下一步，您可以创建新的Job：
-
粘贴以下JSON代码。创建的任务将请求ETH目前的的美金价格。
{ "initiators": [ { "type": "runlog", "params": { "address": "YOUR-ORACLE-CONTRACT-ADDRESS" } } ], "tasks": [ { "type": "httpget", "params": { "get": "https://min-api.cryptocompare.com/data/price?fsym=ETH&tsyms=USD" } }, { "type": "jsonparse", "params": { "path": [ "USD" ] } }, { "type": "multiply", "params": { "times": 100 } }, { "type": "ethuint256" }, { "type": "ethtx" } ] } -
请务必输入您的预言机合约地址（
YOUR-ORACLE-CONTRACT-ADDRESS）。 -
点击Create Job以创建Job
成功！现在，Chainlink预言机节点已经设置成功，并且该节点已经在Moonbase Alpha上运行。
使用任何API¶
您也可以创建并使用job spec来处理任何API。您可以您可以通过例如market.link等独立列表服务搜索预有Job。请注意，尽管这些Job可能会为其他网络实现，但您将能够使用job spec在Moonbase Alpha上为您的预言机节点创建Job。当您找到一个可以满足您需求的Job后，您将需要复制这个job spec JSON并使用它来创建一个新的Job。
举例来说，之前的job规格可以被更改的更为通用，因此可用于任何API：
{
"initiators": [
{
"type": "runlog",
"params": { "address": "YOUR-ORACLE-CONTRACT-ADDRESS" }
}
],
"tasks": [
{ "type": "httpget" },
{ "type": "jsonparse" },
{ "type": "multiply" },
{ "type": "ethuint256" },
{ "type": "ethtx" }
]
}
如果您需要一个更定制化的系统，您可以查阅Chainlink的文档了解如何构建您自己的外部适配器。
预言机测试¶
要验证预言机的在线状态以及是否能正常完成请求，请查阅Chainlink预言机教程。主要步骤是：部署一个客户端合约，向预言机发送请求，并使预言机向客户端合约中写入所请求的数据。
Created: March 26, 2021