Events & WebSocket Subscriptions

Subscribe to real-time events via CometBFT WebSocket at ws://localhost:26657/websocket.

bash

# Connect with wscat
wscat -c ws://localhost:26657/websocket

Subscribe to Events

json

// All procurement releases
{ "jsonrpc": "2.0", "method": "subscribe", "id": "1",
  "params": { "query": "release_submitted.ocid EXISTS" } }

// All infrastructure project creations
{ "jsonrpc": "2.0", "method": "subscribe", "id": "2",
  "params": { "query": "project_created.project_id EXISTS" } }

// Specific OCID only
{ "jsonrpc": "2.0", "method": "subscribe", "id": "3",
  "params": { "query": "release_submitted.ocid='ocds-abc123-ph-dpwh-2024-0001'" } }

Event Reference

Procurement

release_submitted	ocid, release_id, publisher
process_created	ocid, publisher, stage
tender_published	ocid, tender_id, publisher
award_made	ocid, award_id, publisher
contract_signed	ocid, contract_id, publisher
implementation_updated	ocid, contract_id, publisher
entity_registered	entity_id, name, registrar

Infrastructure

project_created	project_id, title, status, publisher
project_updated	project_id, status, publisher
progress_updated	project_id, metric_id, measure, publisher
document_attached	project_id, document_id, document_type, publisher