Skip to content

doc: restructure release notes #780

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gyrationtechs wants to merge 7 commits into
base: main
Choose a base branch
from
+73 −89
Open

doc: restructure release notes #780

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
0547549
doc: restructure release notes
gyrationtechs Mar 31, 2026
4e9740e
doc: Update to implement sentence case capitalization
gyrationtechs Mar 31, 2026
e185161
fix: update compact-js release notes link
gyrationtechs Mar 31, 2026
0bb166c
doc: implement review feedback
gyrationtechs Apr 1, 2026
04a249f
Merge branch 'main' into doc/relnotes-restructure
gyrationtechs Apr 2, 2026
2ef88af
doc: Update release note template
gyrationtechs Apr 3, 2026
9aa80be
fix: resolve merge conflicts
gyrationtechs Apr 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion RELEASE_NOTE_TEMPLATE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# <component><version> (Example: Midnight.js 3.1.0)

* **Date**: YYYY-MM-DD
* **Environment**: All public networks at time of release. For the full compatibility matrix, see the [release notes overview](https://docs.midnight.network/next/relnotes/overview).
* **Environment**: All public networks at time of release. For the full compatibility matrix, see the [release notes overview](https://docs.midnight.network/relnotes/overview).

## High-level summary

Expand Down
46 changes: 46 additions & 0 deletions docs/relnotes/network.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
title: "Environments and endpoints"
sidebar_label: "Environments and endpoints"
description: "Environments and endpoints for Midnight."
keywords: [environments, endpoints]
sidebar_position: 15
---

# Environments and endpoints

Midnight uses dedicated network services such as RPC nodes, indexer API, and proof server to power DApp development and interaction across the Preview, Preprod, and Mainnet environments.

## Preview

The Preview environment is intended for early-stage development and experimentation.
Use these endpoints to connect your DApp to Midnight Preview environment.

| Service | URL |
| --- | --- |
| Node RPC | https://rpc.preview.midnight.network |
| Proof server | https://lace-proof-pub.preview.midnight.network |
| Indexer (GraphQL) | https://indexer.preview.midnight.network/api/v4/graphql |
| Faucet UI | https://faucet.preview.midnight.network/ |
| Block explorer | https://explorer.preview.midnight.network |
| cNgD DApp | https://dust.preview.midnight.network |

## Preprod

The Preprod environment is designed for final testing before mainnet deployment.
Use these endpoints to connect your DApp to Midnight Preprod environment.

| Service | URL |
| --- | --- |
| Node RPC | https://rpc.preprod.midnight.network |
| Proof server | https://lace-proof-pub.preprod.midnight.network |
| Indexer (GraphQL) | https://indexer.preprod.midnight.network/api/v4/graphql |
| Faucet UI | https://faucet.preprod.midnight.network/ |
| Block explorer | https://explorer.preprod.midnight.network |
| cNgD DApp | https://dust.preprod.midnight.network |

## Mainnet

:::important
Mainnet public endpoints are not yet published. They will be added here when available.
:::

88 changes: 13 additions & 75 deletions docs/relnotes/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
---
SPDX-License-Identifier: Apache-2.0
copyright: This file is part of midnight-docs. Copyright (C) 2025 Midnight Foundation. Licensed under the Apache License, Version 2.0 (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
title: "Release Overview"
title: "Release overview"
hide_title: true
displayed_sidebar: sidebar

---

<h1 style={{ marginBottom: '0.1rem' }}>Latest Stable Release</h1>
<h1 style={{ marginBottom: '0.1rem' }}>Latest stable release</h1>

<div
style={{
Expand All @@ -23,84 +22,23 @@ displayed_sidebar: sidebar

This release delivers Midnight Ledger 8.0 on Preview, Preprod, and Mainnet, including updates to the runtime, SDKs and tooling.


---

## Environments

Following are useful links for respective Preview, Preprod, and Mainnet environments for DApp development.

### Preview
- **Node RPC**: https://rpc.preview.midnight.network
- **Proof Server**: https://lace-proof-pub.preview.midnight.network
- **Indexer (GraphQL)**: https://indexer.preview.midnight.network/api/v3/graphql
- **Faucet UI**: https://faucet.preview.midnight.network/
- **Block Explorer**: https://explorer.preview.midnight.network
- **cNgD DApp**: https://dust.preview.midnight.network

### Preprod
- **Node RPC**: https://rpc.preprod.midnight.network
- **Proof Server**: https://lace-proof-pub.preprod.midnight.network
- **Indexer (GraphQL)**: https://indexer.preprod.midnight.network/api/v3/graphql
- **Faucet UI**: https://faucet.preprod.midnight.network/
- **Block Explorer**: https://explorer.preprod.midnight.network
- **cNgD DApp**: https://dust.preprod.midnight.network

### Mainnet

Mainnet public endpoints are not yet published. They will be added here when available.

---

## Compatibility matrix
Midnight uses dedicated network services such as RPC nodes, indexer API, and proof server to power DApp development and interaction across the Preview, Preprod, and Mainnet environments. To connect your application and configure these services correctly, see the [Environments and endpoints](./network) reference.

The following compatibility matrix denotes versions that have been tested to work together on the Preview, Preprod, and Mainnet environments as of this release.

### Preview

| Component | Version |
|---------|--------|
| Ledger | 8.0.3 |
| Node | 0.22.3 |
| Proof Server | 8.0.3 |
| On-chain Runtime | 3.0.0 |
| Compact Runtime | 0.15.0 |
| Compact Toolchain (`compact`) | 0.5.1 |
| Compact Compiler (`compactc`) | 0.30.0 |
| Compact JS | 2.5.0 |
| Platform JS | 2.2.4 |
| Indexer | 4.0.1 |
| DApp Connector API | 4.0.1 |
| Wallet SDK Facade | 3.0.0 |
| Midnight.js | 4.0.2 |
| testkit-js | 4.0.2 |
| Block Explorer | 0.5.0 |
| Faucet | 0.11.9 |

### Preprod & Mainnet
---

## Compatible components

| Component | Version |
|---------|--------|
| Ledger | 8.0.3 |
| Node | 0.22.2 |
| Proof Server | 8.0.3 |
| On-chain Runtime | 3.0.0 |
| Compact Runtime | 0.15.0 |
| Compact Toolchain (`compact`) | 0.5.1 |
| Compact Compiler (`compactc`) | 0.30.0 |
| Compact JS | 2.5.0 |
| Platform JS | 2.2.4 |
| Indexer | 4.0.1 |
| DApp Connector API | 4.0.1 |
| Wallet SDK Facade | 3.0.0 |
| Midnight.js | 4.0.2 |
| testkit-js | 4.0.2 |
| Block Explorer | 0.5.0 |
| Faucet | 0.11.9 (Preprod only) |
Building on Midnight requires a set of compatible components to work properly. When creating DApps, it’s important to use the latest stable version of each component.

---
To view the full list of components and their compatible versions, see the [Compatibility matrix](./support-matrix).

## Release notes & references
---

## Release notes and references

This list contains detailed release notes for each of the components that are required for DApp development.

Expand All @@ -120,12 +58,12 @@ This list contains detailed release notes for each of the components that are re
https://github.com/midnightntwrk/midnight-dapp-connector-api/releases

- Wallet SDK
https://github.com/midnightntwrk/midnight-wallet/blob/main/RELEASE_NOTES.md
https://github.com/midnightntwrk/midnight-wallet/tree/main/release-notes

- Midnight.js
https://github.com/midnightntwrk/midnight-js/releases

- Compact JS
https://www.npmjs.com/package/@midnight-ntwrk/compact-js?activeTab=versions
https://github.com/midnightntwrk/midnight-sdk/blob/cjs-2.5.0/compact-js/RELEASE_NOTES.md

---
26 changes: 13 additions & 13 deletions docs/relnotes/support-matrix.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ copyright: This file is part of midnight-docs. Copyright (C) 2025 Midnight Found
title: Compatibility matrix
displayed_sidebar: sidebar
hide_table_of_contents: true
sidebar_position: 1
sidebar_position: 10
---

# Compatibility matrix
Expand All @@ -15,23 +15,23 @@ sidebar_position: 1
This matrix only reflects the latest tested versions. Earlier versions may still work, but we do not guarantee compatibility or provide support for them.
:::

| **Functional Area** | **Component** | **Version** | **Notes** |
| Functional area | Component | Version | Notes |
|----------------------------|-------------------------------------|-------------|---------------------------------------------|
| Network | Network | **Preprod/Preview/Mainnet** | Current network environments |
| | Node (Midnight) | 0.22.3 | Preview |
| | | 0.22.2 | Preprod & Mainnet |
| Runtime & Contracts | Compact Toolchain (`compact`) | 0.5.1 | Installs compilers, compiles contracts |
| | Compact Compiler (`compactc`) | 0.30.0 | Contract compiler for Midnight |
| | Compact Runtime | 0.15.0 | Runtime library for contracts |
| Network | Network | Preprod/Preview/Mainnet | Current network environments |
| | Node (Midnight) | 0.22.3 | Preview |
| | | 0.22.2 | Preprod and Mainnet |
| Runtime and contracts | Compact devtools (`compact`) | 0.5.1 | Installs compilers, compiles contracts |
| | Compact toolchain (`compact compile`) | 0.30.0 | Contract compiler for Midnight |
| | Compact runtime | 0.15.0 | Runtime library for contracts |
| | Compact JS | 2.5.0 | TypeScript execution environment for compiled contracts |
| | Platform JS | 2.2.4 | Core abstractions and types |
| | On-chain Runtime | 3.0.0 | On-chain runtime support (v3) |
| | On-chain runtime | 3.0.0 | On-chain runtime support (v3) |
| | Ledger | 8.0.3 | Core ledger logic |
| SDKs & APIs | Wallet SDK Facade | 3.0.0 | SDK for building wallet integrations |
| SDKs and APIs | Wallet SDK facade | 3.0.0 | SDK for building wallet integrations |
| | Midnight.js | 4.0.2 | DApp framework: contracts, types, providers |
| | testkit-js | 4.0.2 | E2E testing framework |
| | DApp Connector API | 4.0.1 | Interface between DApps and wallets |
| Indexing & Data | Midnight Indexer | 4.0.1 | Midnight-specific blockchain indexer (v4) |
| ZK & Proving Services | Proof Server | 8.0.3 | Handles ZKP proof generation |
| Tools | Block Explorer | 0.5.0 | On-chain data browser |
| Indexing and data | Midnight Indexer | 4.0.1 | Midnight-specific blockchain indexer (v4) |
| ZK and proving services | Proof server | 8.0.3 | Handles ZKP proof generation |
| Tools | Block explorer | 0.5.0 | On-chain data browser |
| | Faucet (tNIGHT) | 0.11.9 | Test token distribution for testnets |
Loading