> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 链分组

> Cubes 如何被组织到 EVM、Solana 与 Trading Chain Groups 中

## 概述

ChainStream GraphQL 将其 25 个 Cube 划分为三个 **链组（Chain Groups）**。每个组代表一类区块链生态，决定可用的 Cube、`network` 参数如何生效，以及存在哪些链特有字段。

```graphql theme={null}
type ChainStream {
  EVM(network: Network!, dataset: Dataset, aggregates: Aggregates) { ... }
  Solana(network: SolanaNetwork, dataset: Dataset, aggregates: Aggregates) { ... }
  Trading(dataset: Dataset, aggregates: Aggregates) { ... }
}
```

***

## EVM

**EVM** 组包含适用于所有 EVM 兼容链的 Cube。查询时 **必须** 提供 `network` 参数以指定链。

### 可用网络

| 网络 ID     | 区块链             |
| :-------- | :-------------- |
| `eth`     | Ethereum        |
| `bsc`     | BNB Chain (BSC) |
| `polygon` | Polygon         |

<Warning>
  **Polygon 数据可用性：** 目前仅有 **预测市场** 相关 Cube（`PredictionTrades`、`PredictionManagements`、`PredictionSettlements`）在 Polygon 上有数据。其他 Cube（DEXTrades、Blocks、Transfers 等）正在部署中 —— 对它们的查询可能返回错误。
</Warning>

### Cubes

**与 Solana 共用：**
`DEXTrades`、`DEXTradeByTokens`、`Transfers`、`BalanceUpdates`、`DEXPoolEvents`、`TokenSupplyUpdates`、`Blocks`、`Transactions`、`TransactionBalances`、`DEXPools`、`TokenHolders`、`WalletTokenPnL`

**仅 EVM：**

* `Events` — 智能合约事件日志（已解码的 topic 与 data）
* `Calls` — 内部调用追踪（CALL、DELEGATECALL、CREATE 等）
* `MinerRewards` — 出块奖励明细（静态、动态、叔块、销毁手续费等）
* `DEXPoolSlippages` — 池子价格滑点分析
* `Uncles` — 叔块数据（主要为以太坊 PoW 历史）
* `PredictionTrades` — 预测市场交易 *（主要为 Polygon）*
* `PredictionManagements` — 预测市场管理事件 *（主要为 Polygon）*
* `PredictionSettlements` — 预测市场结算 *（主要为 Polygon）*

### 示例查询

```graphql theme={null}
query {
  EVM(network: eth, dataset: combined) {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time Number }
      Transaction { Hash }
      Trade {
        Buy { Currency { SmartContract Symbol } Amount PriceInUSD }
        Sell { Currency { SmartContract Symbol } Amount }
        Dex { ProtocolName }
      }
    }
  }
}
```

***

## Solana

**Solana** 组包含 Solana 链上的 Cube。`network` 参数可用，接受 `solana` 作为值。该参数为可选，默认值为 `solana`。

### Cubes

**与 EVM 共用：**
`DEXTrades`、`DEXTradeByTokens`、`Transfers`、`BalanceUpdates`、`DEXPoolEvents`、`TokenSupplyUpdates`、`Blocks`、`Transactions`、`TransactionBalances`、`DEXPools`、`TokenHolders`、`WalletTokenPnL`

**仅 Solana：**

* `Instructions` — 程序指令数据（程序地址、方法、账户、日志）
* `InstructionBalanceUpdates` — 指令级别的余额变动
* `Rewards` — 验证者与质押奖励
* `DEXOrders` — DEX 订单簿事件（限价单、撤单、成交）

### 示例查询

```graphql theme={null}
query {
  Solana(dataset: realtime) {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time Slot }
      Transaction { Hash }
      Trade {
        Buy { Currency { MintAddress Symbol } Amount PriceInUSD }
        Sell { Currency { MintAddress Symbol } Amount }
        Dex { ProgramAddress ProtocolName }
      }
    }
  }
}
```

### 跨链字段命名

