Skip to content
Darkfibre Documentation

POST /v1/auth/register

Creates a user record and returns an API key. This endpoint requires signature verification to prove wallet ownership.

HTTP

Section titled “HTTP”
  • Method: POST
  • Path: /v1/auth/register

Registration Flow

Section titled “Registration Flow”
  1. Create a message: Format darkfibre:<timestamp> where timestamp is current time in milliseconds
  2. Sign the message: Sign it with your Solana wallet (Ed25519 signature, base58 encoded)
  3. Send request: Include walletAddress, message, and signature in the request body
  4. Server verification: Server verifies the signature matches the wallet address and message

Body

Section titled “Body”
{
  "walletAddress": "YOUR_SOLANA_WALLET_ADDRESS",
  "message": "darkfibre:1736123456789",
  "signature": "BASE58_ENCODED_SIGNATURE"
}

Fields

Section titled “Fields”
  • walletAddress (string, required): Your Solana wallet address (base58)
  • message (string, required): Message in format darkfibre:<timestamp> that you signed
  • signature (string, required): Base58-encoded signature of the message, signed by your wallet

Response

Section titled “Response”
{
  "success": true,
  "data": {
    "apiKey": "api_…",
    "walletAddress": "YOUR_SOLANA_WALLET_ADDRESS"
  }
}

Notes

Section titled “Notes”