Cascade
Auth

Get Auth Message

Request an authentication message to sign (step 1 of 3)

Starts the 3-step authentication flow.

Step 1 (this endpoint): call GET /auth?account=<address> to receive a nonce-bound message, signing_payload, and server signature.

Step 2 (client-side): sign signing_payload with the account's Ethereum private key (EIP-191).

Step 3: submit message, signature, and server_signature to POST /auth to receive a JWT token.

GET
/auth

Query Parameters

accountstring

Ethereum address of the account requesting authentication.

Response Body

application/json

text/plain

text/plain

curl -X GET "https://engine.cascade.cooking/auth?account=0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78"
{
  "message": {
    "account": "0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78",
    "nonce": "string",
    "timestamp": "string"
  },
  "server_signature": "string",
  "signing_payload": "string"
}
"Request timed out"
"Failed to store auth nonce"