An economy where value is created, not extracted. Kredo is a club economy built on two tokens (V — contribution, R — reputation), mutual credit, and compensatory emission. This repository shares the model openly: the mathematics, the formulas, the simulation code, the experiment protocols, and the raw results.
Read the overview in your language: English · Русский · Español · 中文
The idea powers the website at kredoclub.com. This repo is the science behind it — open for anyone to read, check, run, and build on.
| Path | What it is |
|---|---|
paper/ |
Academic preprint (LaTeX + compiled PDF), formatted for arXiv / journal submission |
docs/en/whitepaper.md |
Accessible explanation of the whole model (English) |
docs/en/mathematics.md |
The full formal model: axioms, invariants, formulas, theorems |
docs/en/validation.md |
Experiment protocols and results |
docs/ru/ |
Original Russian documents: whitepaper, full derivation, validation report |
docs/es/overview.md · docs/zh/overview.md |
Overviews in Spanish and Chinese |
formulas.md |
Language-neutral formula reference, labelled in EN/RU/ES/ZH |
simulation/ |
The pure simulation code (domain = formulas, engine, protocols) — runnable |
results/ |
Raw JSON outputs of the validation runs |
improvements/ |
Kredo v2 design extensions (implemented, in Russian): retention channel, cooperative form, Sybil defense, dynamic lock-up, drift detector — plus an end-to-end fraud adversary (Phase 6) |
Two familiar models are unfair by construction: rent capitalism (capital earns without working) and the commune (no reward for the active). Kredo is a third way — reward proportional to created value. Two tokens make it work: V (money, transferable) and R (reputation, soulbound, cannot be bought). Money is minted at the moment of a confirmed deal, with a compensatory "gift to all" held in escrow and burned on default, so there is no inflation. V's real price rests on the club selling value to the outside world. Under attack — inflation, panic, fraud — the system defends itself.
The philosophy is formalized as 5 axioms and 7 invariants, implemented as a deterministic simulator, and stress-tested: across 315 runs, the economy never collapsed.
cd simulation
python -m venv .venv && source .venv/bin/activate # Python 3.12+
pip install -r requirements.txt
python -m experiments.regime_analysis
python -m experiments.monte_carloSee simulation/README.md for the full guide.
The simulator answers "will the structure hold?" — and it does. It does not prove long-horizon behavior, the response of real (adaptive) people, game-theoretically optimal attacks, or anything legal/tax-related. Those are named openly in the validation document. This is a foundation, shared for scrutiny — not a finished product.
MIT. Use it, check it, fork it, build on it.