Midnight Network Infrastructure

Configure and manage Midnight Network components for dApp development.

Quick Reference

Service Testnet-02 URL

Indexer https://indexer.testnet-02.midnight.network/api/v1/graphql

Indexer WS wss://indexer.testnet-02.midnight.network/api/v1/graphql/ws

RPC Node https://rpc.testnet-02.midnight.network

Proof Server http://localhost:6300 (local)

Faucet https://faucet.testnet-02.midnight.network

Reference Files

Topic Resource

Network Config references/network-config.md

Proof Server references/proof-server.md

Indexer Queries references/indexer-graphql.md

Troubleshooting references/troubleshooting.md

Development Setup

1. Start Proof Server

docker run -p 6300:6300 midnightnetwork/proof-server --
midnight-proof-server --network testnet

2. Install Lace Wallet

Download from lace.io and enable Midnight mode.

3. Get Testnet Tokens

Visit the faucet to receive tDUST for testing.

Architecture

┌──────────────┐ ┌───────────────┐ ┌──────────────┐ │ Your dApp │────▶│ Proof Server │────▶│ Midnight │ │ (Browser) │ │ (localhost) │ │ Network │ └──────────────┘ └───────────────┘ └──────────────┘ │ │ │ ┌───────────────┐ │ └─────────────▶│ Indexer │◀──────────┘ │ (GraphQL) │ └───────────────┘

Network IDs

import { NetworkId, setNetworkId } from '@midnight-ntwrk/midnight-js-network-id';

// Always set before using providers setNetworkId(NetworkId.TestNet);

// Available networks enum NetworkId { DevNet = 'DevNet', // Developer network (not persistent) TestNet = 'TestNet', // Persistent testnet MainNet = 'MainNet', // Midnight mainnet Undeployed = 'Undeployed', // Local testing }

Health Checks

Check proof server

curl http://localhost:6300/health

Check indexer

curl https://indexer.testnet-02.midnight.network/api/v1/graphql
-H 'Content-Type: application/json'
-d '{"query":"{ __typename }"}'

Common Issues

Issue Solution

Proof generation timeout Increase timeout, check Docker resources

Connection refused Ensure proof server is running

Network mismatch Verify NetworkId matches wallet

Insufficient funds Get tDUST from faucet

Best Practices

• ✅ Start proof server before dApp

• ✅ Use wallet's service URIs when available

• ✅ Set NetworkId before provider initialization

• ✅ Monitor proof server logs for errors

• ❌ Don't hardcode network URLs (use config)