broadcast - XOXNO Docs

Broadcast one or more fully signed transactions to MultiversX validators via the P2P gossipsub network. The Relayer forwards transactions without modifying or co-signing them.

Endpoint

wss://relayer.xoxno.com/ws

Body

string

required

Must be "broadcast".

string

Echoed back in the response for client-side correlation. Use a unique value per request to match responses across concurrent operations.

object

required

A single signed transaction object.

Hide properties

integer

required

Sender’s current account nonce.

string

required

EGLD value in atomic units (1 EGLD = "1000000000000000000"). Use "0" for ESDT transfers.

string

required

Receiver address in bech32 format (erd1...).

string

required

Sender address in bech32 format (erd1...).

integer

required

Gas price in atomic units. Minimum: 1000000000.

integer

required

Maximum gas units for the transaction.

string

Base64-encoded transaction payload.

string

required

"1" for mainnet, "D" for devnet.

integer

required

Transaction version. Use 2.

string

required

Hex-encoded Ed25519 signature of the serialized transaction.

Response

string

"broadcast"

string

Echoed from the request.

string

"completed" when all transactions succeed, "partial" when some fail, "failed" when all fail.

string[]

Transaction hashes for successfully broadcast transactions.

object[]

Failures, each with index and reason.

Show properties

integer

Zero-based index of the failed transaction in the batch.

string

Error description. See the error reference for all values.

{
  "action": "broadcast",
  "requestId": "tx-001",
  "tx": {
    "nonce": 42,
    "value": "1000000000000000000",
    "receiver": "erd1qyu5wthldzr8wx5c9ucg8kjagg0jfs53s8nr3zpz3hypefsdd8ssycr6th",
    "sender": "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",
    "gasPrice": 1000000000,
    "gasLimit": 50000,
    "chainID": "1",
    "version": 2,
    "signature": "a1b2c3d4..."
  }
}

{
  "action": "broadcast",
  "requestId": "tx-001",
  "status": "completed",
  "hashes": [
    "d5e8c9a1b3f7..."
  ],
  "failed": []
}

{
  "action": "broadcast",
  "requestId": "tx-001",
  "status": "partial",
  "hashes": ["d5e8c9a1b3f7..."],
  "failed": [
    { "index": 1, "reason": "invalid signature" }
  ]
}

​Endpoint

​Body

​Response

Endpoint

Body

Response