xyo-knowledge

XYO プロトコルの知識

このスキルでは、XYO Protocol 2.0 のデータモデル、モジュールシステム、アイデンティティのプリミティブ、および XYO 上で開発する際の規約について説明します。主要な SDK は @xyo-network/sdk のルートバレルです。これは、@xyo-network/sdk-protocol（ペイロード、バウンドウィットネス、アカウント）の上にモジュールシステム（アーキビスト、ディバイナー、ウィットネス、センチネル、ノード）を重ねたもので、ルートバレルから再エクスポートされます。具体的なバックエンド（例：@xyo-network/archivist-indexeddb、@xyo-network/archivist-mongodb）や特殊なディバイナー／ウィットネスは、引き続き個別の @xyo-network/* パッケージとして提供されます。

このスキルの範囲を超えて、正確な型定義や API の詳細を確認する必要がある場合は、該当するパッケージをインストールし、dist/neutral/ 以下にある TypeScript 宣言を参照してください。単独のパッケージでは index.d.ts、@xyo-network/sdk のモジュールでは dist/neutral/modules/<name>/、プロトコルのプリミティブでは @xyo-network/sdk-protocol-core を確認します。

スキルの識別情報。 このスキルのバージョンは、このファイルのフロントマターにある metadata.version で確認できます。計画、確認応答、または完了の要約を提示する際は、どのスキルを参照したかを <skill-name> v<version> の形式で記載してください。バージョンは、このファイルのフロントマターから読み取り、例から取得しないでください。このプラグインの複数のスキルが有効な場合は、それぞれを記載できます。

スキルのレイヤー

これは XYO スキルスタックのレイヤー 3です。xy-development (1) → xy-toolchain (2) → xyo-knowledge (3) → xl1-knowledge (4) → xl1-patterns (5) → xl1-dapp-kit (6) → xl1-testing (7) → xl1-scaffold (8) → xl1-build (9)。

• 基盤となるスキル： ariestools-skills の xy-toolchain と xy-development (1–2) — ビルド／リント／テストのツール、コーディング原則、Git、テスト、ワークフロー
• 引き継ぎ先： 作業対象が XL1 チェーン（ブロック、トランザクション、ゲートウェイ、データレイク）上である場合は xl1-knowledge (4)、XL1 上でアプリケーション機能を構築する場合は xl1-patterns (5)、ユーザーが XL1 上で何かを構築したいものの、内容を指定していない場合は xl1-build (9)

目次

プロトコルのプリミティブ

ペイロード、スキーマ、バウンドウィットネス、ペイロードビルダー、ハッシュなど、XYO のデータ構造を扱う際に参照してください。コアデータモデル、プロトコルオブジェクトの構築と検証方法、新しいペイロード型に必須の Zod 作成パターンについて説明します。

ペイロードスキーマの進化とアイデンティティ

スキーマの命名や改訂、オープン／クローズドフィールドの選択、$version の使用、ルートハッシュとデータハッシュの選択、ペイロードの検証／キャッシュを行う前に参照してください。新しいスキーマ名にはバージョンを付けません。ルートハッシュはアプリケーションでの既定値です。明示的に定められた従来のプロトコル契約は維持してください。

モジュールシステム

アーキビスト、ディバイナー、ウィットネス、センチネル、ノードなど、XYO モジュールを扱う際に参照してください（ブリッジは非推奨です）。モジュールの抽象化、合成パターン、解決、マニフェストシステムについて説明します。

アイデンティティと署名

アカウント、ウォレット、鍵管理、署名、HD 導出を扱う際に参照してください。Account と Wallet の作成（secp256k1 およびポスト量子 ML-DSA-65）、署名フロー、前のハッシュの永続化、アイデンティティとバウンドウィットネスの連携方法について説明します。

プロトコルのベストプラクティス

スキーマの命名、ペイロード構造、モジュール合成戦略、バウンドウィットネスの規律、エラー処理など、設計上の判断を行う際に参照してください。XYO ベースの新しい機能に着手する前に確認してください。