Request challenge

Request a challenge

Request a challenge.

post

/ens/v1/siwe/request-challenge

Body

domainstringrequired

Domain name

Example: justaname

addressstringrequired

Address

Example: 0x1234567890123456789012345678901234567890

originstringrequired

Origin

Example: https://justaname.id

chainIdnumberrequired

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

Example: 11155111

ttlnumber · default: 120000

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

Example: 120000

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.justaname.id/ens/v1/siwe/request-challenge' \
  --header 'Content-Type: application/json' \
  --data '{
    "domain": "justaname",
    "address": "0x1234567890123456789012345678901234567890",
    "origin": "https://justaname.id",
    "chainId": "11155111",
    "ttl": 120000
  }'

201

201

{
  "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": "text"
  }
}

The challenge was requested successfully.