@valiron/sdk

Official TypeScript SDK for Valiron — Trust Infrastructure for AI Agent Systems

Valiron verifies AI agent trustworthiness using on-chain reputation (ERC-8004) and behavioral analysis. This SDK provides routing decisions based on agent trust scores, enabling you to protect infrastructure while maintaining service availability for verified agents.

Installation

npm install @valiron/sdk
# or
yarn add @valiron/sdk
# or
pnpm add @valiron/sdk

Quick Start

import { ValironSDK } from '@valiron/sdk';

const valiron = new ValironSDK();

// Quick routing check
const route = await valiron.checkAgent('25459');
// route: 'prod' | 'prod_throttled' | 'sandbox' | 'sandbox_only'

// Full trust profile
const profile = await valiron.getAgentProfile('25459');

// Trust gate for payment endpoints
const gate = await valiron.gate('25459');
if (gate.allow) { /* proceed */ }

// Behavioral snapshot (for hash-chain commitments)
const snapshot = await valiron.getAgentSnapshot('25459');
console.log(snapshot.snapshotHash);    // '0xabc…'
console.log(snapshot.previousHash);    // '0x0' (genesis)

// Multichain — override per-call or at construction
const monadValiron = new ValironSDK({ chain: 'monad' });
await monadValiron.checkAgent('8348');
await valiron.checkAgent('8348', { chain: 'base' });

Methods

| Method | Returns | Description | |--------|---------|-------------| | checkAgent(agentId, opts?) | RouteDecision | Quick routing check | | getAgentProfile(agentId, opts?) | AgentProfile | Full trust profile (identity + reputation + routing) | | getWalletProfile(wallet, opts?) | WalletProfile | Reverse-lookup wallet → trust profile | | resolveWallet(wallet, opts?) | WalletResolution | Lightweight wallet → agentId (Redis → cache → Agent0 subgraph) | | triggerSandboxTest(agentId, opts?) | SandboxResult | Run sandbox tests, compute behavioral score | | gate(agentId, opts?) | GateResult | Trust gate: reputation + sandbox → allow/deny | | getAgentSnapshot(agentId, opts?) | AgentSnapshotSummary | Opaque behavioral snapshot hash for chain commitments | | createValironGate(config) | Express middleware | Drop-in middleware wrapping gate() |

All methods accept an optional { chain } override. See the full documentation for response shapes, options, and examples.

Telemetry

Anonymous usage telemetry is collected by default (opt-out). No PII is collected.

const valiron = new ValironSDK({ telemetry: { enabled: false } });

// Customize
const valiron2 = new ValironSDK({
  telemetry: { appId: 'my-app', env: 'prod' },
});

Documentation

• Full Documentation — interactive docs with all methods, examples, and dynamic pricing
• llms.txt — compact reference for LLM integration
• ERC-8004 Standard

Support

• Email: [email protected]
• Telegram: https://t.me/valirongrade

License

MIT © Valiron