> For the complete documentation index, see [llms.txt](https://docs.midnight.network/llms.txt)

# Midnight Indexer

The Midnight Indexer is a set of components designed to optimize the flow of blockchain data from a Midnight node to end-user applications. It retrieves history of blocks, processes them, stores indexed data efficiently, and provides a GraphQL API for queries and subscriptions.

***

9 May 2025

## Midnight Indexer 2.0.0 Release Notes[​](#midnight-indexer-200-release-notes "Direct link to Midnight Indexer 2.0.0 Release Notes")

### Stable Release[​](#stable-release "Direct link to Stable Release")

* **Version**: 2.0.0
* **Audience**: Node operators, developers integrating with the Midnight ecosystem
* **Environment**: Production-ready

This release (2.0.0) is considered stable and production-ready. It can safely be deployed in public and production environments.

### Key Changes & Highlights[​](#key-changes--highlights "Direct link to Key Changes & Highlights")

note

This release requires wallet-sdk v5.0.0+ (compatible with Lace Wallet v3.0.0 or higher).

This 2.0.0 release of the Midnight Indexer accompanies the 0.12.0 release of the Midnight Node and the 4.0.0 release of the Midnight Ledger. This release also marks the end of life of the previous Scala based Indexer.

This release also introduces breaking changes to the GraphQL API v1, mainly related to consistent and meaningful naming but also to the GraphQL subscription for wallet events.

### Changelog[​](#changelog "Direct link to Changelog")

#### Features[​](#features "Direct link to Features")

* Redesign wallet subscription `ProgressUpdates` (indexer-api)
* Add tracing to API (indexer-api)
* Add counters for all GraphQL operations (indexer-api)
* Clean naming and inputs (indexer-api)
* Only support bech32m encoded keys/addresses
* Rename contract query and subscription `contract_action` (indexer-api)

#### Bug Fixes[​](#bug-fixes "Direct link to Bug Fixes")

* Add missing logging for wallet subscription (indexer-api)
* Skip collapsed update for failed transactions (indexer-api)
* Add transaction to `ContractCallOrDeploy` (indexer-api)
* Add `deploy` to `ContractCall` (indexer-api)
* Silence harmless database error in `active_wallets` (wallet-indexer)

#### Refactor[​](#refactor "Direct link to Refactor")

* Use `log`, `logforth` and `fastrace` for telemetry
* Replace bytes attribute with byte newtypes
* Pass `SessionId` (Copy) by value
* Move `main/run` into `main.rs`
* Pass block and tx hashes (arrays) by value (indexer-api)
* Lazy resolving of transactions and contract actions (indexer-api)

#### Miscellaneous[​](#miscellaneous "Direct link to Miscellaneous")

* Apply consistent error handling (indexer-api)
* More debug logging (indexer-api)

### Breaking Changes[​](#breaking-changes "Direct link to Breaking Changes")

#### Migration from Scala-based to Rust-based indexer[​](#migration-from-scala-based-to-rust-based-indexer "Direct link to Migration from Scala-based to Rust-based indexer")

**Impact**: API endpoints are similar, but internal implementation and performance characteristics differ **Action Required**:

* Test integrations against the new Rust-based indexer at: `https://indexer-rs.testnet-02.midnight.network/api/v1/graphql`
* Begin migration from the old endpoint (`indexer.testnet-02...`)
* Verify that your system meets the necessary dependencies for PostgreSQL and NATS (cloud) or SQLite (standalone).
* Ensure network access to a running Midnight Node.
* Notice that the Midnight Node 0.12.0 required a chain-reset and hence the storage (PostgreSQL/SQLite and NATS) need to be reset.

### Known Issues[​](#known-issues "Direct link to Known Issues")

* **macOS Compatibility**: Limited testing on macOS. Users may experience issues with native SQLite integration.
* **Windows Support**: Functional but not officially supported. Linux is the recommended environment.

### Compatibility[​](#compatibility "Direct link to Compatibility")

* Midnight Ecosystem: Fully compatible with Midnight Node 0.12 and related infrastructure.
* Operating Systems: Fully tested on Linux, with limited support for Windows and macOS.

### Additional Resources[​](#additional-resources "Direct link to Additional Resources")

* **Community Support**: Join the discussion on [Discord](https://discord.com/invite/midnightnetwork)

### Upgrade/Migration Guide[​](#upgrademigration-guide "Direct link to Upgrade/Migration Guide")

#### Prerequisites[​](#prerequisites "Direct link to Prerequisites")

* PostgreSQL installed and configured (for production)
* Network access to a Midnight node

### Installation & Migration:[​](#installation--migration "Direct link to Installation & Migration:")

* Deploy new indexer binary
* Connect to appropriate backend (SQLite or PostgreSQL)
* Point your API integration to the new endpoint

### Post-Upgrade Checks[​](#post-upgrade-checks "Direct link to Post-Upgrade Checks")

* Confirm GraphQL queries resolve as expected
* Monitor logs for error-free startup
