show_stats — Group 0, Code 02

Returns operational statistics.

Purpose

show_stats is the live statistics endpoint in Group 0. It is the correct reference for operator-style metrics requests; older pages that described code 02 differently are not authoritative.

When to call it

Use this command for aggregated service and performance insight, not for coin validation.

Request body

After the encrypted challenge, the body carries a 16-byte admin key. The handler compares it against config.admin_key and rejects with ERROR_ADMIN_AUTH on mismatch — this command is privileged.

CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH AU AU AU AU AU AU AU AU AU AU AU AU AU AU AU AU 3E 3E

Request packet diagram

Challenge (16 bytes) 0 15 Admin Key (16 bytes) — must equal config.admin_key 16 31

Bytes 32-33 carry the fixed 3E 3E protocol terminator.

Response body

On success the body is a copy of the server’s struct stats_s. The exact byte size depends on the stats struct layout at the responding RAIDA's build; clients should treat the response as opaque metrics data and parse it against the same struct definition the server uses.

Status codes

DecimalHexMeaning
2500xFASTATUS_SUCCESS
1320x84ERROR_EMPTY_REQUEST — body missing
1920xC0ERROR_ADMIN_AUTH — admin key did not match
2540xFEERROR_MEMORY_ALLOC — server allocation failure