VeritasChain 开发者中心

用于实施和验证的规范、SDK规范、指南与参考实现(当前规范:v1.2)

查看VCP v1.2规范

VCP v1.2 规范

AI和算法交易的加密审计标准。

  • 事件生命周期与数据模型
  • 合规层级
  • 监管对接 (MiFID II / EU AI Act)

Explorer API v1.1

事件搜索与证据验证的API文档(尚未部署)。

  • REST端点
  • 拟议的证明验证端点
  • 拟议的事件证书格式

SDKs (TS / Python)

SDK接口规范(候选发布版)。离线核心库vcp-sdk v0.1.0(预发布版)已在GitHub公开。它并非此接口规范的实现;其软件包未发布至PyPI或npm。

  • TypeScript, Python支持
  • 哈希链与Merkle助手
  • 说明性示例(尚不能直接运行)

VC-Certified与合规性

认证所需的检查清单和测试套件。

  • Silver / Gold / Platinum层级
  • 日志格式规则
  • 申请工作流程

Sidecar集成指南

旧VCP v1.0说明性集成模式;非生产就绪或已认证实现。

  • 影子日志
  • Manager API模式
  • 未实现外部锚定或签名

VSO报告Explorer API的159项测试与公开演示的包含计算修正

10月27日补充:Explorer API搜索修正通过159项项目自身CI测试。公开GUI已加入显式树大小的包含计算及不合法证明的拒绝处理,仍是未连接API、未签名的合成演示。实验扩展未获采纳,独立复现尚未成立。

阅读更新与限制 →

计划中的入门流程

SDK规范的示例流程 — PyPI/npm软件包及生产流程尚未提供。GitHub离线核心库与单独的Explorer Evidence Demo已公开。

步骤 1

安装SDK

选择适合您环境的SDK(TypeScript或Python)

步骤 2

记录事件

以VCP兼容格式记录交易事件

步骤 3

验证与认证

使用Explorer API验证链完整性

打开VCP Explorer API

使用示例数据的演示版Web UI见 /explorer/app/。Explorer API源代码已公开。普通API路由返回模拟数据,单独的SDK Evidence Demo可在公开Explorer中使用。此处示例的生产URL与SDK规范流程并非已提供的生产服务。公开API尚未实现认证中间件。

Python快速入门

Silver Tier
# SDK软件包尚未发布(计划中(时间未定))。
# 以下为示意API。离线核心库 github.com/veritaschain/vcp-sdk
# (v0.1.0,预发布版)的API不同,请参阅其README。

from vcp import VCPLogger, Tier

# 初始化Silver Tier日志记录器
logger = VCPLogger(tier=Tier.SILVER, private_key="your-key")

# 记录交易事件
logger.log_order(symbol="EURUSD", side="BUY", quantity="100000", price="1.08450")

# 本地保存(与生产并行运行)
logger.save("./vcp_logs/")

官方SDK

用于VCP集成的库(计划中,尚未发布)

注意:SDK遵循 VCP SDK Specification v1.0。下列 vcp-core-py、vcp-core-cpp、vcp-mql-bridge 软件包尚未发布(计划中(时间未定))。目前已公开的是SDK规范(Release Candidate)、vcp-sidecar-guide 仓库中的VCP v1.0参考Sidecar代码(Python适配器、MQL5桥接),以及 vcp-sdk v0.1.0(面向VCP v1.2的离线核心库;由VeritasChain株式会社编写的预发布版;Python、TypeScript、MQL5;规范化哈希、RFC 6962 Merkle树、Ed25519、三值验证)。vcp-sdk并非vcp-sdk-spec的实现,需从GitHub安装(未发布到PyPI或npm),其验证结果VALID并不构成合规声明。

vcp-core-py

Python 3.8+

适用于数据科学家、风险经理和回测。

  • 回测审计
  • VCP-RISK日志生成
  • RFC 8785 JSON规范化
# 尚未发布

vcp-core-cpp

C++17

适用于HFT和低延迟环境。

  • 微秒精度
  • 无锁环形缓冲区
  • PTP时钟集成
# 尚未发布

vcp-mql-bridge

MQL4/5

适用于MetaTrader EA集成。

  • MT4/MT5 EA集成
  • 零售外汇日志
  • 跨券商审计
#include <VCPLogger.mqh>

集成模式

为您的基础设施选择正确的集成方法

模式A:Sidecar集成

外部进程,无需核心修改

  • 独立于券商基础设施
  • 生成独立审计日志
  • 检测数据篡改

模式B:影子日志

推荐

与现有系统并行生成VCP日志。非常适合PoC。

  • 对生产无影响
  • 分阶段迁移路径
  • 无风险评估

模式C:VeritasChain Cloud (VCC)

SaaS解决方案,无需基础设施

  • 无需基础设施管理
  • REST API集成
  • 自动锚定

模式D:内核旁路 (HFT)

Platinum Tier的超低延迟

  • DPDK/RDMA内核旁路
  • PTP硬件时钟
  • 无锁环形缓冲区

代码示例

示例实现模式(实现vcp-sdk-spec的SDK尚未发布)

Python:回测审计
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}
    )

# 验证链完整性
if logger.verify_chain():
    logger.export_json("backtest_audit.json")
C++:HFT日志记录器
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);
    }
};

GitHub仓库

开源工具和规范

需要技术支持?

集成问题、PoC支持或企业部署 — 我们随时为您提供帮助。

联系我们

对VCP集成有疑问?请联系我们的技术团队。