Transaction Relayer - XOXNO Docs

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

Need	Action
You signed the transaction and pay gas	`broadcast` over WebSocket or `POST /v1/broadcast`
XOXNO co-signs and pays gas	`relay` over WebSocket or `POST /v1/sign`
You need live gas, account, or transaction status events	Subscribe to a WebSocket `topic`
You need push-only network snapshots	Connect to `/ws/stats`

Need	Use instead
You need account state or historical block reads	Gateway
You need swap route construction	Aggregator
You need wallet-side signing	A wallet SDK before calling `broadcast`

Entry point	Purpose	Auth
`wss://relayer.xoxno.com/ws`	Subscriptions, `broadcast`, and `relay` control messages	Public for subscriptions and broadcast; Relayer V3 access is gated
`wss://relayer.xoxno.com/ws/stats`	Push-only network stats stream	None
`https://relayer.xoxno.com/v1/broadcast`	REST broadcast for signed transactions	None
`https://relayer.xoxno.com/v1/sign`	Relayer V3 co-signing	Whitelisted access
`https://relayer.xoxno.com/v1/network-stats/history`	Historical network stats	None

Connect

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

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

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.

Correlate events

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

Action	Limit or behavior
Active subscriptions	64 topics per WebSocket connection
Message size	4 MB
Gas stats stream	50 ms debounce, 5 s periodic fallback
Network stats stream	Adaptive interval, default about 6 s, clamped 500 ms to 30 s
Relayer V3	Enterprise-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.

Broadcast a signed transaction and verify its status event.

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

Send user-paid transactions through WebSocket or REST.

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