RAP:The 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：

Tether市值9天內增加10億美元，系歷史上第二快的增長:Bitfinex和Tether首席技術官Paolo Ardoino周四發推稱，USDT的供應在9天之內增加10億美元，這種增長速度僅次于2020年9月4日創下的記錄，當時USDT的流通量在8天之內增加10億。

截至發稿時，Tether的市值接近190億美元，這意味著以1.00美元的價格流通著約190億美元的USDT。根據CoinMarketCap的數據，自2020年初以來，Tether的市值增長了近四倍。以目前的流通供應量計算，Tether的市值在所有加密貨幣中排在第四位。（Cointelegraph）[2020/11/28 22:25:15]

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。

Tether在以太坊上增發1.2億USDT:據Tokenview穩定幣數據監測，Tether于今日08:07在以太坊上增發1.2億USDT，區塊高度9782643。

這是Tether今年第24次印鈔，今年以來的印鈔數量已達20.6億USDT。[2020/4/1]

添加執行交易腳本，以便觸發事件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,}。

然后執行trufflemigrate--networkropsten以便完成部署和執行createGravatar交易，控制臺里會打印出GravatarRegistry合約部署的地址，復制這個合約地址，后面在編寫subgraph需要使用到。

2.創建定義數據索引的Subgraph

TheGraph中定義如何為數據建立索引，稱為Subgraph，它包含三個組件：

Manifest清單(subgraph.yaml)-定義配置項

數據：近一周Tether共計新增印鈔2.6億USDT:Tokenview數據監測，截止今日15時，近七日Tether新增印鈔2.60億USDT，通過Tether Treasury新發行2.89億USDT。已發行的USDT中有2.78億流入了Bitfinex等4家交易所。注：由于Tether上周進行了2億USDT的換鏈，但原OMNI鏈上的USDT仍回收在Tether Treasury地址，尚未銷毀，故新增印鈔數也計算了上述換鏈的2億USDT。[2020/3/8]

Schema模式(schema.graphql)-定義數據

Mapping映射(mapping.ts)-定義事件到數據的轉換

后面我們將逐一介紹他們的作用及如何來編寫。

在TheGraph創建一個Subgraph空間

因為需要借助TheGraph的節點來完成數據的索引，因此我們需要在TheGraph網站)上創建一個Subgraph。

如果你有自己的私有鏈，這可以克隆Graph節點代碼，自己運行Graph節點來完成數據的索引。

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

image-20210428095928210

可以為你的subgraph選擇一個圖像，定義一個名稱。完成后點擊保存，一個新的、未部署的subgraph將顯示在儀表板上。

開發和部署subgraph

先使用Yarn或NPM在全局安裝GraphCLI：

動態 | Tether向以太坊網絡新增發1500萬枚USDT:據DAppTotal.com穩定幣專題頁面數據顯示：09月14日02時25分 ，USDT發行方Tether向以太坊網絡新增發1筆價值1,500萬美元的USDT， 塊高度為：8542883，交易哈希值為：0x86ae1402e66c536ea357513b5f3c25e736e53d0a4e787e06cefb958f25e825dc 。截至目前，Tether在以太坊網絡上的ERC20 USDT總發行量已達1,950,057,493枚。

DAppTotal敬請廣大投資者警惕行情變動，謹慎應對市場風險。[2019/9/14]

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

TheGraph提供了一個命令：graphcodegen可以生成解析事件的代碼及模式實體代碼，因此只需要基于生成的代碼編寫映射函數，mapping.ts定義如下：

聲音 | 紐約最高法院法官：NYAG、Bitfinex和Tether律師需花費一周時間協商禁令范圍:據financemagnates消息，在周一聽證會上，紐約最高法院的法官Joel M. Cohen對4月底紐約總檢察長辦公室對Bitfinex提出的初步禁令的范圍提出質疑。他表示：“我們現在的初步禁令是模糊開放式的，并沒有足夠的量身定制，這可能會衍生現實的迫在眉睫的傷害。因此，NYAG，Bitfinex和Tether的律師需要花費一周的時間認真協商，敲定禁令的范圍，提出合理的修訂文件。”自提出禁令以來，Bitfinex的客戶已經撤回了超過3萬個比特幣和100萬個以太坊，上周，Bitfinex和Tether的律師提出撤銷或修改初步禁令的要求。[2019/5/7]

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

在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：RAPAPHGRAPGraphWrapped ShiftHolographic Dogeethnology和ethnographyGraphen

狗狗幣最新價格