Back to Blog Release

VCP Sidecar Guide Now Includes Production-Ready Implementation Code

Production-ready MQL5 and Python implementations for VCP v1.0 compliant audit trails.

December 27, 2025 8 min read VeritasChain Standards Organization

We are pleased to announce a major update to the vcp-sidecar-guide repository. This release includes production-ready implementation code for both MQL5 and Python, enabling developers to integrate VCP v1.0 compliant audit trails into their trading systems immediately.


What's New

Production-Ready Source Code

The repository now includes fully functional implementations:

src/
├── mql5/
│   ├── vcp_mql_bridge_v1_0.mqh    # ~850 lines
│   └── README.md
└── python/
    ├── vcp_sidecar_adapter_v1_0.py # ~700 lines
    ├── requirements.txt
    └── README.md

Working Examples

Complete, runnable examples demonstrating real-world usage:

examples/
├── mql5/
│   └── ExampleEA.mq5              # Full EA with MA Crossover strategy
└── python/
    └── example_usage.py           # 7 comprehensive examples

VCP v1.0 Specification Compliance

Both implementations are fully compliant with VCP v1.0:

Feature Status
UUID v7 (RFC 9562)
Dual timestamp format (ns string + ISO 8601)
3-layer event structure (header/payload/security)
SHA-256 hash chain
All event type codes (SIG, ORD, ACK, EXE, etc.)
Numeric values as strings
GDPR-compliant account pseudonymization

These implementations are ready for VC-Certified (Silver) conformance testing.


Quick Start

Python

from vcp_sidecar_adapter_v1_0 import VCPEventFactory, VCPEventSerializer, Tier

factory = VCPEventFactory(venue_id="MY_VENUE", tier=Tier.SILVER)

signal = factory.create_signal_event(
    symbol="XAUUSD",
    account_id="12345",
    algo_id="MY_ALGO",
    algo_version="1.0.0",
    confidence="0.85"
)

print(VCPEventSerializer.to_json(signal, indent=2))

MQL5

#include <VCP/vcp_mql_bridge_v1_0.mqh>

int OnInit()
{
    VCP_CONFIG config;
    config.api_key = InpVCPApiKey;
    config.endpoint = "https://api.veritaschain.org";
    config.venue_id = "MY_VENUE";
    config.tier = VCP_TIER_SILVER;
    config.async_mode = true;
    
    VCP_Initialize(config);
    return INIT_SUCCEEDED;
}

Key Features

MQL5 Bridge

CVCPLogger class, async queue with 10K buffer, batch processing, automatic hash chain

Python Adapter

VCPEventFactory, JSON/JSONL serialization, VCC Client, Manager API polling

Hash Chain

Automatic SHA-256 hash chain for tamper-evident audit trails

TraceID

Order lifecycle correlation with EventCorrelator validation


Who Should Use This


Sample Output

Events generated by these implementations produce VCP v1.0 compliant JSON:

{
  "header": {
    "event_id": "019b591b-ea7e-7507-a1cc-bb555e81345f",
    "trace_id": "019b591b-ea7e-7f6f-b130-ede86931b9d4",
    "timestamp_int": "1766726560382246912",
    "timestamp_iso": "2025-12-26T05:22:40.382Z",
    "event_type": "SIG",
    "event_type_code": 1,
    "timestamp_precision": "MILLISECOND",
    "clock_sync_status": "BEST_EFFORT",
    "hash_algo": "SHA256",
    "venue_id": "MY_PROP_FIRM",
    "symbol": "XAUUSD",
    "account_id": "acc_ca1ee1d09effaa36"
  },
  "payload": {
    "vcp_gov": {
      "algo_id": "ALGO_001",
      "algo_version": "2.1.0",
      "confidence": "0.85"
    }
  },
  "security": {
    "event_hash": "1caae2edff5207de8dbc05ac88a7353c...",
    "prev_hash": "0000000000000000000000000000000000..."
  }
}

Getting Started

1. Clone the repository

git clone https://github.com/veritaschain/vcp-sidecar-guide.git

2. Review the integration guide

3. Run the examples

cd vcp-sidecar-guide
pip install -r src/python/requirements.txt
python examples/python/example_usage.py

4. Integrate into your system

Use the source code in src/ directory


What's Next

We are continuing to expand VCP tooling:


Resources


VeritasChain Standards Organization (VSO) develops open cryptographic audit standards for AI-driven and algorithmic markets. Certification under VSO confirms technical conformance only and does not imply financial, business, or regulatory endorsement.

"Verify, Don't Trust"

Share this article:

Start Building with VCP

Clone the repository and integrate VCP audit trails into your trading system today.

View Repository Back to Blog