Merge branch 'main' into release-notes-ci

Author: gyrationtechs

.github/dependabot.yml

@@ -5,17 +5,23 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    cooldown:
+      default-days: 7
 
 #  - package-ecosystem: "cargo"
 #    directory: "/"
 #    registries: "*"
 #    schedule:
 #      interval: "daily"
+#    cooldown:
+#      default-days: 7
 #
   - package-ecosystem: "npm"
     directory: "/"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
     groups:
       docusaurus:
         patterns:
@@ -25,6 +31,8 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    cooldown:
+      default-days: 7
 
 # registries:
 #   github:

.github/workflows/apis.yml

@@ -10,17 +10,17 @@ on:
         description: 'Component docs to update'
         type: choice
         options:
-          - compactc
+          - compact
           - dapp-connector
           - midnight-indexer
           - ledger
           - midnight-js
           - testkit-js
           - wallet
           - onchain-runtime
-      branch_compactc:
-        description: 'Compactc branch'
-        default: 'testnet'
+      branch_compact:
+        description: 'Compact branch'
+        default: 'main'
       branch_dapp_connector:
         description: 'DApp Connector branch'
         default: 'main'
@@ -32,7 +32,7 @@ on:
         default: 'ledger-7.0.0'
       branch_indexer:
         description: 'Midnight Indexer branch'
-        default: 'v3.0.0'
+        default: 'v4.0.0'
       branch_wallet:
         description: 'Wallet branch'
         default: 'main'
@@ -42,6 +42,9 @@ on:
       branch_onchain_runtime:
         description: 'Onchain Runtime branch'
         default: 'onchain-runtime-2.0.1'
+      indexer_schema_version:
+        description: 'Indexer schema version'
+        default: 'v4'
 
 permissions:
   contents: write
@@ -64,36 +67,30 @@ jobs:
           git config --global user.name "Midnight CI GitHub Action"
           git config --global url.https://${{ secrets.GH_TOKEN }}@github.com/.insteadOf https://github.com/
 
-      - name: Clone compactc repo
-        if: ${{ github.event.inputs.component == 'compactc' }}
+      - name: Clone compact repo
+        if: ${{ github.event.inputs.component == 'compact' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_compactc }} https://github.com/midnightntwrk/compactc.git
+          git clone --branch "$BRANCH_COMPACT" https://github.com/LFDT-Minokawa/compact
+        env:
+          BRANCH_COMPACT: ${{ github.event.inputs.branch_compact }}
 
       - name: Clone ledger repo
         if: ${{ github.event.inputs.component == 'ledger' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_ledger }} https://github.com/midnightntwrk/midnight-ledger.git
