Works on Mac · Linux · Windows · Python 3.8+
| Property | Value |
|---|---|
| Total Supply | 250,000,000 TMPL |
| Reward Per Round | 1.0575 TMPL |
| Round Interval | Every 5 seconds |
| Distribution Period | 37.5 years |
| Eligible Nodes Per Slot | ~10 (scales with network size) |
| Confirmation Depth | 6 slots (~30 seconds) |
| Transaction Fee (Era 1) | Free |
| Transaction Fee (Era 2) | 0.0005 TMPL |
| Pre-mine | None |
| Insider Allocation | None |
TIMPAL runs on Mac, Linux, and Windows. You need Python 3.8 or newer.
That's everything. No configuration files. No accounts. No KYC.
When you start TIMPAL for the first time, it creates a quantum-resistant wallet and connects to the worldwide network automatically.
Your node immediately joins the VRF lottery. Every 5 seconds, one node wins 1.0575 TMPL. You don't need to do anything — just keep it running.
While your node is running, type these at the > prompt:
| Command | What it does |
|---|---|
| balance | Show your TMPL balance and full wallet address |
| chain | Chain height, tip hash, and recent confirmed blocks |
| peers | List online nodes currently connected to you |
| send | Send TMPL interactively (select peer from list) |
| history | Your last rewards and transactions |
| network | Your node and network stats |
| quit | Shut down your node cleanly |
You can also run commands from a second terminal without stopping your node:
Your wallet is stored in one file on your computer:
To restore your wallet on a new machine: install Python, install dilithium-py and cryptography, copy ~/.timpal_wallet.json to the new machine, and run the node. Your balance returns immediately.
TIMPAL is a chain-anchored distributed ledger protocol. Every node holds a complete copy of all transactions and blocks. There is no proof-of-work and no mining. Each reward is a block carrying a cryptographic link to the previous one, anchoring the entire history to a single deterministic chain.
When you send TMPL, your node signs the transaction with your private key and broadcasts it to all connected peers. Every peer verifies your balance and signature before accepting it. The transaction confirms within seconds.
Double-spend prevention works by checking your full balance history before accepting any transaction. The first transaction seen by the network wins.
Every 5 seconds, one node wins 1.0575 TMPL. The lottery uses an eligibility gate and a commit-reveal scheme to ensure fairness at any network size.
Eligibility gate. Before each slot, every node independently checks whether it is eligible to participate using a deterministic hash of its device ID and the slot number. The gate targets ~10 eligible nodes per slot regardless of total network size — so at 1,000,000 nodes, roughly 10 participate, keeping the lottery efficient and fair forever.
The collective target cannot be known until the reveal window closes — no node can predict it in advance or cherry-pick whether to reveal. Every node independently verifies all reveals using the committed hashes and Dilithium3 signatures, then picks the same winner using identical math.
Every reward includes the full VRF proof. Any node can verify the winner is legitimate by confirming the commit, the signature, and that the ticket is the closest to the collective target among all verified participants.
The ledger is a chain of blocks — one per winning slot — stored locally at ~/.timpal_ledger.json. Each block carries a cryptographic link to the previous one, forming a single tamper-evident history.
When two nodes that were disconnected reconnect, their chains are compared and the longer valid chain wins — Nakamoto-style fork resolution without proof-of-work. On equal length, the chain with the lower tip hash wins, a deterministic rule that produces identical results on every node regardless of which chain arrived first. Blocks confirmed at least 6 slots deep (~30 seconds) are final. After any chain reorganization, transactions that are no longer funded by surviving block rewards are automatically removed.
After every merge, the total minted supply is recalculated from scratch — never trusted from incremental additions. This prevents floating point drift at any scale.
TIMPAL uses two peer discovery methods:
| Method | How | Range |
|---|---|---|
| Local | UDP broadcast on port 7778 | Same WiFi network |
| Global | TCP bootstrap at bootstrap.timpal.org:7777 | Worldwide |
The bootstrap server is a directory — it introduces nodes to each other and serves as the commit/reveal registry for the lottery. It stores no funds and controls nothing. If it goes offline, nodes already connected continue operating peer-to-peer.
| Property | Value |
|---|---|
| Total Supply | 250,000,000 TMPL |
| Reward Per Round | 1.0575 TMPL |
| Round Interval | Every 5 seconds |
| Distribution Period | 37.5 years |
| Eligible Nodes Per Slot | ~10 (scales with network size) |
| Confirmation Depth | 6 slots (~30 seconds) |
| Transaction Fee (Era 1) | Free |
| Transaction Fee (Era 2) | 0.0005 TMPL |
| Pre-mine | None |
| Insider Allocation | None |
Era 1 — Distribution (Years 0 to 37.5): All transactions are free. Nodes earn through the VRF lottery. 250 million TMPL distributed over 37.5 years. No pre-mine.
Era 2 — Sustaining (Year 37.5 onwards): Supply fixed at 250 million forever. Every transaction carries a fee of 0.0005 TMPL split equally among all nodes that submitted a VRF commit for that slot. The network is self-sustaining indefinitely.
The transition is automatic. No upgrade required. No vote. When the last TMPL is minted, the lottery stops and fee collection begins.