Developer Docs

Logs tool calls, transactions, reasoning events, errors, and heartbeats from your agent runtime.

Validates API keys, stores events in Supabase, checks guardrails, and fires alerts.

Gives operators live status, incident triage, analytics, and policy controls.

Registry identity, budget governor primitives, circuit breaker state, and event hash anchoring on Base.

import { Vaeltus } from '@vaeltus/sdk';

// Initialize the SDK with your agent credentials
const agent = new Vaeltus({
  agentId: process.env.AGENT_ID!,
  apiKey: process.env.VLTS_API_KEY!,
  guardrails: {
    maxSpendPerHourUsd: 100,
    allowedTools: ['swap', 'bridge', 'transfer'],
    blockedAddresses: ['0x...'],
    maxTxPerMinute: 10,
  },
  failMode: 'open', // continue on API errors
});

// Connect and start heartbeating
await agent.connect();

// Log tool calls with type-safe helpers
await agent.logToolCall('uniswap_swap', { tokenIn: 'ETH', amount: '1.0' }, { txHash: '0x...' });

// Log onchain transactions
await agent.logTransaction('0xabc...', 'base', '0xOwner', {
  to: '0xContract',
  valueUsd: 50.0,
  method: 'swap',
});

// Wrap reasoning steps with trace()
const { result } = await agent.trace('plan-yield-route', async () => {
  return computeOptimalRoute(pools);
});

// Log errors
await agent.logError('Unexpected slippage', { expected: 0.5, actual: 2.1 });