@solrouter/sdk

Privacy-first AI API client with end-to-end encryption.

Installation

npm install @solrouter/sdk

Quick Start

import { SolRouter } from '@solrouter/sdk';

const client = new SolRouter({
  apiKey: 'sk_solrouter_your_key_here'
});

// Your prompt is encrypted client-side before being sent
const response = await client.chat('Explain quantum computing');
console.log(response.message);

Testing Your Setup

Verify API Key

Check if your API key is valid by fetching your balance:

import { SolRouter } from '@solrouter/sdk';

const client = new SolRouter({
  apiKey: 'sk_solrouter_your_key_here',
});

async function main() {
  try {
    const balance = await client.getBalance();
    console.log('API key valid! Balance:', balance.balanceFormatted);
  } catch (error) {
    console.error('Invalid API key');
  }
}
main();

Test Script

The SDK includes a connection test script. After installing, copy it from node_modules:

# Copy the test script
cp node_modules/@solrouter/sdk/examples/test-connection.ts ./

# Run with your API key
SOLROUTER_API_KEY=sk_solrouter_xxx npx ts-node test-connection.ts

The test script will verify:

1. API key validity
2. Encrypted chat functionality
3. Live web search

Example output:

==================================================
  SolRouter SDK Connection Test
==================================================
Base URL: https://solrouter-obb4.onrender.com
API Key: sk_solrouter_xxx****

[1/3] Testing API Key...
  ✓ API key is valid
  Balance: $10.5000 USDC

[2/3] Testing Encrypted Chat...
  ✓ Encrypted chat working
  Response: "4"
  Encrypted: true

[3/3] Testing Live Search...
  ✓ Live search working
  Response: "Bitcoin is currently trading at $95,084 USD."

==================================================
  Results
==================================================
  API Key:        ✓
  Encrypted Chat: ✓
  Live Search:    ✓

  3/3 tests passed

How It Works

1. Client-side Encryption: Your prompt is encrypted using Arcium's RescueCipher before leaving your device
2. Blind Backend: The server only sees encrypted data - it cannot read your prompt
3. TEE Processing: Decryption only happens inside a Trusted Execution Environment (hardware-isolated)
4. Encrypted Response: The AI response is encrypted back to you

API Reference

new SolRouter(config)

Create a new SolRouter client.

const client = new SolRouter({
  apiKey: 'sk_solrouter_...',  // Required: Your API key
  baseUrl: 'https://...',       // Optional: Custom API URL
  encrypted: true,              // Optional: Enable encryption (default: true)
});

client.chat(prompt, options?)

Send a chat message.

const response = await client.chat('Hello!', {
  model: 'gpt-oss-20b',         // Model to use
  encrypted: true,               // Override encryption setting
  systemPrompt: 'You are...',    // System prompt
  chatId: 'conv-123',            // For multi-turn conversations
  useRAG: false,                 // Enable knowledge retrieval
  useLiveSearch: false,          // Enable web search
});

console.log(response.message);        // AI response
console.log(response.encrypted);      // Was request encrypted?
console.log(response.usage);          // Token usage
console.log(response.cost);           // Cost in USDC

Available Models

Privacy mode: only self-hosted open-weight models on the Nosana decentralized GPU network. No third-party model APIs.

| Model | Description | |-------|-------------| | gpt-oss-20b | Open-weight GPT-OSS 20B on Nosana (default) | | qwen3-8b | Open-weight Qwen 3 8B on Nosana |

client.getBalance()

Check your account balance.

const balance = await client.getBalance();
console.log(balance.balanceFormatted); // "$10.5000"

Pricing

| Model | Input (per 1M tokens) | Output (per 1M tokens) | |-------|----------------------|------------------------| | gpt-oss-20b | $0.15 | $0.30 | | qwen3-8b | $0.05 | $0.10 |

Privacy Guarantee

When encryption is enabled (default):

• Your prompts are encrypted on your device using Arcium's MPC encryption
• The SolRouter backend NEVER sees your plaintext prompts
• Decryption only happens inside a hardware-isolated TEE
• On-chain privacy attestations are available for verification

Get an API Key

1. Visit solrouter.com/api
2. Connect your wallet
3. Generate an API key
4. Deposit USDC to fund your account

Links

• Documentation
• API Dashboard
• GitHub