POST
/
v1
/
auth
/
challenge
Challenge
curl --request POST \
  --url https://api.amm.flashnet.xyz/v1/auth/challenge \
  --header 'Content-Type: application/json' \
  --data '{
  "publicKey": "021eec911553028dded1ec644144cd3afee9d9bfe7846af3cf8e6d84f4b3102389"
}'
{
  "challenge": "19f51e5e9b50314318517a5e2bb19e5beb94d9c5d74b61068ff458c75a649712",
  "requestId": "01H8Z0HMVXJN6A8Q9GR1J6Z34E"
}

Body

application/json

Public key for which to generate an authentication challenge

Request body for initiating authentication challenge.

This request starts the authentication flow by requesting a challenge string that must be signed with the user's private key.

​
publicKey
string
required

The public key of the user requesting authentication. Must be a valid Bitcoin or Spark public key.

Example:

"021eec911553028dded1ec644144cd3afee9d9bfe7846af3cf8e6d84f4b3102389"

Response

Challenge generated successfully

Response containing the challenge string to be signed.

The challenge is a random 32-byte value (64 hex characters) that must be signed using the private key corresponding to the provided public key.

​
challenge
string
required

The challenge string that must be signed. This is a 64-character hex string representing 32 random bytes.

Example:

"19f51e5e9b50314318517a5e2bb19e5beb94d9c5d74b61068ff458c75a649712"

​
requestId
string<ulid>
required

Unique request identifier for tracking and debugging.

Example:

"01H8Z0HMVXJN6A8Q9GR1J6Z34E"