Skip to main content

Module node

Module node 

Source
Expand description

decdn node ... — operator-local admin commands that talk to a running node over its loopback JSON-RPC admin surface (appendix-local-admin-http).

Functions§

drain
decdn node drain: call admin_v1_drain on the running node to trigger graceful shutdown (issue #244, appendix-local-admin-http.md).
evict
decdn node evict: call admin_v1_evict on the running node to forcibly remove a single blob from the local cache (issue #279), or preview what the evict would touch when --dry-run is set (issue #379).
health
decdn node health: call admin_v1_health on the running node and print the result. Two-line plain text by default (node_id=… / uptime_s=…), or pretty JSON with --json.
lanes
decdn node lanes: call admin_v1_lanes on the running node and print a snapshot of its open payment lanes (issue #749).
lookup
decdn node lookup — unpaid client-side discovery of active nodes via CapacityBond.getRegisteredNodes (#1481). Unlike register/bond/unbond/ deregister, this never loads a keystore: [discovery::active_nodes] builds its own signer-less read-only provider, so chain_ctx::resolve’s keystore/data_dir outputs are simply unused here.
node_dispatch
Dispatch a decdn node <sub> invocation.
pools
decdn node pools: call admin_v1_pools on the running node and print its buyer-side PaymentPool state — the pools it pays upstream providers from.
reload
decdn node reload: call admin_v1_reload on the running node to re-read the config file it was started with and apply the hot-reloadable subset (issue #373). Equivalent to kill -HUP <pid> for operators who’d rather not stat the PID — and shares the same internal mutex, so concurrent SIGHUPs queue rather than race.
slashes
decdn node slashes: call admin_v1_slashes on the running node and print every detected slash against its operator (#1032). Plain text by default (a summary line + a per-slash table), or pretty JSON with --json.
status
decdn node status: call admin_v1_status on the running node and print a snapshot of its DHT participation health (issue #741).