🔐 Crypto Wallet — Mnemonic Generator (BIP39 Web App)

Application web et API Serverless pour la génération et la validation de phrases mnémoniques BIP39 (12 ou 24 mots).
Compatible avec Bitcoin, Ethereum, Solana et la majorité des portefeuilles crypto (MetaMask, Ledger, Trezor, etc.).

Prête à être déployée en un clic sur Vercel.

---

✨ Fonctionnalités

• ⚡ Génération instantanée : 12 mots (standard) ou 24 mots (sécurité renforcée).
• 🌍 Multilingue : 10 langues officiellement supportées par la norme BIP39 (english, french, spanish, italian, portuguese, czech, japanese, korean, chinese_simplified, chinese_traditional).
• 🔍 Validateur d'entropie & Checksum : Vérifiez la validité de n'importe quelle phrase BIP39 existante.
• 🔒 Sécurité accrue :
  • Génération d'entropie cryptographique via le module Python secrets.
  • Masquage automatique des mots à l'écran avec bouton de d'affichage/masquage.
  • Copie sécurisée dans le presse-papier en un clic.
  • Aucune persistance : aucune donnée ou phrase n'est conservée, enregistrée ou transmise.
• 🎨 Interface moderne : Design sombre (Dark Mode) avec micro-animations et responsive design.

---

📁 Structure du projet

wallet-phrases-generator/
├── api/
│   ├── generate.py       # Serverless Function : Génération BIP39 (/api/generate)
│   ├── validate.py       # Serverless Function : Validation BIP39 (/api/validate)
│   └── requirements.txt  # Dépendances Python pour Vercel Runtime
├── public/
│   ├── index.html        # Page web principale (HTML5 sémantique)
│   ├── style.css         # Design system & styles CSS
│   └── app.js            # Logique frontend (fetch API, interactions UI)
├── vercel.json           # Configuration du routage Vercel (static + serverless)
├── requirements.txt      # Dépendances Python locales
└── Readme.md             # Documentation du projet

---

🚀 Déploiement sur Vercel

Option 1 : Via l'interface Vercel (Recommandé)

1. Poussez votre projet sur GitHub :

   git add .
   git commit -m "feat: web interface and vercel config"
   git push origin main

2. Rendez-vous sur Vercel Dashboard.
3. Importez votre dépôt wallet-phrases-generator.
4. Vercel détecte automatiquement la configuration vercel.json et déploie le projet.

Option 2 : Via Vercel CLI

npm i -g vercel
vercel

---

🛠️ Développement Local

Vous pouvez tester l'application localement avec Vercel CLI ou via un serveur local.

Avec Vercel CLI (Recommandé)

vercel dev

L'application sera accessible sur http://localhost:3000.

Sans Vercel CLI (Serveur Python local)

1. Créer et activer l'environnement virtuel :

   python -m venv venv
   source venv/bin/activate  # Sur Linux / macOS
   # venv\Scripts\activate.bat  # Sur Windows

2. Installer les dépendances :

   pip install -r requirements.txt

3. Tester les fonctions de l'API :

   from api.generate import generate_mnemonic
   print(generate_mnemonic(language="french", strength=128))

---

🔌 API Endpoints

1. Générer une phrase mnémonique

GET /api/generate?language={lang}&strength={bits}

• Paramètres query :
  • language (optionnel) : english (défaut), french, spanish, etc.
  • strength (optionnel) : 128 (12 mots, défaut) ou 256 (24 mots).
• Réponse exemple :

  {
    "phrase": "abandon ability able about above absent absorb abstract absurd abuse access accident",
    "words": ["abandon", "ability", "able", "about", "above", "absent", "absorb", "abstract", "absurd", "abuse", "access", "accident"],
    "word_count": 12,
    "strength": 128,
    "language": "english",
    "valid": true
  }

2. Valider une phrase mnémonique

GET /api/validate?phrase={phrase}&language={lang}

• Paramètres query :
  • phrase (requis) : La phrase de 12 ou 24 mots séparés par des espaces.
  • language (optionnel) : La langue de la wordlist BIP39 à vérifier.
• Réponse exemple :

  {
    "valid": true,
    "word_count": 12,
    "language": "english",
    "phrase": "abandon ability able..."
  }

---

🛡️ Sécurité & Bonnes Pratiques

• L'entropie est générée via le module secrets de Python, spécifiquement conçu pour les usages cryptographiques.
• Attention : Ne partagez jamais vos phrases mnémoniques et ne les commitez jamais dans un dépôt public.
• Pour une utilisation de production avec de vrais fonds importants, il est toujours recommandé de générer ses seed phrases sur un appareil air-gappé ou via un hardware wallet (Ledger / Trezor).

---

📄 Licence

MIT — Libre d'utilisation, de modification et de distribution.