qcoin
| Crates.io | qcoin |
| lib.rs | qcoin |
| version | 1.1.0 |
| created_at | 2025-07-30 09:35:21.350518+00 |
| updated_at | 2025-07-30 11:25:04.57109+00 |
| description | A quantum-based binary choice maker that performs coin tosses using quantum random number generators |
| homepage | https://github.com/weezy20/qcoin |
| repository | https://github.com/weezy20/qcoin |
| max_upload_size | |
| id | 1773305 |
| size | 72,958 |
Abhishek Shah (weezy20)
documentation
https://docs.rs/qcoin
README
qcoin - Quantum Coin Toss
A quantum-based binary choice maker that performs coin tosses using quantum random number generators. The application tries multiple quantum sources and uses a mix of cryptographically secure RNGs seeded with the quantum bytes obtained from a publicly available QRNG.
Installation
You can build the project from source or install it directly from crates.io.
cargo install qcoin
Usage
qcoin # Single coin flip
qcoin -n 10 # 10 coin flips
qcoin --number 100 # 100 coin flips
qcoin -s entropy.hex # Use hex string from entropy.hex as entropy source
qcoin --hex "abc123" # Use hex string directly as entropy source
qcoin --hex "0xff" # Use hex string with 0x prefix
qcoin -n 5 --hex "abc123" # 5 flips using hex string
qcoin --hex "ff" -o saved.hex # Use hex and save to custom file
Command Line Options
| Flag | Description | Default | Notes |
|---|---|---|---|
-n, --number <flips> |
Number of coin flips | 1 |
Must be greater than 0 |
-o, --output <file> |
Output file for quantum entropy | qrandom.bytes |
Saves quantum or hex entropy |
-s, --source <file> |
Use file as entropy source | None | Supports hex strings or binary data |
--hex <string> |
Use hex string directly as entropy source | None | Supports 0x prefix |
How it Works
Coin Flip Logic
Counts 1-bits vs 0-bits in entropy bytes:
- More 1-bits → YES ✅
- More 0-bits → NO ❌
Single flip: Uses entropy bytes directly
Multiple flips: N-1 CSRNG-generated with random bytes as its seed + 1 direct entropy flip
Entropy Sources
- ANU QRNG - Quantum random number generator
- qrandom.io - Alternative quantum source
- User input
--hex <entropy>or-s/--source <file> - Cryptographic SRNG - Fallback
- Saved quantum bytes from
qrandom.bytes