@fairseal/core

Part of FairSeal — formerly OpenRNG.

VEO-2 types, schema, and shared primitives for the FairSeal ecosystem.

VEO = Verifiable Execution Object — a standard format for recording, proving, and explaining AI decisions.

Install

npm install @fairseal/core

Quick Start

import { createVEO, validateVEO, createVEOHash } from '@fairseal/core';

// Create a VEO for an AI execution
const veo = createVEO({
  provider_id: 'my-service',
  execution: {
    prompt_hash: 'sha256-of-prompt',
    output_hash: 'sha256-of-output',
    model_id: 'gpt-4o',
    latency_ms: 412,
    cost: { total_tokens: 1500, cost_usd: 0.003 },
  },
  confidence: { score: 850, grade: 'AA' },
});

// Validate
const { valid, errors } = validateVEO(veo);

// Hash (for anchoring)
const hash = createVEOHash(veo);

Object Classes

| Class | Name | Use Case | |---|---|---| | VEO-2A | Raw Execution | Single AI call (chat, completion, inference) | | VEO-2B | Composite Execution | Multi-step chains, agent pipelines | | VEO-2C | Anchored Execution | With blockchain proof / Merkle anchor | | VEO-2D | Governed Execution | With policy assertions, human approvals |

VEO Lifecycle

created → signed → anchored → indexed → verified

Full Spec

• RFC-0002: VEO-2
• JSON Schema
• Example VEO objects

Related Packages

| Package | Purpose | |---|---| | @fairseal/core | Types, schema, validation (this package) | | @fairseal/verify | Verify any VEO object | | @fairseal/auto | Auto-instrument AI SDK calls |

License

MIT — FairSeal