Incremental Tutorials
Step-by-step hands-on learning path for Alexandria, the eunomia.profiles/v1 DSL, Vocabulary Hub (alexandria-server & alexandria-client), and Sovereign Wallets.
Incremental Tutorials
This tutorial track takes you step by step from writing your first vocabulary profile in YAML to governing multi-version lifecycles on alexandria-server, enforcing Dataspace Protocol (DSP) policies at the edge with alexandria-client, and managing cryptographic identities with Fafnir and Eclipse EDC IdentityHub.
Designed for Hands-On Learning: Every tutorial builds on the concepts of the previous one and uses real commands you can copy and paste directly in your terminal. Tutorials 1 through 4 require only Go (make build)—no Docker containers needed!
Learning Path Progression
[Tutorial 1] [Tutorial 2] [Tutorial 3]
eunomia.profiles/v1 YAML ──► alexandria-server Governance ──► alexandria-client Sidecar Proxy
(alexandriac validate/compile) (/v1/drafts -> /pub/) (S1-S13 sync, DSP gates)
│
▼
[Tutorial 5] [Tutorial 4]
Wallets & IdentityHub ◄── Breaking Changes & F6
(DIDs, Keys, VCs, DCP) (Grace windows, Revocation)Tutorial Catalog
1. Your First Profile in eunomia.profiles/v1
Write an OdrlProfile and SpaceProfile in YAML, validate N1–N5 rules, and compile RDF, JSON-LD, SHACL, JSON Schema, and Cedar artifacts with alexandriac.
2. Publishing & Governance on alexandria-server
Launch alexandria-server, create drafts, propose candidates, approve releases with role separation, verify JCS signatures, and fetch immutable /pub artifacts.
3. Edge DSP Validation with alexandria-client
Place alexandria-client in front of a connector, inspect background sync (S1–S13), validate ContractRequestMessage payloads, and read VHub-Verdict headers.
4. Breaking Changes, Grace Windows & F6
Evolve a profile from 1.0.0 to 2.0.0 (deprecated -> retired), travel through time with the injectable clock, track agreements, and handle revocations.
5. Sovereign Wallets: Fafnir & IdentityHub
Use the Alexandria Wallet REST API and Swagger UI to manage PEM/JWK keys, DID documents, service endpoints, participants, and DCP credentials.
Configuration Reference
Complete configuration reference for alexandria-server (server.json), alexandria-client (config.json), and the Alexandria node (config.yaml).
1. Your First Profile in eunomia.profiles/v1
Learn how to author an OdrlProfile and SpaceProfile in YAML, validate N1–N5 rules, and generate deterministic artifacts with alexandriac.