API documentation (if available)

This section provides detailed technical documentation for integrating with the Solident wallet system.

Overview

The Solident API provides RESTful endpoints for authentication, wallet management, and DeFi operations. All API calls are secured with OAuth 2.0 authentication and support both JSON and Protocol Buffers formats.

Base URL

https://api.solident.io/v1

Authentication

API Key Authentication

curl -X GET "https://api.solident.io/v1/user/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

OAuth 2.0 Flow

const authUrl = "https://auth.solident.io/oauth/authorize";
const params = {
  response_type: "code",
  client_id: "your_client_id",
  redirect_uri: "https://yourapp.com/callback",
  scope: "wallet:read wallet:write",
  state: "random_string"
};

Authentication API

Face Recognition Endpoints

Enroll Face Biometric

POST /auth/face/enroll
Content-Type: multipart/form-data

{
  "face_images": ["base64_image_1", "base64_image_2"],
  "user_id": "user_123"
}

Response:

{
  "success": true,
  "face_vector_id": "fv_abc123",
  "enrollment_confidence": 0.98
}

Verify Face Biometric

POST /auth/face/verify
Content-Type: application/json

{
  "face_image": "base64_image",
  "face_vector_id": "fv_abc123"
}

Response:

{
  "success": true,
  "confidence": 0.96,
  "liveness_detected": true,
  "session_token": "sess_xyz789"
}

Pattern Authentication

Set Unlock Pattern

POST /auth/pattern/set
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "pattern": "1-2-3-6-9-8-7-4",
  "confirm_pattern": "1-2-3-6-9-8-7-4"
}

Verify Pattern

POST /auth/pattern/verify
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "pattern": "1-2-3-6-9-8-7-4"
}

Wallet API

Wallet Management

Create New Wallet

POST /wallet/create
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "wallet_name": "My Solident Wallet",
  "blockchain": "solana"
}

Response:

{
  "wallet_id": "wallet_abc123",
  "public_key": "4ZJmKfN6qZ8GmJfL9pN2sXtWvYbUcRdEaSgQfHjKlMn",
  "creation_date": "2023-10-03T13:30:00Z"
}

Get Wallet Balance

GET /wallet/{wallet_id}/balance
Authorization: Bearer SESSION_TOKEN

Response:

{
  "wallet_id": "wallet_abc123",
  "balances": [
    {
      "token": "SOL",
      "amount": "2.5",
      "usd_value": "75.00"
    },
    {
      "token": "USDC",
      "amount": "100.00",
      "usd_value": "100.00"
    }
  ],
  "total_usd_value": "175.00"
}

Transfer Funds

POST /wallet/{wallet_id}/transfer
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "recipient": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "token": "SOL",
  "amount": "0.1",
  "memo": "Payment for services"
}

Response:

{
  "success": true,
  "transaction_id": "txn_123abc",
  "transaction_hash": "5KJp7...xyz",
  "status": "confirmed",
  "block_height": 123456
}

Transaction History

Get Transaction History

GET /wallet/{wallet_id}/transactions?limit=50&offset=0
Authorization: Bearer SESSION_TOKEN

Response:

{
  "transactions": [
    {
      "transaction_id": "txn_123abc",
      "type": "send",
      "token": "SOL",
      "amount": "0.1",
      "from": "4ZJmKfN6qZ8GmJfL9pN2sXtWvYbUcRdEaSgQfHjKlMn",
      "to": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "timestamp": "2023-10-03T13:30:00Z",
      "status": "confirmed",
      "block_height": 123456
    }
  ],
  "total_count": 150,
  "has_more": true
}

DeFi Integration

Token Swaps

Execute Token Swap

POST /defi/swap
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "input_token": "SOL",
  "output_token": "USDC",
  "input_amount": "1.0",
  "slippage_tolerance": 0.01,
  "wallet_id": "wallet_abc123"
}

Response:

{
  "success": true,
  "transaction_id": "swap_456def",
  "input_amount": "1.0",
  "output_amount": "22.50",
  "price_impact": 0.002,
  "route": [
    {"dex": "raydium", "percentage": 60},
    {"dex": "orca", "percentage": 40}
  ]
}

Get Available Liquidity Pools

GET /defi/pools?token_pair=SOL/USDC
Authorization: Bearer SESSION_TOKEN

Response:

{
  "pools": [
    {
      "pool_id": "pool_789ghi",
      "dex": "raydium",
      "token_a": "SOL",
      "token_b": "USDC",
      "tvl_usd": "1500000",
      "apr": "8.5",
      "fee_rate": "0.0025"
    }
  ]
}

SDK Integration

JavaScript/TypeScript SDK

import { SolidentSDK } from '@solident/sdk';

const sdk = new SolidentSDK({
  apiKey: 'your-api-key',
  endpoint: 'https://api.solident.io/v1'
});

// Initialize wallet
const wallet = await sdk.wallet.create({
  name: 'My Wallet',
  blockchain: 'solana'
});

// Get balance
const balance = await sdk.wallet.getBalance(wallet.id);

// Transfer funds
const tx = await sdk.wallet.transfer({
  walletId: wallet.id,
  recipient: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
  token: 'SOL',
  amount: '0.1'
});

Python SDK

from solident_sdk import SolidentClient

client = SolidentClient(api_key='your-api-key')

# Create wallet
wallet = client.wallets.create(
    name="My Wallet",
    blockchain="solana"
)

# Get balance
balance = client.wallets.get_balance(wallet.id)

# Transfer funds
tx = client.wallets.transfer(
    wallet_id=wallet.id,
    recipient="9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    token="SOL",
    amount="0.1"
)

Webhooks

Configure Webhook

POST /webhooks/configure
Authorization: Bearer API_KEY
Content-Type: application/json

{
  "url": "https://yourapp.com/webhook",
  "events": ["transaction.completed", "wallet.created"],
  "secret": "your_webhook_secret"
}

Webhook Payload

{
  "event": "transaction.completed",
  "data": {
    "transaction_id": "txn_123abc",
    "wallet_id": "wallet_abc123",
    "status": "confirmed",
    "timestamp": "2023-10-03T13:30:00Z"
  },
  "signature": "sha256=abc123def456"
}

Error Codes

Authentication Errors (AUTH_xxx)

• AUTH_001: Invalid API key

• AUTH_002: Session expired

• AUTH_003: Invalid session token

• AUTH_004: Face recognition failed

• AUTH_005: Pattern verification failed

Wallet Errors (WALLET_xxx)

• WALLET_001: Wallet not found

• WALLET_002: Insufficient balance

• WALLET_003: Invalid recipient address

• WALLET_004: Transaction failed

Network Errors (NET_xxx)

• NET_001: Network timeout

• NET_002: RPC node unavailable

• NET_003: Transaction not confirmed

• NET_004: Gas estimation failed

Rate Limits

Endpoint	Rate Limit	Time Window
Authentication	10 requests	1 minute
Wallet operations	100 requests	1 minute
Balance queries	1000 requests	1 minute
Transaction history	100 requests	1 minute

Support

For API support and questions:

• Email: [e-mail]

• Documentation: https://docs.solident.io

• Status Page: https://status.solident.io

• GitHub: https://github.com/solident/api-docs

Changelog

v1.2.0 (2023-10-03)

• Added biometric enrollment endpoints

• Improved error handling

• Added webhook support

v1.1.0 (2023-09-15)

• Added DeFi integration endpoints

• Enhanced transaction history API

• Added Python SDK support

v1.0.0 (2023-08-01)

• Initial API release

• Core wallet functionality

• Basic authentication