Skip to main content
Version: v1

Midnight Indexer v3.0.0 release notes

  • Version: v3.0.0
  • Date: 2026-01-28
  • Environment: Preview, Preprod

High-level summary​

Indexer API를 v3으로 업데이트하며, Ledger v7과 Node 0.20을 완전 지원합니다. 호환성을 깨는 변경이 포함되어 모든 사용자에게 영향을 줍니다.

Audience​

다음 개발자가 확인해야 합니다:

  • Indexer API를 사용하는 개발자
  • Midnight Indexer를 운영하는 개발자

What changed (Summary of updates)​

  • Indexer API를 v1에서 v3으로 업데이트했습니다
  • Ledger v7 및 Node v0.20 완전 지원
  • 포괄적인 비차폐(unshielded) 토큰 기능
  • DUST/cNIGHT 추적 및 생성 상태
  • 거버넌스 시스템 파라미터 지원
  • 트랜잭션 메타데이터에 상태, 수수료, 실행 결과 추가
  • 원장 이벤트 지원

New features​

이번 릴리스의 새 기능입니다.

Unshielded tokens​

Indexer가 DUST 및 cNIGHT를 포함한 비차폐 토큰을 완전히 지원합니다. 비차폐 토큰은 컨트랙트가 소유할 수 있으며, 구독에 동기화 진행 데이터가 포함됩니다.

Governance​

D-Parameter 및 이용약관(T&C)을 지원합니다. 거버넌스 시스템 파라미터를 GraphQL API에서 조회하고 모니터링할 수 있습니다.

Transaction enhancements​

트랜잭션 메타데이터에 상태, 수수료, 실행 결과가 포함됩니다. 시스템 트랜잭션도 지원하며, ApplyStage가 세그먼트 결과를 포함하는 TransactionResult로 이름이 변경되었습니다.

API improvements​

클라이언트/서버 오류 타입을 포함하는 ApiError가 추가되었습니다. DB 쿼리 결과가 노드와 동일한 정렬 순서를 사용하며, 네트워크 ID 불일치 시 오류 처리가 개선되었습니다.

Improvements​

  • 더 이상 사용되지 않는 health 엔드포인트를 제거했습니다.
  • 구식 메트릭을 제거하고 연결된 지갑 게이지를 추가했습니다.
  • 시작 시 네트워크 ID를 소문자로 검증합니다.
  • 저장 시 원장 상태를 검증합니다.
  • 성능 향상을 위해 transactions(variant, id)에 복합 인덱스를 추가했습니다.

Breaking changes​

호환성을 깨는 변경과 필요한 조치 사항입니다.

API version change​

변경 내용: Indexer API가 v1에서 v3으로 변경되었습니다(v2는 건너뛰었습니다).

영향: v1 API 엔드포인트를 사용하는 모든 DApp에 영향을 줍니다.

필요한 조치: API 호출을 v3 엔드포인트 및 스키마로 업데이트하세요.

Node and Ledger compatibility​

변경 내용: Node 0.12 지원이 제거되었으며, Node v0.20 및 Ledger v7만 지원합니다.

영향: 이전 Ledger 또는 Node 버전을 사용하는 DApp은 Indexer v3에서 동작하지 않습니다.

필요한 조치: Ledger를 v7로, Node를 v0.20.0으로 업데이트하세요.

Network ID format​

변경 내용: 네트워크 ID가 열거형에서 문자열로 변경되었으며 소문자여야 합니다.

영향: 대문자 또는 열거형 기반 네트워크 ID를 전달하는 애플리케이션에 영향을 줍니다.

필요한 조치: 네트워크 ID 참조를 소문자 문자열로 업데이트하세요(예: NetworkId.Preview 대신 "preview").