This directory contains the complete protocol specification for Colabonate. Documents describe the what and why of the protocol as an open standard for the freedom of interaction on Bitcoin — completely separated from any specific implementation.
| Step | Document | Why |
|---|---|---|
| 1 | core/vision.md | Understand what the protocol is and isn't |
| 2 | core/protocol-spec-v1.md | Technical overview and API |
| 3 | core/roles.md | Participant roles and permissions |
| 4 | core/nostr-events.md | All event schemas (Kinds 30017–30026) |
| 5 | core/ticket-system.md | Central interaction object |
| 6 | core/escrow-protocol.md | Lightning escrow mechanics |
| 7 | GLOSSARY.md | Canonical terms |
| Document | Description |
|---|---|
| workflows/buy-protocol.md | How to buy: discovery → payment → completion |
| workflows/sell-protocol.md | How to sell: offer creation → fulfillment |
| workflows/cooperation-protocol.md | Multi-party project collaboration |
| workflows/dispute-protocol.md | What happens when something goes wrong |
| Document | Description |
|---|---|
| governance/dao-codex.md | Foundation DAO constitution |
| governance/dao-creation-protocol.md | Creating a community DAO |
| governance/economic-protocol.md | COLA token and fee structure |
| governance/governance-roadmap.md | Phase-by-phase governance plan |
| Document | Description |
|---|---|
| identity/identity-protocol.md | 4-level identity system (Level 0–3) |
| core/reputation-protocol.md | COL-Points and review system |
| Document | Description |
|---|---|
| core/legal-binding-layer.md | Opt-in DAO+Codex transaction binding |
| governance/dao-creation-protocol.md | Community DAO with custom Codex |
| Document | Status | Description |
|---|---|---|
| vision.md | Stable | Protocol philosophy and scope |
| protocol-spec-v1.md | Draft | Technical spec v1 |
| roles.md | Draft | Participant roles |
| ticket-system.md | Draft | Ticket types and state machine |
| nostr-events.md | Draft | Nostr event schemas 30017–30026 |
| escrow-protocol.md | Draft | Lightning escrow |
| reputation-protocol.md | Draft | COL-Points and reviews |
| legal-binding-layer.md | Draft | Opt-in DAO+Codex binding |
| security-model.md | Planned | Threat model |
| protocol-versioning.md | Planned | Versioning for implementers |
| Document | Status | Description |
|---|---|---|
| identity-protocol.md | Draft | 4-level identity system |
| proximity-proof.md | Planned | Level 2 peer verification detail |
| Document | Status | Description |
|---|---|---|
| buy-protocol.md | Phase 1 | Buyer flow |
| sell-protocol.md | Phase 1 | Seller flow |
| cooperation-protocol.md | Phase 2 | Multi-party cooperation |
| dispute-protocol.md | Phase 4 | Conflict resolution |
| Document | Status | Description |
|---|---|---|
| dao-codex.md | Roadmap | Foundation DAO constitution |
| dao-creation-protocol.md | Phase 4 | User-created DAOs |
| economic-protocol.md | Phase 4 | COLA token and fees |
| governance-roadmap.md | Living | Phase-by-phase roadmap |
All documents use consistent status tags:
| Tag | Meaning |
|---|---|
Phase 1 |
Core protocol specification |
Phase 2 |
Extension protocol specification |
Phase 3 |
Advanced identity and reputation |
Phase 4 |
Governance and conflict resolution |
Roadmap |
Concept exists, timeline open |
Draft |
Active working document |
Stable |
Ready for implementation |
For all technical terms (Ticket, Escrow, Pubkey, HID, COL-Points, etc.) → GLOSSARY.md
For the reasoning behind key protocol choices → docs/decisions/INDEX.md