Table of Contents
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
- Prop trading firms implementing VCP for transparency
- MT4/MT5 white-label operators requiring audit trails
- EA developers adding cryptographic logging
- Compliance teams preparing for VC-Certified audits
- RegTech developers building on VCP infrastructure
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:
- TypeScript SDK — Coming Q1 2026
- C++ implementation — For HFT environments
- Conformance test suite — Automated VC-Certified validation
Resources
- Repository: github.com/veritaschain/vcp-sidecar-guide
- VCP Specification: github.com/veritaschain/vcp-spec
- Conformance Tests: github.com/veritaschain/vcp-conformance-guide
- Early Adopter Program: standards@veritaschain.org
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: