SYSTEM DOCUMENTATION
Upload a screenshot. Mint a signed badge. Scan the QR to verify.
What is Niko Kadi?
Niko Kadi is a digital badge system that lets you prove you are a registered voter — without exposing your personal information. Think of it as a digital "I Voted" sticker, but one that actually proves you registered, not just that you voted.
How It Works (The 4 Steps)
Upload Your Proof
Go to verify.iebc.or.ke and check your voter registration. When you see the title Voter found! Details as below: with your details, take a screenshot. Upload that screenshot here. Only the screenshot with the "Voter Found" page works.
OCR Reads Your Screenshot
Our system uses OCR (Optical Character Recognition) to read the text in your screenshot. It looks for specific voter-registration keywords like "IEBC", "voter found", "polling station", and your personal details. We do not save your screenshot — it is processed instantly and then discarded.
Mint Your Badge
If the screenshot is valid (shows "Voter Found" with your details), we create a cryptographically signed badge. This badge contains your chosen name/alias, your statement, and a summary of the proof (not the full screenshot).No database stores your data. The badge is a self-contained token that can be verified by anyone.
Verify Anywhere
Your badge has a QR code. Anyone can scan it to see your verification page. The page checks the cryptographic signature to confirm the badge is real — no database lookup needed.
Trust & Security (Why You Can Trust This)
No Database
We do not store your screenshots, name, ID number, or any personal data. The badge is stateless — it proves itself through math, not through a database lookup.
Open Source
All code is public on GitHub. Anyone can audit it, verify it works as claimed, or even run their own copy. No hidden tricks.
Cryptographic Signing
Every badge is signed with HMAC-SHA256. The signature can be verified mathematically. A fake badge cannot pass verification.
IEBC Official Source
We only accept screenshots from verify.iebc.or.ke — the official IEBC voter verification portal. This ensures the proof comes from the official source, not a photoshopped image.
What Data Is Stored In Your Badge?
Your badge contains: (1) Your chosen alias/name, (2) Your statement/motto, (3) A score showing how many voter keywords were detected, (4) A timestamp of when it was created, and (5) A cryptographic signature.It does NOT contain your ID number, polling station details, or the full screenshot. The badge is designed to prove you registered while protecting your privacy.
Built For Transparency
In a world where trust must be earned, not assumed, this system is designed to be verifiable by anyone. The entire codebase is open source — no hidden logic, no secret processes. The cryptographic signatures use standard, well-documented algorithms that mathematicians worldwide have verified. You do not need to trust the creators; you can audit the code yourself, verify the signatures independently, and understand exactly how every part works. Your badge cannot be forged, cannot be censored, and cannot be deleted — it is mathematical proof, not a database entry.
Open Source
The code is open for anyone to audit, verify, and improve. Check the GitHub repository to see exactly how it works.
Repository
VIEW_CODE