CLClosed-Loop Ledger Lab
Course companion · Simulation only · Nothing is stored

A custodial virtual economy, modeled end to end.

An interactive model of a centralized, asset-backed, closed-loop currency: an administrator provisions accounts, mints points against deposited physical goods, watches balances move through play, then burns points on redemption. Watch where the peg holds and where it breaks.

01 · Technical architecture

Two layers, one ledger.

The back office holds write access to the supply. The client app can only spend what it was given. Both read from the same balance store, and that shared store is the system's single point of truth and of trust.

LAYER 1

Back office

Superuser control panel, elevated permissions

  • +U
    Account provisioningMaster credentials create subordinate "seats".
  • MINT
    Manual creditingPoints issued only after a physical deposit.
  • BURN
    Redemption & settlementBalance zeroed, goods returned from reserve.
LAYER 2

Client app

User-facing interface, restricted permissions

  • AUTH
    Independent sessionsEach seat logs in and acts on its own.
  • WLT
    Wallet integrationBalance is the user's ceiling for activity.
  • LOG
    Session persistenceEvery balance change is recorded in real time.
Shared state seats · balances · append-only event log · reserve count
DimensionTechnical architecture (software)Operational workflow (human)
IssuanceA privileged write to a balance fieldOperator checks a physical deposit before writing
RedemptionBalance set to zero and an event loggedOperator hands goods back from the reserve
IntegrityAppend-only log; supply = mint − burn ± playPhysical count must match the ledger's liabilities
Failure modeBugs, unauthorized writes, credential leaksMiscount, theft, insolvency, operator discretion

02 · Operational workflow

Be the custodian.

Every name and number here is made up, and everything resets when you reload. Make deposits, run play sessions at different return rates, then try redemptions. Watch the collateral ratio: it shows whether the reserve can still cover every point in circulation.

Peg (set by operator)1 card = 100 pts

1Provision a seat

Back office: create a subordinate account.

2Deposit → mint

Cards go into custody and points are issued at the peg.

3Simulate client play

Client app: balance changes at random around an expected return.

4Redeem → burn

Points convert back to cards at the peg and those points are destroyed.

✓Fully backed.
Cards in custody
0
physical reserve
Points outstanding
0
≈ 0 cards owed
Collateral ratio
—
Net play P/L
0
+ means points went to users

Seats

SeatBalanceDepositedReturnedNet P/L

03 · Audit trail

The append-only ledger.

Every change in supply is a recorded event. Reconciliation checks that the running supply equals mint − burn + net play, and compares it with the physical reserve.

#TimeEventSeatΔ PointsΔ CardsSupply after
Σ Minted0
Σ Burned0
Σ Net play0
Ledger check✓ balanced

04 · Vocabulary for the paper

Key concepts.

Use these terms to keep the software design separate from the human process that keeps it honest.

Monetary design

Closed-loop economy

The currency only has value inside the system. It can't be moved to another platform, so the operator controls every place it enters and leaves.

Backing

Asset-backed tokens

Each point is a claim on a physical good held in reserve. The issuer acts like a small reserve bank, and the token is only worth as much as the trust in that reserve.

Supply

Mint & burn

Points are created when goods are deposited and destroyed when they are redeemed. Burning on redemption stops the same claim from being cashed twice (double spending).

Solvency

Collateral ratio

Reserve ÷ (points outstanding ÷ peg). Below 100%, the custodian can't honor every claim at once. Play with an expected return above 100% pushes the system there.

Settlement

Manual reconciliation

No payment processor sits in the middle. The operator settles offline, so the peg holds only as long as the operator counts correctly and acts honestly.

Governance

Custodial trust

Users can't check the reserve themselves. The administrator is issuer, custodian and auditor all at once, a concentration of roles that real financial regulation deliberately keeps separate.

05 · Notes for your paper

What to say, and what to flag.

A strong analysis covers the economics and also the regulatory status of the model.

Suggested structure

  1. Architecture: the two-layer system with privileged write access and a shared ledger.
  2. Workflow: the manual steps of provisioning, crediting, settling and burning.
  3. Economics: the peg, the reserve, and how play results shift what the custodian owes.
  4. Risk: insolvency, single-operator trust, and the lack of any outside audit.
  5. Regulation: how lawmakers classify this design (see right).

The regulatory question

Most US jurisdictions define gambling by three elements together:

ConsiderationChancePrize

When users pay something of value in (cards), play games of chance, and can redeem winnings for value (cards back), all three elements are present. Swapping cash for collectibles generally doesn't change that. This is why platforms like Juwa, Milky Way and Game Vault, run through independent "distributors", face enforcement and state attorney-general actions. Legitimate social casinos avoid this by making their coins non-redeemable, or by running a legally structured sweepstakes with a free way to enter.

Made with wish4