Skip to content

Matrix Pulse#

Matrix Pulse is a lightweight live monitor for Ergo Matrix input-block activity. It tails an Ergo Matrix node's systemd journal, parses input-block lifecycle events, and streams a browser view over Server-Sent Events.

What It Shows#

The repository describes a compact status and activity view for:

  • node version, network, name, processed/header heights, processing lag, sync state, peers, mempool, and mining status from /info;
  • Matrix sub-blocks per block, current input-block tip, competing forks, best fork depth, and difficulty;
  • sub-block arrivals, applied input-block transactions, disconnected-queue churn, fork switches, cumulative rollups, and a bounded notices log;
  • parser health, sequence-gap detection, and stale-frame state kept separate from the SSE connection state.

Operator Notes#

Matrix Pulse is intentionally small: Python standard library only, no external Python dependencies, and loopback-only by default. The README says the SSE server binds to 127.0.0.1, exposes only the page and event stream, reads the node journal and /info, and does not write to the node.

Use it as operator/debugging tooling for Matrix DevNet-style testing, not as consensus evidence or a production monitoring guarantee.