Auth

Auth related API endpoints

Authenticate user with BIP322 signature verification

post

Authenticates a user by verifying their BIP322 signature and creates a wallet with JWT tokens

Body

application/json

messagestringRequired

The message that was signed

Example: Sign this message to authenticate with the system

signaturestringRequired

The BIP322 signature of the message

Example: base64-encoded-signature

addressstringRequired

The Bitcoin address that signed the message

Example: bc1p...

publicKeystringRequired

The public key used for signing

Example: 02a1b2c3d4e5f6...

Responses

200

User authenticated successfully

application/json

400

Invalid signature, invalid address, or authentication failed

application/json

post

/api/auth/authenticate

HTTPcURLJavaScriptPython

POST /api/auth/authenticate HTTP/1.1
Host: api.radfi.co
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "message": "Sign this message to authenticate with the system",
  "signature": "base64-encoded-signature",
  "address": "bc1p...",
  "publicKey": "02a1b2c3d4e5f6..."
}

{
  "code": "1",
  "message": "common.success",
  "data": {},
  "metaData": {
    "totalItems": 1,
    "currentPage": 1,
    "pageSize": 1,
    "totalPages": 1
  }
}

Refresh access token using refresh token

post

Body

application/json

refreshTokenstringRequired

Refresh token to generate new access token

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Responses

200

New access token generated successfully

No content

400

Invalid or expired refresh token

application/json

post

/api/auth/refresh-token

HTTPcURLJavaScriptPython

POST /api/auth/refresh-token HTTP/1.1
Host: api.radfi.co
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

No content