AssignRequest

Request body of POST /v1/relay/assign.

senderAddressrequired

MultiversX bech32 address.

Possible values: Value must match regular expression ^erd1[02-9ac-hj-np-z]{58}$

Example: erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e

proof object

Proof that the caller controls the sender. Required unless a native-auth bearer token of sender is presented. signature is an Ed25519 signature, made by the sender's own key, over the UTF-8 bytes of the message corelayer/assign/v1|<chainId>|<sender bech32>|<serverTimeMs>. Sign the bytes directly: a wallet's signMessage adds the MultiversX signed-message prefix first, and that signature does not verify. kind is sponsor when a sponsor API key will pay for the relay (sent as X-Api-Key on POST /v1/relay), and key otherwise. The sender's key signs both kinds. It signs a message: there is no nonce and no wallet prompt, and the user still signs the transaction only once. The server verifies it, and it can be used once per (sender, serverTimeMs).

kindstringrequired

Possible values: [key, sponsor]

serverTimeMsinteger<int64>required

Within +/- 30 000 ms of the signer clock (GET /v1/network.serverTimeMs).

Possible values: >= 0

signaturestringrequired

Possible values: Value must match regular expression ^[0-9a-f]{128}$

renewForAddress

Relayer named in an already signed transaction; returns a RENEWAL lease for it.

Possible values: Value must match regular expression ^erd1[02-9ac-hj-np-z]{58}$

Example: erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e

cancel object

nonceinteger<int64>required

Possible values: >= 0

AssignRequest

{
  "sender": "erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e",
  "proof": {
    "kind": "key",
    "serverTimeMs": 0,
    "signature": "string"
  },
  "renewFor": "erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e",
  "cancel": {
    "nonce": 0
  }
}