VeritasChain Developer Hub

Specifications, the SDK specification, guides and reference implementations for implementing and verifying VCP.

View VCP Specification

VCP Specification

An open cryptographic audit standard for AI & algorithmic trading.

Event lifecycle & data model
Compliance tiers
Regulatory alignment (MiFID II / EU AI Act)

Explorer API v1.1

API documentation for event search and proof verification (not deployed).

REST endpoints
Merkle proof verification
Event certificates

SDKs (TS / Python)

SDK interface specification (Release Candidate). SDK packages are not yet published.

TypeScript, Python
Hash-chain & Merkle helpers
Illustrative examples (not runnable yet)

VC-Certified & Conformance

Certification scheme and the Conformance Test Guide (written for VCP v1.0).

Silver / Gold / Platinum tiers
Log format rules
Submission workflow

Sidecar Integration Guide

Non-invasive integration for MT4/5, cTrader, and WL brokers.

Shadow logging
Manager API patterns
24h anchoring examples

Planned Quick-Start Workflow

Planned workflow — the SDK packages and the Explorer API are not yet available (Planned — no date set)

STEP 1

Install SDK

Choose an SDK for your environment (TypeScript or Python)

STEP 2

Log Events

Record trading events in VCP-compliant format

STEP 3

Verify & Certify

Use Explorer API to verify chain integrity

Open VCP Explorer API

A demo Web UI with sample data is available at /explorer/app/. The Explorer API is not yet deployed (Planned — no date set).

Quick Start with Python

Silver Tier

# SDK package not yet published (Planned — no date set)

from vcp import VCPLogger, Tier

# Initialize Silver Tier logger
logger = VCPLogger(tier=Tier.SILVER, private_key="your-key")

# Record trading events
logger.log_order(symbol="EURUSD", side="BUY", quantity="100000", price="1.08450")

# Save locally (runs parallel to production)
logger.save("./vcp_logs/")

Official SDKs

Planned libraries for VCP integration (not yet published)

Note: SDKs follow VCP SDK Specification v1.0. The vcp-core-py, vcp-core-cpp and vcp-mql-bridge packages named below are not published yet (Planned — no date set). Available today: the SDK specification (Release Candidate) and VCP v1.0 reference sidecar code (Python adapter, MQL5 bridge) in the vcp-sidecar-guide repository.

vcp-core-py

Python 3.8+

For data scientists, risk managers, and backtesting.

Backtest auditing
VCP-RISK log generation
RFC 8785 JSON canonicalization

# Not yet published

vcp-core-cpp

C++17

For HFT and low-latency environments.

Microsecond precision
Lock-free ring buffer
PTP clock integration

# Not yet published

vcp-mql-bridge

MQL4/5

For MetaTrader EA integration.

MT4/MT5 EA integration
Retail forex logging
Cross-broker auditing

// Not yet published

Integration Patterns

Choose the right integration approach for your infrastructure

Pattern A: Sidecar Integration

External process, no core modification

Independent from broker infrastructure
Generate independent audit logs
Detect data tampering

Pattern B: Shadow Logging

RECOMMENDED

Generate VCP logs parallel to existing system. Perfect for PoC.

No production impact
Phased migration path
Risk-free evaluation

Pattern C: VeritasChain Cloud (VCC)

Concept only — a hosted service has not been released (browser demo at /vcc/)

No infrastructure management
REST API integration
Automatic anchoring

Pattern D: Kernel Bypass (HFT)

Ultra-low latency for Platinum Tier

DPDK/RDMA for kernel bypass
PTP hardware clock
Lock-free ring buffer

Code Examples

Illustrative implementation patterns (SDK not yet published)

Python: Backtest Audit

Silver Tier

from vcp import VCPLogger, Tier, EventType
from datetime import datetime

logger = VCPLogger(
    tier=Tier.SILVER,
    private_key_path="./key.pem"
)

def log_backtest_trade(symbol, side, qty, price):
    logger.log_event(
        event_type=EventType.ORDER_ACCEPTED,
        timestamp=datetime.now(),
        payload={"symbol": symbol, "side": side,
                 "quantity": qty, "price": price}
    )

# Verify chain integrity
if logger.verify_chain():
    logger.export_json("backtest_audit.json")

C++: HFT Logger

Platinum Tier

#include <vcp/platinum.hpp>

class HFTVCPLogger {
    vcp::PlatinumLogger logger_;
    vcp::PTPClock ptp_clock_;
public:
    HFTVCPLogger() 
        : logger_(vcp::ClockSource::PTP_HARDWARE),
          ptp_clock_("/dev/ptp0") {}

    inline void log_order(uint64_t order_id,
                          const char* symbol,
                          Side side) {
        uint64_t ts = ptp_clock_.now_ns();
        logger_.write_event(order_id, symbol, ts);
    }
};