Auth

If you would like to get familiar with the authentication flow, please click here.

Retrieves nonce for authentication

GET https://gateway-relay.herokuapp.com/auth/{wallet_address}/nonce

Path Parameters

Name	Type	Description
wallet_address*	string	address of the user's UP

200: OK successful operation

Example 200 Response

{
    nonce: 1955258057868615
}

400: Bad Request malformed request error

Example 400 Response

{
    error: 'Malformed request, please ensure the following parameters are included: wallet_address'
}

500: Internal Server Error internal server error

Example 500 Response

{
    error: 'An internal server error occurred. Please check the request body, ensure you are authenticated, and try again.'
}

Validate signature to authenticate user and provide jwt token

POST https://gateway-relay.herokuapp.com/auth/{wallet_address}/signature

Path Parameters

Name	Type	Description
wallet_address*	string	address of the user's UP

200: OK successful operation

Example 200 Response

{
    success: true,
    token: 'Bearer eyJh...LoYI', //full jwt token will go here
    expiresIn: '6h'
}

400: Bad Request malformed request error

Example 400 Response

{
    error: 'Malformed request, please ensure the following parameters are included: wallet_address'
}

401: Unauthorized invalid credentials error

Example 401 Response

{
    error: 'Invalid Credentials! Ensure the account you are using to sign this message is the same as the one that received the nonce.'
}

404: Not Found user not found error

Example 404 Response

{
    error: 'No user found with provided address: 0x218C2BbaaBa0D66ddcD5De942Ed2980Bbfd1f004'
}

500: Internal Server Error internal server error

Example 500 Response

{
    error: 'An internal server error occurred. Please check the request body, ensure you are authenticated, and try again.'
}