VAELTUS SDK

TypeScript client for sending agent events and heartbeats to VAELTUS while applying local guardrail checks before risky actions are shipped.

Install

npm install @vaeltus/sdk

Configure

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

const vaeltus = new Vaeltus({
  agentId: process.env.VAELTUS_AGENT_ID!,
  apiKey: process.env.VAELTUS_API_KEY!,
  baseUrl: process.env.VAELTUS_BASE_URL ?? 'https://vaeltus.xyz',
  guardrails: {
    maxSpendPerHourUsd: 100,
    maxSpendPerDayUsd: 500,
    maxTxPerMinute: 10,
    allowedTools: ['swap', 'bridge', 'transfer'],
    blockedAddresses: ['0x0000000000000000000000000000000000000000'],
  },
});

Usage

await vaeltus.connect();

await vaeltus.logToolCall(
  'uniswap_swap',
  { tokenIn: 'ETH', amount: '1.0' },
  { txHash: '0x...' },
  { success: true, latencyMs: 420, costUsd: 0.05 }
);

await vaeltus.sendHeartbeat({
  status: 'alive',
  metadata: { activeTaskCount: 3 },
});

await vaeltus.disconnect();

Common Commands

npm run build --workspace=packages/sdk
npm run test --workspace=packages/sdk
npm publish --workspace=packages/sdk --access public

Links

• Website: https://vaeltus.xyz
• Repository: https://github.com/zenita7/vaeltus
• Documentation: https://vaeltus.xyz/docs