Request a challenge

POST 
/ens/v1/siwe/request-challenge

Request a challenge.

Request

application/json

Body

required

domain stringrequired

Domain name

address stringrequired

Address

origin stringrequired

Origin

chainId numberrequired

Chain id, we only support Ethereum Mainnet and Sepolia Testnet (1 for mainnet, 11155111 for sepolia)

ttl number

Default value: 120000

Time to Live (TTL) in milliseconds (ms), default is 2 minutes (2 * 60 * 1000 = 120000 ms)

Responses

201

The challenge was requested successfully.

application/json

Schema

Schema

statusCode numberrequired

The status code of the response.

result objectrequired

data objectrequired

challenge stringrequired

error stringrequired

Null if no error occurred, otherwise the error message.

Example (from schema)

{
  "statusCode": 200,
  "result": {
    "data": {
      "challenge": "domain wants you to sign in with your Ethereum account:\nAddress\n\nPlease sign this message to verify that you want to add/update your subdomain provided by justawallet to your account Address using JustaName\n\nURI: uri\nVersion: 1\nChain ID: ChainId\nNonce: nonce\nIssued At: Date\nExpiration Time: Date"
    },
    "error": "string"
  }
}

Loading...