XYO Protocol Knowledge

This skill covers the XYO Protocol 2.0 — the data model, module system, identity primitives, and conventions for building on XYO. The primary SDK is published as individual @xyo-network/* packages on npm.

When you need to look up exact type definitions or API details beyond what this skill covers, install the relevant @xyo-network/* package and read the TypeScript declarations at dist/neutral/index.d.ts.

This builds on the Development Skill for coding principles and the XY Toolchain Skill for build/lint/test tooling.

Skill identity. This skill's version is exposed in this file's frontmatter under metadata.version. When reporting which skills informed your work, format as <skill-name> v<version> (e.g. xyo-knowledge v1.1.19). When multiple skills from this plugin are active, each may be listed.

Table of Contents

Protocol Primitives

Read when working with XYO data structures — payloads, schemas, bound witnesses, payload builders, or hashing. Covers the core data model, how to construct and validate protocol objects, and the mandatory Zod authoring pattern for a new payload type.

Payload Schema Evolution and Identity

Read before naming or revising schemas, choosing open/closed fields, using $version, selecting root versus data hashes, or validating/caching payloads. New schema names stay unversioned; root hashes are the application default. Preserve explicitly prescribed legacy protocol contracts.