Gas statistics - XOXNO Docs

Subscribe to gasStats to receive per-shard gas price and PPU statistics.

Request

{
  "action": "subscribe",
  "requestId": "gas-001",
  "topic": "gasStats"
}

Acknowledgment

{
  "action": "subscribe",
  "requestId": "gas-001",
  "status": "ok",
  "topic": "gasStats"
}

Pushed Event

{
  "type": "gasStats",
  "data": {
    "shard": 0,
    "gasPrice": {
      "min": 1000000000,
      "max": 1500000000,
      "avg": 1200000000,
      "bucketAvg": 1210000000,
      "percentiles": {
        "p50": 1150000000,
        "p75": 1350000000,
        "p90": 1450000000
      }
    },
    "ppu": {
      "avg": 0.0000012,
      "percentiles": {
        "p50": 0.0000011,
        "p75": 0.0000013,
        "p90": 0.0000014
      }
    }
  }
}

Fields

Field	Meaning
`data.shard`	Shard ID.
`gasPrice.avg`	Arithmetic average across the 30-minute window.
`gasPrice.bucketAvg`	Average of 10-second bucket averages.
`gasPrice.percentiles`	`p50`, `p75`, and `p90` gas prices.
`ppu`	Price per gas unit after data payload costs.

Limits

Limit	Value
Update cadence	50 ms debounce on state changes
Periodic fallback	5 s
Window	30 minutes, divided into 10-second buckets
Topic slot usage	1 of 64 active topics

Unsubscribe

{
  "action": "unsubscribe",
  "requestId": "gas-stop",
  "topic": "gasStats"
}

Reconnect Handling

After reconnect, send the subscribe control message again. Keep the last received shard values in memory until fresh events arrive.