XL1 dApp Kit
An XL1 dApp is a portable, headless protocol runtime. UI, CLI, and HTTP surfaces are clients. Indexes and projections are rebuildable. Finalized XL1 is the canonical ordering substrate; side channels may accelerate liveness but must not secretly govern recovery.
This skill teaches the @xyo-network/dapp-kit* application-contract layer. It sits above xl1-knowledge and alongside xl1-patterns (domain recipes still apply). Classic xl1-scaffold React+Express apps remain valid; migrate to dapp-kit when you need definition/plan/ports/recovery/conformance — not merely a Vite UI.
Skill identity. Report as xl1-dapp-kit v<version> from this file's metadata.version.
Maturity: @xyo-network/dapp-kit* is published on npm (1.x line, public access; license may still be UNLICENSED). Local UC-01..03 and adapters exist; credentialed hosted / Sequence / production evidence gates can still be open per consumer — check the deployment's evidence labels. Prefer local conformance via @xyo-network/dapp-kit-vitest-config; do not claim hosted qualification from local tests.
Lower layers
- XL1 Knowledge — chain, gateway, datalakes, identity
- XL1 Patterns — indexing, statement graph, wakes, DoD checklist
- XL1 Testing — headless verification, including dapp-kit vitest
local-xl1and local dapp-kit stack - xy-toolchain / xy-development — from ariestools-skills (redirect stubs may appear in this pack)
Table of Contents
Vocabulary
Definition, configuration, plan, incarnation, host, status dimensions, durability classes — the words agents must not collapse.
Project manifest
xl1.dapp.json, deployment requests, locks, and the xl1-dapp CLI (validate / inspect / plan / dev / test).
Effects and recovery
Staged XL1 effects, effect journals, prepared sidecars, and SIGKILL-safe recovery.
Application ports
Typed command/query/status/admin frames over WebSocket / MessagePort — not “REST as the protocol.”
Events and wakes
Event Kit wakes vs dapp-kit durable events vs subscription cursors. Detail for JWT/grants: Authenticated Wake Delivery.
Hosting and targets
Node vs browser hosts, deployable things, Vercel/Cloudflare composition, fail-closed policies.
Conformance
Evidence labels, what “done” means for a dapp-kit app, and what local tests do not prove.