{
  "verified_on": "2026-11-17",
  "core_revision": "31a2a4d531170cbc51671790bd5c1a492ea5c533",
  "network": "mainnet",
  "chain_id": "chipcoin-mainnet-1",
  "routes": [
    {
      "method": "GET",
      "path": "/v1/health",
      "surface": "wallet",
      "description": "Network identity: status, network, chain_id, genesis_hash."
    },
    {
      "method": "GET",
      "path": "/v1/status",
      "surface": "wallet",
      "description": "Node status, height, sync and peers. Read supply separately from /v1/supply."
    },
    {
      "method": "GET",
      "path": "/v1/supply",
      "surface": "wallet",
      "description": "Issued, circulating, immature and scheduled supply; integer chipbits."
    },
    {
      "method": "GET",
      "path": "/v1/tip",
      "surface": "wallet",
      "description": "Current height and block_hash; use with the block API to detect reorgs."
    },
    {
      "method": "GET",
      "path": "/v1/blocks",
      "surface": "explorer",
      "description": "limit=1..100 (default 20), from_height >= 0 (inclusive; not above tip). Newest first."
    },
    {
      "method": "GET",
      "path": "/v1/block",
      "surface": "explorer",
      "description": "Exactly one of height >= 0 or hash. Includes header and transaction summaries; fetch each tx for inputs/outputs."
    },
    {
      "method": "GET",
      "path": "/v1/tx/<txid>",
      "surface": "wallet",
      "description": "64-hex txid. location, height, block_hash and transaction; 404 if not found."
    },
    {
      "method": "POST",
      "path": "/v1/tx/submit",
      "surface": "wallet",
      "description": "JSON {raw_hex: signed transaction hex}. No server-side signing; acceptance is not confirmation."
    },
    {
      "method": "GET",
      "path": "/v1/mempool",
      "surface": "explorer",
      "description": "offset=0..100000, limit=1..1000 (default 100). Pending transaction diagnostics."
    },
    {
      "method": "GET",
      "path": "/v1/peers",
      "surface": "local",
      "description": "offset=0..100000, limit=1..1000 (default 200). Full peer diagnostics: keep private."
    },
    {
      "method": "GET",
      "path": "/v1/peers/summary",
      "surface": "explorer",
      "description": "Aggregate peer health and counts."
    },
    {
      "method": "GET",
      "path": "/v1/peers/public",
      "surface": "explorer",
      "description": "Public bootstrap peer candidates, not a guarantee of live connectivity."
    },
    {
      "method": "GET",
      "path": "/v1/address/<address>",
      "surface": "wallet",
      "description": "Confirmed, immature and spendable balances, utxo_count and address scheme."
    },
    {
      "method": "GET",
      "path": "/v1/address/<address>/utxos",
      "surface": "wallet",
      "description": "Array: txid, vout, amount_chipbits, coinbase, mature, status and origin_height."
    },
    {
      "method": "GET",
      "path": "/v1/address/<address>/history",
      "surface": "wallet",
      "description": "limit=1..100 (default 50), order=asc|desc (default desc). Confirmed history only; no offset/cursor/type filter."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/epoch",
      "surface": "local",
      "description": "Optional epoch_index and node_id. Detailed reward state."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/assignments",
      "surface": "local",
      "description": "Optional epoch_index and node_id. Verifier assignments."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/node-status",
      "surface": "explorer",
      "description": "Required node_id; optional epoch_index >= 0."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/node-fees",
      "surface": "explorer",
      "description": "Current registration and renewal fees. Never hardcode them."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/epoch-summary",
      "surface": "explorer",
      "description": "Required epoch_index >= 0. Aggregated reward accounting."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/concentration",
      "surface": "local",
      "description": "Optional epoch_index >= 0. Reward concentration report."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/attestations",
      "surface": "local",
      "description": "Optional epoch_index. Attestation diagnostics."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/attestation-backlog",
      "surface": "local",
      "description": "Pending attestation workload."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/settlements",
      "surface": "explorer",
      "description": "Optional epoch_index. Settlement diagnostics."
    },
    {
      "method": "GET",
      "path": "/v1/rewards/settlement-report",
      "surface": "explorer",
      "description": "Optional epoch_index. Settlement accounting report."
    },
    {
      "method": "GET",
      "path": "/mining/status",
      "surface": "local",
      "description": "Local mining status only; never expose an unrestricted mining API."
    },
    {
      "method": "POST",
      "path": "/mining/get-block-template",
      "surface": "local",
      "description": "JSON payout_address, miner_id, optional template_mode (default full_block)."
    },
    {
      "method": "POST",
      "path": "/mining/submit-block",
      "surface": "local",
      "description": "JSON template_id, serialized_block and miner_id. Consensus-valid blocks only."
    }
  ],
  "cli_groups": [
    {
      "title": "Read chain and address data",
      "note": "Mainnet reads; use the existing node database. Address and reward summaries require --address.",
      "commands": [
        "status",
        "tip",
        "block",
        "tx",
        "mempool",
        "utxos",
        "balance",
        "address-history",
        "chain-window",
        "difficulty",
        "retarget-info",
        "supply",
        "supply-diagnostics",
        "economy-summary",
        "reward-history",
        "reward-summary",
        "mining-history",
        "node-income-summary",
        "top-miners",
        "top-nodes",
        "top-recipients"
      ]
    },
    {
      "title": "Node operation and peers",
      "note": "Operator commands, not public web endpoints. start/run/sync and peer changes can modify local state.",
      "commands": [
        "start",
        "run",
        "operator-check",
        "sync",
        "add-peer",
        "remove-peer",
        "list-peers",
        "peer-detail",
        "peer-summary",
        "public-peers",
        "peerbook-clean"
      ]
    },
    {
      "title": "Wallet and transaction tools",
      "note": "Local keys only. wallet-generate prints secret material; wallet-import is the legacy private-key import path, not a general Mainnet PQ seed importer. wallet-build signs; wallet-send and submit-raw-tx submit transactions.",
      "commands": [
        "wallet-generate",
        "wallet-import",
        "wallet-address",
        "wallet-utxos",
        "wallet-balance",
        "wallet-build",
        "wallet-send",
        "submit-raw-tx"
      ]
    },
    {
      "title": "Reward-node lifecycle and diagnostics",
      "note": "Read diagnostics first. Registration, renewal, attestation and settlement submissions are specialized operator workflows with fees, eligibility rules and cryptographic requirements. Legacy register-node/renew-node are not the Mainnet PQ reward-node registration path.",
      "commands": [
        "node-registry",
        "next-winners",
        "register-node",
        "renew-node",
        "register-reward-node",
        "renew-reward-node",
        "reward-epoch-seed",
        "reward-epoch-state",
        "reward-assignments",
        "reward-node-status",
        "reward-node-fees",
        "reward-epoch-summary",
        "reward-attestations",
        "reward-attestation-backlog",
        "reward-settlements",
        "reward-settlement-preview",
        "reward-settlement-report",
        "submit-reward-attestation-bundle",
        "submit-reward-settle-epoch"
      ]
    },
    {
      "title": "Mining and snapshots",
      "note": "mine is an external miner client; mine-local-block is a local/testing helper, not a production pool setup. Snapshot import/reset changes chain state: use the Mainnet operator runbook and a separately verified trust anchor.",
      "commands": [
        "mine",
        "mine-local-block",
        "snapshot-export",
        "snapshot-import",
        "snapshot-sign"
      ]
    },
    {
      "title": "PQ diagnostics and isolated test tools",
      "note": "pq-operational-readiness can inspect Mainnet with explicit options. verify-pq-activation has its own --network flag defaulting to testnet: pass mainnet after the subcommand too. Smoke, benchmark, rehearsal and audit tools are not production transaction workflows; never aim isolated test tooling at the live database.",
      "commands": [
        "pq-smoke",
        "pq-benchmark",
        "pq-audit-report",
        "pq-dress-rehearsal",
        "pq-operational-readiness",
        "verify-pq-activation"
      ]
    }
  ],
  "cli_help": {
    "start": {
      "help": "usage: chipcoin start [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "run": {
      "help": "usage: chipcoin run [-h] [--listen-host LISTEN_HOST]\n                    [--listen-port LISTEN_PORT] [--http-host HTTP_HOST]\n                    [--http-port HTTP_PORT] [--snapshot-file SNAPSHOT_FILE]\n                    [--snapshot-reset]\n                    [--snapshot-trust-mode {off,warn,enforce}]\n                    [--snapshot-trusted-key SNAPSHOT_TRUSTED_KEY]\n                    [--snapshot-trusted-keys-file SNAPSHOT_TRUSTED_KEYS_FILE]\n                    [--peer PEER] [--peer-source {manual,seed}]\n                    [--run-seconds RUN_SECONDS]\n                    [--connect-interval-seconds CONNECT_INTERVAL_SECONDS]\n                    [--ping-interval-seconds PING_INTERVAL_SECONDS]\n                    [--read-timeout-seconds READ_TIMEOUT_SECONDS]\n                    [--write-timeout-seconds WRITE_TIMEOUT_SECONDS]\n                    [--handshake-timeout-seconds HANDSHAKE_TIMEOUT_SECONDS]\n                    [--mempool-relay-interval-seconds MEMPOOL_RELAY_INTERVAL_SECONDS]\n                    [--sync-scheduler-interval-seconds SYNC_SCHEDULER_INTERVAL_SECONDS]\n                    [--peer-resolution-cache-ttl-seconds PEER_RESOLUTION_CACHE_TTL_SECONDS]\n                    [--peer-discovery-enabled PEER_DISCOVERY_ENABLED]\n                    [--peerbook-max-size PEERBOOK_MAX_SIZE]\n                    [--peer-addr-max-per-message PEER_ADDR_MAX_PER_MESSAGE]\n                    [--peer-addr-relay-limit-per-interval PEER_ADDR_RELAY_LIMIT_PER_INTERVAL]\n                    [--peer-addr-relay-interval-seconds PEER_ADDR_RELAY_INTERVAL_SECONDS]\n                    [--peer-stale-after-seconds PEER_STALE_AFTER_SECONDS]\n                    [--peer-retry-backoff-base-seconds PEER_RETRY_BACKOFF_BASE_SECONDS]\n                    [--peer-retry-backoff-max-seconds PEER_RETRY_BACKOFF_MAX_SECONDS]\n                    [--max-outbound-sessions MAX_OUTBOUND_SESSIONS]\n                    [--max-inbound-sessions MAX_INBOUND_SESSIONS]\n                    [--max-pending-handshakes MAX_PENDING_HANDSHAKES]\n                    [--max-pending-handshakes-per-ip MAX_PENDING_HANDSHAKES_PER_IP]\n                    [--max-peer-aliases-per-node-id MAX_PEER_ALIASES_PER_NODE_ID]\n                    [--inbound-handshake-rate-limit-per-minute INBOUND_HANDSHAKE_RATE_LIMIT_PER_MINUTE]\n                    [--memory-metrics-interval-seconds MEMORY_METRICS_INTERVAL_SECONDS]\n                    [--tracemalloc-enabled TRACEMALLOC_ENABLED]\n                    [--tracemalloc-top-limit TRACEMALLOC_TOP_LIMIT]\n                    [--min-stable-session-seconds MIN_STABLE_SESSION_SECONDS]\n                    [--peer-discovery-startup-prefer-persisted PEER_DISCOVERY_STARTUP_PREFER_PERSISTED]\n                    [--headers-sync-enabled HEADERS_SYNC_ENABLED]\n                    [--headers-max-per-message HEADERS_MAX_PER_MESSAGE]\n                    [--block-download-window-size BLOCK_DOWNLOAD_WINDOW_SIZE]\n                    [--block-max-inflight-per-peer BLOCK_MAX_INFLIGHT_PER_PEER]\n                    [--block-request-timeout-seconds BLOCK_REQUEST_TIMEOUT_SECONDS]\n                    [--headers-sync-parallel-peers HEADERS_SYNC_PARALLEL_PEERS]\n                    [--headers-sync-start-height-gap-threshold HEADERS_SYNC_START_HEIGHT_GAP_THRESHOLD]\n                    [--misbehavior-warning-threshold MISBEHAVIOR_WARNING_THRESHOLD]\n                    [--misbehavior-disconnect-threshold MISBEHAVIOR_DISCONNECT_THRESHOLD]\n                    [--misbehavior-ban-threshold MISBEHAVIOR_BAN_THRESHOLD]\n                    [--misbehavior-ban-duration-seconds MISBEHAVIOR_BAN_DURATION_SECONDS]\n                    [--misbehavior-decay-interval-seconds MISBEHAVIOR_DECAY_INTERVAL_SECONDS]\n                    [--misbehavior-decay-step MISBEHAVIOR_DECAY_STEP]\n\noptions:\n  -h, --help            show this help message and exit\n  --listen-host LISTEN_HOST\n  --listen-port LISTEN_PORT\n  --http-host HTTP_HOST\n  --http-port HTTP_PORT\n  --snapshot-file SNAPSHOT_FILE\n                        Optional local snapshot file for fast bootstrap.\n  --snapshot-reset      Replace existing local chain state when importing a\n                        snapshot.\n  --snapshot-trust-mode {off,warn,enforce}\n  --snapshot-trusted-key SNAPSHOT_TRUSTED_KEY\n                        Trusted Ed25519 signer public key hex for snapshot\n                        verification.\n  --snapshot-trusted-keys-file SNAPSHOT_TRUSTED_KEYS_FILE\n                        Path to a text or JSON file containing trusted Ed25519\n                        signer public keys.\n  --peer PEER           Outbound peer in host:port form.\n  --peer-source {manual,seed}\n  --run-seconds RUN_SECONDS\n                        Stop automatically after N seconds.\n  --connect-interval-seconds CONNECT_INTERVAL_SECONDS\n  --ping-interval-seconds PING_INTERVAL_SECONDS\n  --read-timeout-seconds READ_TIMEOUT_SECONDS\n  --write-timeout-seconds WRITE_TIMEOUT_SECONDS\n  --handshake-timeout-seconds HANDSHAKE_TIMEOUT_SECONDS\n  --mempool-relay-interval-seconds MEMPOOL_RELAY_INTERVAL_SECONDS\n  --sync-scheduler-interval-seconds SYNC_SCHEDULER_INTERVAL_SECONDS\n  --peer-resolution-cache-ttl-seconds PEER_RESOLUTION_CACHE_TTL_SECONDS\n  --peer-discovery-enabled PEER_DISCOVERY_ENABLED\n  --peerbook-max-size PEERBOOK_MAX_SIZE\n  --peer-addr-max-per-message PEER_ADDR_MAX_PER_MESSAGE\n  --peer-addr-relay-limit-per-interval PEER_ADDR_RELAY_LIMIT_PER_INTERVAL\n  --peer-addr-relay-interval-seconds PEER_ADDR_RELAY_INTERVAL_SECONDS\n  --peer-stale-after-seconds PEER_STALE_AFTER_SECONDS\n  --peer-retry-backoff-base-seconds PEER_RETRY_BACKOFF_BASE_SECONDS\n  --peer-retry-backoff-max-seconds PEER_RETRY_BACKOFF_MAX_SECONDS\n  --max-outbound-sessions MAX_OUTBOUND_SESSIONS\n  --max-inbound-sessions MAX_INBOUND_SESSIONS\n  --max-pending-handshakes MAX_PENDING_HANDSHAKES\n  --max-pending-handshakes-per-ip MAX_PENDING_HANDSHAKES_PER_IP\n  --max-peer-aliases-per-node-id MAX_PEER_ALIASES_PER_NODE_ID\n  --inbound-handshake-rate-limit-per-minute INBOUND_HANDSHAKE_RATE_LIMIT_PER_MINUTE\n  --memory-metrics-interval-seconds MEMORY_METRICS_INTERVAL_SECONDS\n  --tracemalloc-enabled TRACEMALLOC_ENABLED\n  --tracemalloc-top-limit TRACEMALLOC_TOP_LIMIT\n  --min-stable-session-seconds MIN_STABLE_SESSION_SECONDS\n  --peer-discovery-startup-prefer-persisted PEER_DISCOVERY_STARTUP_PREFER_PERSISTED\n  --headers-sync-enabled HEADERS_SYNC_ENABLED\n  --headers-max-per-message HEADERS_MAX_PER_MESSAGE\n  --block-download-window-size BLOCK_DOWNLOAD_WINDOW_SIZE\n  --block-max-inflight-per-peer BLOCK_MAX_INFLIGHT_PER_PEER\n  --block-request-timeout-seconds BLOCK_REQUEST_TIMEOUT_SECONDS\n  --headers-sync-parallel-peers HEADERS_SYNC_PARALLEL_PEERS\n  --headers-sync-start-height-gap-threshold HEADERS_SYNC_START_HEIGHT_GAP_THRESHOLD\n  --misbehavior-warning-threshold MISBEHAVIOR_WARNING_THRESHOLD\n  --misbehavior-disconnect-threshold MISBEHAVIOR_DISCONNECT_THRESHOLD\n  --misbehavior-ban-threshold MISBEHAVIOR_BAN_THRESHOLD\n  --misbehavior-ban-duration-seconds MISBEHAVIOR_BAN_DURATION_SECONDS\n  --misbehavior-decay-interval-seconds MISBEHAVIOR_DECAY_INTERVAL_SECONDS\n  --misbehavior-decay-step MISBEHAVIOR_DECAY_STEP\n",
      "required": []
    },
    "mine": {
      "help": "usage: chipcoin mine [-h] [--node-url NODE_URL] [--run-seconds RUN_SECONDS]\n                     [--max-accepted-blocks MAX_ACCEPTED_BLOCKS]\n                     --miner-address MINER_ADDRESS [--miner-id MINER_ID]\n                     [--polling-interval-seconds POLLING_INTERVAL_SECONDS]\n                     [--request-timeout-seconds REQUEST_TIMEOUT_SECONDS]\n                     [--nonce-batch-size NONCE_BATCH_SIZE]\n                     [--worker-count WORKER_COUNT]\n                     [--template-refresh-skew-seconds TEMPLATE_REFRESH_SKEW_SECONDS]\n                     [--mining-min-interval-seconds MINING_MIN_INTERVAL_SECONDS]\n\noptions:\n  -h, --help            show this help message and exit\n  --node-url NODE_URL   Mining node HTTP endpoint. Repeat the flag to\n                        configure failover nodes.\n  --run-seconds RUN_SECONDS\n                        Stop automatically after N seconds.\n  --max-accepted-blocks MAX_ACCEPTED_BLOCKS\n                        Stop after this many accepted blocks. Intended for\n                        controlled operations.\n  --miner-address MINER_ADDRESS\n                        Mining reward payout address.\n  --miner-id MINER_ID   Stable miner identifier used in template requests.\n  --polling-interval-seconds POLLING_INTERVAL_SECONDS\n  --request-timeout-seconds REQUEST_TIMEOUT_SECONDS\n  --nonce-batch-size NONCE_BATCH_SIZE\n  --worker-count WORKER_COUNT\n                        Number of local mining worker processes.\n  --template-refresh-skew-seconds TEMPLATE_REFRESH_SKEW_SECONDS\n  --mining-min-interval-seconds MINING_MIN_INTERVAL_SECONDS\n                        Optional local throttle between mined blocks. Does not\n                        change consensus.\n",
      "required": [
        "--miner-address"
      ]
    },
    "pq-smoke": {
      "help": "usage: chipcoin pq-smoke [-h] [--activation-height ACTIVATION_HEIGHT]\n                         [--keep-state] [--json] [--verbose]\n\noptions:\n  -h, --help            show this help message and exit\n  --activation-height ACTIVATION_HEIGHT\n  --keep-state\n  --json\n  --verbose\n",
      "required": []
    },
    "pq-benchmark": {
      "help": "usage: chipcoin pq-benchmark [-h] [--json] [--quick]\n\noptions:\n  -h, --help  show this help message and exit\n  --json\n  --quick\n",
      "required": []
    },
    "pq-audit-report": {
      "help": "usage: chipcoin pq-audit-report [-h] [--json]\n\noptions:\n  -h, --help  show this help message and exit\n  --json\n",
      "required": []
    },
    "pq-dress-rehearsal": {
      "help": "usage: chipcoin pq-dress-rehearsal [-h]\n                                   [--activation-height ACTIVATION_HEIGHT]\n                                   [--output-json OUTPUT_JSON]\n                                   [--output-markdown OUTPUT_MARKDOWN]\n                                   [--skip-subprocess-checks]\n                                   [--skip-browser-checks] [--json]\n                                   [--verbose]\n\noptions:\n  -h, --help            show this help message and exit\n  --activation-height ACTIVATION_HEIGHT\n  --output-json OUTPUT_JSON\n  --output-markdown OUTPUT_MARKDOWN\n  --skip-subprocess-checks\n  --skip-browser-checks\n  --json\n  --verbose\n",
      "required": []
    },
    "pq-operational-readiness": {
      "help": "usage: chipcoin pq-operational-readiness [-h] [--json] [--html HTML]\n                                         [--output OUTPUT]\n                                         [--markdown MARKDOWN]\n                                         [--output-dir OUTPUT_DIR]\n                                         [--api-url API_URL]\n                                         [--timeout TIMEOUT] [--no-network]\n                                         [--strict] [--compact]\n                                         [--config CONFIG]\n                                         [--block-interval-window BLOCK_INTERVAL_WINDOW]\n                                         [--run-local-checks] [--html-stdout]\n                                         [--markdown-stdout] [--verbose]\n\noptions:\n  -h, --help            show this help message and exit\n  --json\n  --html HTML\n  --output OUTPUT\n  --markdown MARKDOWN\n  --output-dir OUTPUT_DIR\n  --api-url API_URL\n  --timeout TIMEOUT\n  --no-network\n  --strict\n  --compact\n  --config CONFIG\n  --block-interval-window BLOCK_INTERVAL_WINDOW\n  --run-local-checks\n  --html-stdout\n  --markdown-stdout\n  --verbose\n",
      "required": []
    },
    "verify-pq-activation": {
      "help": "usage: chipcoin verify-pq-activation [-h] [--network VERIFY_NETWORK]\n                                     [--expected-height EXPECTED_HEIGHT]\n                                     [--json]\n\noptions:\n  -h, --help            show this help message and exit\n  --network VERIFY_NETWORK\n  --expected-height EXPECTED_HEIGHT\n  --json\n",
      "required": []
    },
    "status": {
      "help": "usage: chipcoin status [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "operator-check": {
      "help": "usage: chipcoin operator-check [-h] [--json] [--reward-node-id REWARD_NODE_ID]\n                               [--node-url NODE_URL]\n                               [--miner-payout-address MINER_PAYOUT_ADDRESS]\n                               [--snapshot-manifest-url SNAPSHOT_MANIFEST_URL]\n                               [--request-timeout-seconds REQUEST_TIMEOUT_SECONDS]\n\noptions:\n  -h, --help            show this help message and exit\n  --json                Emit stable machine-readable JSON.\n  --reward-node-id REWARD_NODE_ID\n                        Require a specific reward node to be registered and\n                        eligible.\n  --node-url NODE_URL   Optional HTTP node API URL for remote mining template\n                        checks.\n  --miner-payout-address MINER_PAYOUT_ADDRESS\n                        Optional payout address used for mining template\n                        checks.\n  --snapshot-manifest-url SNAPSHOT_MANIFEST_URL\n                        Optional snapshot manifest URL to verify. Defaults to\n                        NODE_SNAPSHOT_MANIFEST_URLS when set.\n  --request-timeout-seconds REQUEST_TIMEOUT_SECONDS\n",
      "required": []
    },
    "tip": {
      "help": "usage: chipcoin tip [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "mine-local-block": {
      "help": "usage: chipcoin mine-local-block [-h] --payout-address PAYOUT_ADDRESS\n\noptions:\n  -h, --help            show this help message and exit\n  --payout-address PAYOUT_ADDRESS\n",
      "required": [
        "--payout-address"
      ]
    },
    "block": {
      "help": "usage: chipcoin block [-h] (--height HEIGHT | --hash HASH)\n\noptions:\n  -h, --help       show this help message and exit\n  --height HEIGHT\n  --hash HASH\n",
      "required": []
    },
    "tx": {
      "help": "usage: chipcoin tx [-h] txid\n\npositional arguments:\n  txid\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": [
        "txid"
      ]
    },
    "submit-raw-tx": {
      "help": "usage: chipcoin submit-raw-tx [-h] --node-url NODE_URL raw_hex\n\npositional arguments:\n  raw_hex\n\noptions:\n  -h, --help           show this help message and exit\n  --node-url NODE_URL  Node HTTP endpoint, for example http://127.0.0.1:8081\n",
      "required": [
        "--node-url",
        "raw_hex"
      ]
    },
    "add-peer": {
      "help": "usage: chipcoin add-peer [-h] host port\n\npositional arguments:\n  host\n  port\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": [
        "host",
        "port"
      ]
    },
    "remove-peer": {
      "help": "usage: chipcoin remove-peer [-h] host port\n\npositional arguments:\n  host\n  port\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": [
        "host",
        "port"
      ]
    },
    "list-peers": {
      "help": "usage: chipcoin list-peers [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "peer-detail": {
      "help": "usage: chipcoin peer-detail [-h] --node-id NODE_ID\n\noptions:\n  -h, --help         show this help message and exit\n  --node-id NODE_ID\n",
      "required": [
        "--node-id"
      ]
    },
    "peer-summary": {
      "help": "usage: chipcoin peer-summary [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "public-peers": {
      "help": "usage: chipcoin public-peers [-h] [--diagnostics]\n\noptions:\n  -h, --help     show this help message and exit\n  --diagnostics\n",
      "required": []
    },
    "peerbook-clean": {
      "help": "usage: chipcoin peerbook-clean [-h] [--reset-penalties] [--dry-run]\n\noptions:\n  -h, --help         show this help message and exit\n  --reset-penalties\n  --dry-run\n",
      "required": []
    },
    "mempool": {
      "help": "usage: chipcoin mempool [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "utxos": {
      "help": "usage: chipcoin utxos [-h] --address ADDRESS\n\noptions:\n  -h, --help         show this help message and exit\n  --address ADDRESS\n",
      "required": [
        "--address"
      ]
    },
    "balance": {
      "help": "usage: chipcoin balance [-h] --address ADDRESS\n\noptions:\n  -h, --help         show this help message and exit\n  --address ADDRESS\n",
      "required": [
        "--address"
      ]
    },
    "node-registry": {
      "help": "usage: chipcoin node-registry [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "next-winners": {
      "help": "usage: chipcoin next-winners [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "reward-history": {
      "help": "usage: chipcoin reward-history [-h] --address ADDRESS [--limit LIMIT]\n                               [--ascending] [--start-height START_HEIGHT]\n                               [--end-height END_HEIGHT]\n\noptions:\n  -h, --help            show this help message and exit\n  --address ADDRESS\n  --limit LIMIT\n  --ascending\n  --start-height START_HEIGHT\n  --end-height END_HEIGHT\n",
      "required": [
        "--address"
      ]
    },
    "reward-summary": {
      "help": "usage: chipcoin reward-summary [-h] --address ADDRESS\n                               [--start-height START_HEIGHT]\n                               [--end-height END_HEIGHT]\n\noptions:\n  -h, --help            show this help message and exit\n  --address ADDRESS\n  --start-height START_HEIGHT\n  --end-height END_HEIGHT\n",
      "required": [
        "--address"
      ]
    },
    "node-income-summary": {
      "help": "usage: chipcoin node-income-summary [-h] [--node-id NODE_ID]\n                                    [--address ADDRESS]\n\noptions:\n  -h, --help         show this help message and exit\n  --node-id NODE_ID\n  --address ADDRESS\n",
      "required": []
    },
    "mining-history": {
      "help": "usage: chipcoin mining-history [-h] --address ADDRESS [--limit LIMIT]\n                               [--ascending]\n\noptions:\n  -h, --help         show this help message and exit\n  --address ADDRESS\n  --limit LIMIT\n  --ascending\n",
      "required": [
        "--address"
      ]
    },
    "economy-summary": {
      "help": "usage: chipcoin economy-summary [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "supply": {
      "help": "usage: chipcoin supply [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "top-miners": {
      "help": "usage: chipcoin top-miners [-h] [--limit LIMIT]\n\noptions:\n  -h, --help     show this help message and exit\n  --limit LIMIT\n",
      "required": []
    },
    "top-nodes": {
      "help": "usage: chipcoin top-nodes [-h] [--limit LIMIT]\n\noptions:\n  -h, --help     show this help message and exit\n  --limit LIMIT\n",
      "required": []
    },
    "top-recipients": {
      "help": "usage: chipcoin top-recipients [-h] [--limit LIMIT]\n\noptions:\n  -h, --help     show this help message and exit\n  --limit LIMIT\n",
      "required": []
    },
    "supply-diagnostics": {
      "help": "usage: chipcoin supply-diagnostics [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "address-history": {
      "help": "usage: chipcoin address-history [-h] --address ADDRESS [--limit LIMIT]\n                                [--ascending]\n\noptions:\n  -h, --help         show this help message and exit\n  --address ADDRESS\n  --limit LIMIT\n  --ascending\n",
      "required": [
        "--address"
      ]
    },
    "difficulty": {
      "help": "usage: chipcoin difficulty [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "retarget-info": {
      "help": "usage: chipcoin retarget-info [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "chain-window": {
      "help": "usage: chipcoin chain-window [-h] --start START --end END\n\noptions:\n  -h, --help     show this help message and exit\n  --start START\n  --end END\n",
      "required": [
        "--start",
        "--end"
      ]
    },
    "sync": {
      "help": "usage: chipcoin sync [-h] --peer-data PEER_DATA\n\noptions:\n  -h, --help            show this help message and exit\n  --peer-data PEER_DATA\n                        Path to a peer SQLite data file.\n",
      "required": [
        "--peer-data"
      ]
    },
    "snapshot-export": {
      "help": "usage: chipcoin snapshot-export [-h] --snapshot-file SNAPSHOT_FILE\n                                [--snapshot-format {v1,v2,v3}]\n\noptions:\n  -h, --help            show this help message and exit\n  --snapshot-file SNAPSHOT_FILE\n  --snapshot-format {v1,v2,v3}\n",
      "required": [
        "--snapshot-file"
      ]
    },
    "snapshot-import": {
      "help": "usage: chipcoin snapshot-import [-h] --snapshot-file SNAPSHOT_FILE\n                                [--snapshot-reset]\n                                [--snapshot-trust-mode {off,warn,enforce}]\n                                [--snapshot-trusted-key SNAPSHOT_TRUSTED_KEY]\n                                [--snapshot-trusted-keys-file SNAPSHOT_TRUSTED_KEYS_FILE]\n\noptions:\n  -h, --help            show this help message and exit\n  --snapshot-file SNAPSHOT_FILE\n  --snapshot-reset\n  --snapshot-trust-mode {off,warn,enforce}\n  --snapshot-trusted-key SNAPSHOT_TRUSTED_KEY\n                        Trusted Ed25519 signer public key hex for snapshot\n                        verification.\n  --snapshot-trusted-keys-file SNAPSHOT_TRUSTED_KEYS_FILE\n                        Path to a text or JSON file containing trusted Ed25519\n                        signer public keys.\n",
      "required": [
        "--snapshot-file"
      ]
    },
    "snapshot-sign": {
      "help": "usage: chipcoin snapshot-sign [-h] --snapshot-file SNAPSHOT_FILE\n                              --private-key-file PRIVATE_KEY_FILE\n\noptions:\n  -h, --help            show this help message and exit\n  --snapshot-file SNAPSHOT_FILE\n  --private-key-file PRIVATE_KEY_FILE\n                        Protected file containing one raw 32-byte Ed25519\n                        private key in hex.\n",
      "required": [
        "--snapshot-file",
        "--private-key-file"
      ]
    },
    "wallet-generate": {
      "help": "usage: chipcoin wallet-generate [-h] --wallet-file WALLET_FILE\n                                [--scheme {secp256k1,mldsa44}]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --scheme {secp256k1,mldsa44}\n",
      "required": [
        "--wallet-file"
      ]
    },
    "wallet-import": {
      "help": "usage: chipcoin wallet-import [-h] --wallet-file WALLET_FILE\n                              (--private-key-hex PRIVATE_KEY_HEX | --private-key-file PRIVATE_KEY_FILE | --private-key-stdin)\n                              [--quiet]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --private-key-hex PRIVATE_KEY_HEX\n  --private-key-file PRIVATE_KEY_FILE\n                        Protected file containing one private key in hex;\n                        avoid passing key material in argv.\n  --private-key-stdin   Read one private key in hex from non-interactive\n                        stdin.\n  --quiet               Suppress imported private-key JSON output.\n",
      "required": [
        "--wallet-file"
      ]
    },
    "wallet-address": {
      "help": "usage: chipcoin wallet-address [-h] --wallet-file WALLET_FILE\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n",
      "required": [
        "--wallet-file"
      ]
    },
    "wallet-utxos": {
      "help": "usage: chipcoin wallet-utxos [-h] --wallet-file WALLET_FILE\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n",
      "required": [
        "--wallet-file"
      ]
    },
    "wallet-balance": {
      "help": "usage: chipcoin wallet-balance [-h] --wallet-file WALLET_FILE\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n",
      "required": [
        "--wallet-file"
      ]
    },
    "register-node": {
      "help": "usage: chipcoin register-node [-h] --wallet-file WALLET_FILE --node-id NODE_ID\n                              --payout-address PAYOUT_ADDRESS\n                              [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --node-id NODE_ID\n  --payout-address PAYOUT_ADDRESS\n  --connect CONNECT\n",
      "required": [
        "--wallet-file",
        "--node-id",
        "--payout-address"
      ]
    },
    "renew-node": {
      "help": "usage: chipcoin renew-node [-h] --wallet-file WALLET_FILE --node-id NODE_ID\n                           [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --node-id NODE_ID\n  --connect CONNECT\n",
      "required": [
        "--wallet-file",
        "--node-id"
      ]
    },
    "register-reward-node": {
      "help": "usage: chipcoin register-reward-node [-h] --wallet-file WALLET_FILE --node-id\n                                     NODE_ID --payout-address PAYOUT_ADDRESS\n                                     --node-pubkey-hex NODE_PUBKEY_HEX\n                                     --declared-host DECLARED_HOST\n                                     --declared-port DECLARED_PORT\n                                     [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --node-id NODE_ID\n  --payout-address PAYOUT_ADDRESS\n  --node-pubkey-hex NODE_PUBKEY_HEX\n  --declared-host DECLARED_HOST\n  --declared-port DECLARED_PORT\n  --connect CONNECT\n",
      "required": [
        "--wallet-file",
        "--node-id",
        "--payout-address",
        "--node-pubkey-hex",
        "--declared-host",
        "--declared-port"
      ]
    },
    "renew-reward-node": {
      "help": "usage: chipcoin renew-reward-node [-h] --wallet-file WALLET_FILE --node-id\n                                  NODE_ID --declared-host DECLARED_HOST\n                                  --declared-port DECLARED_PORT\n                                  [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --node-id NODE_ID\n  --declared-host DECLARED_HOST\n  --declared-port DECLARED_PORT\n  --connect CONNECT\n",
      "required": [
        "--wallet-file",
        "--node-id",
        "--declared-host",
        "--declared-port"
      ]
    },
    "reward-epoch-seed": {
      "help": "usage: chipcoin reward-epoch-seed [-h] [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": []
    },
    "reward-epoch-state": {
      "help": "usage: chipcoin reward-epoch-state [-h] [--epoch-index EPOCH_INDEX]\n                                   [--node-id NODE_ID]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n  --node-id NODE_ID\n",
      "required": []
    },
    "reward-assignments": {
      "help": "usage: chipcoin reward-assignments [-h] [--epoch-index EPOCH_INDEX]\n                                   [--node-id NODE_ID]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n  --node-id NODE_ID\n",
      "required": []
    },
    "reward-node-status": {
      "help": "usage: chipcoin reward-node-status [-h] --node-id NODE_ID\n                                   [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --node-id NODE_ID\n  --epoch-index EPOCH_INDEX\n",
      "required": [
        "--node-id"
      ]
    },
    "reward-node-fees": {
      "help": "usage: chipcoin reward-node-fees [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "reward-epoch-summary": {
      "help": "usage: chipcoin reward-epoch-summary [-h] --epoch-index EPOCH_INDEX\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": [
        "--epoch-index"
      ]
    },
    "reward-attestations": {
      "help": "usage: chipcoin reward-attestations [-h] [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": []
    },
    "reward-attestation-backlog": {
      "help": "usage: chipcoin reward-attestation-backlog [-h]\n\noptions:\n  -h, --help  show this help message and exit\n",
      "required": []
    },
    "reward-settlements": {
      "help": "usage: chipcoin reward-settlements [-h] [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": []
    },
    "reward-settlement-preview": {
      "help": "usage: chipcoin reward-settlement-preview [-h] [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": []
    },
    "reward-settlement-report": {
      "help": "usage: chipcoin reward-settlement-report [-h] [--epoch-index EPOCH_INDEX]\n\noptions:\n  -h, --help            show this help message and exit\n  --epoch-index EPOCH_INDEX\n",
      "required": []
    },
    "submit-reward-attestation-bundle": {
      "help": "usage: chipcoin submit-reward-attestation-bundle [-h] --bundle-file\n                                                 BUNDLE_FILE\n                                                 [--wallet-file WALLET_FILE]\n                                                 [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --bundle-file BUNDLE_FILE\n  --wallet-file WALLET_FILE\n  --connect CONNECT\n",
      "required": [
        "--bundle-file"
      ]
    },
    "submit-reward-settle-epoch": {
      "help": "usage: chipcoin submit-reward-settle-epoch [-h] --settlement-file\n                                           SETTLEMENT_FILE [--connect CONNECT]\n\noptions:\n  -h, --help            show this help message and exit\n  --settlement-file SETTLEMENT_FILE\n  --connect CONNECT\n",
      "required": [
        "--settlement-file"
      ]
    },
    "wallet-build": {
      "help": "usage: chipcoin wallet-build [-h] --wallet-file WALLET_FILE --to TO --amount\n                             AMOUNT --fee FEE\n                             [--change-address CHANGE_ADDRESS]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --to TO\n  --amount AMOUNT\n  --fee FEE\n  --change-address CHANGE_ADDRESS\n",
      "required": [
        "--wallet-file",
        "--to",
        "--amount",
        "--fee"
      ]
    },
    "wallet-send": {
      "help": "usage: chipcoin wallet-send [-h] --wallet-file WALLET_FILE --to TO --amount\n                            AMOUNT --fee FEE [--change-address CHANGE_ADDRESS]\n                            [--connect CONNECT] [--node-url NODE_URL]\n\noptions:\n  -h, --help            show this help message and exit\n  --wallet-file WALLET_FILE\n  --to TO\n  --amount AMOUNT\n  --fee FEE\n  --change-address CHANGE_ADDRESS\n  --connect CONNECT     Optional node endpoint in host:port form for P2P\n                        submission.\n  --node-url NODE_URL   Optional node HTTP API base URL for transaction\n                        submission.\n",
      "required": [
        "--wallet-file",
        "--to",
        "--amount",
        "--fee"
      ]
    }
  }
}
