@liq /子图
Liq市场子图的类型化GraphQL客户端。
概述
@liq/subgraph 提供了 LiqSubgraph 客户端类，具有用于从The Graph获取链上事件数据的类型化查询方法——账户、市场、订单结算、抵押品变更、清算和市场更新。子图URL自动从 @liq/core 链配置时 chainId 提供，或可直接提供。
主要出口
LiqSubgraph
由 LiqSubgraphConfig （{ chainId? } | { url? }）。
| 方法 | 返回类型 | 描述 |
|---|---|---|
getAccount(accountId) | SubgraphAccount | null | 账户+抵押品余额 |
getMarket(marketId) | SubgraphMarket | null | 市场的元数据 |
getOrderSettlements(filter, pagination) | SubgraphOrderSettled[] | 已结算订单历史 |
getCollateralHistory(filter, pagination) | SubgraphCollateralModified[] | 抵押品存取款事件 |
getLiquidations(filter, pagination) | SubgraphPositionLiquidated[] | 清算事件 |
getMarketUpdates(filter, pagination) | SubgraphMarketUpdated[] | 资金率+倾斜更新 |
类型
SubgraphAccount，SubgraphMarket-核心实体类型SubgraphOrderSettled，SubgraphCollateralModified，SubgraphPositionLiquidated，SubgraphMarketUpdated-事件类型OrderSettledFilter，CollateralFilter，LiquidationFilter，MarketUpdatedFilter-滤波器输入PaginationOpts- - - - - -{ first?, skip? }分页
使用
import { LiqSubgraph } from '@liq/subgraph';
const subgraph = new LiqSubgraph({ chainId: 6343 });
// or: new LiqSubgraph({ url: 'https://...' })
const account = await subgraph.getAccount(12345n);
const settlements = await subgraph.getOrderSettlements({ accountId: '12345' }, { first: 50 });
安装
pnpm add @liq/subgraph graphql
依赖关系
@liq/core- chain配置和子图URL解析graphql-request-轻量级GraphQL客户端
同行依赖性
graphql^ 16
构建
moon run liq-subgraph:build # tsup → dist/