Quickstart

npm install @saturn-pay/sdk

import { Saturn } from '@saturn-pay/sdk';

const { saturn, apiKey } = await Saturn.signup({
  name: 'my-first-agent',
  baseUrl: 'https://api.saturn-pay.com',
});

// Save this API key — it's only shown once
console.log('Your API key:', apiKey);

const result = await saturn.reason({
  prompt: 'Explain quantum computing in one sentence',
});

console.log(result.data.content);
// → "Quantum computing uses quantum mechanical phenomena..."

console.log(`Cost: ${result.metadata.chargedSats} sats`);
console.log(`Balance remaining: ${result.metadata.balanceAfter} sats`);

await saturn.policies.update(agentId, {
  maxPerCallSats: 500,      // Max $0.50 per call
  maxPerDaySats: 5000,      // Max $5.00 per day
  allowedCapabilities: ['reason', 'search', 'read'],
});

import { Saturn, SaturnPolicyDeniedError } from '@saturn-pay/sdk';

async function main() {
  // Create agent
  const { saturn, apiKey } = await Saturn.signup({
    name: 'research-bot',
    baseUrl: 'https://api.saturn-pay.com',
  });

  console.log('API Key:', apiKey);

  // Fund wallet
  const checkout = await saturn.wallet.fundCard({ amountUsdCents: 500 });
  console.log('Fund your wallet:', checkout.checkoutUrl);

  // Wait for payment (in real app, use webhook)
  await new Promise(r => setTimeout(r, 60000));

  // Use capabilities
  try {
    // Search the web
    const search = await saturn.search({
      query: 'latest AI research papers'
    });
    console.log('Found:', search.data.results.length, 'results');

    // Read a page
    const read = await saturn.read({
      url: search.data.results[0].url
    });
    console.log('Content length:', read.data.content.length);

    // Synthesize
    const reason = await saturn.reason({
      prompt: `Summarize this: ${read.data.content.slice(0, 2000)}`,
    });
    console.log('Summary:', reason.data.content);

  } catch (err) {
    if (err instanceof SaturnPolicyDeniedError) {
      console.log('Budget exceeded:', err.message);
    } else {
      throw err;
    }
  }
}

main();