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

# Welcome to XOXNO

> Build on XOXNO across Stellar and MultiversX: a Soroban-native lending protocol to supply, borrow, and earn yield on stablecoins, plus swap aggregation, transaction relaying, chain-event streaming, and Gateway RPC.

Use XOXNO to broadcast MultiversX transactions, stream confirmation events, quote swaps, query Gateway RPC, integrate Stellar lending, or run an `mxnode` host.

## Use This When

| Goal                                                       | Use                | Entry point                                                              |
| ---------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------ |
| Broadcast a signed MultiversX transaction                  | Relayer            | `wss://relayer.xoxno.com/ws` or `https://relayer.xoxno.com/v1/broadcast` |
| Let XOXNO co-sign and pay gas                              | Relayer V3         | `https://relayer.xoxno.com/v1/sign`                                      |
| Stream gas, account, network, or transaction status events | Relayer WebSocket  | `wss://relayer.xoxno.com/ws`                                             |
| Quote and build a MultiversX swap transaction              | Aggregator         | `https://swap.xoxno.com/api/v1/quote`                                    |
| Quote and build a Stellar `TransactionEnvelope`            | Stellar Aggregator | `https://stellar-swap.xoxno.com/api/v1/quote`                            |
| Query MultiversX observer data through shard-aware RPC     | Gateway            | `https://rust-gateway.xoxno.com`                                         |
| Run validators, observers, or multikey hosts               | mxnode             | `mxnode install`                                                         |

## Start Here

<CardGroup cols={2}>
  <Card title="Relayer quickstart" icon="radio" href="/relayer/quickstart">
    Broadcast a signed transaction and watch its status.
  </Card>

  <Card title="Aggregator quickstart" icon="shuffle" href="/aggregator/quickstart">
    Validate a pair, request a quote, and inspect transaction data.
  </Card>

  <Card title="Gateway quickstart" icon="server" href="/gateway/quickstart">
    Query an account and submit a transaction through the Gateway.
  </Card>

  <Card title="mxnode quickstart" icon="terminal" href="/mxnode/quickstart">
    Install the CLI and start a MultiversX node shape.
  </Card>
</CardGroup>

## Build Flow

<Steps>
  <Step title="Choose the execution path">
    Use the decision table above. Do not mix `broadcast` and `relay`: `broadcast` sends your signed transaction, while `relay` means XOXNO co-signs and pays gas.
  </Step>

  <Step title="Read the product overview">
    Each overview gives the base URL, availability, limits, and the next API or guide page.
  </Step>

  <Step title="Run the quickstart">
    Quickstarts end with a verification step: a status event, supported-pair result, successful account read, or running node unit.
  </Step>

  <Step title="Move to the reference">
    Use OpenAPI pages for endpoint structure and MDX guides for behavior that schemas cannot express.
  </Step>
</Steps>

## Canonical Limits

| Area                           | Limit or default                                              |
| ------------------------------ | ------------------------------------------------------------- |
| Relayer WebSocket topics       | 64 active topics per connection                               |
| Relayer WebSocket message size | 4 MB                                                          |
| Relayer gas statistics         | 50 ms debounce, 5 s periodic fallback                         |
| Relayer network stats          | Adaptive interval, default about 6 s, clamped 500 ms to 30 s  |
| Aggregator rate limit          | 100 requests per second per IP                                |
| MultiversX Aggregator sources  | xExchange, AshSwap, JEX, OneDex                               |
| Stellar Aggregator sources     | Soroswap, Aquarius, Phoenix, Stellar SDEX, static SAC bridges |
| Gateway endpoint coverage      | 80 OpenAPI endpoints                                          |
| Gateway metachain shard ID     | `4294967295`                                                  |
| mxnode multikey shape          | 4 nodes, one per shard                                        |

## Product Paths

<CardGroup cols={2}>
  <Card title="Relayer" icon="bolt" href="/relayer/overview">
    Broadcast signed transactions, relay Relayer V3 transactions, and stream WebSocket events.
  </Card>

  <Card title="MultiversX Aggregator" icon="shuffle" href="/aggregator/overview">
    Quote swaps against the latest pool snapshot and build transaction data.
  </Card>

  <Card title="Stellar Aggregator" icon="orbit" href="/stellar-aggregator/overview">
    Quote Soroban and Classic routes and request a prepared `TransactionEnvelope`.
  </Card>

  <Card title="Gateway" icon="server" href="/gateway/overview">
    Query MultiversX accounts, transactions, blocks, network data, and VM values.
  </Card>

  <Card title="Stellar Lending" icon="coins" href="/stellar-lending/overview">
    Integrate supply, borrow, repay, withdraw, liquidation, flash-loan, and strategy flows.
  </Card>

  <Card title="mxnode" icon="terminal" href="/mxnode/overview">
    Install and operate MultiversX validators, observers, and multikey hosts.
  </Card>
</CardGroup>