체인 그룹

Cubes가 EVM, Solana, Trading Chain Groups로 구성되는 방식

​

개요

ChainStream GraphQL은 25개의 Cube를 세 가지 Chain Group으로 묶습니다. 각 그룹은 블록체인 생태계를 나타내며, 어떤 Cube를 쓸 수 있는지, network 파라미터가 어떻게 동작하는지, 체인별 필드가 무엇인지를 결정합니다.

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

Polygon 데이터 가용성: 현재 Polygon에서 데이터가 있는 Cube는 예측 시장(Prediction Markets) Cube(PredictionTrades, PredictionManagements, PredictionSettlements)뿐입니다. 다른 Cube(DEXTrades, Blocks, Transfers 등)는 배포 중이며, 해당 Cube에 대한 쿼리는 오류를 반환할 수 있습니다.

​

Cube

Solana와 공유: DEXTrades, DEXTradeByTokens, Transfers, BalanceUpdates, DEXPoolEvents, TokenSupplyUpdates, Blocks, Transactions, TransactionBalances, DEXPools, TokenHolders, WalletTokenPnL

EVM 전용:

• Events — 스마트 컨트랙트 이벤트 로그(디코딩된 topic·data)
• Calls — 내부 호출 트레이스(CALL, DELEGATECALL, CREATE 등)
• MinerRewards — 블록 보상 분해(static, dynamic, uncle, burned fees)
• DEXPoolSlippages — 풀 가격 슬리피지 분석
• Uncles — Uncle 블록 데이터(주로 Ethereum PoW 과거)
• PredictionTrades — 예측 시장 거래 (주로 Polygon)
• PredictionManagements — 예측 시장 관리 이벤트 (주로 Polygon)
• PredictionSettlements — 예측 시장 정산 (주로 Polygon)

​

예시 쿼리

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입니다.

​

Cube

EVM과 공유: DEXTrades, DEXTradeByTokens, Transfers, BalanceUpdates, DEXPoolEvents, TokenSupplyUpdates, Blocks, Transactions, TransactionBalances, DEXPools, TokenHolders, WalletTokenPnL

Solana 전용:

• Instructions — 프로그램 instruction 데이터(프로그램 주소, 메서드, 계정, 로그)
• InstructionBalanceUpdates — instruction 단위 잔액 변화
• Rewards — 검증자·스테이킹 보상
• DEXOrders — DEX 오더북 이벤트(지정가 주문, 취소, 체결)

​

예시 쿼리

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 타입에는 모든 체인의 필드를 합친 superset이 들어 있어, 모든 Cube의 Record에 MintAddress와 SmartContract가 함께 존재하며 동일한 기본 데이터를 가리킵니다. 어떤 체인에서든 둘 중 하나를 쓸 수 있습니다.

개념	관례(Solana)	관례(EVM)	크로스체인?
토큰 주소	MintAddress	SmartContract	모든 체인에서 둘 다 동작
트랜잭션 ID	Signature / Hash	Hash	모든 체인에서 둘 다 동작
블록 식별자	Slot	Number	모든 체인에서 둘 다 동작
프로그램/컨트랙트	ProgramAddress	SmartContract	모든 체인에서 둘 다 동작
수수료 지불자	FeePayer	From	모든 체인에서 둘 다 동작

즉 하나의 쿼리 템플릿으로 모든 체인을 다룰 때 필드 이름을 바꿀 필요가 없습니다. 예를 들어 Solana·EVM 쿼리 모두에서 Currency { MintAddress }가 동작합니다.

---

​

Trading

Trading 그룹은 크로스체인 사전 집계 거래 분석을 제공합니다. 지원 체인 데이터를 통합한 materialized view에 chain 차원으로 필터링할 수 있습니다.

​

Cube

• Pairs — OHLC 캔들(open/high/low/close, 거래량, 거래 건수)
• Tokens — 토큰별 거래 통계(거래량, 매수/매도 분해, 고유 트레이더 수)

​

EVM/Solana 그룹과의 주요 차이

1. network 인자 없음 — Trading은 체인을 합친 데이터입니다. 네트워크별 필터는 데이터 안의 chain 차원을 사용하세요.
2. 크로스체인 데이터 — 한 쿼리로 sol, eth, bsc 등을 함께 반환할 수 있습니다.
3. 사전 집계 — DWM 레이어에서 분 단위로 materialize된 데이터입니다.

​

예시: 크로스체인 OHLC

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 }
    }
  }
}

​

예시: 체인별 토큰 거래 통계

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 }
    }
  }
}

---

​

Chain Group 비교

기능	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)	이벤트 + instruction 단위	사전 집계(DWM)
dataset 지원	예(대부분 Cube)	예(대부분 Cube)	예
aggregates 지원	예	예	예

---

​

관련 문서

데이터 Cube

25개 Cube 전체의 필드 구조와 사용 사례.

Dataset과 Aggregates

데이터 소스 범위와 사전 집계 동작 제어.