Skip to main content
Use the Relayer to broadcast signed transactions, stream chain events, or relay Relayer V3 transactions where XOXNO co-signs and pays gas.

​
Use This When

NeedAction
You signed the transaction and pay gasbroadcast over WebSocket or POST /v1/broadcast
XOXNO co-signs and pays gasrelay over WebSocket or POST /v1/sign
You need live gas, account, or transaction status eventsSubscribe to a WebSocket topic
You need push-only network snapshotsConnect to /ws/stats

​
Do Not Use This When

NeedUse instead
You need account state or historical block readsGateway
You need swap route constructionAggregator
You need wallet-side signingA wallet SDK before calling broadcast

​
Entry Points

Entry pointPurposeAuth
wss://relayer.xoxno.com/wsSubscriptions, broadcast, and relay control messagesPublic for subscriptions and broadcast; Relayer V3 access is gated
wss://relayer.xoxno.com/ws/statsPush-only network stats streamNone
https://relayer.xoxno.com/v1/broadcastREST broadcast for signed transactionsNone
https://relayer.xoxno.com/v1/signRelayer V3 co-signingWhitelisted access
https://relayer.xoxno.com/v1/network-stats/historyHistorical network statsNone

​
Flow

1

Connect

Open a WebSocket to /ws for subscriptions and control messages, or to /ws/stats for network snapshots only.
2

Subscribe

Send a subscribe control message for each topic you need, such as gas stats, account deltas, or transaction status.
3

Broadcast or relay

Send broadcast when the user pays gas with a signed transaction. Send relay only for Relayer V3 flows where XOXNO co-signs and pays gas.
4

Correlate events

Include requestId in control messages and match it against acknowledgments and pushed status events.

​
Limits

ActionLimit or behavior
Active subscriptions64 topics per WebSocket connection
Message size4 MB
Gas stats stream50 ms debounce, 5 s periodic fallback
Network stats streamAdaptive interval, default about 6 s, clamped 500 ms to 30 s
Relayer V3Enterprise-only access; XOXNO co-signs and pays gas
Use broadcast for signed transactions where the user pays gas. Use relay only when your integration is approved for Relayer V3.

​
Next Steps

Quickstart

Broadcast a signed transaction and verify its status event.

Connection limits

Heartbeats, topic caps, message limits, and reconnect handling.

Broadcast transactions

Send user-paid transactions through WebSocket or REST.

Relayer V3

Prepare a flow where XOXNO co-signs and pays gas.