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 3 seconds, one node wins 0.6345 TMPL. You don't need to do anything — just keep it running.

While your node is running, type these at the > prompt:

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, copy ~/.timpal_wallet.json to the new machine, and run the node. Your balance returns immediately.

TIMPAL is a distributed ledger protocol. Every node holds a complete copy of all transactions and rewards. There are no blocks, no miners, and no proof-of-work.

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 in under a second.

Double-spend prevention works by checking your full balance history before accepting any transaction. The first transaction seen by the network wins.

Every 3 seconds, one node wins 0.6345 TMPL. The winner is selected by a Verifiable Random Function:

This scales to millions of nodes because no peer list is required. Every node independently computes its ticket. The winner is determined by pure mathematics — no voting, no coordination, no central authority.

Every reward includes the VRF ticket as cryptographic proof. Any node can verify the winner is legitimate by recomputing SHA256(winner_id + time_slot) and confirming it is the lowest value for that round.

The ledger is an append-only record of every transaction and reward ever. Your local copy is stored at ~/.timpal_ledger.json.

When two nodes that were disconnected reconnect, their ledgers merge automatically. Conflict resolution rules are deterministic: for rewards, the earlier timestamp wins. For transactions, the first one seen with a valid balance wins.

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:

The bootstrap server is a directory — it introduces nodes to each other. It stores no funds and controls nothing. If it goes offline, nodes already connected continue operating peer-to-peer.

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 paid to the node that first broadcast it. 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.