networkStats - XOXNO Docs

The server pushes this event at adaptive intervals tuned to block time. On /ws/stats, it arrives automatically. On /ws, subscribe to the networkStats topic. The payload includes schema versioning for forward compatibility.

Topic

Connect to wss://relayer.xoxno.com/ws/stats (automatic) or subscribe to networkStats on wss://relayer.xoxno.com/ws.

Event fields

string

Value is "networkStats".

string

Semantic version of the schema (e.g., "1.1.0").

integer

Monotonically increasing frame counter. Use this to detect gaps.

integer

Unix timestamp in milliseconds.

object

Hide properties

object

Show properties

number

Current transactions per second.

number

Rolling 10-second TPS average.

integer

Total connected P2P peers.

integer

Validators with a recent heartbeat.

integer

WebSocket delivery lag, in milliseconds.

object

Show properties

object

Latest shard block metadata (nonce, round, epoch, hash).

object

Latest metachain block metadata.

object

Median block time per shard in milliseconds.

object

Show properties

integer

Estimated pending transaction count.

number

Transactions entering the mempool per second.

number

Transactions included in blocks per second.

number

Queue depth relative to throughput capacity (0.0 to 1.0).

object

Show properties

object

Online validator count per shard.

integer

Total online validators.

number

Heartbeat messages per second.

object

Show properties

number

P2P message deduplication ratio over the last minute.

integer

Active WebSocket subscribers.

number

Data completeness score (0.0 to 1.0).

{
  "type": "networkStats",
  "schemaVersion": "1.1.0",
  "sequence": 4821,
  "ts": 1738800000000,
  "data": {
    "network": {
      "currentTps": 85.3,
      "avgTps10s": 82.1,
      "connectedPeers": 147,
      "activeValidators": 3200,
      "wsLagMs": 2
    },
    "blocks": {
      "latestShard": { "nonce": 19284712, "round": 19285000, "epoch": 1200 },
      "latestMeta": { "nonce": 19284700, "round": 19284950, "epoch": 1200 },
      "blockTimeMsP50ByShard": { "0": 6000, "1": 6100, "2": 5900 }
    },
    "mempool": {
      "estimatedQueue": 1240,
      "ingressTps": 90.5,
      "inclusionTps": 85.3,
      "pressure": 0.34
    },
    "validators": {
      "onlineByShard": { "0": 800, "1": 800, "2": 800, "meta": 800 },
      "totalOnline": 3200,
      "heartbeatRatePerSec": 12.5
    },
    "health": {
      "p2pDedupRatio1m": 0.92,
      "streamSubscribers": 45,
      "dataCompleteness": 1.0
    }
  }
}

​Topic

​Event fields

Topic

Event fields