Request challenge

Request a challenge

Request a challenge.

POSThttps://api.justaname.id/ens/v1/siwe/request-challenge

Body

application/json

domain*string

Domain name

Example: "justaname"

address*string

Address

Example: "0x1234567890123456789012345678901234567890"

origin*string

Origin

Example: "https://justaname.id"

chainId*number

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

Example: "11155111"

ttlnumber

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

Example: 120000

Response

201

The challenge was requested successfully.

Body

application/json

statusCode*number

The status code of the response.

Example: 200

result*SiweRequestChallengeApiResponseResultSwagger (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.justaname.id/ens/v1/siwe/request-challenge', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "domain": "justaname",
      "address": "0x1234567890123456789012345678901234567890",
      "origin": "https://justaname.id",
      "chainId": "11155111"
    }),
});
const data = await response.json();

Response

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"
  }
}