Create Challenge
This endpoint creates a challenge for the user to sign to verify ownership of their web3 address. By signing the message actions such as creating a funding source can be performed.
- application/json
Request Body required
- purpose string required
Possible values: [
claim-web3-address]The purpose of the challenge.
- network string required
Possible values: [
polygon-mainnet,polygon-amoy]The blockchain network associated with the web3 address.
- address string required
The web3 address to which the challenge is directed.
- 200
- 403
Successful operation
- application/json
- Schema
- Example (from schema)
Schema
- id string
The unique identifier of the challenge.
- purpose string
Possible values: [
claim-web3-address]The purpose of the challenge.
- address string
The web3 address to which the challenge is directed.
- network string
Possible values: [
polygon-mainnet,polygon-amoy]The blockchain network associated with the web3 address.
- description string
The description of the challenge.
- expiresAt string
The time the challenge expires.
- createdAt string
The time the challenge was created.
- message string
The message to be signed by the web3 address owner.
{
"id": "GlSDzZHcxrSDeJbKu",
"purpose": "claim-web3-address",
"address": "0x123...",
"network": "polygon-mainnet",
"description": "To verify ownership of the web3 address....",
"expiresAt": "2024-03-20T08:20:00.000Z",
"createdAt": "2024-03-20T08:20:00.000Z",
"message": "To verify ownership of the web3 address ..."
}
INVALID_CHAIN Chain not supported.
- application/json
- Schema
- Example (from schema)
Schema
- statusCode integer required
- statusName string required
- errorCode string required
- reason string
{
"statusCode": 403,
"statusName": "Forbidden",
"errorCode": "FORBIDDEN",
"reason": "Unauthorized"
}