Initialize client session

POST

/initialize

curl --request POST \
  --url http://localhost:3001/initialize \
  --header 'Content-Type: application/json' \
  --data '{ "first_name": "example", "last_name": "example", "message": "example", "signature": "example", "username": "example", "wallet_address": "example" }'

• Local development
• Production

Create a new client session with wallet-based authentication

Request Body^required

Initialize request with wallet signature

Media typeapplication/json

object

first_name

First name (for new users)

string

last_name

Last name (for new users)

string

message

Message that was signed

string

signature

Optional signature for wallet verification

string

username

Display username (optional for returning users)

string

wallet_address

Ethereum wallet address (0x…)

string

Example^generated

{
  "first_name": "example",
  "last_name": "example",
  "message": "example",
  "signature": "example",
  "username": "example",
  "wallet_address": "example"
}

Responses

200

Session initialized successfully

Media typeapplication/json

object

key

additional properties

any

Example^generated

{}

400

Invalid request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

401

Unauthorized - invalid signature

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}