WebSocket Tools

Real-time blockchain monitoring via persistent WebSocket connections.

WebSocket Connection(zetrix_ws_connect)

Connect and register to WebSocket for real-time updates.

Purpose: Establish persistent bidirectional connection to Zetrix node.

Returns:

  • Connection status

  • Blockchain version

  • Node information

Connection Details:

  • Mainnet: ws://node-ws.zetrix.com

  • Testnet: ws://test-node-ws.zetrix.com

Automatic Handling:

  • Reconnects on disconnect

  • Queues messages during reconnection


Transaction via WebSocket(zetrix_ws_submit_transaction)

Submit transaction via WebSocket with real-time status.

Purpose: Send transaction and receive instant status updates as it processes.

Advantages over HTTP:

  • Real-time status updates

  • Instant confirmation notifications

  • No polling required

Timeout: 30 seconds for confirmation, then falls back to polling.


Transaction Events(zetrix_ws_subscribe_tx)

Subscribe to transaction notifications for addresses.

Purpose: Monitor specific addresses and get notified of any transactions.

Parameters:

  • addresses (array): List of addresses to monitor

Notifications:

  • Incoming transactions

  • Outgoing transactions

  • Transaction details

Limits: Maximum 100 subscriptions per connection

Use Cases:

  • Payment processing

  • Wallet notifications

  • Exchange deposit monitoring


Transaction Events(zetrix_ws_disconnect)

Disconnect from WebSocket.

Purpose: Properly close WebSocket connection and clean up resources.

Note: Can reconnect after disconnect by calling ws_connect again.


WebSocket Connection Status(zetrix_ws_status)

Check WebSocket connection status.

Purpose: Verify connection state and health.

Returns:

  • Connection state (connected/disconnected)

  • Message count

  • Errors

  • Reconnection attempts

  • Latency


Last updated