Midnight Indexer 4.1.0

Release notes

Release name

Version: 4.1.0
Date: 2026-04-20

🚀 Features

• Log wallet ID on connect and disconnect mutations (#935)
• (indexer-api) Add query for zswap collapsed update (#982)
• Support node v1.0 (#985)
• (indexer-api) Add zswap Merkle tree root to block (#988)
• Add efficient dust wallet synchronisation endpoints (#980)
• Remove support for node 0.20 and 0.21 (#986)
• Add shieldedNullifierTransactions subscription (#996)
• Bridge async-graphql tracing to fastrace (#1037)
• Avoid unnecessary scans of shielded transactions (#1039)
• Support ledger 8.1 (#1033)
• Add node 1.0.0-rc.2 metadata and remove rc.1 (#1041)

🐛 Bug Fixes

• Pin upload-sarif-github-action to latest SHA (KICS/Trivy disabled)
• Add start_period to postgres healthcheck in docker-compose (#936)
• (chain-indexer) Falling back to metadata of parent block (#970)
• Per-generation capacity calculation and cursor pagination for dust queries (#997)
• (indexer-api) Make standalone sqlite spo queries match postgres (#977)
• (api) Align dustCommitmentMerkleTreeUpdate with zswapMerkleTreeCollapsedUpdate pattern (#1023)
• Compute transaction fees using ledger's Transaction::fees() API (#1031)

🚜 Refactor

• Simplify and make recent code more consistent (#1035)

⚡ Performance

• (indexer-api) Introduce DataLoader for block-by-hash lookups (#1018)
• (indexer-api) Introduce DataLoader for transactions-by-block-id lookups (#1022)
• (indexer-api) Introduce DataLoader for contract-actions-by-transaction-id lookups (#1030)
• (indexer-api) Introduce DataLoader for transaction-by-id lookups (#1027)

⚙️ Miscellaneous Tasks

• (security) Fix vulnerability (#914)
• (api) Add fee field and deprecate estimatedFees and fees wrapper (#1036)
• Bump midnight-storage-core to 1.2.0-rc.2 (#1052)
• Remove unused node 0.20 and 0.21 data (#1042)

Audience

This release note is critical for developers who:

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

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.1.0/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.1.0/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.1.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

Midnight Indexer 4.0.1

Release notes

Release name

Version: 4.0.1
Date: 2026-03-25

High-level summary

This is a hotfix release for a single issue.

Audience

This release note is critical for developers who:

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

Bug fixes

• Correct timestamp unit mismatch in currentCapacity calculation (#929)

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.1/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.1/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.1/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

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

v4.0.0-rc.9

Release notes

Release name

Version: 4.0.0-rc.9
Date: 2026-03-16

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

What changed

Refactor

• Batch ledger_db_nodes inserts to reduce SQL roundtrips (#892)
• Rename cardano_address DB column to cardano_stake_key for clarity (#902)

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.9/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.9/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.9/docs/api/v4/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

v4.0.0-rc.10

Release notes

Release name

Version: 4.0.0-rc.10
Date: 2026-03-16

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

What changed

Bug Fix

• Flush pending inserts before delete/root-count to preserve batch_update ordering (#904)

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.10/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.10/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.10/docs/api/v4/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

v4.0.0-rc.7

Release notes

Release name

Version: 4.0.0-rc.7
Date: 2026-03-13

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

What changed

Refactor

• Replace window function with scalar subquery in ledger events query (#890)

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.7/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.7/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.7/docs/api/v4/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

v4.0.0-rc.6

Release notes

Release name

Version: 4.0.0-rc.6
Date: 2026-03-12

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.6/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.6/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.6/docs/api/v4/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

v4.0.0-rc.5

Release notes

Release name

Version: 4.0.0-rc.5
Date: 2026-03-06

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

What changed

Bug Fixes

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

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.5/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.5/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.5/docs/api/v4/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

v4.0.0-rc.4

Release notes

Release name

Version: 4.0.0-rc.4
Date: 2026-03-04

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage.

Audience

This release note is critical for developers who:

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

What changed

Features

• Use storage-core v1.1 with layout v2 (#861)

Miscellaneous

• Drop year from copyright notices (#848)

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.4/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.4/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.4/docs/api/v4/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

v4.0.0-rc.3

Release notes

Release name

Version: 4.0.0-rc.3
Date: 2026-03-02

High-level summary

This pre-release is for testing purposes only and not suitable for production grade usage. It fixes a rare bug.

Audience

This release note is critical for developers who:

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

What changed

Bug fixes

• Prevent processes from hanging on termination (#844)

Required Updates:

• The API of Indexer v4.0 is backwards compatible with v3.x when using /api/v3
• Requires node v0.22.0+ and ledger v8.0.0+

Links and references

• Full changelog: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.3/CHANGELOG.md
• Indexer API schema: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.3/indexer-api/graphql/schema-v4.graphql
• Indexer API docs/examples: https://github.com/midnightntwrk/midnight-indexer/blob/v4.0.0-rc.3/docs/api/v4/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