Subscribing to events via Websocket

Tendermint emits different events, which you can subscribe to via Websocket (opens new window). This can be useful for third-party applications (for analysis) or for inspecting state.

List of events (opens new window)

To connect to a node via websocket from the CLI, you can use a tool such as wscat (opens new window) and run:

Copy wscat ws://127.0.0.1:26657/websocket

You can subscribe to any of the events above by calling the subscribe RPC method via Websocket along with a valid query.

Copy { "jsonrpc": "2.0", "method": "subscribe", "id": 0, "params": { "query": "tm.event='NewBlock'" } }

Check out API docs (opens new window) for more information on query syntax and other options.

You can also use tags, given you had included them into DeliverTx response, to query transaction results. See Indexing transactions for details.

ValidatorSetUpdates

When validator set changes, ValidatorSetUpdates event is published. The event carries a list of pubkey/power pairs. The list is the same Tendermint receives from ABCI application (see EndBlock section (opens new window) in the ABCI spec).

Response:

Copy { "jsonrpc": "2.0", "id": 0, "result": { "query": "tm.event='ValidatorSetUpdates'", "data": { "type": "tendermint/event/ValidatorSetUpdates", "value": { "validator_updates": [ { "address": "09EAD022FD25DE3A02E64B0FE9610B1417183EE4", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "ww0z4WaZ0Xg+YI10w43wTWbBmM3dpVza4mmSQYsd0ck=" }, "voting_power": "10", "proposer_priority": "0" } ] } } } }