Request Challenge Transaction

GET 
/WEB_AUTH_ENDPOINT

Allows the wallet to get the SEP-10 challenge transaction to be signed. More information here. The endpoint url can change but is provided in the Get Stellar toml endpoint response under the WEB_AUTH_ENDPOINT variable.

Request

Query Parameters

account stringrequired

The Client Account, which can be a stellar account (G...) or muxed account (M...) that the Client wishes to authenticate with the Server..

memo string

The memo to attach to the challenge transaction. Only permitted if a Stellar account (G...) is used. The memo must be of type id. Other memo types are not supported.

client_domain stringrequired

a Client Domain. Need to be supplied by all Clients/Wallets.

Responses

200

OK

Response Headers

application/json

Schema

Schema

transaction string
network_passphrase string

Example (from schema)

{
  "transaction": "AAAAAgAAAADIiRu2BrqqeOcP28PWCkD4D5Rjjsqh71HwvqFX+F4VXAAAAGQAAAAAAAAAAAAAAAEAAAAAXzrUcQAAAABfOtf1AAAAAAAAAAEAAAABAAAAAEEB8rhqNa70RYjaNnF1ARE2CbL50iR9HPXST/fImJN1AAAACgAAADB0aGlzaXNhdGVzdC5zYW5kYm94LmFuY2hvci5hbmNob3Jkb21haW4uY29tIGF1dGgAAAABAAAAQGdGOFlIQm1zaGpEWEY0L0VJUFZucGVlRkxVTDY2V0tKMVBPYXZuUVVBNjBoL09XaC91M2Vvdk54WFJtSTAvQ2UAAAAAAAAAAfheFVwAAABAheKE1HjGnUCNwPbX8mz7CqotShKbA+xM2Hbjl6X0TBpEprVOUVjA6lqMJ1j62vrxn1mF3eJzsLa9s9hRofG3Ag==",
  "network_passphrase": "Test SDF Network ; September 2015"
}

response

{
  "transaction": "AAAAAgAAAADIiRu2BrqqeOcP28PWCkD4D5Rjjsqh71HwvqFX+F4VXAAAAGQAAAAAAAAAAAAAAAEAAAAAXzrUcQAAAABfOtf1AAAAAAAAAAEAAAABAAAAAEEB8rhqNa70RYjaNnF1ARE2CbL50iR9HPXST/fImJN1AAAACgAAADB0aGlzaXNhdGVzdC5zYW5kYm94LmFuY2hvci5hbmNob3Jkb21haW4uY29tIGF1dGgAAAABAAAAQGdGOFlIQm1zaGpEWEY0L0VJUFZucGVlRkxVTDY2V0tKMVBPYXZuUVVBNjBoL09XaC91M2Vvdk54WFJtSTAvQ2UAAAAAAAAAAfheFVwAAABAheKE1HjGnUCNwPbX8mz7CqotShKbA+xM2Hbjl6X0TBpEprVOUVjA6lqMJ1j62vrxn1mF3eJzsLa9s9hRofG3Ag==",
  "network_passphrase": "Test SDF Network ; September 2015"
}

400

If some information was missing or invalid.

Response Headers

application/json

Schema

Schema

error string
extras object
account string

Example (from schema)

{
  "error": "Bad request.",
  "extras": {
    "account": "account cannot be empty"
  }
}

response

{
  "error": "Bad request.",
  "extras": {
    "account": "account cannot be empty"
  }
}

Loading...