subgraph 是什么
subgraph 索引协议作为 Dapp 领域最重要的基建之一(如 uniswap、wave 等都在使用),主要用来做链上数据索引,即在链下对链上事件进行捕捉(扫链、计算、存储),然后可对存储下来的数据进行相关读操作,其关键总结为三点:
- 通过链下监听事件,逻辑处理,然后存储到数据库中,供前端调用;
- 常用于统计历史信息及变化,仅做展示相关,可以节约链上存储成本,且响应更快;
- 请求 subgraph 时使用专门的 graphql 语言,而非 sql;
原理
- 用户从合约侧发起交易;
- 合约发送事件;
- 由 subgraph 监听到该事件,并在内部执行逻辑(根据实际业务需求自定义),处理后入库;
- 用户(前端)从 subgraph 的数据库中读取数据,完成展示;
使用方式
- the graph 官方提供的去中心化网络:subgraph studio(需要 token 支持,请自行尝试)
- 也可搭建本地 graph node,先下载其环境到本地:
git clone https://github.com/graphprotocol/graph-node/
这里对 graph node 与 subgraph 关系进行说明,在 graph node 上可以部署多个 subgraph,每个 subgraph 可以服务多个不同的项目。
创建 subgraph
// 安装 subgraph
npm install -g @graphprotocol/graph-cli
// 初始化
graph init
具体选项跟随引导程序填写,选择:网络 -> 名称 -> 合约地址 -> 合约名字,引导程序会自动在网络上拉取 ABI(前提是我们 verify 了,否则需要自己填写)
配置修改
增加扫块起点 startBlock 为当前合约所部署的块,如果不增加,则从最初块开始扫,效率低