Yashotantra Academy logo
← Python theorytheory 0/50 · 0%
level 1
Curious · 0 XP
streak
0d
perfect
0
badges
0

100 XP to Apprentice

Capstone · hard

46. Simulating a token ledger (design)

Modeling balances, transfers, and invariants with plain Python.

1 min read3 questionsup to 50 XPtopic 46/50

Read in another language

AI translates the explanation and quiz text while preserving code and answer scoring.

A simple in-memory ledger models balances as a dict and transfers as validated state transitions, which mirrors (in miniature) how a blockchain's state transition function works.

python
class Ledger:
    def __init__(self):
        self.balances: dict[str, float] = {}

    def mint(self, to: str, amount: float) -> None:
        self.balances[to] = self.balances.get(to, 0) + amount

    def transfer(self, frm: str, to: str, amount: float) -> None:
        if self.balances.get(frm, 0) < amount:
            raise ValueError("insufficient balance")
        self.balances[frm] -= amount
        self.balances[to] = self.balances.get(to, 0) + amount

An important invariant: total supply (sum of all balances) should only change on `mint`/`burn`, never on `transfer`. Testing this invariant after each operation catches logic bugs early — the same principle underlies real smart contract auditing.

How to study this topic

  1. 1. Read the explanation once end to end, skipping the code.
  2. 2. Re-read the code snippets and say out loud what each line does.
  3. 3. Answer the quiz without scrolling back — that is the real check.
  4. 4. Read every explanation, even for the answers you got right.

Scoring

  • · Up to 30 XP from quiz accuracy.
  • · +15 XP for a perfect first attempt.
  • · +5 XP while a 3-day streak is running.
  • · 75% or higher marks the topic complete.

Check your understanding

  1. 1. What invariant should hold after any `transfer` call?

  2. 2. What does `self.balances.get(frm, 0)` protect against?

  3. 3. Why raise ValueError on insufficient balance rather than allowing negative balances?

Badges

First light
Pass your first topic
Sharp shooter
3 perfect first-try quizzes
On a roll
Study 3 days in a row
Week warrior
Study 7 days in a row
Grinder
Earn 500 XP
Deep diver
Earn 1500 XP