The Graph에서 마이그레이션하기
The Graph에서의 Kaia 지원은 2026년 8월 31일에 종료되었습니다. Kaia 서브그래프는 더 이상 색인이 생성되지 않으며, 해당 쿼리 엔드포인트는 더 이상 Kaia 데이터를 반환하지 않으며, Kaia는 Subgraph Studio에서 더 이상 배포 가능한 네트워크가 아닙니다.
사용 중인 DApp이 여전히 The Graph의 Kaia 서브그래프를 참조하고 있다면, Goldsky, SubQuery 또는 자체 호스팅 그래프 노드로 이동하십시오. 서브그래프 코드는 변경 없이 그대로 이어집니다.
무슨 일이 있었나요?
The Graph는 Kaia에 대한 지원을 중단했습니다. 이는 호스팅 인덱싱 서비스에만 영향을 미쳤습니다.
| 2026년 8월 31일 | Kaia 서브그래프의 색인 생성이 중단되었습니다. The Graph 게이트웨이의 쿼리 엔드포인트에서 Kaia 데이터를 더 이상 반환하지 않게 되었습니다. |
| 지금 | Kaia는 더 이상 Subgraph Studio에서 배포 가능한 네트워크가 아닙니다. Kaia용 graph deploy가 실패합니다. |
온체인 상에서는 아무런 변경 사항도 없습니다. 카이아 메인넷(8217)과 카이로스 테스트넷(1001), 사용자의 계약, 그리고 전체 이벤트 내역은 모두 영향을 받지 않습니다. Kaia RPC 엔드포인트를 읽는 모든 인덱서는 제네시스 블록부터 정확히 동일한 데이터를 재구성할 수 있습니다. 과거 기록이 손실된 부분이 없으며, 온체인에서 복구해야 할 사항도 없습니다.
여러분도 영향을 받고 계신가요?
다음 중 하나라도 해당된다면 귀하도 영향을 받게 됩니다:
- 앱은 Kaia 서브그래프를 가리키는
gateway.thegraph.com또는gateway-arbitrum.network.thegraph.com의 URL을 조회합니다. - 사용자의 앱은 Subgraph Studio(
api.studio.thegraph.com/query/...)에서 Kaia 서브그래프 엔드포인트에 쿼리를 보냅니다. graph deploy --studio명령어를 사용하여 Kaia 서브그래프를 배포하거나, The Graph의 분산형 네트워크에 게시할 수 있습니다.- 스택 내의 종속성, 대시보드 또는 분석 작업이 해당 엔드포인트 중 하나에서 데이터를 읽어옵니다.
코드베이스를 빠르게 확인하는 방법:
grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" .
다음 중 하나라도 해당된다면, 해당 쿼리는 이미 오류가 발생하고 있습니다. 마이그레이션을 수행하면 서비스가 복구됩니다.
Goldsky, SubQuery, 자체 호스팅 그래프 노드를 통해 Kaia를 색 인화하거나 Kaia RPC 엔드포인트를 직접 읽는 경우에는 영향을 받지 않습니다.
대안을 선택하세요
아래의 세 가지 옵션 모두 Kaia 메인넷과 Kairos를 인덱싱합니다.
| Goldsky | SubQuery | 자체 호스팅 그래프 노드 | |
|---|---|---|---|
| 기존 하위 그래프 실행 | 네 — 동일한 부분그래프 사양입니다. | 네 — IPFS 배포 ID를 통해 | 네 — 그건 그래프 노드입니다 |
| 이주 노력 | CLI 명령어 하나 | 기존 빌드 게시하기 | 자체 인프라 구축 |
| 호스팅 | 관리형 | 중앙 집중형 또는 분산형 네트워크 | 사용자가 직접 조작합니다 |
| 또한 다음과 같은 서비스를 제공합니다 | Mirror (데이터베이스 스트리밍), RPC, 파이프라인 | 단일 프로젝트 내의 멀티체인 인덱싱 | 완전한 제어 |
| 다음에 가장 적합합니다 | 가장 빠른 드롭인 교체 | 다중 체인 프로젝트, 탈중앙화 호스팅 | 공급업체에 대한 의존성을 원치 않는 팀들 |
가장 간편한 방법을 원하신다면 Goldsky를 사용하세요. Goldsky는 The Graph의 서브그래프 사양과 완벽하게 호환되므로, 기존 Kaia 서브그래프를 매핑, 스키마, 쿼리를 변경하지 않고 그대로 이전할 수 있습니다. 앱 내의 엔드포인트 URL만 변경되면 됩니다.
The Graph의 마이그레이션 가이드는 대개 라이브 쿼리 엔드포인트에서 서브그래프의 배포 해시를 확인하는 것으로 시작합니다. 카이아 서브그래프의 경우, 해당 종단점이 응답을 중단했기 때문에 더 이상 불가능합니다.
대신 서브그래프의 소스 저장소에서 배포하세요. 배포 ID가 필요하지 않으며, 동일한 빌드를 생성하고, 현재로서는 가장 신뢰할 수 있는 방법입니다. 이전에 IPFS 해시를 저장해 두었거나, Graph Explorer 또는 Subgraph Studio에서 서브그래프 페이지에서 여전히 해당 해시를 읽을 수 있는 경우에만 IPFS 해시를 사용하십시오.
옵션 1: Goldsky로 이전하기
1. Goldsky CLI 설치 및 인증
# macOS / Linuxcurl https://goldsky.com | sh# Windowsnpm install -g @goldskycom/cli
app.goldsky.com의 프로젝트 설정에서 API 키를 생성한 다음, 다음 단계를 따르세요:
goldsky login
CI 또는 헤드리스 환경의 경우:
goldsky login --token <API_KEY>
2. 소스에서 서브그래프 배포하기
서브그래프 프로젝트 디렉터리에서:
goldsky subgraph deploy <your-subgraph-name>/<version>
Goldsky는 사용자의 subgraph.yaml, schema.graphql 및 매핑 정보를 기반으로 구축한 후, 사용자가 설정한 시작 블록부터 Kaia에 대한 인덱싱을 시작합니다. 전체 내용은 서브그래프 배포를 참조하십시오.
이전 빌드의 IPFS 해시가 아직 남아 있다면, 대신 그 빌드를 그대로 배포할 수 있습니다:
goldsky subgraph deploy <your-subgraph-name>/<version> --from-ipfs-hash <your-subgraph-ipfs-hash>
3. 동기화가 완료될 때까지 기다린 후 엔드포인트를 전환하세요.
다음 방법을 통 해 진행 상황을 확인하세요:
goldsky subgraph list
시작 지점부터 카이아(Kaia) 기록을 다시 색인화하는 데는 시간이 걸리므로, 즉시 전환될 것이라고 기대하기보다는 이에 대비해 계획을 세워 두십시오. 서브그래프가 체인 헤드에 도달하면, 앱 내의 게이트웨이 URL을 다음과 같이 변경하십시오:
- const queryUrl = 'https://gateway.thegraph.com/api/<api-key>/subgraphs/id/<subgraph-id>';+ const queryUrl = 'https://api.goldsky.com/api/public/<project-id>/subgraphs/<name>/<version>/gn';
GraphQL 쿼리는 변경되지 않습니다. Goldsky에서 Kaia 서브그래프를 처음부터 구축하는 방법에 대한 자세한 안내는 Goldsky를 참조하십시오.
옵션 2: SubQuery로 마이그레이션
SubQuery는 기존 서브그래프 빌드를 실행할 수 있을 뿐만 아니라, 멀티체인 프로젝트를 위한 자체 SDK도 지원합니다.
-
SubQuery의 IPFS 게이트웨이를 기반으로 서브그래프를 구축하여 배포 ID(CID)를 생성하세요:
graph build -i https://unauthipfs.subquery.network/ipfs/api/v0서비스 종료 전에 Graph Explorer에서 배포 ID를 저장해 두셨다면, 그 ID를 대신 사용할 수 있습니다.
-
SubQuery Explorer를 열고 새 프로젝트 게시를 선택합니다.
-
CID와 프로젝트 메타데이터를 입력한 다음 게시하세요.
SubQuery Network는 GraphQL 구독 기능을 지원하지 않는다는 점에 유의하시기 바랍니다. Subgraph 프로젝트를 SubQuery 네트워크에 게시하기 및 Kaia 빠른 시작 가이드를 참조하거나, Kaia 전용 시작 가이드를 보려면 SubQuery 페이지를 확인하세요.
옵션 3: 그래프 노드 자체 호스팅
사용자의 부분 그래프는 이식 가능합니다. Kaia 아카이브 RPC 엔드포인트를 대상으로 graph-node를 직접 실행하고, 매핑, 스키마 및 쿼리를 현재 상태 그대로 유지할 수 있습니다.
Kaia RPC 엔드포인트(공개 엔드포인트를 참조하거나 자체 노드를 실행)와 PostgreSQL, IPFS가 필요합니다. 이를 통해 인프라를 직접 운영해야 하는 대가를 치르긴 하지만, 완전한 통제권을 확보할 수 있으며 공급업체에 대한 의존성을 없앨 수 있습니다.
전환 체크리스트
- 팀에서 관리하는 모든 Kaia 하위 그래프를 나열해 주세요. 여기에는 내부 대시보드와 분석 작업도 포함됩니다.
- 각 항목에 대한 소스 저장소와 시작 블록, 그리고 필요한 접목 구성을 찾아보세요.
- 각 서브그래프를 선택한 제공업체에 배포하십시오.
- 각 서브그래프가 체인 헤드와 동기화될 때까지 기다립니다.
- 새로운 엔드포인트에 대해 몇 가지 알려진 쿼리를 실행해 보고 결과가 올바른지 확인하십시오.
- 앱, 환경 변수 및 CI 시크릿에 지정된 엔드포인트 URL과 API 키를 업데이트하십시오.
- 서브그래프 엔드포인트를 사용하는 타사 연동 서비스나 파트너를 모두 업데이트하십시오.
- 앱을 배포하고, 새로운 엔드포인트에서 프로덕션 트래픽이 정상적으로 처리되는지 확인하십시오.
- Kaia에서만 사용되었던 The Graph 청구 정보 또는 API 키를 취소하십시오.
자주 묻는 질문
이것이 제 스마트 계약이나 온체인 데이터에 영향을 미치나요? 아니요. 호스팅되는 색인 서비스만 사라졌습니다. Kaia에 저장된 귀하의 계약, 거래 및 이벤트 로그는 변경되지 않았으며, 모든 인덱서를 통해 계속해서 완벽하게 조회할 수 있습니다.
서브그래프를 다시 작성해야 하나요?
아니요. Goldsky, SubQuery, 그리고 자체 호스팅 그래프 노드는 모두 표준 서브그래프 사양을 준수합니다. schema.graphql, 매핑 및 GraphQL 쿼리는 그대로 유지됩니다.
서브그래프의 배포 ID를 저장해 둔 적이 없습니다. 제 부분 그래프가 사라진 건가요?** 아닙니다. 배포 ID는 데이터가 아닌 빌드를 식별합니다. 소스 저장소에서 배포하면 새로운 인덱서가 체인에서 동일한 데이터 세트를 다시 구축합니다.
저도 더 이상 서브그래프 소스 코드를 가지고 있지 않습니다. 인덱싱된 데이터는 여전히 재구축할 수 있지만, 매핑과 스키마는 다시 작성해야 합니다. Goldsky 가이드를 참고하여, 계약의 ABI와 계약이 배포된 블록을 활용하여 시작하세요.
다른 체인에 대한 쿼리는 여전히 작동할까요? 네. 이 일은 카이아에게만 영향을 미쳤다. The Graph를 통해 다른 네트워크에서 실행하는 서브그래프는 영향을 받지 않습니다.
카이아가 특정 업체를 추천하고 있나요? 아닙니다. Goldsky는 단일 명령어로 마이그레이션이 가능하기 때문에 가장 빠르게 도입할 수 있는 방법이지만, SubQuery와 자체 호스팅 그래프 노드 역시 모두 유효한 선택지입니다. 자신의 스택에 맞는 것을 선택하세요.
마이그레이션에 도움이 필요합니다. Kaia 개발자 포럼이나 Kaia 디스코드에서 문의해 주세요. 대규모 또는 복잡한 하위 그래프를 운영 중이라면, Kaia 팀에 문의해 주시면 전환 계획을 수립하는 데 도움을 드리겠습니다.