readme

Author: teddav

README.md

@@ -1,29 +1,44 @@
-# Local testing
+# CoMatch 🍑🌶️ Dating
 
-```bash
-npm i -g vercel@latest
-vercel build
-vercel dev -t "<TOKEN>"
-```
+> A private dating experiment built with real cryptography, using MPC and ZK proofs.
+
+## 🧠 What is this?
+
+Co-Match is a privacy-preserving dating prototype with:
+
+🔐 End-to-end encrypted preferences
+
+🤝 Match discovery via secure MPC (thanks to [co-snarks](https://github.com/TaceoLabs/co-snarks/))
 
-# Flow
+✅ Mutual match proof with ZK-SNARKs (thanks to [Noir](https://github.com/noir-lang/noir))
 
-## frontend
+🙈 No swiping. No profile. No public data.
 
-- input preferences
-- split into shares
-- send each share to a different MPC server
-- wait for matching
+Built during [#NoirHack](https://www.noirhack.com/) as a fun experiment to combine MPC and ZK.
 
-## backend (mpc server)
+Live Demo (might be slow — ping me if it is!): https://co-match.vercel.app/
 
-- receives shares (both "user1" and "user2")
-- matches user1 against all user2
-- write matches to DB
-- stores user2
+## 🧪 How it works
 
-# MPC Server
+You enter your preferences and your Twitter handle, so your matches can contact you 🌶️.  
+Since I have your Twitter, it's not completely private... 😏 Next step: build an in-app chat.
+
+Preferences are encrypted in your browser.  
+Ok, I'm lying here... 🙊 [co-noir](https://github.com/TaceoLabs/co-snarks/tree/main/co-noir/co-noir) cannot yet run in the browser (not possible to compile to wasm), so I'm actually encrypting your preferences on the server. But this will soon be changed!
+
+They're sent to multiple MPC servers that check for mutual matches.
+
+If a match is found: A ZK proof is generated (with Noir) that confirms the match without revealing your preferences.  
+If there's no match: no one ever knows.
+
+## Run
+
+### MPC server
+
+### Front
 
 ```bash
-cargo run --bin gen_cert -- -k data/key0.der -c data/cert0.der -s localhost -s ip6-localhost -s 127.0.0.1 -s party0
+npm i -g vercel@latest
+vercel build
+vercel dev -t "<TOKEN>"
 ```