Introduction

The Agglayer Knowledge Base is the human-first reference for architecture, domain concepts, and contributor workflows in this repository. It is intended to be useful for both maintainers and AI coding agents, with clarity and operational correctness as the primary goals.

What this book covers

• Core terms and protocol language used across Agglayer.
• Crate and domain ownership, including certificate lifecycle and settlement flow.
• Safety-sensitive subsystems, such as pessimistic proof, protobuf boundaries, and storage layout.
• Contributor workflows for AI-agent configuration and docs publishing.

How to use it

1. Start with Glossary and Architecture to build shared context.
2. Use domain chapters for deep dives: Pessimistic Proof, Protobuf and gRPC, and Storage.
3. Use workflow chapters for contributor operations: AI Agent Configuration and Documentation Publishing.

Editorial expectations

• Keep content factual, concise, and linked to concrete code paths where relevant.
• Prefer explicit safety invariants, failure modes, and verification guidance over vague descriptions.
• Update Summary when adding or restructuring chapters.