agentsclimarketplace

Midnight network

Skill mzf11125/midnight_agent_skills/midnight-network

7 modular agent skills for building on Midnight Network's zero-knowledge blockchain

Install
npx -y skills add mzf11125/midnight_agent_skills --skill midnight-network

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Guide to Midnight Network infrastructure, validators, indexers, and network operations. Use when users need to run Midnight validators and participate in consensus, set up and configure Midnight indexers for blockchain data, configure network nodes and infrastructure, monitor validator performance and network health, understand network parameters and configuration, deploy and manage network infrastructure, troubleshoot network issues, and access node release information and compatibility.

SKILL.md

11.4 KB, as published. Nobody here has run it

Midnight Network Infrastructure

Complete guide to running and managing Midnight Network infrastructure.

Infrastructure Overview

ComponentPurposeRequirements
Full NodeValidate transactions, relay blocks4+ CPU, 8GB RAM, 100GB SSD
Archive NodeFull history storage4+ CPU, 16GB RAM, 1TB SSD
ValidatorProduce blocks, consensus8+ CPU, 16GB RAM, 100GB SSD, stake
IndexerQuery API for DApps4+ CPU, 8GB RAM, 500GB SSD, v4.3.3
Proof ServerGenerate ZK proofs8+ CPU, 32GB RAM, GPU recommended

Quick Start

Local Development (Recommended for DApps)

Option 1: midnight-local-dev (Full Local Network)

Provides complete local network with Node, Indexer, Proof Server:

git clone https://github.com/midnightntwrk/midnight-local-dev
cd midnight-local-dev
npm install
npm start

Network ID: undeployed

Services & Ports:

ServicePortURL
Node9944http://localhost:9944
Indexer GraphQL8088http://localhost:8088/api/v4/graphql
Indexer WS8088ws://localhost:8088/api/v4/graphql/ws
Proof Server6300http://localhost:6300

Docker Images: node 0.24.0, indexer 4.3.3, proof-server 8.0.3

Funding: Use interactive menu to fund wallets with 50,000 tNIGHT each.

Standalone Mode (No Menu)

docker compose -f standalone.yml up -d

Option 2: midnight-wallet-cli

npx midnight-wallet-cli serve

Option 3: midnight-playground

Full Node Setup

# Using Docker (recommended)
docker run -d \
  --name midnight-node \
  -p 9933:9933 \
  -p 9944:9944 \
  -v midnight-data:/data \
  midnightnetwork/node:v0.24.0 \
  --network testnet-02 \
  --pruning archive

Validator Setup

# See detailed guide below
# Requires staking tokens

docker run -d \
  --name midnight-validator \
  -p 9933:9933 \
  -p 9944:9944 \
  --restart unless-stopped \
  -v validator-data:/data \
  midnightnetwork/node:v0.24.0 \
  --validator \
  --staking <stake-address>

Indexer Setup

# Using Docker Compose with PostgreSQL
# v4.0.0+ required

docker run -d \
  --name midnight-indexer \
  -p 3100:3100 \
  -e DATABASE_URL=postgresql://postgres:password@db:5432/indexer \
  -e NETWORK=testnet-02 \
  --link midnight-postgres:db \
  midnightnetwork/indexer:v4.3.3

Node Architecture

Node Types

  1. Full Node

    • Validates all blocks and transactions
    • Stores current state
    • No historical queries
    • Minimum for DApp connection

  2. Archive Node

    • Full history storage
    • Historical state queries
    • Recommended for indexer backend

  3. Light Client

    • Lightweight verification
    • For resource-constrained environments
    • Trust minimum

Node Ports

PortProtocolPurpose
9933HTTPRPC API
9944WebSocketSubscriptions
9615PrometheusMetrics

Docker Deployment

Single Node

# docker-compose.yaml
version: '3.8'
services:
  node:
    image: midnightnetwork/node:v0.24.0
    ports:
      - "9933:9933"
      - "9944:9944"
    environment:
      - NETWORK=testnet-02
    volumes:
      - node-data:/data
    restart: unless-stopped

Full Stack (Node + Indexer + PostgreSQL)

version: '3.8'
services:
  node:
    image: midnightnetwork/node:v0.24.0
    ports:
      - "9933:9933"
    environment:
      - NETWORK=testnet-02
    volumes:
      - node-data:/data

  postgres:
    image: postgres:15
    environment:
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: indexer
    volumes:
      - postgres-data:/var/lib/postgresql/data

  indexer:
    image: midnightnetwork/indexer:v4.3.3
    ports:
      - "3100:3100"
    environment:
      - DATABASE_URL=postgresql://postgres:secret@postgres:5432/indexer
      - NETWORK=testnet-02
    depends_on:
      - postgres
      - node

volumes:
  node-data:
  postgres-data:

Production Validator

