VCP Explorer API v1.1

概要

VCP Explorer APIは、VeritasChain Protocol (VCP)のイベント検索、Merkle証明取得、イベント証明書生成を提供します。VCP仕様v1.0に完全準拠し、規制当局、ブローカー、プロップファーム、監査人などの外部関係者が、記録されたイベントを独立して検証することを可能にします。

暗号学的検証

RFC 6962準拠のMerkle証明により、APIを信頼することなく外部検証が可能。「検証せよ、信頼するな」の原則を実践。

高度な検索

TraceIDで完全なトランザクションライフサイクルを追跡。シンボル、時間範囲、イベントタイプ、アルゴリズムIDでフィルタリング。

規制証明書

イベントデータ、Merkle証明、暗号署名を含むコンプライアンス対応の監査証明書を生成。

VCPモジュール構造

VCP-TRADE、VCP-RISK、VCP-GOVモジュールによる明確な関心事の分離でイベントデータを整理。

ナノ秒精度

文字列ベースのタイムスタンプでJavaScriptの2^53制限を回避し、真のナノ秒レベルの精度をサポート。

ブロックチェーンアンカリング（計画中）

将来のVCP Explorerバージョンでは、追加の不変性保証のためEthereumへの監査ルートアンカリングをサポート予定。

ベースURL

https://explorer.veritaschain.org/api/v1

注意: Explorer APIのデプロイは進行中です。ライブエンドポイントが利用可能になるまで、このドキュメントは実装リファレンスとして機能します。デプロイが発表されるまで、開発者はこれらのエンドポイントを呼び出さないでください。

認証

すべてのAPIリクエストは、リクエストヘッダーでAPIキーを使用した認証が必要です:

HTTPヘッダー

X-VCP-API-Key: <your_api_key>

セキュリティ: クライアントサイドコードでAPIキーを公開しないでください。適切なキー管理を行い、常にサーバーサイドリクエストを使用してください。

APIエンドポイント

GET /v1/events

シンボル、イベントタイプ、trace_id、タイムスタンプなどでVCPイベントを検索およびフィルタリング。

クエリパラメータ

パラメータ	型	必須	説明	例
`symbol`	String	いいえ	取引シンボル	XAUUSD, EURUSD
`event_type`	String	いいえ	イベントタイプ名	ORD, EXE, REJ
`trace_id`	UUID v7	いいえ	トランザクショントレースID	01934e3a-6a1b...
`start_time`	ISO8601	いいえ	時間範囲の開始	2025-11-24T00:00:00Z
`end_time`	ISO8601	いいえ	時間範囲の終了	2025-11-24T23:59:59Z
`limit`	Integer	いいえ	最大結果数(1-500)	20 (デフォルト)

リクエスト例

GET https://explorer.veritaschain.org/api/v1/events?symbol=XAUUSD&limit=20

curl -H "X-VCP-API-Key: your_api_key" \\
  "https://explorer.veritaschain.org/api/v1/events?symbol=XAUUSD&limit=20"

GET /v1/events/{event_id}

IDで完全なイベント詳細を取得。ヘッダー、ペイロード(VCP-TRADE, VCP-RISK, VCP-GOV)、セキュリティメタデータを含む。

GET /v1/events/{event_id}/proof

APIを信頼することなく外部検証を可能にするVCP Merkleインクルージョン証明(RFC 6962スタイル)を返す。

「検証せよ、信頼するな」: このエンドポイントは、暗号学的証明を使用したイベント真正性の独立検証を可能にします。

GET /v1/events/{event_id}/certificate

イベントデータ、Merkle証明、署名メタデータ、検証結果を含む規制グレードの証明書を生成。

使用ケース

規制監査: アルゴリズム取引イベントの検証可能な証拠を提供
支払い紛争: 実行の真正性とタイミングを証明
コンプライアンスレポート: 金融当局向けの監査証跡を生成
第三者検証: 外部関係者による独立検証を可能に

イベントタイプリファレンス

VCP仕様v1.0は、実装間の一貫性のために固定イベントタイプコードを定義しています:

コード	タイプ	説明	カテゴリ
1	`SIG`	シグナル/決定生成	取引
2	`ORD`	注文送信	取引
3	`ACK`	注文確認	取引
4	`EXE`	完全実行	取引
5	`PRT`	部分約定	取引
6	`REJ`	注文拒否	取引
7	`CXL`	注文キャンセル	取引
20	`ALG`	アルゴリズム更新	ガバナンス
21	`RSK`	リスクパラメータ変更	リスク
98	`HBT`	ハートビート	システム
99	`ERR`	エラー	システム

Merkle証明検証ガイド

VCP Explorer APIは、Merkleツリー証明のためにRFC 6962証明書透明性標準に従っています。これにより、誰でもAPIを信頼することなくイベントの真正性を独立して検証できます。

検証ステップ

1. イベント取得

GET /v1/events/:idを使用して完全なイベント詳細を取得。セキュリティセクションからevent_hashを抽出。

2. 証明取得

GET /v1/events/:id/proofを使用してMerkle証明を取得。これには監査パスとルートハッシュが含まれます。

3. ルート計算

バイナリMerkleツリー構造でSHA-256を使用して、event_hashとaudit_pathを結合。

4. ルート検証

計算されたルートと返されたmerkle_rootを比較。一致すれば、イベントは検証されます。

重要性: この検証プロセスにより、記録後のイベント改ざんを防止します。ブロックチェーンアンカーは、Merkleルートが永続的にEthereumメインネットに記録されるため、追加の不変性レイヤーを提供します。

HTTPステータスコード

ステータス	意味	説明
200	OK	リクエスト成功
400	Bad Request	無効なリクエストパラメータまたは不正なJSON
401	Unauthorized	無効または欠落したAPIキー
404	Not Found	イベントIDが見つかりません
429	Too Many Requests	レート制限超過
500	Server Error	内部サーバーエラー

概要