The Graph 入门教程:如何索引合约事件_RAP:Graph

编写智能合约时,通常状态的变化是通过触发一个事件来表达,TheGraph则是捕捉区块链事件并提供一个查询事件的GraphQL接口,让我们可以方便的跟踪数据的变化。实际上很多DEFI协议及都是TheGraph来基于查询数据。

这篇TheGraph教程在官方的教程基础上,进行了一些补充扩展主要包含以下内容:

在Ropsten部署一个合约,并调用触发事件。

创建定义数据索引的Subgraph。

部署Subgraph到TheGraph,实现数据索引。

在前端DApp中查询索引数据。

本教程的完整代码已上传到GitHub:https://github

Gravatarpublicgravatars;mapping(uint=>address)publicgravatarToOwner;mapping(address=>uint)publicownerToGravatar;functioncreateGravatar(string_displayName,string_imageUrl)public{require(ownerToGravatar==0);uintid=gravatars

functionupdateGravatarName(string_displayName)public{require(ownerToGravatar!=0);require(msg

}

可以看到合约里在创建和更新时分别触发了NewGravatar和UpdatedGravatar事件,稍后再subgraph里,将跟踪这两个事件,但是需要我们先把合约部署到网络上,这里使用以太坊测试网Ropsten:

The Art of Seasons系列NFT近24小时交易额增长超800%:金色财经报道,OpenSea最新数据显示,The Art of Seasons系列NFT过去24小时的交易额为367 ETH,增长率为802%。近24小时交易额排名位列OpenSea第3。[2022/9/17 7:02:31]

module.exports={networks:{ropsten:{provider:function(){returnnewHDWalletProvider(process.env.MNEMONIC,`https://ropsten.infura.io/v3/${process.env.ROPSTEN_INFURA_API_KEY}`。,network_id:'3',},}}

这里为了安全考虑,把助记词和APIKEY保存在.env文件中

添加部署脚本2_deploy_contract.js:

constGravatarRegistry=artifacts.require('./GravatarRegistry.sol')module.exports=asyncfunction(deployer){awaitdeployer.deploy(GravatarRegistry。

添加执行交易脚本,以便触发事件3_create_gravatars.js:

constGravatarRegistry=artifacts.require('./GravatarRegistry.sol')module.exports=asyncfunction(deployer,network,accounts){constregistry=awaitGravatarRegistry.deployed()console.log('Accountaddress:',registry.address)awaitregistry.createGravatar('Carl','https://thegraph.com/img/team/team_04.png',{from:accounts,}。

THETA跌破6.2美元关口 日内涨幅为0.98%:欧易OKEx数据显示,THETA短线下跌,跌破6.2美元关口,现报6.1987美元,日内涨幅达到0.98%,行情波动较大,请做好风险控制。[2021/5/23 22:34:28]

然后执行trufflemigrate--networkropsten以便完成部署和执行createGravatar交易,控制台里会打印出GravatarRegistry合约部署的地址,复制这个合约地址,后面在编写subgraph需要使用到。

2.创建定义数据索引的Subgraph

TheGraph中定义如何为数据建立索引,称为Subgraph,它包含三个组件:

Manifest清单(subgraph.yaml)-定义配置项

Schema模式(schema.graphql)-定义数据

Mapping映射(mapping.ts)-定义事件到数据的转换

后面我们将逐一介绍他们的作用及如何来编写。

在TheGraph创建一个Subgraph空间

因为需要借助TheGraph的节点来完成数据的索引,因此我们需要在TheGraph网站)上创建一个Subgraph。

如果你有自己的私有链,这可以克隆Graph节点代码,自己运行Graph节点来完成数据的索引。

如果没有TheGraph的账户,可以用GitHub注册。创建账户之后,进入仪表盘就可以开始通过界面创建subgraph,进入你的仪表板,并点击AddSubgraph:

Synthetix创建合成资产sTSLA的治理提案已通过:Synthetix创建合成资产sTSLA的治理提案已通过,将提供对特斯拉股票的链上敞口。据悉,添加sTSLA (SIP110)的提案于2月10日提交。此前2020年12月份,Synthetix曾表示将支持合成股票资产的交易,让非美国用户获得美国证券敞口。(AMBcrypto)[2021/2/12 19:34:06]

image-20210428095928210

可以为你的subgraph选择一个图像,定义一个名称。完成后点击保存,一个新的、未部署的subgraph将显示在仪表板上。

开发和部署subgraph

先使用Yarn或NPM在全局安装GraphCLI:

$npminstall-g

ID,Bytes及String是GraphQL数据类型,!表示该值不能为空。模式的定义文档可以在这里找到:https://thegraph.com/docs/define-a-subgraph#the-graphql-schema。

定义映射(mapping.ts)

TheGraph中的映射文件定义了如何将传入事件转换为实体的函数。它用TypeScript的子集AssemblyScript编写。因此可以将其编译为WASM(WebAssembly),以更高效,更便携式地执行映射。

需要定义_subgraph.yaml_文件中每个handler函数,因此在我们的例子中,我们需要实现函数:handleNewGravatar及handleUpdatedGravatar。

动态 | 以太坊DeFi锁仓排名小幅变动,Synthetix一度超越Compound居第二:大部分时间里,以太坊DeFi平台锁仓价值排名靠前的往往都是MakerDAO、Compound等项目。但Doggie Tail Crypto Capital合伙人Spencer Noon指出,情况正在发生变化。他在最近的一条推特中称,Synthetix是一种去中心化合成资产的DeFi协议,允许用户以去中心化的方式交易一种大宗商品工具。目前它在合约中锁定了价值1.035亿美元的资产,甚至一度稍稍超过了Compound(1.03亿美元)。 Spencer Noon将此归因于两点或三点:1、MakerDAO削减了稳定费;2、这意味着许多用户可能更愿意通过Maker而非Compound获得贷款;3、Synthetix的原生代币价格开始飙升,在过去30天内上涨了56%。 尽管许多人可能认为这一小小的“震荡”无关紧要,但它表明了以太坊的DApp生态系统及其DeFi的发展和增长。此外,Noon指出,在DeFi排行榜上争夺一席之地是一个“健康生态系统的标志”,因为它表明存在竞争,这自然会导致创新——从长远来看,这对区块链的用户和ETH投资者而言都是净收益。[2019/11/14]

TheGraph提供了一个命令:graphcodegen可以生成解析事件的代码及模式实体代码,因此只需要基于生成的代码编写映射函数,mapping.ts定义如下:

import{NewGravatar,UpdatedGravatar}from'../generated/Gravity/Gravity'import{Gravatar}from'../generated/schema'exportfunctionhandleNewGravatar(event:NewGravatar):void{letgravatar=newGravatar(event.params.id.toHex())gravatar.owner=event.params.ownergravatar.displayName=event.params.displayNamegravatar.imageUrl=event.params.imageUrlgravatar.save(。exportfunctionhandleUpdatedGravatar(event:UpdatedGravatar):void{letid=event.params.id.toHex()letgravatar=Gravatar.load(id)if(gravatar==null){gravatar=newGravatar(id。gravatar.owner=event.params.ownergravatar.displayName=event.params.displayNamegravatar.imageUrl=event.params.imageUrlgravatar.save(。

动态 | OKEx计划于10月推出Tether保证金期货:OKEx的一位女发言人向The Block表示,OKEx计划于10月推出Tether保证金期货,但确切的发布时间表尚未确定。(The Block)[2019/9/23]

在handler函数,我们使用事件的ID创建Gravatar实体。并使用相应的字段填充数据,最后需要.save()来存储实体。

如何编写映射函数,还可以参考文档:https://thegraph.com/docs/define-a-subgraph#writing-mappings。

接下来就是把编写好的Subgraph部署到TheGraph

3.部署Subgraph

在控制台先用graphauth进行授权:

graphauthhttps://api.thegraph.com/deploy/

请使用你在创建Subgraph空间提示的Accesstoken。

然后使用graphdeploy进行部署:

graphdeploy--debug--nodehttps://api.thegraph.com/deploy/--ipfshttps://api.thegraph.com/ipfs/

使用完成的Subgraph名称,我们这里是:xilibi2003/Gameplayer。

如果顺利的话,可以在TheGraph的面板上观察到subgraph索引过程,初始索引可能需要等待几分钟,如下图:

subgraph索引

当索引完成后,通过GraphExplorer中的GraphQLplayground进行交互查询:

GraphQL查询

4.DApp前端查询索引数据

在我们的代码库中,front目录中,已经提供一个示例DApp,用来访问数据。进入应用程序目录,配置查询subgraph的GraphQL端点地址:

$cdfront$echo'REACT_APP_GRAPHQL_ENDPOINT=https://api.thegraph.com/subgraphs/name//'>.env

最后,安装DApp的依赖并启动项目。

$yarn&&yarnstart

可以看到通过GraphQL查询出来了3条数据:

image-20210429183042997

在React前端使用了ApolloClient来集成GraphQL查询,如果是Vue可以使用VueApollo。

GraphQL查询的代码可以在front/App.js找到,这里不做详细介绍。

参考资料

智能合约:https://learnblockchain.cn/article/1717

DEFI:https://learnblockchain.cn/article/570

TheGraph:https://thegraph.com/explorer/

仪表板:https://thegraph.com/explorer/dashboard/

定义subgraph.yaml的详细文档:https://thegraph.com/docs/define-a-subgraph#the-subgraph-manifest

https://thegraph.com/docs/define-a-subgraph#the-graphql-schema:_https://thegraph.com/docs/define-a-subgraph#the-graphql-schema_

AssemblyScript:https://www.assemblyscript.org/

WebAssembly:https://webassembly.org/

https://thegraph.com/docs/define-a-subgraph#writing-mappings:_https://thegraph.com/docs/define-a-subgraph#writing-mappings_

VueApollo:https://apollo.vuejs.org/guide/#become-a-sponsor

免责声明:作为区块链信息平台,本站所发布文章仅代表作者个人观点,与链闻ChainNews立场无关。文章内的信息、意见等均仅供参考,并非作为或被视为实际投资建议。

本文来源于非小号媒体平台:

登链社区

现已在非小号资讯平台发布105篇作品,

非小号开放平台欢迎币圈作者入驻

入驻指南:

/apply_guide/

本文网址:

/news/9921988.html

免责声明:

1.资讯内容不构成投资建议,投资者应独立决策并自行承担风险

2.本文版权归属原作所有,仅代表作者本人观点,不代表非小号的观点或立场

上一篇:

Bitfinex一周简报

郑重声明: 本文版权归原作者所有, 转载文章仅为传播更多信息之目的, 如作者信息标记有误, 请第一时间联系我们修改或删除, 多谢。

水星链

BNBBHEX关于恢复EOS充值和提现的公告_HEX:HEXH币

尊敬的社区用户: EOS节点升级完毕,BHEX现已恢复EOS的充值和提现。暂停期间给您带来的不便,敬请谅解! 风险提示: 数字资产是创新的投资产品,价格波动较大,请您理性判断自己的投资能力,审慎.

[0:78ms0-0:727ms