SDK
SDK Reference
@auron-solana/sdk — a fully typed client for Node.js, browsers, and AI agents.
Installation
bash
npm install @auron-solana/sdkbash
yarn add @auron-solana/sdkNOTE
The SDK ships full TypeScript definitions. No separate
@types package needed.AuronClient
The main entry point. Create one instance per application — safe to share across concurrent requests.
ts
import { AuronClient } from C8F135">"@auron-solana/sdk";
const auron = new AuronClient({
apiKey: C8F135">"ak_live_xxx",
baseUrl: C8F135">"https:C8F135">">//auron-mocha.vercel.app",
});Constructor options
getQuote(inrAmount)
Returns the USDC amount required for a given INR payment at the current live rate. Quotes are valid for 60 seconds.
ts
const quote = await auron.getQuote(999);
C8F135">"color:#3F3F46">// {
C8F135">"color:#3F3F46">// inrAmount: 999,
C8F135">"color:#3F3F46">// usdcAmount: 11.84,
C8F135">"color:#3F3F46">// auronRate: 84.37, // INR per USDC (after 0.5% spread)
C8F135">"color:#3F3F46">// marketRate: 84.79, // raw CoinGecko rate
C8F135">"color:#3F3F46">// spread: 0.005,
C8F135">"color:#3F3F46">// validUntil: 1718734800000
C8F135">"color:#3F3F46">// }Return type
ts
interface QuoteResult {
inrAmount: F5A623">number;
usdcAmount: F5A623">number;
auronRate: F5A623">number;
marketRate: F5A623">number;
spread: F5A623">number;
validUntil: F5A623">number; C8F135">"color:#3F3F46">// Unix ms
}Error handling
ts
import { AuronClient, AuronError } from C8F135">"@auron-solana/sdk";
try {
const quote = await auron.getQuote(999);
} catch (err) {
if (err instanceof AuronError) {
C8F135">"color:#3F3F46">// err.code → C8F135">"RATE_UNAVAILABLE" | C8F135">"UNAUTHORIZED" | ...
C8F135">"color:#3F3F46">// err.message → human-readable description
C8F135">"color:#3F3F46">// err.status → HTTP status code
}
}