Skip to main content
Enterprise feature. Submit a user-signed transaction that includes a shard-matched relayer address. The Relayer validates the shard assignment, co-signs with its Ed25519 key, and broadcasts via P2P gossipsub, covering the gas fee. Gasless relaying is available to whitelisted enterprise applications. For standard transaction submission, use broadcast instead.

Endpoint

wss://relayer.xoxno.com/ws

Body

action
string
required
Must be "relay".
requestId
string
Echoed back in the response for client-side correlation.
tx
object
required
A user-signed transaction with the relayer field set.

Response

action
string
"relay"
requestId
string
Echoed from the request.
status
string
"completed", "partial", or "failed".
hashes
string[]
Transaction hashes for successfully relayed transactions.
failed
object[]
Failures, each with index and reason.
{
  "action": "relay",
  "requestId": "relay-001",
  "tx": {
    "nonce": 42,
    "value": "0",
    "receiver": "erd1qqqqqqqqqqqqqpgq...",
    "sender": "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",
    "gasPrice": 1000000000,
    "gasLimit": 50000000,
    "data": "c3dhcA==",
    "chainID": "1",
    "version": 2,
    "signature": "a1b2c3d4...",
    "relayer": "erd1l0x0n5yxsfcy93gm0vyvx9m9f7cte9h9vuq4am33ugpw3d5r3hvqx6f59h"
  }
}
{
  "action": "relay",
  "requestId": "relay-001",
  "status": "completed",
  "hashes": [
    "d5e8c9a1b3f7..."
  ],
  "failed": []
}
{
  "action": "relay",
  "requestId": "relay-001",
  "status": "failed",
  "hashes": [],
  "failed": [
    { "index": 0, "reason": "shard mismatch: sender_shard=1, relayer_shard=0" }
  ]
}