下表列出各链的惯用字段名。但 Record 类型会包含 **所有链字段的并集** —— 每个 Cube 的 Record 中同时存在 `MintAddress` 与 `SmartContract`，底层数据一致。任意链上均可使用其中任一名称。

| 概念     | 惯用（Solana）           | 惯用（EVM）         | 跨链通用？ |
| :----- | :------------------- | :-------------- | :---- |
| 代币地址   | `MintAddress`        | `SmartContract` | 各链均可  |
| 交易 ID  | `Signature` / `Hash` | `Hash`          | 各链均可  |
| 区块标识   | `Slot`               | `Number`        | 各链均可  |
| 程序/合约  | `ProgramAddress`     | `SmartContract` | 各链均可  |
| 手续费支付方 | `FeePayer`           | `From`          | 各链均可  |

<Tip>
  因此你可以用 **同一套查询模板** 跨链查询而无需改字段名。例如 `Currency { MintAddress }` 在 Solana 与 EVM 查询中均可使用。
</Tip>

***

## Trading

**Trading** 组提供 **跨链预聚合** 的交易分析数据。它将各支持链的数据合并为统一物化视图，并通过 `chain` 维度做筛选。

### Cubes

* `Pairs` — OHLC K 线（开高低收、成交量、成交笔数）
* `Tokens` — 按代币的交易统计（成交量、买卖拆分、独立交易者数）

### 与 EVM / Solana 组的主要区别

1. **无 `network` 参数** — Trading 组跨链汇总数据，请在数据内用 `chain` 维度按网络过滤。
2. **跨链数据** — 单次查询可同时返回 `sol`、`eth`、`bsc` 等。
3. **预聚合** — 数据来自 DWM 层，按分钟粒度物化。

### 示例：跨链 OHLC

```graphql theme={null}
query {
  Trading(aggregates: yes) {
    Pairs(
      where: { Token: { Address: { is: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" } } }
      limit: {count: 60}
      orderBy: {descending: Block_Time}
    ) {
      Token { Address }
      Market { Network }
      Interval { Time }
      Price { Ohlc { Open High Low Close } }
      Volume { Usd Native }
      Stats { TradeCount BuyCount SellCount }
    }
  }
}
```

### 示例：按链的代币成交统计

```graphql theme={null}
query {
  Trading {
    Tokens(
      where: {
        Token: { Address: { is: "0xdac17f958d2ee523a2206206994597c13d831ec7" } }
        Market: { Network: { is: "eth" } }
      }
      limit: {count: 30}
      orderBy: {descending: Block_Time}
    ) {
      Interval { Time }
      Volume { Usd BuyVolumeUSD SellVolumeUSD }
      Stats { TradeCount UniqueBuyers UniqueSellers }
    }
  }
}
```

***

## 链组对比

| 特性                  | EVM                                                            | Solana                                                   | Trading      |
| :------------------ | :------------------------------------------------------------- | :------------------------------------------------------- | :----------- |
| **`network` 参数**    | 必填（`eth`、`bsc`、`polygon`）                                      | 可选（`solana`，默认 `solana`）                                 | 不需要（跨链）      |
| **独有 Cube**         | Events、Calls、MinerRewards、Uncles、DEXPoolSlippages、Prediction\* | Instructions、InstructionBalanceUpdates、Rewards、DEXOrders | Pairs、Tokens |
| **数据粒度**            | 逐事件（DWD）+ 聚合（DWM/DWS）                                          | 逐事件 + 指令级                                                | 预聚合（DWM）     |
| **`dataset` 支持**    | 是（多数 Cube）                                                     | 是（多数 Cube）                                               | 是            |
| **`aggregates` 支持** | 是                                                              | 是                                                        | 是            |

***

## 相关文档

<CardGroup cols={2}>
  <Card title="数据 Cubes" icon="cubes" href="/cn/graphql/schema/cubes">
    全部 25 个 Cube 的字段结构与使用场景详解。
  </Card>

  <Card title="Dataset 与 Aggregates" icon="database" href="/cn/graphql/schema/dataset-aggregates">
    控制数据源范围与预聚合行为。
  </Card>
</CardGroup>