Initiate SIWE Login

post/siwe/generate-challenge

Deprecated

Deprecated

This endpoint is deprecated, please use Sign Up or Initiate Login instead.

Generating the SIWE challenge is the first step in the process of getting the authentication token.

For detailed information on scopes, see the Authentication Guide.

Request

Body application/json

walletAddressstringrequired
The address of the signing wallet or the smart contract that implements ERC-1271
chainIdnumberrequired
Chain ID (see https://chainlist.org/)
clientApplicationIdstringrequired
ID of the client application created in an Immersve partner profile
scopesstring[]required
An array of authorization scopes requested by the client application
urlstring<uri>required
Domain in the <domain> wants you to sign in.. of the EIP-4361 is derived from the host fragment of this parameter. The client application identified by clientApplicationId must allow this URL.

Response

Challenge to be signed in EIP-4361 format. (Quick start signing)

Example

Example Request

Server

curl https://api.immersve.com/siwe/generate-challenge \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddress": "0xA3058369d6A481B1ff08F62B352409c3D709De9b",
  "chainId": 1,
  "clientApplicationId": "deeec538c6e59f8e5c746c05f766fcc0",
  "scopes": [
    "cardholder-partner"
  ],
  "url": "https://example.service"
}'

curl https://test.immersve.com/siwe/generate-challenge \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddress": "0xA3058369d6A481B1ff08F62B352409c3D709De9b",
  "chainId": 1,
  "clientApplicationId": "deeec538c6e59f8e5c746c05f766fcc0",
  "scopes": [
    "cardholder-partner"
  ],
  "url": "https://example.service"
}'

Example Response

"app.immersve.com wants you to sign in with your Ethereum account:\n0xA3058369d6A481B1ff08F62B352409c3D709De9b\n\nImmersve wants to access your Immersve account. Immersve will be able to: Have full access to all your Immersve resources. By connecting your wallet and using Immersve, you agree to our Terms of services and Privacy Policy\n\nURI: https://app.immersve.com\nVersion: 1\nChain ID: 1\nNonce: 2hFm7TDbZmerUgnrJ\nIssued At: 2022-08-11T22:29:48.244Z\n"