Alexandria Documentation

Welcome to the Alexandria documentation portal. Alexandria is a Vocabulary Hub engineered to deliver semantic interoperability, runtime term dereferencing, and remote conformance testing for sovereign dataspaces.

Alexandria implements the Vocabulary Hub pattern for dataspaces. Its architecture couples an in-process Go modular monolith with decentralized identity (DID / SSI), pluggable wallet ports, and Zitadel OIDC authentication.

Core Missions of the Vocabulary Hub

Vocabulary Lifecycle Management: Author, version, and publish domain ontologies, RDF vocabularies, and dataset profiles extending shared dataspace models.
Runtime Semantic Dereferencing: Real-time IRI resolution for dataspace Connectors parsing Self-Descriptions and data agreements.
Remote Conformance Testing: Automated validation of connector payloads, dataset schemas, and SHACL constraint shapes to certify dataspace compliance.
Trust & SSI Anchor: Cryptographically secured with DIDs and delegated wallet key custody for verifiable vocabulary attestation.

Documentation Sections

Getting Started

Overview of the Vocabulary Hub, prerequisites, local setup with Taskfile, and configuration.

Architecture & Wallets

Hexagonal architecture, in-process bounded contexts, unified wallet port, and Fafnir vs IdentityHub.

API & Development

REST API reference, remote conformance testing, node-terminated OIDC, and CI/CD pipelines.

Architecture Decisions (ADRs)

Formal record of accepted architectural decisions (0001 through 0007) and decision rationale.

Introduction