Qazna.org
The Open Standard Ledger Runtime. Think of it as PostgreSQL for financial accounting.
Qazna is a high-performance, deterministic ledger engine. It provides the strict correctness of a blockchain with the throughput and privacy of a centralized database.
🚀 Quick Start
Spin up a local instance having a Go API, Rust Core, and Postgres DB in 2 minutes.
bash
# 1. Setup environment
cp .env.example .env
# 2. Run everything
docker compose up -d
# 3. Mint some money (Example)
curl -X POST http://localhost:8080/v1/ledger/transactions \
-u "admin:secret" \
-d '{"amount": 1000, "asset": "QAZ", "type": "MINT"}'Read the Full Documentation | Why Qazna?
🧐 Why?
Building a ledger on a raw database (Postgres/MySQL) is easy at first, but fatal at scale.
- ❌ Race Conditions:
UPDATE balance = balance - 10is not safe without complex locking. - ❌ Data Drift: Without double-entry constraints, money can "disappear" or be created effectively by bugs.
- ❌ Audit Nightmares: "Why is the balance negative?" If you don't have an immutable log, you can't say.
Qazna Solves This:
- ✅ Double-Entry enforced: Every credit has a debit.
- ✅ Immutable Log: History is never lost, only appended to.
- ✅ Deterministic Replay: Re-run the log, get the exact same state.
🏗 Architecture
Qazna implements the Open Ledger Runtime Standard. It is designed as modular infrastructure, not a monolithic bank-in-a-box.
| Component | Tech | Responsibility |
|---|---|---|
| Core | Rust 🦀 | The "Kernel". Deterministic state machine. |
| API | Go 🐹 | The "Shell". HTTP/gRPC access, auth, logging. |
| Spec | TLA+ 📐 | Mathematical proof of correctness. |
📚 Documentation
- Standard Definition: The normative specification.
- Use Cases: Fintech, Marketplaces, Gaming.
- Governance: How the project is run neutrally.
🤝 Contributing
We are building the "Linux of Finance". We need:
- Rust Engineers for the Core.
- Go Engineers for the API.
- Financial Architects for the Standard.
See CONTRIBUTING.md to get involved.
Licensed under AGPL-3.0. A Qazna Technologies Project.