Infrastructure · Data Structures
Ledger
Immutable transactional history
Definition
Mechanism
An immutable record of Value transfers, debts, and obligations between Agents, serving as the shared memory for economic coordination. Because entries are never edited, a wrong entry is corrected by appending an offsetting entry rather than by revision — the error and its correction both remain visible, which is the property an audit depends on.
Invariants
- Immutability: Past entries cannot be modified.
- Append-Only: New transactions are added to the end.
Risks
Failure modes
None stated.
Relationships
Builds on
Used by
References
Immutable append-only log of agent actions for compliance and debugging
Society
Weighted negotiation concession with deferred debt ledger
Composes with
Generic Red/Yellow/Green flow control
Reference
Data schema
{
"type": "object",
"required": [
"ledger_id",
"entries"
],
"properties": {
"ledger_id": {
"type": "string",
"description": "Unique identifier"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from_agent": {
"type": "string"
},
"to_agent": {
"type": "string"
},
"amount": {
"type": "number"
},
"timestamp": {
"type": "string",
"format": "date-time"
}
}
},
"description": "Immutable transaction history"
},
"balance_snapshot": {
"type": "object",
"description": "Current balances per agent"
}
}
}