valta-sdk

Official TypeScript SDK for Valta, financial governance infrastructure for autonomous AI agents.

Installation

npm install valta-sdk

Quick Start

import { Valta } from 'valta-sdk'

const valta = new Valta({
  apiKey: process.env.VALTA_API_KEY!
})

const agent = await valta.agents.create({
  name: 'Research Agent',
  wallet: {
    initialBalance: 100,
    dailyLimit: 50
  },
  policy: {
    requireApprovalAbove: 25,
    blockedCategories: ['gambling']
  }
})

const run = await valta.agents.run(agent.id, {
  task: 'Analyse last month spend and identify top cost drivers'
})

const { data: entries } = await valta.audit.list({ agentId: agent.id })
console.log(agent.id, run.status, entries.length)

CLI

valta login
valta agents list
valta agents create "Research Agent"
valta agents run agent_123 "Review Q4 vendor spend"
valta wallets get agent_123
valta wallets balance agent_123
valta wallets transactions agent_123
valta keys create "Production Server"
valta audit agent_123

API Reference

valta.auth

• login(email, password) returns { token, user }
• logout() clears the server session when supported
• whoami() returns the authenticated user profile
• refreshToken() returns a fresh API token

valta.agents

• create(params) creates a governed agent
• list(params?) lists agents with { data, pagination }
• get(agentId) fetches one agent with wallet and policy
• update(agentId, params) updates metadata
• delete(agentId) deletes an agent
• freeze(agentId) blocks runs and transactions
• unfreeze(agentId) restores active status
• run(agentId, params) starts a run
• getRun(agentId, runId) fetches a run
• listRuns(agentId, params?) lists runs

valta.wallets

• get(agentId) returns balance, spend, limits, and address
• getBalance(agentId) returns the USDC balance as a number
• getDepositAddress(agentId) returns a Base USDC address and QR data URL
• listTransactions(agentId, params?) lists wallet transactions
• transfer(params) transfers funds between agent wallets

valta.policies

• create(params) creates a spending policy
• get(agentId) returns a policy or null
• update(agentId, params) updates a policy
• delete(agentId) removes a policy
• list() lists policies

valta.audit

• list(params?) lists audit entries
• get(entryId) fetches one entry
• export(params?) auto-paginates all matching entries
• verify(agentId) verifies audit chain integrity

valta.keys

• create({ name }) creates an API key and returns fullKey once
• list() lists key metadata
• revoke(keyId) revokes a key

Error Handling

import { Valta, ValtaError } from 'valta-sdk'

try {
  await valta.agents.get('missing')
} catch (err) {
  if (err instanceof ValtaError) {
    console.log(err.code)
    console.log(err.status)
    console.log(err.message)
  }
}

Documentation

valta.co/docs

License

MIT