Skip to content

veritaschain/vcp-rta-reference

πŸ”— Related Reference Implementations (Other Platforms)

cTrader

πŸ“Œ World-First Evidence
Publicly documented, independently verifiable cryptographic audit trail PoC
πŸ‘‰ https://github.com/veritaschain/vcp-ctrader-rta-reference

FIX Protocol

πŸ“Œ World-First Evidence
Publicly documented, independently verifiable cryptographic audit trail PoC
πŸ‘‰ https://github.com/veritaschain/vcp-fix-rta-reference

Interactive Brokers (IBKR)

πŸ“Œ World-First Evidence
Publicly documented, independently verifiable cryptographic audit trail PoC
πŸ‘‰ https://github.com/veritaschain/vcp-ibkr-rta-reference

Nasdaq

πŸ“Œ World-First Evidence
Publicly documented, independently verifiable cryptographic audit trail PoC
πŸ‘‰ https://github.com/veritaschain/vcp-nasdaq-rta-reference

cloudflare

πŸ“Œ World-First Evidence
Publicly documented, independently verifiable cryptographic audit trail PoC
πŸ‘‰ https://github.com/veritaschain/vcp-cloudflare-rta-reference

VCP Reference Trading Agent (VCP-RTA)

English | ζ—₯本θͺž

VCP v1.1 Tier Silver License CC BY 4.0

"Verify, Don't Trust."

VCP-RTA is a reference implementation demonstrating VCP v1.1 Silver Tier compliance for algorithmic trading systems. This repository provides a complete, verifiable evidence pack that third parties can independently validate.

πŸ“„ A detailed "World's First" Evidence Report documenting independent prior-art analyses is included in this repository.


Overview

This Evidence Pack demonstrates a production-grade implementation of VCP in a live MT5 environment. The implementation captures AI-driven trading decisions and execution events using a non-invasive sidecar architecture that operates independently of the core trading platform.

AI decision signals, order lifecycle events, and execution outcomes are recorded externally, cryptographically hashed, organized into Merkle trees, and anchored to enable independent third-party verification.


What's New in v1.1

Feature v1.0 v1.1
Three-Layer Architecture - βœ… NEW
External Anchor (Silver) OPTIONAL REQUIRED
Policy Identification - REQUIRED
PrevHash REQUIRED OPTIONAL
Completeness Guarantees - βœ… NEW

v1.1 Core Enhancement: Extends tamper-evidence to completeness guarantees β€” third parties can now verify not only that events were not altered, but that no required events were omitted.


Repository Structure

vcp_v1_1_repo_aligned/
β”œβ”€β”€ evidence/
β”‚   β”œβ”€β”€ evidence_index.json          # Evidence manifest
β”‚   β”œβ”€β”€ 01_trade_logs/
β”‚   β”‚   └── vcp_rta_events.jsonl     # VCP v1.1 event chain (40 events)
β”‚   β”œβ”€β”€ 02_verification/
β”‚   β”‚   └── verification_report.txt  # Verification results
β”‚   β”œβ”€β”€ 03_tamper_detection/
β”‚   β”‚   β”œβ”€β”€ tamper_detection_test.py # Tamper detection test
β”‚   β”‚   └── tampered_chain.jsonl     # Tampered sample for testing
β”‚   └── 04_anchor/
β”‚       β”œβ”€β”€ security_object.json     # Merkle tree & signatures
β”‚       β”œβ”€β”€ anchor_reference.json    # External anchor info
β”‚       └── public_key.json          # Verification public key
β”œβ”€β”€ examples/
β”‚   └── ai-trading-integration/
β”‚       β”œβ”€β”€ README.md                # Integration guide
β”‚       β”œβ”€β”€ vcp_logger.py            # VCP v1.1 logger module
β”‚       └── vcp_poc_demo.py          # PoC demonstration
β”œβ”€β”€ tools/
β”‚   └── verifier/
β”‚       └── vcp_verifier.py          # Chain verification tool
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ VERIFICATION_GUIDE.md        # Step-by-step verification
β”‚   └── architecture.md              # Three-layer architecture
β”œβ”€β”€ CHANGELOG.md
β”œβ”€β”€ DISCLAIMER.md
└── LICENSE

Quick Verification

Prerequisites

  • Python 3.8+
  • No external dependencies required (standard library only)

Run Verification

# Clone the repository
git clone https://github.com/veritaschain/vcp-rta-reference.git
cd vcp-rta-reference

# Run verification (Linux/macOS)
python tools/verifier/vcp_verifier.py \
    evidence/01_trade_logs/vcp_rta_events.jsonl \
    -s evidence/04_anchor/security_object.json

# Run verification (Windows)
python tools\verifier\vcp_verifier.py evidence\01_trade_logs\vcp_rta_events.jsonl -s evidence\04_anchor\security_object.json

# Run tamper detection test
python evidence/03_tamper_detection/tamper_detection_test.py

Expected Output

======================================================================
VCP v1.1 Verification Report
======================================================================
[Verification Results]
  Overall Status: [PASS] VALID
  Total Events: 40
  Valid Events: 40
  Invalid Events: 0

[Chain Integrity]
  Sequence Continuity: [PASS]
  PrevHash Integrity: [PASS]
  Merkle Root: [PASS]
======================================================================
Verification complete: All checks passed
======================================================================

Evidence Summary

Metric Value
Total Events 40
Signal Events 20
Order Events 20
VCP Version 1.1
Tier Silver

Anonymization

This evidence pack anonymizes sensitive information:

  • Ticket numbers: SHA-256 hashed
  • Position IDs: SHA-256 hashed
  • Trade amounts: Excluded
  • Account identifiers: Excluded
  • AI model names: Excluded (vote counts only)

Security Features

Three-Layer Architecture (VCP v1.1)

  1. Layer 1: Event Integrity - Individual event hash & signature (SHA-256 + Ed25519)
  2. Layer 2: Collection Integrity - RFC 6962 Merkle Tree + PrevHash linking
  3. Layer 3: External Verifiability - External timestamp anchoring (OpenTimestamps)

Tamper Detection Capabilities

  • βœ… Event Omission (Deletion Attack) - Detected via sequence gaps + Merkle mismatch
  • βœ… Event Modification (Alteration Attack) - Detected via Merkle root mismatch
  • βœ… Event Insertion (Injection Attack) - Detected via prev_hash + Merkle mismatch

License

This evidence pack is licensed under CC BY 4.0.


Integration Examples

The examples/ directory contains reference implementations for integrating VCP into your own systems:


Related Links

About

Non-certified reference implementation of VCP v1.0 event logging for AI-driven trading systems.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages