Skip to main content
For the complete documentation index, see llms.txt

Midnight Explorer

Midnight Explorer는 Midnight Network을 위한 오픈소스 blockchain explorer입니다. 트랜잭션, 블록, 스마트 컨트랙트, liquidity pool을 비롯한 on-chain 활동을 검색하고 추적하며 분석할 수 있는 web 인터페이스를 제공합니다. TexLabs가 Tech-Expansion GitHub 조직에서 이 프로젝트를 관리하며, midnightexplorer.com에서 공개 인스턴스를 운영합니다.

Community-maintained - not audited

이 프로젝트는 Midnight Foundation이 아니라 TexLabs가 관리합니다. 감사(audit)를 받지 않았습니다. production 결정에 이 데이터를 활용하기 전에 직접 검토하세요.

Prerequisites​

explorer를 로컬에서 실행하기 전에 다음을 갖췄는지 확인하세요:

  • Node.js 20 이상.
  • npm.
  • 컨테이너 기반 배포를 사용할 계획이라면 Docker.

Compatibility​

ComponentVersionNotes
Explorer version0.1.0정식 릴리스 없음. main 브랜치에서 코드를 받습니다.
@midnight-ntwrk/compact-runtime^0.9.0package.json에 명시됨.
@midnight-ntwrk/midnight-js-types^2.0.2package.json에 명시됨.
@midnight-ntwrk/zswap^4.0.0package.json에 명시됨.
NetworksPreview, Preprod, Mainnet Lite헤더의 network switcher에서 선택합니다. 공개 인스턴스는 기본적으로 Preprod를 제공합니다.
LicenseApache 2.0

Features​

explorer는 다음과 같은 화면을 제공합니다:

  • Universal search: 블록, 트랜잭션, address, 컨트랙트를 hash나 ID로 조회합니다.
  • Block explorer: 최신 블록을 전체 블록 상세 정보 및 트랜잭션 목록과 함께 살펴봅니다.
  • Transaction viewer: 트랜잭션 데이터, input, output, 컨트랙트 상호작용을 확인합니다.
  • Address explorer: address의 이력, 잔액, 연관된 컨트랙트를 봅니다.
  • 스마트 컨트랙트: 배포된 컨트랙트와 그 on-chain state를 살펴봅니다.
  • Pool analytics: liquidity pool의 지표와 활동을 추적합니다.
  • Network charts: on-chain 통계와 시간에 따른 추세를 시각화합니다.
  • Live network stats: 현재 epoch, slot, 총 블록 수, 트랜잭션 수, 평균 블록 생성 시간을 모니터링합니다.
  • Network switcher: 헤더에서 Midnight 환경을 전환합니다.

Run the explorer locally​

의존성을 설치하고 개발 서버를 실행합니다:

npm install
npm run dev

dev 스크립트는 포트 8081에서 Next.js를 실행합니다. 브라우저에서 http://localhost:8081을 엽니다.

이 프로젝트는 Next.js 15 (App Router), TypeScript, Tailwind CSS v4, Radix UI, TanStack Query, Recharts, PostgreSQL을 사용합니다.

Deployment​

저장소에는 컨테이너 기반 호스팅을 위한 Dockerfile과 Nginx compose 파일(docker-compose.nginx.yml)이 함께 들어 있습니다. README에는 Let's Encrypt를 이용한 HTTPS 설정, 인증서 자동 갱신, 무중단 업데이트를 위한 blue-green 전략이 정리되어 있습니다. 전체 배포 명령은 project README를 참고하세요.

Additional resources​

Report issues​

explorer 관련 문제는 TexLabs' tracker에 등록하세요.

이 문서 페이지 관련 문제는 Midnight docs repository에 등록하세요.