diff --git a/docs/stagenet/_category_.yaml b/docs/stagenet/_category_.yaml new file mode 100644 index 00000000..ad29943e --- /dev/null +++ b/docs/stagenet/_category_.yaml @@ -0,0 +1,9 @@ +position: 11 +label: 'Stagenet (beta)' +collapsible: true # make the category collapsible +collapsed: true # keep the category closed by default +link: + type: doc + id: index +customProps: + description: Delivery notes for the Stagenet release-candidate environment, including tested component versions and artifact checksums. diff --git a/docs/stagenet/artifact-checksums.mdx b/docs/stagenet/artifact-checksums.mdx new file mode 100644 index 00000000..2eb487a2 --- /dev/null +++ b/docs/stagenet/artifact-checksums.mdx @@ -0,0 +1,104 @@ +--- +SPDX-License-Identifier: Apache-2.0 +copyright: This file is part of midnight-docs. Copyright (C) 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: Artifact checksums +description: SHA-256 checksums and image digests for every component delivered in the Midnight 2.0 Stagenet beta (Q2 2026). +id: artifact-checksums +displayed_sidebar: sidebar +sidebar_position: 3 +tags: [stagenet, releases, checksums, verification] +--- + +# Artifact checksums: Midnight 2.0 Stagenet beta (Q2) + +:::warning Draft + +This section is a draft shared for partner review. Content is subject to change and is not part of the published documentation set. + +::: + +SHA-256 checksums for the Q2 delivery components. All values are published and independently verifiable, except the ledger item noted at the end. Verified 2026-07-10. + +## npm components (SHA-256 of the published .tgz) + +Each file is the published `.tgz` from the npm registry; the SHA-256 is computed from that archive. To verify, download each `dist.tarball`, then run `shasum -a 256 -c`. + +```text +ba3897b8ac1fac72f0544ed721f6639fc0f09fbcf7aeb62252475d118edf8d5e midnight-js-5.0.0-beta.4.tgz +e9d24d0cba7fe806d68916ec7a6822f27ce6e0532473f2c0203b980601007dcc compact-js-2.5.5-rc.6.tgz +3b8402724f7087a6b94f58c3ea676b112124e85c8cd632c99a536a7a398b07fc compact-runtime-0.18.0-rc.1.tgz +cbe37c50a73475232e5ba3b3fca684b36acedfda722e9df60edaa39914cd617c wallet-sdk-2.0.0-beta.2.tgz +``` + +Tarballs on the public registry follow the pattern `https://registry.npmjs.org//-/.tgz`. Note the organization split: Compact.js, Compact runtime, and Midnight.js are under `@midnight-ntwrk` (with a hyphen); the wallet SDK is under `@midnightntwrk` (no hyphen). npm also publishes an SRI `dist.integrity` (SHA-512) per version. + +Midnight.js is a meta-package: the root `.tgz` (about 3.4 KB) pins the scoped sub-packages (`-contracts`, `-protocol`, `-types`, `-utils`, `-network-id`) at the same version, which is where the code lives. `5.0.0-beta.4` is the Ledger RC3 stack build. If the full set is required, the sub-package tarballs hash alongside the root. + +## Node 2.0.0-rc.4 (release-attached SHA256SUMS) + +Source: GitHub release `node-2.0.0-rc.4` assets (`SHA256SUMS` and `srtool-digest.json`). + +```text +2bfd0f768a88d0d1d49cc97bfd6b9f4401646458887219e8c021bff8d9a9ae0b midnight-node-2.0.0-rc.4-linux-arm64.tar.gz +33d756ca39e6623e5718222c2e3ff9271e8b6eea00dea5bf4564d1b80e743479 midnight_node_runtime-2.0.0-rc.4.wasm +85513afbfe4dd3fccadde6ad5d7ccf82b8fa0c88d010445fc62c223c9ef078eb midnight-node-toolkit-2.0.0-rc.4-linux-arm64.tar.gz +bd98bcf938e24e8764d56a072ec9c1434b0e819b6f049240a6c428524d0b0edf midnight_node_runtime-2.0.0-rc.4.compact.wasm +f0397437ad4c1efa9e96c9ba1be17ac2168757471cbe96cef656576c74593d60 midnight-node-2.0.0-rc.4-linux-amd64.tar.gz +f0905d38bae87f97c888c09fd95df6b3a4d235475695a383d4b81a14d134a778 midnight_node_runtime-2.0.0-rc.4.compact.compressed.wasm +fdd9f6974c1c20928d3b9dc79c13c51bf984eb6dc4cdaf1978a1b037794402de midnight-node-toolkit-2.0.0-rc.4-linux-amd64.tar.gz +``` + +The srtool reproducible-build runtime is blake2_256 `0x15ff2c42eca1fd6399271532cea505a32162b1a7067d6a583f9774588ea94451`, spec_version 2000000. + +## Compact compiler 0.33.0-rc.2 (per-asset SHA-256) + +Source: GitHub release `compactc-v0.33.0-rc.2` at `LFDT-Minokawa/compact`. Pin the platform your delivery targets. + +```text +35a28009c9a57d20902e4fcfd12f0ca9ea94338208954cf8bcd335652e24f382 compactc_v0.33.0-rc.2_aarch64-darwin.zip +3aa23812b0b086dbce07da3931a40dcb01bec9676b1ceed7f2d0be370ab2dc46 compactc_v0.33.0-rc.2_aarch64-unknown-linux-musl.zip +dce1a57d82ce06208fcc5d9de5343f18c48654a5ff3acf6bafabe3d17bf1ef18 compactc_v0.33.0-rc.2_x86_64-darwin.zip +3055ab92bbc8d5bb0d6282b661b83761d2a0de2ee37e21cf7107e25aaf2a9aad compactc_v0.33.0-rc.2_x86_64-unknown-linux-musl.zip +``` + +## Proof server 9.0.0-rc.5_experimental (Docker image digests) + +The proof server is not a tarball; its integrity is the image digest. Pin through `midnightntwrk/proof-server@`. + +```text +index sha256:4f02ca2734649eb238d13924df299b1c82bd5546ec928c5d67bdd0ce86dd0bd1 +amd64 sha256:4db380b1434492896a144a5ffc083a145d30dc68af64e43e5b4813efa118a09a +arm64 sha256:83eb40f64db7c8d4a5972352da2bc4a86e4e2963bccdcd96b5116d1a640cf709 +``` + +The primary registry is `ghcr.io/midnight-ntwrk/proof-server`, mirrored to Docker Hub. Digests were read from the Docker Hub mirror. + +## Indexer 4.4.0-pre-alpha.16 (five image digests) + +The indexer ships as five images. Tag: `4.4.0-pre-alpha.16-l91r3-n2r3-bridge-and-events-epics-contract-zswap-16c656df`. Pin through `midnightntwrk/@sha256:...`. + +```text +chain-indexer sha256:3ad83b1e424bf8e5933b12c162015dabb20e8f4621ff8a83469944379a851f17 +indexer-api sha256:a03b8485eadee1145d9d92e5176bd9e93149ea2ef2bcab3b01d0aac90b3c091a +wallet-indexer sha256:e2a4af1fceacdde1aa80240f812c5ea636e013524aa321eb515138e0b9e7e92d +indexer-standalone sha256:893173e52e07560c366d3c96edfeede569c2d20cb5fad7b8d7e71aaa99f21c70 +spo-indexer sha256:a65806e41260c346542a4b225c425d2493d439013b0fb64d0de72f9f65a6f028 +``` + +## Ledger + +Ledger 9.1.0.0-rc.3 is a Rust workspace built from source rather than a published tarball, so it carries no standalone SHA-256 in the list above. The delivered version is pinned by the git tag `ledger-9.1.0.0-rc.3` (commit `4823b53`) and builds reproducibly from that source through the repository's Cargo workspace and Nix flake. To verify, clone the tag and build. The wasm bindings (`ledger-wasm`, `onchain-runtime`) are distributed alongside for JS consumers. + +Source: [midnight-ledger at ledger-9.1.0.0-rc.3](https://github.com/midnightntwrk/midnight-ledger/tree/ledger-9.1.0.0-rc.3) + +## Notes + +- Compact.js 2.5.5-rc.6 covers Keccak and secp256k1; the single rc.6 tarball above serves both, with no separate build. +- Containerized components (indexer, proof server) have no tarball and are verified by their SHA-256 registry image digest, anonymously verifiable on the registry. +- The faucet is excluded: it is operational infrastructure run on Stagenet, not a SOW component, and it is reached by endpoint with no build or checksum. + +## Low-level protocol documentation (SOW-09) + +- [Impact opcodes](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/impact-opcodes.md) +- [Transaction format](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/transaction-format.md) +- [Transaction types](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/transaction-types.md) diff --git a/docs/stagenet/index.mdx b/docs/stagenet/index.mdx new file mode 100644 index 00000000..be5b2a74 --- /dev/null +++ b/docs/stagenet/index.mdx @@ -0,0 +1,29 @@ +--- +SPDX-License-Identifier: Apache-2.0 +copyright: This file is part of midnight-docs. Copyright (C) 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: Stagenet delivery notes +description: Delivery documents for the Stagenet environment, listing the tested component versions deployed so the Midnight Foundation and partners can exercise delivered features. +id: index +displayed_sidebar: sidebar +sidebar_position: 1 +tags: [stagenet, releases, delivery] +--- + +# Stagenet delivery notes + +:::warning Draft + +This section is a draft shared for partner review. Content is subject to change and is not part of the published documentation set. + +::: + +Delivery documents for the **Stagenet** environment: the tested component versions deployed on Stagenet so the Midnight Foundation and partners can exercise the delivered features. One document per stack; a new document is issued each time the Stagenet stack is promoted, for example RC2 to RC3. + +Stagenet is a release-candidate environment with no SLA that resets to genesis each quarter. Formal releases happen at Preview. + +## Contents + +- [Midnight 2.0 Stagenet beta](./midnight-2-0-stagenet-beta.mdx) — Ledger RC3 stack, Q2 statement-of-work delivery. +- [Artifact checksums](./artifact-checksums.mdx) — download links and SHA-256 checksums for every delivered component. + +See the [compatibility matrix](/relnotes/support-matrix) for the current published version of every Midnight component. diff --git a/docs/stagenet/midnight-2-0-stagenet-beta.mdx b/docs/stagenet/midnight-2-0-stagenet-beta.mdx new file mode 100644 index 00000000..0a1a7985 --- /dev/null +++ b/docs/stagenet/midnight-2-0-stagenet-beta.mdx @@ -0,0 +1,113 @@ +--- +SPDX-License-Identifier: Apache-2.0 +copyright: This file is part of midnight-docs. Copyright (C) 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: Midnight 2.0 Stagenet beta +description: Q2 2026 beta delivery document for Midnight 2.0 on Stagenet, covering deliverables, the Ledger RC3 compatible stack, and Stagenet access details. +id: midnight-2-0-stagenet-beta +displayed_sidebar: sidebar +sidebar_position: 2 +tags: [stagenet, releases, delivery, ledger] +--- + +# Midnight Q2 2026 beta delivery document + +:::warning Draft + +This section is a draft shared for partner review. Content is subject to change and is not part of the published documentation set. + +::: + +## What is in this document + +- List of Q2 deliverables and their delivery status. +- The compatibility matrix needed to exercise these features on Stagenet. +- Link to the release artifact checksum document. +- Links to the low-level protocol documentation. +- How to access Stagenet, including RPC and faucet URLs. + +## Q2 SOW deliverables + +| ID | Deliverable | Components | Status | +| ------ | --- | --- | --- | +| SOW-01 | Native cryptographic primitives for Prime stablecoin integration (USDCx) | Language, Smart Compliance | Delivered | +| SOW-02 | ECDSA signature support (custodian integrations) | Ledger, Crypto | Delivered | +| SOW-03 | Contract-to-contract calls, phase 1 (unshielded data only) | Midnight.js, Compact | Delivered | +| SOW-04 | ZKIR v3 | Crypto, Language, Ledger | Delivered | +| SOW-05 | cNIGHT to mNIGHT protocol token bridge | Protocol, Ledger, Cardano integration | Delivered | +| SOW-06 | Native Keccak hashing | Crypto, Language | Delivered | +| SOW-07 | Native secp256k1 | Crypto, Language | Delivered | +| SOW-08 | Event emission support for Compact smart contracts, phase 1 (unshielded only) | Ledger, Language | Delivered | +| SOW-09 | Low-level protocol documentation | Ledger | Delivered | + +## Component versions + +### Stagenet testing (Ledger RC3 compatible stack) + +| Component | Version | +| --- | --- | +| Ledger | [9.1.0.0-rc.3](https://github.com/midnightntwrk/midnight-ledger) | +| Node | [2.0.0-rc.4](https://github.com/midnightntwrk/midnight-node/releases/tag/node-2.0.0-rc.4) | +| Indexer | [4.4.0-pre-alpha.16](https://github.com/midnightntwrk/midnight-indexer) | +| Proof server | [9.0.0-rc.5_experimental](https://hub.docker.com/r/midnightntwrk/proof-server) | +| Compact compiler | [0.33.0-rc.2](https://github.com/LFDT-Minokawa/compact/releases/tag/compactc-v0.33.0-rc.2) | +| Compact runtime | [0.18.0-rc.1](https://www.npmjs.com/package/@midnight-ntwrk/compact-runtime/v/0.18.0-rc.1) | +| Compact.js | [2.5.5-rc.6](https://github.com/midnightntwrk/midnight-sdk/releases/tag/compact-js-v2.5.5-rc.6) | +| Midnight.js | [5.0.0-beta.4](https://github.com/midnightntwrk/midnight-js/releases/tag/v5.0.0-beta.4) | +| Wallet SDK | [2.0.0-beta.2](https://github.com/midnightntwrk/midnight-wallet) | + +:::note + +ZKIR v3 support requires the experimental build of the proof server. `--feature-zkir-v3` is a Compact compiler flag; contracts compiled with it must run against that experimental proof-server build. + +::: + +## How to access Stagenet + +- **Access model**: publicly accessible over RPC (TLS, under `stagenet.shielded.tools`), like Preview and Preprod. A brand-new chain with its own genesis, connected to Cardano through a partner-chain bridge. +- **Wallet and setup**: use the wallet SDK version above; point tools and wallets at the RPC endpoint below. Endpoints and partner configuration are preserved across resets, so connection settings do not change. This reset regenerated the chain genesis, so Stagenet is a new chain and on-chain state is wiped: resync wallets from scratch, re-request faucet funds, and redeploy any contracts. +- **View the chain in a browser**: open the Polkadot/Substrate apps explorer at [polkadot.js.org/apps → Stagenet](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.stagenet.shielded.tools#/explorer). No install is needed; if it warns about an unknown chain, continue. +- **Faucet**: get a Stagenet address, open the faucet URL below, paste the address, and request tokens. A small daily rate limit applies per requester. +- **Quick health check**: + + ```bash + curl -s https://rpc.stagenet.shielded.tools \ + -H 'Content-Type: application/json' \ + -d '{"jsonrpc":"2.0","id":1,"method":"system_health","params":[]}' + ``` + + A healthy response has `isSyncing: false` and `peers` greater than 0. + +| Purpose | URL | +| --- | --- | +| Node RPC | `wss://rpc.stagenet.shielded.tools` | +| Indexer (GraphQL) | `https://indexer.stagenet.shielded.tools/api/v4/graphql` | +| Faucet | `https://faucet.stagenet.shielded.tools` | +| Browser explorer | [polkadot.js.org/apps → Stagenet](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.stagenet.shielded.tools#/explorer) | + +## Policy IDs on Stagenet + +Stagenet has the same policy ID as Preview for cNIGHT: + +```text +0xd2dbff622e509dda256fedbd31ef6e9fd98ed49ad91d5c0e07f68af1 +``` + +Check this through [chain state on the Polkadot apps explorer](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.stagenet.shielded.tools#/chainstate), or in the [source code](https://github.com/midnightntwrk/midnight-node/blob/node-2.0.0-rc.4/res/stagenet/cnight-config.json). + +## Stagenet updates + +Stagenet continues to get updated as STL tests further and finds and fixes issues. Expect further RC versions deployed to this environment over the coming days. STL keeps MNF up to date on what is changing so that all interested parties can continue testing these delivered features on Stagenet. + +## Artifacts + +Download links and SHA-256 checksums for every component above are provided in the companion manifest: [artifact checksums](./artifact-checksums.mdx). It covers the npm packages (including Midnight.js 5.0.0-beta.4), the node release assets, the Compact compiler, and the proof-server and indexer image digests. + +Per the statement of work, the manifest carries a SHA-256 checksum per artifact. Containerized components with no tarball (indexer, proof server) are verified by their SHA-256 registry image digest, anonymously verifiable on the registry. + +### Low-level protocol documentation (SOW-09) + +Low-level protocol specifications in the `midnight-ledger` repository: + +- [Impact opcodes](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/impact-opcodes.md) +- [Transaction format](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/transaction-format.md) +- [Transaction types](https://github.com/midnightntwrk/midnight-ledger/blob/ledger-9/spec/transaction-types.md)