DEV Community

Cover image for PAN-RAP Municipio v0.5 : vote anonyme avec Blind Schnorr, éligibilité HMAC et procès-verbaux PDF
Fenix
Fenix

Posted on

PAN-RAP Municipio v0.5 : vote anonyme avec Blind Schnorr, éligibilité HMAC et procès-verbaux PDF

PAN-RAP Municipio v0.5

Système de vote anonyme avec intégrité cryptographique pour la gouvernance civique municipale. Blind Schnorr sur secp256k1, éligibilité modulaire HMAC, cycle de vie des convocations et génération de procès-verbaux PDF vérifiables.

Qu'est-ce que c'est

PAN-RAP (Planet Assembly Network / Red Asamblearia Planetaria) est un écosystème de gouvernance civique décentralisé conçu pour les municipalités de ~25 000 habitants. Ce dépôt est l'implémentation de référence du module de vote anonyme.

Stack :

  • Backend : Python 3.12+ / FastAPI / coincurve (libsecp256k1)
  • Frontend : Modules JavaScript ES / @noble/curves vendorisé (sans CDN)
  • Crypto : Blind Schnorr sur secp256k1 (token 65 octets)
  • BD : SQLite (WITHOUT ROWID sur l'urne)
  • Licence : AGPL-3.0-or-later

Ce qu'il livre (Phase 5.5 terminée)

Fonctionnalité État Détail
Moteur Blind Schnorr ✅ Émetteur (coincurve) + Urne (vérification fail-closed) + Frontend (@noble/curves)
Éligibilité modulaire ✅ 4 modes : recensement (HMAC), présentiel (codes à usage unique), parrainage (K parrainages), eid (placeholder)
Cycle de vie convocations ✅ Transitions validées : brouillon → programmée → émission → vote → close → scrutée → archivée
Scrutin public ✅ GET /convocatorias/{id}/escrutinio avec dépouillement, participation, hash de l'urne
Téléchargement urne complète ✅ GET /convocatorias/{id}/urna votes ordonnés par r_prima
Procès-verbal PDF ✅ POST /convocatorias/{id}/acta avec reportlab, seulement en état scrutée
Vérificateur indépendant ✅ scripts/verificador_independiente.py audite l'urne complète
Tests ✅ 10 passed (3 éligibilité + 7 cycle de vie)

Ce qu'il NE fait PAS encore

Phase État En attente
Phase 6 ⏳ Audit cryptographique externe (Cure53, Trail of Bits, etc.)
Phase 7 ⏳ Déploiement pilote en municipalité réelle
Persistance états mémoire ⏳ Codes présentiel et parrainages perdus au redémarrage
Endpoint lister convocations ⏳ GET /convocatorias public pour découverte
Mode eid complet ⏳ Intégration OIDC / identité numérique nationale

Note de transparence : Le projet est en Phase 5.5. Les tests passent (10/10), le moteur crypto est audité en interne, mais aucun audit externe n'a été réalisé. Non apte à un usage contraignant jusqu'à la Phase 6.

Comment l'essayer

# 1. Cloner et configurer
git clone https://github.com/amurlaniakea/pan-rap-municipio.git
cd pan-rap-municipio
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt  # inclut reportlab pour les PV PDF

# 2. Lancer les tests
pytest tests/ -v
# → 10 passed

# 3. Démarrer le serveur
export PANRAP_EMISOR_KEY_HEX="$(openssl rand -hex 32)"
fastapi dev main.py

# 4. Flux rapide (exemple mode recensement)
curl -X POST http://localhost:8000/convocatorias \
  -H "Content-Type: application/json" \
  -d '{"titulo":"Test","texto":"...","opciones":["a_favor","en_contra"],"modo_elegibilidad":"padron","nivel_garantia":"alta","emision_abre_en":"2026-11-01T00:00:00","voto_abre_en":"2026-11-02T00:00:00","cierra_en":"2026-11-03T00:00:00"}'
# → {"id": "uuid", "estado": "borrador"}

curl -X POST http://localhost:8000/convocatorias/{id}/censo \
  -H "Content-Type: application/json" \
  -d '{"identificadores": ["dni_123"]}'

curl -X PATCH http://localhost:8000/convocatorias/{id}/estado \
  -H "Content-Type: application/json" \
  -d '{"estado": "programada"}'

curl -X PATCH http://localhost:8000/convocatorias/{id}/estado \
  -H "Content-Type: application/json" \
  -d '{"estado": "emision"}'

# 5. Vérifier l'urne et générer le PV
python scripts/verificador_independiente.py
# → VÉRIFICATION RÉUSSIE : X votes valides, 0 invalides
Enter fullscreen mode Exit fullscreen mode

Architecture de sécurité (résumé)

  • S1 Émission séquentielle : threading.Lock() + TTL 10s
  • S4 Zéro arithmétique int sur secrets : seulement coincurve
  • S5 k éphémère par session : PrivateKey() nouveau à chaque inicio()
  • S6 Validation fail-closed : urna_schnorr.verificar() capture les exceptions
  • S7 Clé hors git : .gitignore couvre clave_emisor.hex
  • S8 Client vendorisé : frontend/lib/ avec @noble/curves (sans CDN)
  • Éligibilité : persona_ref = HMAC-SHA256(secreto_convocatoria, convocatoria:identifiant) — différent par convocation, non liable
  • Secret persistant : stocké dans convocatorias.secreto_hmac, jamais exposé dans les réponses HTTP

Références


Auteur : Pedro Sordo Martínez

Licence : AGPL-3.0-or-later

Top comments (0)