> ## Documentation Index
> Fetch the complete documentation index at: https://xoxno.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction Relayer

> Use the Relayer to broadcast signed MultiversX transactions, relay Relayer V3 transactions, and stream confirmation events.

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`                             |

## Do Not Use This When

| Need                                             | Use instead                             |
| ------------------------------------------------ | --------------------------------------- |
| You need account state or historical block reads | [Gateway](/gateway/overview)            |
| You need swap route construction                 | [Aggregator](/aggregator/overview)      |
| You need wallet-side signing                     | A wallet SDK before calling `broadcast` |

## Entry Points

| 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                                                               |

## Flow

<Steps>
  <Step title="Connect">
    Open a WebSocket to `/ws` for subscriptions and control messages, or to `/ws/stats` for network snapshots only.
  </Step>

  <Step title="Subscribe">
    Send a `subscribe` control message for each `topic` you need, such as gas stats, account deltas, or transaction status.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Correlate events">
    Include `requestId` in control messages and match it against acknowledgments and pushed status events.
  </Step>
</Steps>

## Limits

| 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          |

<Warning>
  Use `broadcast` for signed transactions where the user pays gas. Use `relay` only when your integration is approved for Relayer V3.
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/relayer/quickstart">
    Broadcast a signed transaction and verify its status event.
  </Card>

  <Card title="Connection limits" icon="shield" href="/relayer/connection-limits">
    Heartbeats, topic caps, message limits, and reconnect handling.
  </Card>

  <Card title="Broadcast transactions" icon="radio" href="/relayer/transaction-broadcasting">
    Send user-paid transactions through WebSocket or REST.
  </Card>

  <Card title="Relayer V3" icon="key-round" href="/relayer/transaction-relaying">
    Prepare a flow where XOXNO co-signs and pays gas.
  </Card>
</CardGroup>