@veritera.ai/eydii-verify

EYDII Verify SDK for JavaScript/TypeScript. Verify AI agent decisions with cryptographic attestation.

Install

npm install @veritera.ai/eydii-verify

Quick Start

import { EydiiVerify } from "@veritera.ai/eydii-verify";

const eydii = new EydiiVerify({ apiKey: "vt_live_..." });

const result = await eydii.verifyDecision({
  agentId: "agent-1",
  action: "payment.create",
  params: { amount: 100, currency: "USD" },
  policy: "finance-controls",
});

if (result.verified) {
  // Action approved — execute it
} else {
  console.log("Blocked:", result.reason);
}

API

new EydiiVerify(config)

| Option | Type | Default | Description | |--------|------|---------|-------------| | apiKey | string | required | API key (vt_live_..., vt_sandbox_...) | | baseUrl | string | https://id.veritera.ai | API base URL | | timeout | number | 10000 | Request timeout (ms) | | maxRetries | number | 2 | Retries on 5xx errors | | failClosed | boolean | true | Return denied instead of throwing on errors | | debug | boolean | false | Enable debug logging |

Aliases: Eydii, Veritera (backward compatibility)

Methods

• verifyDecision(request) — Verify an agent action against policy
• getProof(proofId) — Retrieve a verification proof
• verifyProofLocally(verification) — Verify attestation offline (Ed25519)
• createDelegation(request) — Create a scoped agent delegation
• getUsage(period?) — Get billing usage stats
• health() — Check API health

Error Handling

import { EydiiError, RateLimitError } from "@veritera.ai/eydii-verify";

try {
  await eydii.verifyDecision({ ... });
} catch (err) {
  if (err instanceof RateLimitError) {
    // Wait err.retryAfterMs before retrying
  } else if (err instanceof EydiiError) {
    console.log(err.code, err.status, err.message);
  }
}

Fail-Closed (Default)

When failClosed: true (default), network/server errors return a denied result instead of throwing. The agent is blocked, not crashed.

Circuit Breaker

After 5 consecutive failures, the SDK opens a circuit breaker for 30 seconds, immediately returning errors without hitting the API. After 30s, one request is allowed through (half-open). On success, the circuit closes.

Migrating from @veritera.ai/sdk

npm uninstall @veritera.ai/sdk
npm install @veritera.ai/eydii-verify

Update imports:

// Before
import { Veritera } from "@veritera.ai/sdk";
// After (Veritera still works as alias)
import { EydiiVerify } from "@veritera.ai/eydii-verify";

Requirements

• Node.js >= 18.0.0
• Works with CommonJS and ESM

Links

• Docs
• API Reference