第1节：subgraph

小白入门：https://github.com/dukedaily/solidity-expert ，欢迎star转发，文末加V入群。

职场进阶: https://dukeweb3.com

概述

subgraph是DAPP领域最重要的基建之一，主流协议都在使用，其功能为：

  • 链下监听事件，逻辑处理，存储到数据库中，供前端调用；
  • 常用于：统计历史信息等，仅做展示相关，可以节约链上存储成本，且响应更快；
  • 请求subgraph的时候使用graphql语言，而非sql语句。

下图的是uniswapV3的面板信息，其中绝大多数内容都取自subgraph服务。

image-20221006102831823

举例

  • uniswap v3的token功能主要是从subgraph中读取的

  • 问：uniswapV3 查询当前有哪些pool？

  • Url：https://api.thegraph.com/subgraphs/name/uniswap/uniswap-v3

  • 请求语句：

    {
  pools(
      first: 50 
      orderBy: totalValueLockedUSD 
      orderDirection: desc  
      subgraphError: allow) {    
      id    
      __typename  
    }
}

  • 请求结果：(部分)

    {
  "data": {
    "pools": [
      {
        "id": "0x277667eb3e34f134adf870be9550e9f323d0dc24",
        "__typename": "Pool"
      },
      {
        "id": "0xa850478adaace4c08fc61de44d8cf3b64f359bec",
        "__typename": "Pool"
      },
      {
        "id": "0x8c0411f2ad5470a66cb2e9c64536cfb8dcd54d51",
        "__typename": "Pool"
      },
      {
        "id": "0x055284a4ca6532ecc219ac06b577d540c686669d",
        "__typename": "Pool"
      }
     ]
  }
}

原理

  1. 用户从合约侧发起交易；
  2. 合约发送事件；
  3. 由subgraph监听到该事件，并在内部执行逻辑（我们根据业务需求，自定义），处理后入库；
  4. 用户（前端）从subgraph的数据空中读取数据，完成展示。

subgraph流程图

可选资源

subgraph一共有三种模式可以使用，具体如下（我们使用第三种）：

  1. the graph官方提供的host serivce模式（已经废弃了）
  2. the graph官方提供的去中心化网络：subgraph studio（需要token支持，激励别人帮忙加速索引，请自行尝试）
  3. 使用the graph官方提供的开源代码自己搭建：（推荐，官方指导）
    1. 先试用docker创建一个：graph node
    2. 在graph node上部署subgraph

关系梳理

graph node和subgraph的关系如下，在graph node上可以部署多个subgraph，每个subgraph可以服务多个不同的项目。官方的host service（已经废弃），就是帮我们创建了一个graph node。

graphnode

小结

  1. subgraph是DAPP必要基建
  2. 目前最佳实践是自行搭建graph node，使用docker
  3. subgraph部署在graph node之上，编程语言为：WASM (WebAssembly)
  4. 使用graphql查询

下一节我们聊一聊如何进行使用docker搭建graphnode并部署自己的subgraph。

加V入群：dukeweb3，公众号：阿杜在新加坡，一起抱团拥抱web3，下期见！

关于作者：国内第一批区块链布道者；2017年开始专注于区块链教育(btc, eth, fabric)，目前base新加坡，专注海外defi,dex,元宇宙等业务方向。