The Graph — a subgraph is an index you have to design

The Graph indexes chain events into a GraphQL API via a subgraph, moving the modeling work upstream: what you fail to index at deploy time you cannot query later without a re-sync.

Not yet scoped.

Why

The PoC writes and deploys one subgraph for a sample contract and contrasts its query ergonomics with raw RPC, making the index-design tradeoff explicit.

How it works

Not yet built.

Where it lands in Jayverse

Verex: design the subgraph schema for markets, orders and settlements before the first deploy. What is not indexed at deploy time cannot be queried later without a re-sync, and Verex's query ergonomics depend entirely on decisions made before any data exists.
gitboard: treat The Graph as one option for the projection layer this dashboard already needs. The comparison against raw RPC this PoC produces is the concrete evidence for choosing between a subgraph and the hand-rolled indexer from the-app-reads-a-projection.

Key expressions

Words and phrases from this page worth keeping, with the Korean meaning and the sentence they come from.

Expression	뜻 · 쓰이는 자리
move upstream	(작업을) 더 이른 단계로 앞당기다 · 나중에 할 일을 미리 처리해야 할 때. "moving the modeling work upstream"
without a re-sync	재동기화 없이는 · 처음부터 데이터를 다시 색인하지 않고서는. "cannot query later without a re-sync."
query ergonomics	조회(쿼리)의 사용 편의성 · API가 얼마나 쓰기 편한지를 말할 때. "contrasts its query ergonomics with raw RPC"
make explicit	~을 명시적으로 드러내다 · 암묵적이던 트레이드오프를 분명하게 보여줄 때. "making the index-design tradeoff explicit."
fail to index	색인화하지 못하다, 빠뜨리다 · 필요한 데이터를 미리 색인하지 않았을 때. "what you fail to index at deploy time"
GraphQL	그래프 기반 API 쿼리 언어(제품/기술명) · The Graph가 체인 이벤트를 색인해 제공하는 질의 인터페이스 형식. "The Graph indexes chain events into a GraphQL API"

← All Knowledge Notes · Workspace Index · Top ↑

The Graph — 서브그래프는 설계해야 하는 인덱스다

The Graph는 서브그래프를 통해 체인 이벤트를 GraphQL API로 인덱싱하며, 모델링 작업을 상류로 옮깁니다: 배포 시점에 인덱싱하지 못한 것은 재동기화 없이는 나중에 조회할 수 없습니다.

아직 범위 미정.

왜

이 PoC는 샘플 컨트랙트용 서브그래프 하나를 작성·배포하고 그 조회 편의성을 원시 RPC와 대조해, 인덱스 설계의 트레이드오프를 드러냅니다.

동작 방식

아직 만들지 않음.

Jayverse에서의 위치

Verex: 첫 배포 전에 마켓, 주문, 정산에 대한 서브그래프 스키마를 설계한다. 배포 시점에 인덱싱하지 않은 것은 나중에 재동기화 없이 쿼리할 수 없다. Verex의 쿼리 편의성은 데이터가 존재하기 전에 내린 결정에 전적으로 달려 있다.
gitboard: The Graph를 이 대시보드가 이미 필요로 하는 프로젝션 레이어의 한 옵션으로 다룬다. 이 PoC가 만드는 raw RPC 대비 비교가, 서브그래프와 the-app-reads-a-projection의 수작업 인덱서 중 무엇을 고를지에 대한 구체적 근거가 된다.

핵심 표현

이 페이지의 영어 본문에서 배울 만한 단어와 표현, 뜻과 나온 자리.

Expression	뜻 · 쓰이는 자리
move upstream	(작업을) 더 이른 단계로 앞당기다 · 나중에 할 일을 미리 처리해야 할 때. "moving the modeling work upstream"
without a re-sync	재동기화 없이는 · 처음부터 데이터를 다시 색인하지 않고서는. "cannot query later without a re-sync."
query ergonomics	조회(쿼리)의 사용 편의성 · API가 얼마나 쓰기 편한지를 말할 때. "contrasts its query ergonomics with raw RPC"
make explicit	~을 명시적으로 드러내다 · 암묵적이던 트레이드오프를 분명하게 보여줄 때. "making the index-design tradeoff explicit."
fail to index	색인화하지 못하다, 빠뜨리다 · 필요한 데이터를 미리 색인하지 않았을 때. "what you fail to index at deploy time"
GraphQL	그래프 기반 API 쿼리 언어(제품/기술명) · The Graph가 체인 이벤트를 색인해 제공하는 질의 인터페이스 형식. "The Graph indexes chain events into a GraphQL API"

← 전체 기술 노트 · 워크스페이스 인덱스 · 맨 위 ↑