version: '3.8'
services:
  validator:
    image: midnightnetwork/node:v0.24.0
    ports:
      - "9933:9933"
      - "9944:9944"
    environment:
      - NETWORK=mainnet
      - VALIDATOR_MODE=true
      - STAKING_ADDRESS=<your-address>
    volumes:
      - validator-keys:/keys
      - validator-data:/data
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 16G

Validator Operations

Requirements

RoleStake RequiredHardware
Full ValidatorTBD8+ CPU, 16GB RAM

Setup Steps

  1. Generate Keys
# Generate staking keypair
docker run --rm -v keys:/keys midnightnetwork/node:v0.24.0 \
  keygen --output /keys/stash

  1. Stake Tokens

    • Transfer NIGHT to stake address
    • Delegate to validator (if using pool)

  2. Start Validator

docker run -d \
  --name midnight-validator \
  -v keys:/keys \
  -e NETWORK=mainnet \
  -e VALIDATOR_KEY=stash.ss58 \
  midnightnetwork/node:v0.24.0 \
  --validator
  1. Monitor

Validator Commands

# Check status
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"validator_key","id":1}'

# Get producing status
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"validator_producing","id":1}'

# Manual key rotation
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"validator_rotate","params":["newKey"],"id":1}'

Indexer Setup (v4.0.0+)

Docker Deployment

# Start PostgreSQL first
docker run -d \
  --name midnight-postgres \
  -e POSTGRES_PASSWORD=secret \
  -e POSTGRES_DB=indexer \
  -v postgres-data:/var/lib/postgresql/data \
  postgres:15

# Start Indexer
docker run -d \
  --name midnight-indexer \
  -p 3100:3100 \
  -e DATABASE_URL=postgresql://postgres:secret@host:5432/indexer \
  -e NETWORK=testnet-02 \
  --link midnight-postgres:db \
  midnightnetwork/indexer:v4.3.3

GraphQL API

Endpoint: http://localhost:3100/graphql

# Query transactions
query {
  transactions(
    first: 10,
    after: "cursor"
  ) {
    edges {
      node {
        id
        hash
        block {
          height
        }
      }
    }
  }
}

# Query contracts
query {
  contracts(filter: { hasCode: true }) {
    nodes {
      address
      codeHash
    }
  }
}

Monitoring

Prometheus Metrics

MetricTypeDescription
midnight_blocks_producedCounterTotal blocks produced
midnight_transactions_totalCounterTotal transactions
midnight_peer_countGaugeConnected peers
midnight_block_heightGaugeCurrent height
midnight_sync_statusGaugeSyncing (0/1)

Health Checks

# Node health
curl http://localhost:9933/health

# Indexer health
curl http://localhost:3100/health

# Prometheus metrics
curl http://localhost:9615/metrics

Useful Queries

# Block production rate
rate(midnight_blocks_produced[5m])

# Transaction throughput
rate(midnight_transactions_total[5m])

# Peer count
midnight_peer_count

# Sync progress
midnight_block_height / ignoring (job) (max by (job) (midnight_block_height))

Network Configuration

Networks

NetworkPurposeChain IDRPC URLStatus
mainnetProductionNIGHThttps://rpc.mainnet.midnight.networkActive
preprodTestingpreprodhttps://rpc.preprod.midnight.networkActive (use this)
previewEarly Devpreviewhttps://rpc.preview.midnight.network⛔ Discontinued
testnet-02Integrationtestnet-02-⛔ Discontinued

⚠️ Important: Both Preview and Testnet-02 are discontinued. Use Preprod for all testing.

Environment Variables

# Node
export MIDNIGHT_NETWORK=preprod
export MIDNIGHT_RPC_PORT=9933
export MIDNIGHT_WS_PORT=9944
export MIDNIGHT_PRUNING=archive

# Indexer
export DATABASE_URL=postgresql://user:pass@host:5432/midnight
export NETWORK=preprod
export PORT=3100

Troubleshooting

Common Issues

Node not syncing:

# Check sync status
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"system_syncStatus","id":1}'

# Check peers
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"system_peers","id":1}'

Indexer not syncing:

# Check indexer logs
docker logs midnight-indexer

# Check database connection
docker exec midnight-indexer psql -U postgres -c "SELECT 1"

Validator not producing:

# Verify keys
ls -la /keys/

# Check stake balance
curl -X POST http://localhost:9933 -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"validator_key","id":1}'

Developer Tools Reference

From midnight-awesome-dapps

Block Explorers

Resources

Cross Reference Skills

This skill covers infrastructure and operations. For related areas see these skills.

  • midnight-concepts — Network architecture, consensus, cryptography
  • midnight-compact — Contract development, compilation, local devnet
  • midnight-api — Indexer queries, node RPC, proof server integration
  • midnight-wallet — DUST generation, wallet state, MCP operations
  • midnight-dapp-dev — Frontend deployment, provider configuration
  • midnight-expert — Health diagnostics, tool verification, compatibility matrix

Inline References

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.