Quickstart

Get an API key

Your key is how Solrouter authenticates you and bills your usage. It is tied to your wallet, not your identity.

Go to solrouter.com/sdk, connect your Solana wallet, and generate an API key. Top up your prepaid balance in USDC or $ROUTER to start making calls.

Install the SDK

The SDK handles encryption, routing, and decryption for you, so you write normal TypeScript and get privacy by default.

Add @solrouter/sdk to your project using your preferred package manager.

npm install @solrouter/sdk

yarn add @solrouter/sdk

pnpm add @solrouter/sdk

Initialize the client

One call gets you a configured client. Pass your API key and the API base URL.

The SDK fetches the enclave's published public key from GET /tee/public-key before your first encrypted request. That key is the encryption target for your prompts. The SDK does not fetch or verify the attestation quote. To check the enclave yourself, see Attestation.

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

const client = new SolRouter({
  apiKey: 'sk_solrouter_...',
  baseUrl: 'https://api.solrouter.com',
});

Send your first encrypted chat

Here the privacy guarantee pays off. Your prompt travels encrypted through the Solrouter backend. Only the TEE (Trusted Execution Environment: hardware that isolates code and data from the machine's operator) can decrypt it. The enclave then sends the plaintext to an open-weight model on a Nosana GPU node.

Call client.chat() to send a message. The SDK encrypts it client-side with Arcium's RescueCipher. It sends the encrypted blob through the Solrouter backend, which cannot read it. Then it decrypts the response for you.

With the current SDK, use the default model gpt-oss-20b. Other catalog ids pass through with a type cast; see Models.

// Encrypted end to end: the Solrouter backend never sees plaintext
const response = await client.chat('What are the risks of this DeFi protocol?');
console.log(response.message);

If the GPU node was idle, the first reply can say "Nosana GPU node is warming up". Wait a moment and send the request again.

Check your balance

Solrouter bills against prepaid funds, so you can check your remaining balance at any time. For example, check it before a batch of calls, or show it in your own UI.

Query your prepaid balance:

const { balance, balanceFormatted } = await client.getBalance();
console.log(`Balance: ${balanceFormatted}`);