Midnight Indexer 4.0.0

Release notes

Release name

Version: 4.0.0
Date: 2026-03-17

High-level summary

This release mainly bumps the API version to v4 and adds support for Node 0.22 and Ledger 8.

Audience

This release note is critical for developers who:

• use the Midnight Indexer via the Indexer API
• run the Midnight Indexer

What changed

• (indexer-api) Replace deterministic session ID with random per-session token (#807)
• Use storage-core v1.1 with layout v2 (#861)
• Replace window function with scalar subquery in ledger events query (#890)
• Batch ledger_db_nodes inserts to reduce SQL roundtrips (#892)

New features

• (indexer-api) Bump API version to v4
• (indexer-api) /api/v3 alias for /api/v4 for backwards compatibility (#815)

Bug fixes

• Use lazy loading for ledger state deserialization to avoid recursion depth limit (#871)

Required Updates

• All users are encouraged to use API v4. API v3 is still supported, but will be deprecated soon and eventually removed
• The internal database format has changed and hence it is necessary to start with a fresh/empty database

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0/docs/api/v3/api-documentation.md
• Chain Indexer Docker image: https://hub.docker.com/r/midnightntwrk/chain-indexer
• Indexer API Docker image: https://hub.docker.com/r/midnightntwrk/indexer-api
• Wallet Indexer Docker image: https://hub.docker.com/r/midnightntwrk/wallet-indexer
• Indexer Standalone Docker image: https://hub.docker.com/r/midnightntwrk/indexer-standalone