Verdikta Common¶

Welcome to the Verdikta Common library documentation. This package provides essential shared utilities for building applications that interact with the Verdikta blockchain ecosystem.

What is Verdikta Common?¶

Verdikta Common (@verdikta/common) is a JavaScript/Node.js library that provides:

• Manifest Parsing: Parse and validate Verdikta manifest.json files
• IPFS Integration: Seamless IPFS content fetching and upload capabilities
• Archive Management: Handle compressed archives for arbitration cases
• Multi-CID Support: Process complex multi-party arbitration scenarios
• ClassID Model Mapping: Curated AI model pools with deterministic validation
• Validation Utilities: Comprehensive validation for manifests and requests

Key Features¶

🚀 Easy Integration¶

Simple factory function to get started quickly with sensible defaults.

📋 Manifest Specification v2.0¶

Complete support for the latest Verdikta manifest format including multi-CID and addendum features.

🌐 IPFS Ready¶

Built-in IPFS client with retry logic, multiple gateways, and caching support.

🔒 Validation & Security¶

Joi-based validation with sanitization for safe content processing.

🔧 Configurable¶

Flexible configuration options for different environments and use cases.

🤖 ClassID Model Pools¶

Curated AI model mappings with deterministic validation and automatic truncation for consistent arbiter behavior.

Quick Start¶

npm install @verdikta/common

const { parseManifest, validateRequest, classMap } = require('@verdikta/common');

// Parse a manifest from an extracted archive
const result = await parseManifest('/path/to/extracted/archive');

// Validate a request object
await validateRequest(requestObject);

// Use ClassID model pools
const cls = classMap.getClass(128);
const validationResult = classMap.validateQueryAgainstClass(manifest, 128);

Architecture Overview¶

graph TD
    A[Client Application] --> B[Verdikta Common]
    B --> C[Manifest Parser]
    B --> D[IPFS Client]
    B --> E[Archive Service]
    B --> F[Validator]
    B --> G[ClassMap System]

    C --> H[Multi-CID Processing]
    C --> I[Addendum Injection]

    D --> J[IPFS Gateways]
    D --> K[Pinning Services]

    E --> L[Archive Extraction]
    E --> M[File Management]

    F --> N[Joi Schemas]
    F --> O[Content Sanitization]

    G --> P[Model Pool Mapping]
    G --> Q[Deterministic Validation]

Use Cases¶

Arbitration Platforms¶

Build applications that submit cases to Verdikta arbiters with proper manifest formatting.

Content Management¶

Handle IPFS-based content archives for decentralized storage and retrieval.

Multi-Party Disputes¶

Process complex arbitration scenarios with multiple parties and evidence sources.

AI Model Management¶

Manage AI model pools with ClassID mappings for consistent arbiter behavior and deterministic validation.

Testing & Development¶

Use the library's testing utilities for developing Verdikta-compatible applications.

Core Concepts¶

Manifests¶

JSON configuration files that define arbitration cases, including: - Primary query definitions - Supporting file references
- Jury parameter configurations - Multi-party content organization

Multi-CID Support¶

Handle arbitration cases that involve multiple content archives: - Primary disputes with rebuttals - Complex evidence chains - Hierarchical content organization

IPFS Integration¶

Seamless blockchain storage integration: - Content addressing via CIDs - Automatic retry and fallback - Local caching for performance

ClassID Model Pools¶

AI model management and validation: - Curated model mappings by ClassID - Deterministic query validation - Automatic resource limit enforcement - Support for OpenAI, Anthropic, Ollama, and more

Getting Started¶

Choose your path:

Latest Updates¶

Community & Support¶

• GitHub: verdikta/verdikta-common
• Issues: Report bugs and request features on GitHub
• Documentation: Complete guides and API reference available here

Ready to start building with Verdikta? Check out the Quick Start Guide, explore the API Reference, or learn about ClassID Model Pools.