Skip to main content
Use broadcast to send fully signed MultiversX transactions through the Relayer without XOXNO co-signing or paying gas.

​
Use This When

NeedAction
User signed and pays gasSend broadcast.
Backend signer produced signed transactionsSend broadcast with tx or txs.
You need status after submissionSubscribe to tx-status/{hash} before or after broadcast.

​
Do Not Use This When

NeedUse
XOXNO co-signs and pays gasRelayer V3
Transaction is not signed yetWallet or signing SDK first
You only need RPC status pollingGateway transactions

​
Entry Points

TransportEndpointPayload
WebSocketwss://relayer.xoxno.com/wsbroadcast control message
RESTPOST https://relayer.xoxno.com/v1/broadcastJSON body with transactions

​
Flow

1

Build and sign

Construct the MultiversX transaction and sign it with the sender wallet or backend signer.
2

Subscribe to status

Subscribe to tx-status/{hash} when the hash is known, or track returned hashes after broadcast.
3

Broadcast

Send one transaction in tx or a batch in txs over WebSocket, or call POST /v1/broadcast.
4

Verify

Treat status: completed as Relayer acceptance. Wait for a txStatus event or Gateway status for chain finality.

​
Example Payload

{
  "action": "broadcast",
  "requestId": "tx-001",
  "tx": {
    "nonce": 42,
    "value": "0",
    "receiver": "erd1...",
    "sender": "erd1...",
    "gasPrice": 1000000000,
    "gasLimit": 50000,
    "data": "",
    "chainID": "1",
    "version": 2,
    "signature": "<hex-signature>"
  }
}
The payload above is an example. Replace placeholders with a real signed transaction.

​
Edge Cases

CaseBehaviorFix
invalid signatureThe signature does not match the transaction payload.Rebuild and sign again.
nonce too lowSender nonce already advanced.Re-read nonce and sign a new transaction.
Batch with partial failuresRelayer can return partial with per-index reasons.Retry only failed transactions after rebuilding nonce order.
Accepted but not finalizedBroadcast acknowledgment is not finality.Track txStatus or Gateway status.