The Graph 入門教程：如何索引合約事件_GRAP

編寫智能合約時，通常狀態的變化是通過觸發一個事件來表達，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：

Ethereum Fair 硬分叉成功并正常出塊:9月15日消息，以太坊成功升級合并并正式轉為 PoS 算法，同一時間 Ethereum Fair 硬分叉成功將繼續 PoW 算法，目前 ETF 已成功出塊。[2022/9/15 6:58:25]

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,}。

The Game Changer Limited宣布推出P2E游戲Covenant Child:12月28日消息，The Game Changer Limited宣布計劃于2022年第一季度正式推出基于區塊鏈的游戲“Covenant Child”。 據悉，Covenant Child旨在建立一個去中心化的游戲服務環境，用戶通過Play-to-Earn (P2E) 模式賺取代幣和NFT。（globenewswire.）[2021/12/28 8:09:37]

然后執行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節點來完成數據的索引。

聲音 | The Force Partners合伙人：杠桿ETF是普通投資者放大收益的工具:2月19日晚間，The Force Partners合伙人王翔做客抹茶周三見時表示：相較于期權、合約等高門檻的交易工具，杠桿ETF更容易讓普通投資者理解與上手。此外他還指出，合成類資產及衍生資產，能夠幫助市場優化整體流動性。The Force Partners是一家圍繞全球區塊鏈產業及衍生應用領域進行投資的專業機構。基金目前主要為布局有三方面：風險投資基金，二級市場管理人基金，算力基金。MXC抹茶周三見”是MXC抹茶推出的一檔AMA活動，不定期邀請重量級嘉賓在周三進行分享。[2020/2/19]

如果沒有TheGraph的賬戶，可以用GitHub注冊。創建賬戶之后，進入儀表盤就可以開始通過界面創建subgraph，進入你的儀表板，并點擊AddSubgraph：

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)，以更高效，更便攜式地執行映射。

動態 | 近七日Tether新發行1.57億USDT:據Tokenview數據分析，近七日Tether新增4500萬USDT，通過Tether Treasury地址共計新發行了1.57億USDT。以太坊和波場成為新發行USDT的主要公鏈，分別占比71.34%和27.85%。而在新發行的USDT大額流轉中，Binance和Bitfinex成為接收數額較多的兩家交易所，分別收到約6786萬和5009萬USDT。[2020/2/16]

需要定義_subgraph.yaml_文件中每個handler函數，因此在我們的例子中，我們需要實現函數：handleNewGravatar及handleUpdatedGravatar。

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(。

動態 | 以太坊合作社宣布已將Ethercluster項目貢獻給Hyperledger labs:據以太坊經典博客最新博文，以太坊合作社宣布，Ethercluster項目已經被貢獻給Hyperledger labs，將這個關鍵的以太坊基礎設施項目帶給更廣泛的受眾。據悉，Ethercluster使用Kubernetes、Terraform和Docker來托管一組為JSON-RPC端點服務的以太坊客戶端節點集群，這些集群可以動態擴展。[2019/12/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一周簡報

Tags：RAPAPHGraphGRAPWrapped Celoethnographyethnology和ethnographyethnographyinbusiness

PEPE