This directory contains ADRs for CarbonLedger. Each ADR documents a significant architectural decision: the context that led to it, the decision made, and its consequences.
# ADR-NNN: Title
| Field | Value |
|-------|-------|
| Status | Proposed / Accepted / Deprecated / Superseded by ADR-NNN |
| Date | YYYY-MM-DD |
| Deciders | ... |
## Context
## Decision
## Consequences| ADR | Title | Status |
|---|---|---|
| ADR-001 | Stellar over Ethereum | Accepted |
| ADR-002 | Soroban over Stellar Classic | Accepted |
| ADR-003 | USDC over XLM for payments | Accepted |
| ADR-004 | Oracle architecture — off-chain bridge | Accepted |
| ADR-005 | Off-chain storage — PostgreSQL + IPFS | Accepted |
| ADR-006 | Retirement state machine invariants | Accepted |
| ADR-007 | MultiSig contract upgrade | Accepted |
| ADR-008 | O(log n) serial registry structure | Accepted |