thegraph

The Graph网络对Web3的查询层和API层进行了去中心化，消除了dApp开发者目前面临的取舍难题：到底是开发一个高性能应用，还是开发一个完全去中心化的应用…

1.创建旧版本子图-浏览器

因为新版收费，且新版至目前只支持以太坊主链

旧版子图地址: https://thegraph.com/hosted-service/

打开地址登录github

点击Add Subgraph创建子图

此处的名称需要和你的github账号名称对应，否则点击按钮无效，控制台输出报错（可能是bug）

2.创建子图应用

下载graph

// NPM
npm install -g @graphprotocol/graph-cli

// Yarn
yarn global add @graphprotocol/graph-cli

创建项目

graph init

步骤↓

Protocol · ethereum【选择以太坊】
✔ Product for which to initialize · hosted-service
✔ Subgraph name · web03/demo【你的graph名称/子图】
✔ Directory to create the subgraph in · demo
✔ Ethereum network · bsc【链】
✔ Contract address · 0x86f447333734052bc3d19858Fe334179eF66bE40【合约地址】
✔ Fetching ABI from Etherscan
✔ Contract Name · DuskAllowList【合约名称】

下载依赖

cd 项目地址
npm install

部署

// 构建
npm run codegen
// 添加访问令牌
graph auth --product hosted-service <ACCESS_TOKEN>
// 部署到线上
graph deploy --product hosted-service <GITHUB_USER>/<SUBGRAPH NAME>

部署完成

配置说明

子图定义由几个文件组成：

• subgraph.yaml：包含子图清单的 YAML 文件

• schema.graphql: 一个 GraphQL 模式，它定义了为你的子图存储了什么数据，以及如何通过 GraphQL 查询它

• AssemblyScript Mappings：从事件数据转换为模式中定义的实体的AssemblyScript代码

建议直接看官方文档：https://thegraph.com/docs/developer/create-subgraph-hosted

查询

{
  实体(筛选条件) {
    查询返回的字段
  }
}

假设schema.graphql

type AccountPool @entity {
  id: ID!
  accountAddress: Bytes!
  poolAddress: String!
  amount: BigInt!
  createdAt: BigInt!
  pool: Pool!
  account: Account!
}

查询用户的pool地址

{
  AccountPool(first: 1000, skip:0, where:{account: 0x123xxxxxxxxxxxxxxxx}) {
    id,
	poolAddress
  }
}

查询说明

排序

// 通过price排序，排序方式为asc【acs升序，desc降序】
{
  tokens(orderBy: price, orderDirection: asc) {
    id
    owner
  }
}

分页

first参数可用于从集合的开头进行分页

默认排序顺序是按字母数字升序的 ID，而不是按创建时间

此外，该skip参数可用于跳过实体和分页。例如，first:100 显示前 100 个实体。 first:100, skip:100 显示接下来的 100 个实体

// 查询前10个
{
  tokens(first: 10) {
    id
    owner
  }
}

// 查询 10 个Token实体，从集合的开头偏移 10 个位置，获得11~20的Token
{
  tokens(first: 10, skip: 10) {
    id
    owner
  }
}

条件过滤-指定值

// 查询前1000个，并且holder字段要等于 用户地址 
list(first: 1000, where: { holder: "用户地址"  }) {
      id
      name
	  holder
    }

条件过滤-检索多个实体

// 第一次，它会发送带有 的查询lastID = ""，对于后续请求，它将设置lastID为id前一个请求中最后一个实体的属性。这种方法的性能明显优于使用递增skip值
{
  query manyTokens($lastID: String) {
    tokens(first: 1000, where: { id_gt: $lastID  }) {
      id
      owner
    }
  }
}

过滤条件-比较

// 查询 amount 字段大于 100 的数据
{
  UAmount(where: { amount_gt: "100" }) {
    id
    amount
  }
}
// 查询name字段不等于 mmm 的数据
{
  names(where: { name_not: "mmm" }) {
    id
    name
  }
}

请注意，某些后缀仅支持特定类型。例如，Boolean仅支持_not，_in和_not_in。

查询指定区块

// 查询区块号为8000000里面的数据，此查询将返回Challenge实体及其关联 Application实体，因为它们在处理编号为 8000000 的区块后直接存在
{
  challenges(block: { number: 8000000 }) {
    challenger
    outcome
    application {
      id
    }
  }
}

查询指定哈希的数据

{
  challenges(block: { hash: "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c" }) {
    challenger
    outcome
    application {
      id
    }
  }
}

运算符

// 检索text值为'a'或者为'b'的数据
{
  blogSearch(text: "a | b") {
    id
    title
    body
    author
  }
}

// 检索text以a在b左边的，如axxxb，xxaxxb，xxaxxbxx【xxaxxb，xxaxxbxx是我的猜测，具体开实际情况】
{
  blogSearch(text: "a <-> b") {
    id
    title
    body
    author
  }
}

// 检索text以a开头的，如axxxb，axxbxx【axxbxx是我的猜测，具体开实际情况】
{
  blogSearch(text: "a:* <-> b") {
    id
    title
    body
    author
  }
}

axios请求graph

axios({
    
    
      method: 'post',
      url:
        'https://thegraph.com/explorer/subgraph/xxx/xxx',
      data: {
    
    
        query: `{
          dusks(first: 1000, skip:0, where:{holder: "${
      
      account}"}) {
            id
            holder
            tokenId
          }
        }`,
      },
    }).then(res =>{
    
    
	
	})