Skip to content

Repository files navigation

TPT Flow

A programmable complementary currency with built-in demurrage and accumulation limits that make wealth concentration economically self-correcting.

What It Is

TPT Flow is a concept-stage currency protocol designed to address structural problems in modern monetary systems: velocity collapse, wealth concentration, and advice asymmetry. It does this through three core mechanics:

  • Demurrage — a holding cost on idle balances that incentivises circulation
  • Accumulation limits — soft and hard caps that prevent runaway concentration
  • Commons redistribution — demurrage proceeds flow back to participants proportional to their economic activity

This Repository

This monorepo contains:

Path Contents
src/app/(public)/ Public whitepaper pages (problem, mechanics, governance, roadmap)
src/app/docs/ Developer wiki rendered from MDX
src/app/simulate/ Interactive economic simulation
src/lib/simulation/ Pure TypeScript simulation engine
src/content/docs/ MDX documentation files
docker/ Nginx config for self-hosted deployment

Running Locally

npm install
npm run dev

Open http://localhost:3000.

Building

npm run build
npm start

Docker (Self-Hosted)

docker-compose up --build

Requires a domain and SSL certificates. See docker/nginx.conf for the expected certificate paths.

Simulation

The simulation engine lives in src/lib/simulation/ and is pure TypeScript with no runtime dependencies. It can be imported independently of the UI.

import { runSimulation, DEFAULT_CONFIG } from "@/lib/simulation/engine";

const result = runSimulation({
  ...DEFAULT_CONFIG,
  demurrageRate: 0.01,   // 1% per month
  agents: 500,
  steps: 36,
});

Status

Phase 0 — concept and simulation. No smart contracts exist yet. See the Roadmap for what comes next and the open questions blocking Phase 1.

Licence

MIT — see LICENSE.

About

Concept-stage complementary currency protocol with built-in demurrage, dynamic accumulation caps, and commons redistribution — designed to counter wealth concentration and velocity collapse. Includes a whitepaper, developer docs, and an interactive economic simulator (Next.js 16 + TypeScript).

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages