Bootstrap: nodes.json

This file is the canonical discovery mechanism for wallets and public tools. It can be updated to add or remove endpoints without requiring a wallet update.

Format Example Verify

Canonical URL

bootstrap

https://bootstrap.phonchain.org/nodes.json

genesis_hash

c098fa5e985edd56634af262975b771f0dadc607494d6875cb725f1006611658

1. Purpose

Provide a canonical list of public endpoints (API, gateway/seed, explorer).
Allow endpoint rotation without shipping a new wallet build.
Keep the wallet safe by anchoring to the canonical genesis_hash.

2. Required fields

Header

network — network name (e.g., phonchain)
mode — production or testnet
min_version — minimum compatible wallet/node version
genesis_hash — canonical chain anchor

Nodes

nodes[] list of objects
Each node: url, role, region, priority
Higher priority = tried earlier

3. Example

{
  "network": "phonchain",
  "mode": "production",
  "min_version": "1.0.0",
  "genesis_hash": "c098fa5e985edd56634af262975b771f0dadc607494d6875cb725f1006611658",
  "nodes": [
    { "url": "https://api.phonchain.org", "role": "api", "region": "EU", "priority": 1 },
    { "url": "https://seed2.phonchain.org", "role": "gateway", "region": "EU", "priority": 2 },
    { "url": "https://explorer.phonchain.org/explorer", "role": "explorer", "region": "EU", "priority": 3 }
  ]
}

4. How wallets use it

Download nodes.json over HTTPS.
Probe endpoints and call /network_info.
Accept a node only if genesis_hash matches the canonical value.
Select the best available node by priority + health checks.

Tip

Publish only public endpoints in bootstrap. Keep any private infrastructure private.