-
-      - name: Update compact-runtime
-        if: ${{ github.event.inputs.component == 'compactc' }}
-        run: |
-          DEST_DIR=api-reference/compact-runtime
-          SRC_DIR=temp/compactc/doc/api/runtime
-          rm -rf ${DEST_DIR} || true
-          mkdir ${DEST_DIR}
-          cp -r ${SRC_DIR}/* ${DEST_DIR}
-          echo -e "# Compact runtime API\n\n$(cat ${DEST_DIR}/README.md)" > ${DEST_DIR}/README.md
+          git clone --branch "$BRANCH_LEDGER" https://github.com/midnightntwrk/midnight-ledger.git
+        env:
+          BRANCH_LEDGER: ${{ github.event.inputs.branch_ledger }}
 
       - name: Update DApp connector
         if: ${{ github.event.inputs.component == 'dapp-connector' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_dapp_connector }} https://github.com/midnightntwrk/midnight-dapp-connector-api.git
+          git clone --branch "$BRANCH_DAPP_CONNECTOR" https://github.com/midnightntwrk/midnight-dapp-connector-api.git
           cd ..
           DEST_DIR=api-reference/dapp-connector
           SRC_DIR=temp/midnight-dapp-connector-api/docs/api
@@ -109,6 +106,8 @@ jobs:
           if [ -f ./temp/backup-readme.md ]; then
             cp ./temp/backup-readme.md ${DEST_DIR}/README.md
           fi
+        env:
+          BRANCH_DAPP_CONNECTOR: ${{ github.event.inputs.branch_dapp_connector }}
 
       - name: Update ledger
         if: ${{ github.event.inputs.component == 'ledger' }}
@@ -125,58 +124,68 @@ jobs:
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_midnight_js }} https://github.com/midnightntwrk/midnight-js.git
+          git clone --branch "$BRANCH_MIDNIGHT_JS" https://github.com/midnightntwrk/midnight-js.git
           cd ..
           DEST_DIR=api-reference/midnight-js
           SRC_DIR=temp/midnight-js/docs/api/midnight-js
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
           echo -e "# Midnight JS API\n\n$(cat ${DEST_DIR}/README.md)" > ${DEST_DIR}/README.md
+        env:
+          BRANCH_MIDNIGHT_JS: ${{ github.event.inputs.branch_midnight_js }}
 
       - name: Update testkit-js
         if: ${{ github.event.inputs.component == 'testkit-js' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_midnight_js }} https://github.com/midnightntwrk/midnight-js.git
+          git clone --branch "$BRANCH_MIDNIGHT_JS" https://github.com/midnightntwrk/midnight-js.git
           cd ..
           DEST_DIR=api-reference/testkit-js
           SRC_DIR=temp/midnight-js/docs/api/testkit-js
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
           echo -e "# Testkit JS API\n\n$(cat ${DEST_DIR}/README.md)" > ${DEST_DIR}/README.md
+        env:
+          BRANCH_MIDNIGHT_JS: ${{ github.event.inputs.branch_midnight_js }}
 
       - name: Update midnight-indexer
         if: ${{ github.event.inputs.component == 'midnight-indexer' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_indexer }} https://github.com/midnightntwrk/midnight-indexer.git
+          git clone --branch "$BRANCH_INDEXER" https://github.com/midnightntwrk/midnight-indexer.git
           cd ..
+          INDEXER_SCHEMA_VERSION="$INDEXER_SCHEMA_VERSION"
           DEST_DIR=api-reference/midnight-indexer
-          SRC_DIR=temp/midnight-indexer/docs/api/v3
+          SRC_DIR=temp/midnight-indexer/docs/api/${INDEXER_SCHEMA_VERSION}
           STATIC_DIR=static/midnight-indexer
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
           mv ${DEST_DIR}/api-documentation.md ${DEST_DIR}/README.md
-          sed -E -i 's|\[\`indexer-api/graphql/schema-v3\.graphql\`\]\(.*\)|[midnight-indexer-api-schema](pathname:///midnight-indexer/schema-v3.graphql)|g' ${DEST_DIR}/README.md
-          cp temp/midnight-indexer/indexer-api/graphql/schema-v3.graphql ${STATIC_DIR}
+          sed -E -i 's|\[\`indexer-api/graphql/schema-${INDEXER_SCHEMA_VERSION}\.graphql\`\]\(.*\)|[midnight-indexer-api-schema](pathname:///midnight-indexer/schema-${INDEXER_SCHEMA_VERSION}.graphql)|g' ${DEST_DIR}/README.md
+          cp temp/midnight-indexer/indexer-api/graphql/schema-${INDEXER_SCHEMA_VERSION}.graphql ${STATIC_DIR}
+        env:
+          BRANCH_INDEXER: ${{ github.event.inputs.branch_indexer }}
+          INDEXER_SCHEMA_VERSION: ${{ github.event.inputs.indexer_schema_version }}
 
       - name: Update wallet
         if: ${{ github.event.inputs.component == 'wallet' }}
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_wallet }} https://github.com/midnightntwrk/midnight-wallet.git
+          git clone --branch "$BRANCH_WALLET" https://github.com/midnightntwrk/midnight-wallet.git
           cd ..
           DEST_DIR=static/midnight-wallet/snippets
           SRC_DIR=temp/midnight-wallet/packages/docs-snippets/src/snippets
           rm -rf ${DEST_DIR} || true
           mkdir -p ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
+        env:
+          BRANCH_WALLET: ${{ github.event.inputs.branch_wallet }}
 
       - name: Inject H1 header into midnight-js packages
         if: ${{ github.event.inputs.component == 'midnight-js' }}
@@ -199,41 +208,43 @@ jobs:
         run: |
           mkdir ./temp
           cd temp
-          git clone --branch ${{ github.event.inputs.branch_onchain_runtime }} https://github.com/midnightntwrk/midnight-ledger.git
+          git clone --branch "$BRANCH_ONCHAIN_RUNTIME" https://github.com/midnightntwrk/midnight-ledger.git
           cd ..
           DEST_DIR=api-reference/onchain-runtime
           SRC_DIR=temp/midnight-ledger/docs/api/midnight-onchain-runtime
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
           echo -e "# Onchain Runtime API\n\n$(cat ${DEST_DIR}/README.md)" > ${DEST_DIR}/README.md
+        env:
+          BRANCH_ONCHAIN_RUNTIME: ${{ github.event.inputs.branch_onchain_runtime }}
 
       - name: Update Compact standard library
-        if: ${{ github.event.inputs.component == 'compactc' }}
+        if: ${{ github.event.inputs.component == 'compact' }}
         run: |
           DEST_DIR=docs/compact/standard-library
-          SRC_DIR=temp/compactc/doc/api/CompactStandardLibrary
+          SRC_DIR=temp/doc/api/CompactStandardLibrary
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_DIR}/* ${DEST_DIR}
           echo -e "# Compact standard library\n\n$(cat ${DEST_DIR}/README.md)" > ${DEST_DIR}/README.md
 
-      - name: Update static assets from compactc
-        if: ${{ github.event.inputs.component == 'compactc' }}
+      - name: Update static assets from compact
+        if: ${{ github.event.inputs.component == 'compact' }}
         run: |
           DEST_DIR=static/language
-          SRC_1=temp/compactc/doc/Compact.html
-          SRC_2=temp/compactc/doc/ledger-adt.mdx
+          SRC_1=temp/compact/doc/Compact.html
+          SRC_2=temp/doc/ledger-adt.mdx
           rm -rf ${DEST_DIR} || true
           mkdir ${DEST_DIR}
           cp -r ${SRC_1} ${DEST_DIR}/compact.html
           cp -r ${SRC_2} ${DEST_DIR}/ledger-adt.mdx
 
       - name: Update compiler usage
-        if: ${{ github.event.inputs.component == 'compactc' }}
+        if: ${{ github.event.inputs.component == 'compact' }}
         run: |
           DEST=docs/compact/compilation-and-tooling/compiler-usage.mdx
-          SRC=temp/compactc/doc/compiler-usage.md
+          SRC=temp/doc/compiler-usage.md
           cp -r ${SRC} ${DEST}
 
       - name: Add changes
@@ -270,6 +281,8 @@ jobs:
       - name: Create a PR
         if: ${{ steps.prep.outputs.UPDATE == 'true' }}
         run: |
-            gh pr create --base ${{ github.event.inputs.branch_merge }} --title 'Merge API documentation from ${{ github.event.inputs.component }}' --body 'Merging API documentation - created by Midnight CI Github Action'
+            gh pr create --base "$BRANCH_MERGE" --title 'Merge API documentation from "$COMPONENT"' --body 'Merging API documentation - created by Midnight CI Github Action'
         env:
           GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          BRANCH_MERGE: ${{ github.event.inputs.branch_merge }}
+          COMPONENT: ${{ github.event.inputs.component }}

.github/workflows/playwright-visual-regression.yml

@@ -70,7 +70,7 @@ jobs:
 
       - name: Upload Test Results
         if: always()
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # 7.0.0
         id: upload-report
         with:
           name: test-report
@@ -111,11 +111,12 @@ jobs:
           pr_url: ${{ github.event.pull_request.html_url }}
           comment: ${{ steps.format_playwright_message.outputs.comment }}
           repo_name: ${{ github.repository }}
+          pr_number: ${{ github.event.pull_request.number }}
         run: |
           repo_name=$(echo "$repo_name" | cut -d'/' -f2)
 
           curl -X POST -H 'Content-type: application/json' \
           --data '{
-            "text": "Playwright Visual Regression Tests completed for <'"$pr_url"'|PR #${{ github.event.pull_request.number }}> on '"$repo_name"'. \nTest Summary: \n'"$comment"'"
+            "text": "Playwright Visual Regression Tests completed for <'"$pr_url"'|PR #"$pr_number"> on '"$repo_name"'. \nTest Summary: \n'"$comment"'"
           }' \
           ${{ secrets.SLACK_WEBHOOK_URL }}

RELEASE_NOTE_TEMPLATE.md

@@ -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
 

docs/compact/compilation-and-tooling/neovim-setup.mdx

@@ -0,0 +1,30 @@
+---
+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.
+---
+
+# Neovim setup for Compact
+
+[compact.vim](https://github.com/1NickPappas/compact.vim) is a community-driven plugin that provides Compact language support for Neovim.
+
+## Features
+
+The plugin provides the following capabilities for working with Compact source files:
+
+* Syntax highlighting (regex-based and tree-sitter)
+* Smart indentation
+* Code folding
+* Text objects (requires [nvim-treesitter-textobjects](https://github.com/nvim-treesitter/nvim-treesitter-textobjects))
+* Import navigation via `gf`
+* Compiler integration via `:make`
+* Local scoping (variable references scoped per circuit/block)
+
+![Syntax highlighting](/img/neovim-setup/compact-syntax.png)
+
+## Installation
+
+Install with [lazy.nvim](https://github.com/folke/lazy.nvim):
+
+```lua
+{ "1NickPappas/compact.vim" }
+```

docs/compact/compilation-and-tooling/vscode-plugin.mdx

@@ -12,6 +12,9 @@ DApp developers can create new smart contracts
 * using a file template
 * from scratch, optionally using code snippets.
 
+## Installation
+Install via the [Releases page] (https://raw.githubusercontent.com/midnight-ntwrk/releases/gh-pages/artifacts/vscode-extension/compact-0.2.13/compact-0.2.13.vsix)
+
 ## Features
 
 ### Syntax highlighting

docs/getting-started/installation.mdx

@@ -94,7 +94,7 @@ The proof server runs as a background service using Docker. Ensure the Docker en
 Use the following command to start the proof server in your terminal:
 
 ```bash
-docker run -p 6300:6300 midnightntwrk/proof-server:latest midnight-proof-server -v
+docker run -p 6300:6300 midnightntwrk/proof-server:8.0.3 midnight-proof-server -v
 ```
 
 This command occupies the terminal window while running.
@@ -155,7 +155,7 @@ Error: bind: address already in use
 Either stop the process using port 6300, or run the proof server on a different port:
 
 ```bash
-docker run -p 6301:6300 midnightntwrk/proof-server:latest midnight-proof-server -v
+docker run -p 6301:6300 midnightntwrk/proof-server:8.0.3 midnight-proof-server -v
 ```
 
 Remember to update your application configuration to use the new port.

docs/glossary.mdx

@@ -86,12 +86,15 @@ A field used when a DApp asks a user to sign a message. It helps ensure that a m
 ### DUST
 A shielded, non-transferable, consumable network resource used exclusively to pay transaction fees on Midnight.
 
-### Fungible token
-Fungible tokens are identical to one another, have the same value, and are interchangeable.
+### Faucet
+A web service that distributes free test tokens to developers building on a testnet. On Midnight, the faucet provides tNIGHT, which generates tDUST for paying transaction fees during development. Faucet tokens have no real-world value and exist only for testing purposes.
 
 ### Federated Node Operators (FNO)
 A network of independent node operators that work together to maintain and secure the Midnight blockchain. These operators validate transactions, produce blocks, and ensure the network remains decentralized and reliable. Unlike a single centralized authority, FNOs distribute control across multiple trusted entities, enhancing security and reducing single points of failure.
 
+### Fungible token
+Fungible tokens are identical to one another, have the same value, and are interchangeable.
+
 ### Gadget
 A gadget is a specialized entry point, specific to zero-knowledge cryptography, designed to bring ZK Snark circuit development within reach of a wide range of developers. Midnight cryptography (Midnight's cryptographic backend library) provides several gadgets, including a signing gadget, an encryption gadget, and a hashing gadget.