cryptoseed 1.0.0

package/README.fr.md

@@ -0,0 +1,224 @@
+# 🛡️ cryptoseed
+
+🌍 **Select Language / Selecione o Idioma:**
+[Português](./README.md) | [English](./README.en.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Italiano](./README.it.md) | [Türkçe](./README.tr.md) | [Русский](./README.ru.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [한국어](./README.ko.md) | [עברית](./README.he.md)
+
+
+**cryptoseed** est une bibliothèque de classe entreprise, légère et de haute performance développée en **JavaScript Pur** (Node.js) conçue pour le diagnostic, la validation et la récupération de phrases mnémoniques (*seed phrases*) cryptographiques perdues, désordonnées ou saisies avec des fautes d'orthographe.
+
+Développée dans l'écosystème de sécurité et d'infrastructure de **b2 wallet** ([better2better](https://better2better.net), sous la direction de [diegooris](https://diegohorantunes.web.app/)), la bibliothèque a été conçue pour fournir aux développeurs et analystes de sécurité une robustesse maximale, une vitesse de recherche ultra-rapide et une précision historique chirurgicale pour la dérivation d'adresses sur **39 blockchains et écosystèmes différents**. Tout cela fonctionne de manière 100% autonome, sans dépendances de compilation C/C++ native ni paquets externes qui pourraient compromettre la portabilité de la version compilée.
+
+---
+
+## 📅 Variations de BIP Supportées et Chronologie Historique
+
+Pour récupérer des fonds avec précision, il ne suffit pas de connaître les mots ; vous devez comprendre les spécifications techniques et l'année de création du portefeuille. **cryptoseed** implémente et respecte rigoureusement les normes historiques (BIPs).
+
+### 🔍 Tableau des Normes BIP Implémentées et Alignées
+
+| BIP | Nom | Implémentation & Support dans **cryptoseed** |
+| :---: | :--- | :--- |
+| **BIP-32** | *Hierarchical Deterministic Wallets* | **Support Complet.** Fondation de l'arbre de dérivation HD. Permet au moteur de dériver des chemins infinis de clés publiques/privées (`xprv`/`xpub`) à partir d'une seule graine principale en utilisant des mathématiques de courbe elliptique pures via notre moteur de clés. |
+| **BIP-39** | *Mnemonic Code* | **Support Complet.** Le standard le plus répandu. Supporte les phrases de **12, 15, 18, 21 ou 24 mots** avec vérification de l'intégrité intégrée (*checksum*) de 4 à 8 bits et dictionnaires en **10 langues** différentes. |
+| **BIP-43** | *Purpose Field* | **Support Complet.** Respecte la structure qui a introduit le champ de but (`m / purpose'`) au sommet de l'arbre des chemins, assurant un routage correct vers les portefeuilles multi-usages. |
+| **BIP-44** | *Multi-Account* | **Support Complet.** Le chemin de dérivation standard le plus utilisé dans l'industrie : `m/44'/coin_type'/account'/change/address_index`. Utilisé par défaut pour Bitcoin Legacy, Ethereum, EVMs, Solana Legacy, TRON, Cardano Legacy, etc. |
+| **BIP-45** | *Multisig HD* | **Alignement de Chemins.** Utilisé pour les portefeuilles multi-signatures dans les chemins de but `m/45'`. Si vous récupérez une graine individuelle faisant partie d'un portefeuille multisig BIP-45, le moteur dérive les clés privées individuelles normalement. |
+| **BIP-47** | *Payment Codes* | **Compatibilité des Graines.** Codes de paiement réutilisables et privés (comme les portefeuilles Samourai). La sauvegarde des portefeuilles utilisant le BIP-47 est une graine BIP-39 standard de 12 ou 24 mots. **cryptoseed** récupère cette graine maîtresse parfaitement. |
+| **BIP-48** | *Multisig Structure* | **Compatibilité.** Structure multisig avancée basée sur BIP-43 utilisant le chemin `m/48'/coin_type'/...`. Compatible pour récupérer la graine maîtresse signant ces transactions multi-signatures. |
+| **BIP-49** | *Nested SegWit* | **Support Complet.** Adresses Bitcoin de transition commençant par le caractère `3` (format P2SH-P2WPKH), dérivées sous le chemin officiel `m/49'/0'/0'/0/index`. |
+| **BIP-84** | *Native SegWit* | **Support Complet.** Adresses Bitcoin modernes de haute performance commençant par `bc1q` et Litecoin commençant par `ltc1` (format Bech32), dérivées sous `m/84'/0'/0'/0/index` (et `m/84'/2'/...` pour LTC). |
+| **BIP-85** | *Child Seeds* | **Compatibilité Conceptuelle.** Permer à une graine principale BIP-39 de générer de nouvelles sous-graines sécurisées (de 12 ou 24 mots) pour d'autres portefeuilles sous les chemins comme `m/85'/...`. Si votre graine perdue est une graine enfant dérivée par le BIP-85, le moteur la récupérera comme toute graine BIP-39 normale. |
+| **BIP-86** | *Taproot* | **Support Complet.** Adresses Bitcoin de dernière génération (Schnorr/Taproot) commençant par `bc1p` (Bech32m), dérivées sous le chemin standard `m/86'/0'/0'/0/index`. |
+
+---
+
+## ⚡ Pourquoi cryptoseed a-t-il été créé ?
+
+Lorsque j'ai dû récupérer des portefeuilles pour des clients et des amis de l'écosystème **b2 wallet** / [better2better](https://better2better.net), j'ai réalisé que les outils existants étaient soit trop complexes (nécessitant des compilations C++ natives qui cassaient Node) soit ne comprenaient pas la transition historique des blockchains. J'ai créé cette bibliothèque pour proposer les solutions suivantes :
+
+1.  **Zéro Dépendance Native (Pure JS):** Fonctionne sans problème sous Windows, Linux ou macOS. Idéal pour compiler des exécutables portables avec `pkg`.
+2.  **Technologie de "Découpage de Lettres" (Prefix Fallback):** J'ai écrit un algorithme qui, si vous saisissez un mot incorrect comme `engino`, découpera le mot caractère par caractère (`e-n-g-i-n-o` -> `e-n-g-i-n` -> `engine`) pour identifier automatiquement le mot le plus probable dans le dictionnaire officiel.
+3.  **Gestion Intelligente des Mots Manquants:** Si l'algorithme trouve un mot inconnu sans correspondance de préfixe dans le dictionnaire, il le convertit automatiquement en un caractère générique (`*`) pour tester toutes les possibilités du dictionnaire 1 par 1 de manière automatisée.
+4.  **Élagage Précoce des Branches (Early Branch Pruning):** J'ai développé le moteur de recherche avec un élagage précoce basé sur des contraintes (mots requis et exclus - NOK), évitant au processeur de calculer des milliards de permutations inutiles.
+5.  **Contournement Intégré du Checksum:** Comme les graines BIP-39 contiennent des sommes de contrôle, le code élimine **99.6%** de toutes les combinaisons générées avant même de tenter les calculs complexes de courbe elliptique, économisant 1000 fois le temps de processeur.
+
+---
+
+## 🛠️ Fonctionnalités de Récupération et Ingénierie de Recherche
+
+Développé à l'origine en **2023** comme outil propriétaire exclusif pour l'écosystème de la **b2 wallet** ([better2better](https://better2better.net)), **cryptoseed** a été ouvert au public pour offrir une infrastructure de récupération scientifiquement supérieure aux solutions ordinaires du marché. Le moteur de recherche présente les capacités et distinctions technologiques suivantes :
+
+### 🎯 Classification des États par Mot
+Contrairement aux scripts de récupération basiques, l'assistant interactif vous permet de configurer l'état de confiance de chaque mot individuel de la graine mnémonique en utilisant trois classifications :
+* **✔️**: Le mot et sa position exacte dans la phrase sont confirmés. Le moteur verrouille ce mot et concentre sa puissance de calcul exclusivement sur les autres emplacements.
+* **🔀**: Le mot est connu pour appartenir à la phrase, mais sa position est incorrecte ou incertaine. Le moteur considère dynamiquement ce mot pour des permutations sécurisées uniquement sur les emplacements disponibles, évitant ainsi les tests redondants.
+* **🎲**: Le mot est totalement inconnu, perdu ou illisible. Le moteur teste automatiquement et de manière exhaustive toutes les possibilités du dictionnaire correspondant.
+
+### 📊 Pré-traitement et Estimations de Faisabilité
+Avant de dépenser de l'énergie informatique, le moteur analyse la phrase et les contraintes fournies pour afficher un tableau mathématique détaillé :
+* **Espace de Recherche Brut**: Affiche le total mathématique exact des combinaisons théoriques basées sur votre configuration.
+* **Élagage de l'Arbre (Somme de Contrôle & Filtres)**: Indique combien de combinaisons restent après l'application de filtres logiques immédiats (tels que les sommes de contrôle ou les exclusions de mots NOK), réduisant ainsi considérablement le volume de dérivations de clés.
+* **Projections de Temps d'Analyse**: Compare en temps réel les estimations de temps de scan à l'aide d'une connexion moyenne (APIs publiques) par rapport à une connexion locale ultra-rapide (nœuds RPC locaux).
+* **Alerte d'Infaisabilité**: Le moteur alerte l'utilisateur de manière transparente si la complexité configurée nécessite des ressources de supercalcul, évitant ainsi les blocages matériels inutiles.
+
+### 🌐 Multiples Moteurs de Validation et Formats
+L'écosystème prend en charge différentes structures cryptographiques avec des règles de validation spécifiques :
+* **Moteur BIP-39**: Prise en charge des graines de **12, 15, 18, 21 et 24 mots**, appliquant une validation de somme de contrôle (*checksum*) intégrée pour éliminer **99.6%** des fausses combinaisons avant toute dérivation.
+* **Moteur Electrum**: Validation et dérivation adaptées exactement aux règles exclusives des graines mnémoniques Electrum (Legacy et Modern).
+* **Moteur Electron Cash**: Adaptation précise de la logique de dérivation et de validation du checksum de l'écosystème Bitcoin Cash.
+* **Mode Sans Validation (Force Brute)**: Générateur brut de dérivation sans filtre de somme de contrôle, idéal pour les formats hérités propriétaires ou les phrases personnalisées non standard, garantissant une couverture de recherche maximale.
+
+### 🧩 Résolution de Cas Complexes Combinés
+Le moteur résout des problèmes combinés complexes en une seule exécution, notamment :
+* Un ou plusieurs mots complètement perdus dans des positions connues ou inconnues.
+* Mots connus avec un ordre complètement mélangé.
+* Scénarios mixtos (ex. graines où certains mots sont manquants alors que les mots connus ne sont pas dans le bon ordre).
+* Choix du profil de recherche : **Vitesse Maximale** (avec sommes de contrôle et contraintes) ou **Couverture Maximale** (force brute mathématique globale).
+
+---
+
+## ⚙️ Installation
+
+### Installation Globale (Pour exécuter l'utilitaire CLI interactif directement dans le terminal)
+```bash
+npm install -g cryptoseed
+```
+
+### Installation Locale (Pour importer les logiques dans votre projet Node)
+```bash
+npm install cryptoseed
+```
+
+---
+
+## 🛡️ Utilisation de l'API (JavaScript)
+
+La bibliothèque met à disposition des exports propres et bien structurés pour une intégration immédiate des logiques de sécurité de **b2 wallet** dans votre application :
+
+```javascript
+const { wordlists, searchEngine, addressDeriver, typo } = require('cryptoseed');
+
+// 1. Corriger un mot erroné avec le "Découpage de Lettres"
+const dictionnaire = wordlists.bip39.fr || wordlists.bip39.en;
+const motErrone = "*";
+const suggestions = typo.getPrefixSuggestions(motErrone, dictionnaire);
+console.log("Mot déduit :", suggestions); // Retourne [ 'engine' ]
+
+// 2. Dériver l'adresse publique réelle pour MetaMask (EVM)
+const seed = "cabin engine harvest fiction witness walnut ladder tumble insect fox notable spoon";
+const adresseEth = addressDeriver.deriveAddress(seed, 'metamask', 'ETH', 0);
+console.log("Adresse Ethereum :", adresseEth);
+
+// 3. Dériver l'adresse personnalisée en utilisant la cryptographie B2 Wallet
+const adresseB2 = addressDeriver.deriveAddress(seed, 'b2wallet', 'BTC', 0);
+console.log("Adresse Bitcoin dans B2 Wallet :", adresseB2);
+```
+
+---
+
+## 💻 CLI Interactive
+
+Tapez simplement la commande principale dans votre terminal et suivez l'assistant :
+```bash
+cryptoseed
+```
+
+### Commandes d'Aide et d'Information Historique
+
+*   **Aide rapide (`-h` ou `--help`):** Affiche le guide d'utilisation et les options de ligne de commande.
+    ```bash
+    cryptoseed --help
+    ```
+*   **Recueil d'informations (`-i` ou `--info`):** Affiche un résumé historique complet de chaque blockchain supportée, les chemins par défaut utilisés par année et les portefeuilles compatibles. Excellent pour savoir où de vieux fonds pourraient être stockés !
+    ```bash
+    cryptoseed --info
+    ```
+
+---
+
+## 🧮 Mathématiques et Limites de Viabilité
+
+Si vous avez perdu votre graine, vous devez être réaliste quant aux probabilités. J'ai configuré le moteur pour afficher des alertes réalistes avant de lancer une recherche lourde :
+
+### Tableau des Combinaisons BIP-39 (Dictionnaire de 2048 Mots)
+
+| Mots Perdus | Calcul de Combinaisons | Total des Possibilités | Viabilité Réelle |
+| :---: | :---: | :---: | :--- |
+| **1 Mot** | $2048^1$ | **2 048** | **Totalement Viable** (Fractions de seconde sur n'importe quel CPU) |
+| **2 Mots** | $2048^2$ | **4 194 304** | **Viable** (Quelques secondes avec notre moteur optimisé) |
+| **3 Mots** | $2048^3$ | **8 589 934 592** | **Très Lourd** (Viable si vous connaissez les positions ou si vous avez des contraintes) |
+| **4 Mots** | $2048^4$ | **17 592 186 044 416** | **Inviable** pour les ordinateurs ordinaires (prendrait des semaines/mois) |
+| **5 Mots** | $2048^5$ | **36 028 797 018 963 968**| **Mathématiquement Impossible** (Nécessiterait des superordinateurs) |
+
+---
+
+## 📊 Matrice des Blockchains et Portefeuilles Supportés (39 Réseaux)
+
+Voici la liste complète et détaillée des 39 réseaux et écosystèmes pris en charge nativement par le moteur de dérivation de **cryptoseed**, garantissant une compatibilité descendante et contemporaine :
+
+| Écosystème / Réseau | Symbole | Chemin de Dérivation par Défaut (HD Path) | Portefeuilles de Référence Compatibles |
+| :--- | :---: | :--- | :--- |
+| **Bitcoin** | BTC | `m/84'/0'/0'/0/i` (Native SegWit)<br>`m/49'/0'/0'/0/i` (Nested SegWit)<br>`m/44'/0'/0'/0/i` (Legacy)<br>`m/86'/0'/0'/0/i` (Taproot) | B2 Wallet, Electrum, Trust Wallet, Ledger, Trezor |
+| **Ethereum** | ETH | `m/44'/60'/0'/0/i` | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **BNB Chain** | BNB | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Polygon** | MATIC | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Arbitrum** | ARB | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Optimism** | OP | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Avalanche** | AVAX | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, Core, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Base** | BASE | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Fantom** | FTM | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Cronos** | CRO | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Harmony** | ONE | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet |
+| **Gnosis Chain** | GNOSIS | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Solana** | SOL | `m/44'/501'/0'/0'` (Phantom Standard)<br>`m/44'/501'/0'/0/i` (Sollet/Legacy) | B2 Wallet, Phantom, Sollet, Solflare, Trust Wallet |
+| **Cardano** | ADA | `m/1852'/1815'/0'/0/i` (Shelley Native)<br>`m/44'/1815'/0'/0/i` (Byron Legacy) | Yoroi, Daedalus, Eternl, Lace |
+| **TRON** | TRX | `m/44'/195'/0'/0/i` | B2 Wallet, TronLink, Trust Wallet, Ledger, Trezor |
+| **Waves** | WAVES | `m/44'/5741564'/0'/0/i` | Waves Keeper, Waves Client |
+| **Stellar** | XLM | `m/44'/148'/0'/0/i` | Lobstr, Stellar Wallet, Ledger |
+| **Ripple** | XRP | `m/44'/144'/0'/0/i` | Toast Wallet, Xumm, Ledger, Trezor |
+| **Polkadot** | DOT | `m/44'/354'/0'/0'/0'` (Substrate Path) | Polkadot.js, Talisman, Fearless |
+| **Kusama** | KSM | `m/44'/434'/0'/0'/0'` (Kusama Path) | Polkadot.js, Talisman, Fearless |
+| **Cosmos** | ATOM | `m/44'/118'/0'/0/i` | Keplr, Cosmostation, Ledger |
+| **Osmosis** | OSMO | `m/44'/118'/0'/0/i` | Keplr, Cosmostation, Ledger |
+| **Secret Network** | SCRT | `m/44'/529'/0'/0/i` | Keplr, Cosmostation |
+| **Injective** | INJ | `m/44'/60'/0'/0/i` (Keccak-256) | Keplr, MetaMask, Leap |
+| **Hedera** | HBAR | `m/44'/3030'/0'/0/i` | Hashpack, Blade Wallet |
+| **NEM** | XEM | `m/44'/43'/0'/0/i` | NEM Wallet |
+| **Chia** | XCH | `m/44'/8444'/0'/0/i` | Chia Wallet |
+| **Tezos** | XTZ | `m/44'/1729'/0'/0/i` | Temple, Kukai, Ledger |
+| **Algorand** | ALGO | `m/44'/283'/0'/0'/0'` | Pera Wallet, Defly Wallet |
+| **Near** | NEAR | `m/44'/397'/0'/0'/0'` | MyNearWallet, Sender Wallet |
+| **Sui** | SUI | `m/44'/784'/0'/0'/0'` | Sui Wallet, Suiet, Trust Wallet |
+| **Aptos** | APT | `m/44'/637'/0'/0'/0'` | Petra Wallet, Pontem, Martian |
+| **Litecoin** | LTC | `m/84'/2'/0'/0/i` (Native SegWit)<br>`m/44'/2'/0'/0/i` (Legacy) | B2 Wallet, Electrum LTC, Trust Wallet, Ledger |
+| **Dogecoin** | DOGE | `m/44'/3'/0'/0/i` | B2 Wallet, Multidoge, Trust Wallet, Ledger, Trezor |
+| **Bitcoin Cash** | BCH | `m/44'/145'/0'/0/i` | B2 Wallet, Electron Cash, Trust Wallet, Ledger |
+| **Dash** | DASH | `m/44'/5'/0'/0/i` | B2 Wallet, Dash Core, Trust Wallet, Ledger |
+| **Zcash** | ZEC | `m/44'/133'/0'/0/i` | B2 Wallet, Trust Wallet, Ledger |
+| **Kaspa** | KAS | `m/44'/111111'/0'/0/i` | Kaspium, Kaspa Web Wallet |
+| **Monero** | XMR | `m/44'/128'/0'/0/i` | Cake Wallet, Monerujo, GUI Wallet |
+
+---
+
+## 🛠️ Performance : Nœud RPC local vs API publique
+
+À la fin de chaque recherche, **cryptoseed** enregistre un rapport de récupération détaillé sur votre disque (`resultado_recuperacao_[timestamp].txt`) et fournit une estimation en temps réel de la vitesse de requête pour vérifier si les adresses trouvées ont des fonds en ligne :
+
+*   **Requêtes via API Publiques (50ms par requête):** Utile uniquement si vous avez très peu de graines candidates ($<100$). Souffre de la latence d'internet et des limites de taux.
+*   **Requêtes via Nœud RPC Local (0.1ms par requête):** La solution idéale pour les recherches volumineuses ($>1000$ graines). Divise le temps d'analyse par **500** en s'exécutant localement sur votre propre machine.
+
+---
+
+## 🎓 Easter Egg de l'ère Satoshi (2009 - 2010)
+
+Si vous tentez de sélectionner dans l'assistant que votre portefeuille a été créé en ou avant **2010**, le programme s'arrêtera et vous dévoilera un secret historique : **À cette époque originelle, les graines mnémoniques de récupération N'EXISTAIENT PAS !**
+Le client d'origine de Satoshi Nakamoto (Bitcoin-Qt) générait des clés privées aléatoires enregistrées directement dans le fichier binaire `wallet.dat`. Si vous avez perdu ce fichier, aucune phrase de récupération ne pourra récupérer vos fonds, car le concept de graine mnémonique déterministe n'avait simplement pas encore été inventé !
+
+---
+
+## 🛡️ Licence, Sécurité et Gouvernance
+
+Cette bibliothèque s'exécute de manière **100% locale et hors ligne** sur votre machine. Le code est ouvert, propre et n'effectue aucune requête réseau pour transmettre vos mots ou clés privées. La sécurité avant tout.
+
+*   **Licence :** MIT (Créé en 2023)
+*   **Crédits :** Projet **b2 wallet** / [better2better](https://better2better.net) / [diegooris](https://diegohorantunes.web.app/).

package/README.he.md

@@ -0,0 +1,224 @@
+# 🛡️ cryptoseed
+
+🌍 **Select Language / Selecione o Idioma:**
+[Português](./README.md) | [English](./README.en.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Italiano](./README.it.md) | [Türkçe](./README.tr.md) | [Русский](./README.ru.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [한국어](./README.ko.md) | [עברית](./README.he.md)
+
+
+**cryptoseed** היא ספרייה ברמת ארגונית, קלת משקל ובעלת ביצועים גבוהים, שפותחה ב-**JavaScript טהור** (Node.js) ומיועדת לאבחון, אימות ושחזור של ביטויי מפתח מנמוניים קריפטוגרפיים (*seed phrases*) שאבדו, התבלבלו או הוקלדו עם שגיאות כתיב.
+
+הספרייה פותחה תחת מערכת האבטחה והתשתית של **b2 wallet** ([better2better](https://better2better.net), בהובלת [diegooris](https://diegohorantunes.web.app/)), והיא תוכננה לספק למפתחים ולאנליסטים של אבטחה חוסן מרבי, מהירות חיפוש גבוהה במיוחד ודיוק היסטורי כירורגי בגזירת כתובות ב-**39 רשתות בלוקצ'יין ואקו-سیסטמים שונים**. כל זאת תוך עבודה אוטונומית של 100%, ללא תלות בקומפילציה מקומית של C/C++ או בחבילות חיצוניות שעלולות לפגוע בניידות של ה-build.
+
+---
+
+## 📅 וריאציות של BIP נתמכות וציר זמן היסטורי
+
+כדי לשחזר כספים בדיוק, לא מספיק רק לדעת את המילים; עליך להבין את המפרט הטכני ואת השנה שבה נוצר הארנק. **cryptoseed** מיישמת ומכבדת בקפידה את הסטנדרטים ההיסטוריים (BIPs).
+
+### 🔍 טבלת תקני BIP מיושמים ומתואמים
+
+| BIP | שם התקן | יישום ותמיכה ב-**cryptoseed** |
+| :---: | :--- | :--- |
+| **BIP-32** | *Hierarchical Deterministic Wallets* | **תמיכה מלאה.** הבסיס של עץ הגזירה של HD. מאפשר למנוע לגזור אינסוף נתיבים של מפתחות ציבוריים/פרטיים (`xprv`/`xpub`) מסיד מאסטר יחיד באמצעות מתמטיקה טהורה של עקומות אליפטיות דרך מנוע המפתחות שלנו. |
+| **BIP-39** | *Mnemonic Code* | **תמיכה מלאה.** הסטנדרט הנפוץ בתעשייה. תומך בביטויים של **12, 15, 18, 21 או 24 מילים** עם אימות בדיקת סכום (*checksum*) משולב של 4 עד 8 סיביות ומילונים ב-**10 שפות שונות**. |
+| **BIP-43** | *Purpose Field* | **תמיכה מלאה.** מכבד את המבנה שהציג את שדה הייעוד (`m / purpose'`) בראש עץ הנתיבים, ומבטיח שהמנוע מנתב נכון לארנקים רב-תכליתיים. |
+| **BIP-44** | *Multi-Account* | **תמיכה מלאה.** הסטנדרט הנפוץ ביותר לנתיבי גזירה בתעשייה: `m/44'/coin_type'/account'/change/address_index`. בשימוש כברירת מחדל עבור Bitcoin Legacy, Ethereum, EVM, Solana Legacy, TRON, Cardano Legacy וכד'. |
+| **BIP-45** | *Multisig HD* | **התאמת נתיב.** משמש לארנקי ריבוי חתימות בנתיבי ייעוד `m/45'`. אם אתה משחזר סיד אינדיבידואלי שהוא חלק מהגדרת multisig של BIP-45, המנוע גוזר את המפתחות הפרטיים הבודדים מנתיב זה כרגיל. |
+| **BIP-47** | *Payment Codes* | **תאימות סיד.** קודי תשלום ניתנים לשימוש חוזר ופרטיים (כמו ארנקי Samourai). הגיבוי של ארנקים המשתמשים ב-BIP-47 הוא סיד BIP-39 סטנדרטי של 12 או 24 מילים. **cryptoseed** משחזר את סיד המאסטר הזה בצורה מושלמת. |
+| **BIP-48** | *Multisig Structure* | **תאימות.** מבנה multisig מתקדם המבוסס על BIP-43 באמצעות הנתיב `m/48'/coin_type'/...`. תואם לשחזור סיד המאסטר החותם על עסקאות ריבוי חתימות אלו. |
+| **BIP-49** | *Nested SegWit* | **תמיכה מלאה.** כתובות מעבר של ביטקוין המתחילות בתו `3` (פורמט P2SH-P2WPKH), הנגזרות תחת הנתיב הרשמי `m/49'/0'/0'/0/index`. |
+| **BIP-84** | *Native SegWit* | **תמיכה מלאה.** כתובות ביטקוין מודרניות ובעלות ביצועים גבוהים המתחילות ב-`bc1q` ולייטקוין המתחילות ב-`ltc1` (פורמט Bech32), הנגזרות תחת הנתיב `m/84'/0'/0'/0/index` (ועבור לייטקוין `m/84'/2'/...`). |
+| **BIP-85** | *Child Seeds* | **תאימות מושגית.** מאפשר לסיד מאסטר BIP-39 לייצר סידי בת מאובטחים חדשים (של 12 או 24 מילים) עבור ארנקים אחרים תחת נתיבים כמו `m/85'/...`. אם הסיד האבוד שלך הוא סיד בת שנגזר על ידי BIP-85, המנוע ישחזר אותו כמו כל סיד BIP-39 רגיל. |
+| **BIP-86** | *Taproot* | **תמיכה מלאה.** כתובות ביטקוין מהדור הבא (חתימות Schnorr/Taproot) המתחילות ב-`bc1p` (פורמט Bech32m), הנגזרות תחת נתיב הסטנדרט `m/86'/0'/0'/0/index`. |
+
+---
+
+## ⚡ מדוע נוצר cryptoseed?
+
+כאשר הייתי צריך לשחזר ארנקים עבור לקוחות וחברים של אקו-סיסטם **b2 wallet** / [better2better](https://better2better.net), הבנתי שהכלים הקיימים היו מורכבים מדי (הדרשו קומפילציות מקומיות של C++ ששברו את Node) או שלא הבינו את המעבר ההיסטורי של רשתות הבלוקצ'יין. יצרתי את הספרייה הזו כדי להציע את הפתרונות הבאים:
+
+1.  **אפס תלות מקומית (Pure JS):** עובד ללא כאבי ראש ב-Windows, Linux או macOS. מצוין להידור קבצי הרצה ניידים באמצעות `pkg`.
+2.  **טכנולוגיית "חיתוך אותיות" (Prefix Fallback):** כתבתי אלגוריתם שאם תקליד מילה שגויה כמו `engino`, הוא יחתוך את המילה תו אחר תו (`e-n-g-i-n-o` -> `e-n-g-i-n` -> `engine`) כדי לזהות אוטומטית את המילה הסבירה ביותר במילון הרשמי.
+3.  **טיפול חכם במילים חסרות:** אם האלגוריתם מוצא מילה לא ידועה ללא התאמת תחילית במילון, הוא ממיר אותה אוטומטית לתו כללי (*wildcard* - `*`) כדי לבדוק את כל אפשרויות המילון אחת אחת בצורה אוטומטית.
+4.  **גיזום ענפים מוקדם (Early Branch Pruning):** פיתחתי את מנוע החיפוש עם גיזום מוקדם המבוסס על אילוצים (מילים חובה ומילים לא נכללות - NOK), מה שמונע מהמעבד לחשב מיליארדי פרמוטציות חסרות תועלת.
+5.  **מעקף בדיקת סכום מובנה (Checksum Bypass):** מכיוון שסידי BIP-39 מכילים בדיקות סכום, הקוד פוסל **99.6%** מכל השילובים שנוצרו עוד לפני שהוא מנסה לעשות מתמטיקה כבדה של עקומות אליפטיות, ובכך חוסך זמן מעבד פי 1000.
+
+---
+
+## 🛠️ תכונות שחזור והנדסת חיפוש
+
+פותח במקור בשנת **2023** ככלי בלעדי עבור האקו-סיסטם **b2 wallet** ([better2better](https://better2better.net)), **cryptoseed** הפך לקוד פתוח כדי לספק תשתית שחזור עדיפה מבחינה מדעית על פתרונות השוק הנפוצים. למנוע החיפוש יש את היכולות והיתרונות הבאים:
+
+### 🎯 סימון מצבים לפי מילה
+בניגוד לסקריפטי שחזור פשוטים, האשף האינטראקטיבי מאפשר לך להגדיר את רמת האמון של כל מילה בסיד בנפרד באמצעות שלושה סיווגים סמנטיים:
+* **✔️**: המילה ומיקומה המדויק בסיד מאושרים. המנוע נועל מילה זו וממקד את משאבי העיבוד אך ורק בשאר המיקומים.
+* **🔀**: המילה ידועה ושייכת לקבוצה, אך מיקומה אינו נכון או אינו ודאי. המנוע שוקל מילה זו באופן דינמי עבור פרמוטציות בטוחות רק במיקומים הפנויים הזמינים, ובכך מונע בדיקות כפולות.
+* **🎲**: המילה אבודה לחלוטין או שאינה קריאה. המנוע בודק באופן אוטומטי ומקיף את כל האפשרויות ממילון הפורמט המתאים.
+
+### 📊 עיבוד מקדים והערכת היתכנות
+לפני הוצאת אנרגיית עיבוד כבדה, המנוע מנתח את הסיד ואת האילוצים שסופקו כדי להציג פאנל מתמטי מפורט:
+* **מרחב חיפוש גולמי**: מציג את הסך המתמטי המדויק של השילובים התיאורטיים שיש לקונפיגורציה הנוכחית.
+* **גיזום עץ (סכום ביקורת ומסננים)**: מדווח כמה שילובים נותרו לאחר החלת מסננים לוגיים מהירים (כמו סכומי ביקורת או הגבלות על מילות NOK), מה שמפחית באופן דרסטי את נפח גזירות המפתחות הכבדות.
+* **תחזיות זמן סריקה**: משווה בזמן אמת את הערכת זמן הסריקה בעת שימוש בחיבורים בעלי השהיה ממוצעת (APIs ציבוריים) לעומת חיבורים מקומיים בעלי ביצועים גבוהים (צומת RPC מקומי).
+* **אזהרת אי-היתכנות**: המנוע מזהיר את המשתמש באופן שקוף אם המורכבות המוגדרת דורשת כוח של מחשב-על, ובכך מונע נעילה מיותרת של חומרת המשתמש.
+
+### 🌐 מנועי אימות ופורמטים מרובים
+האקו-סיסטם תומך במבנים קריפטוגרפיים שונים עם כללי אימות ספציפיים לכל פורמט:
+* **מנוע BIP-39**: תומך בסידים של **12, 15, 18, 21 ו-24 מילים**, ומחיל בדיקת תקינות (*checksum*) משולבת כדי לפסול **99.6%** מההשערות השגויות לפני הגזירה.
+* **מנוע Electrum**: אימות וגזירה המבוססים על הכללים הייחודיים של סידי Electrum (Legacy ו-Modern).
+* **מנוע Electron Cash**: התאמה מדויקת של לוגיקת הגזירה ואימות סכומי הביקורת של האקו-סיסטם של Bitcoin Cash.
+* **מצב ללא אימות (Brute Force)**: מנוע גזירה גולמי ללא בדיקת checksum; אידיאלי עבור פורמטים ישנים קנייניים או סידים מותאמים אישית שאינם סטנדרטיים, ומבטיח טווח חיפוש מקסימלי.
+
+### 🧩 פתרון מקרים משולבים מורכבים
+המנוע פותר בעיות מורכבות גבוהה בהרצה אחת, כולל:
+* מילה אחת או יותר שאבדו לחלוטין במיקומים ידועים או לא ידועים.
+* מילים ידועות שסדרן התבלבל.
+* תרחישים מעורבים (למשל: כאשר חסרות מילים ובמקביל המילים הידועות אינן במקומן הנכון).
+* בחירת פרופיל חיפוש: **מהירות מקסימלית** (תוך שימוש בסכומי ביקורת ומגבלות) או **טווח מקסימלי** (כוח גס מתמטי רחב).
+
+---
+
+## ⚙️ התקנה
+
+### התקנה גלובלית (להרצת כלי ה-CLI האינטראקטיבי ישירות במסוף שלך)
+```bash
+npm install -g cryptoseed
+```
+
+### התקנה מקומית (לייבוא הלוגיקה לפרויקט ה-Node שלך)
+```bash
+npm install cryptoseed
+```
+
+---
+
+## 🛡️ כיצד להשתמש בקוד שלך (JavaScript API)
+
+הספרייה מספקת ייצוא נקי ומובנה היטב לשילוב מיידי של לוגיקת האבטחה של **b2 wallet** באפליקציה שלך:
+
+```javascript
+const { wordlists, searchEngine, addressDeriver, typo } = require('cryptoseed');
+
+// 1. תיקון שגיאת הקלדה באמצעות "חיתוך אותיות"
+const dictionary = wordlists.bip39.he || wordlists.bip39.en;
+const wordWithError = "*";
+const suggestions = typo.getPrefixSuggestions(wordWithError, dictionary);
+console.log("המילה שנגזרה:", suggestions); // מחזיר [ 'engine' ]
+
+// 2. גזירת כתובת ציבורית אמיתית עבור MetaMask (EVM)
+const seed = "cabin engine harvest fiction witness walnut ladder tumble insect fox notable spoon";
+const ethAddress = addressDeriver.deriveAddress(seed, 'metamask', 'ETH', 0);
+console.log("כתובת Ethereum:", ethAddress);
+
+// 3. גזירת כתובת מותאמת אישית באמצעות קריפטוגרפיה של B2 Wallet
+const b2Address = addressDeriver.deriveAddress(seed, 'b2wallet', 'BTC', 0);
+console.log("כתובת Bitcoin ב-B2 Wallet:", b2Address);
+```
+
+---
+
+## 💻 CLI אינטראקטיבי
+
+פשוט הקלד את הפקודה הראשית במסוף שלך ופעל לפי המדריך:
+```bash
+cryptoseed
+```
+
+### פקודות עזרה והיסטוריה
+
+*   **עזרה מהירה (`-h` או `--help`):** מציג את מדריך השימוש ואת אפשרויות שורת הפקודה.
+    ```bash
+    cryptoseed --help
+    ```
+*   **לקט מידע (`-i` או `--info`):** מציג סיכום היסטורי מלא של כל רשת בלוקצ'יין נתמכת, נתיבי הסטנדרט המשמשים לפי שנה והארנקים התואמים. מצוין כדי להבין היכן עשויים להיות מאוחסנים כספים ישנים!
+    ```bash
+    cryptoseed --info
+    ```
+
+---
+
+## 🧮 המתמטיקה שמאחורי וגבולות היתכנות
+
+אם איבדת את הסיד שלך, עליך להיות מציאותי לגבי ההסתברויות. כתבתי את המנוע כך שיציג התראות מציאותיות לפני תחילת חיפוש כבד כלשהו:
+
+### טבלת שילובים של BIP-39 (מילון של 2048 מילים)
+
+| מילים אבודות | חישוב שילובים | סך כל האפשרויות | היתכנות אמיתית |
+| :---: | :---: | :---: | :--- |
+| **מילה אחת** | $2048^1$ | **2,048** | **קביל לחלוטין** (חלקי שנייה בכל מעבד) |
+| **2 מילים** | $2048^2$ | **4,194,304** | **קביל** (שניות בודדות עם המנוע המותאם שלנו) |
+| **3 מילים** | $2048^3$ | **8,589,934,592** | **כבד מאוד** (קביל אם אתה יודע את המיקומים או שיש לך אילוצים) |
+| **4 מילים** | $2048^4$ | **17,592,186,044,416** | **לא קביל** למחשבים רגילים (ייקח שבועות/חודשים) |
+| **5 מילים** | $2048^5$ | **36,028,797,018,963,968**| **בלתי אפשרי מתמטית** (דורש מחשבי על) |
+
+---
+
+## 📊 מטריצת רשתות בלוקצ'יין וארנקים נתמכים (39 רשתות)
+
+להלן הרשימה המלאה והמפורטת של כל 39 הרשתות והאקו-סיסטמים הנתמכים באופן מקומי על ידי מנוע הגזירה של **cryptoseed**, המבטיחה תאימות לאחור ותאימות עכשווית:
+
+| אקו-סיסטם / רשת | סמל | נתיב גזירת ברירת מחדל (HD Path) | ארנקי ייחוס תואמים |
+| :--- | :---: | :--- | :--- |
+| **Bitcoin** | BTC | `m/84'/0'/0'/0/i` (Native SegWit)<br>`m/49'/0'/0'/0/i` (Nested SegWit)<br>`m/44'/0'/0'/0/i` (Legacy)<br>`m/86'/0'/0'/0/i` (Taproot) | B2 Wallet, Electrum, Trust Wallet, Ledger, Trezor |
+| **Ethereum** | ETH | `m/44'/60'/0'/0/i` | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **BNB Chain** | BNB | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Polygon** | MATIC | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Arbitrum** | ARB | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Optimism** | OP | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Avalanche** | AVAX | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, Core, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Base** | BASE | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Fantom** | FTM | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Cronos** | CRO | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet, Ledger, Trezor |
+| **Harmony** | ONE | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Trust Wallet |
+| **Gnosis Chain** | GNOSIS | `m/44'/60'/0'/0/i` (EVM) | B2 Wallet, MetaMask, Rabby, Trust Wallet, Ledger, Trezor |
+| **Solana** | SOL | `m/44'/501'/0'/0'` (Phantom Standard)<br>`m/44'/501'/0'/0/i` (Sollet/Legacy) | B2 Wallet, Phantom, Sollet, Solflare, Trust Wallet |
+| **Cardano** | ADA | `m/1852'/1815'/0'/0/i` (Shelley Native)<br>`m/44'/1815'/0'/0/i` (Byron Legacy) | Yoroi, Daedalus, Eternl, Lace |
+| **TRON** | TRX | `m/44'/195'/0'/0/i` | B2 Wallet, TronLink, Trust Wallet, Ledger, Trezor |
+| **Waves** | WAVES | `m/44'/5741564'/0'/0/i` | Waves Keeper, Waves Client |
+| **Stellar** | XLM | `m/44'/148'/0'/0/i` | Lobstr, Stellar Wallet, Ledger |
+| **Ripple** | XRP | `m/44'/144'/0'/0/i` | Toast Wallet, Xumm, Ledger, Trezor |
+| **Polkadot** | DOT | `m/44'/354'/0'/0'/0'` (Substrate Path) | Polkadot.js, Talisman, Fearless |
+| **Kusama** | KSM | `m/44'/434'/0'/0'/0'` (Kusama Path) | Polkadot.js, Talisman, Fearless |
+| **Cosmos** | ATOM | `m/44'/118'/0'/0/i` | Keplr, Cosmostation, Ledger |
+| **Osmosis** | OSMO | `m/44'/118'/0'/0/i` | Keplr, Cosmostation, Ledger |
+| **Secret Network** | SCRT | `m/44'/529'/0'/0/i` | Keplr, Cosmostation |
+| **Injective** | INJ | `m/44'/60'/0'/0/i` (Keccak-256) | Keplr, MetaMask, Leap |
+| **Hedera** | HBAR | `m/44'/3030'/0'/0/i` | Hashpack, Blade Wallet |
+| **NEM** | XEM | `m/44'/43'/0'/0/i` | NEM Wallet |
+| **Chia** | XCH | `m/44'/8444'/0'/0/i` | Chia Wallet |
+| **Tezos** | XTZ | `m/44'/1729'/0'/0/i` | Temple, Kukai, Ledger |
+| **Algorand** | ALGO | `m/44'/283'/0'/0'/0'` | Pera Wallet, Defly Wallet |
+| **Near** | NEAR | `m/44'/397'/0'/0'/0'` | MyNearWallet, Sender Wallet |
+| **Sui** | SUI | `m/44'/784'/0'/0'/0'` | Sui Wallet, Suiet, Trust Wallet |
+| **Aptos** | APT | `m/44'/637'/0'/0'/0'` | Petra Wallet, Pontem, Martian |
+| **Litecoin** | LTC | `m/84'/2'/0'/0/i` (Native SegWit)<br>`m/44'/2'/0'/0/i` (Legacy) | B2 Wallet, Electrum LTC, Trust Wallet, Ledger |
+| **Dogecoin** | DOGE | `m/44'/3'/0'/0/i` | B2 Wallet, Multidoge, Trust Wallet, Ledger, Trezor |
+| **Bitcoin Cash** | BCH | `m/44'/145'/0'/0/i` | B2 Wallet, Electron Cash, Trust Wallet, Ledger |
+| **Dash** | DASH | `m/44'/5'/0'/0/i` | B2 Wallet, Dash Core, Trust Wallet, Ledger |
+| **Zcash** | ZEC | `m/44'/133'/0'/0/i` | B2 Wallet, Trust Wallet, Ledger |
+| **Kaspa** | KAS | `m/44'/111111'/0'/0/i` | Kaspium, Kaspa Web Wallet |
+| **Monero** | XMR | `m/44'/128'/0'/0/i` | Cake Wallet, Monerujo, GUI Wallet |
+
+---
+
+## 🛠️ ביצועים: צומת RPC מקומי לעומת API ציבורי
+
+בסוף כל חיפוש, **cryptoseed** שומר דוח שחזור מפורט בדיסק שלך (`resultado_recuperacao_[timestamp].txt`) ומספק הערכה אמיתית של מהירות השאילתה כדי לבדוק אם לסידים שנמצאו יש יתרה ברשת:
+
+*   **שאילתה באמצעות ממשקי API ציבוריים (50 מילישנייה לבקשה):** שימושי רק אם יש לך מעט מאוד סידים מועמדים ($<100$). סובל מהשהיית אינטרנט וחסימת מגבלות בקשות.
+*   **שאילתה באמצעות צומת RPC מקומי (0.1 מילישנייה לבקשה):** הדרך האידיאלית לחיפושים חזקים ($>1000$ סידים). מפחית את זמן הסריקה הכולל עד **פי 500** על ידי הרצה מקומית על המחשב שלך.
+
+---
+
+## 🎓 ביצת פסחא של עידן סאטושי (2009 - 2010)
+
+אם תנסה לבחור במדריך שהארנק שלך נוצר בשנת **2010 או לפני כן**, התוכנית תפסיק את הריצה ותגלה לך סוד היסטורי: **בעידן בראשית זה, ביטויי מפתח מנמוניים לשחזור לא היו קיימים!**
+הלקוח המקורי של סאטושי נאקאמוטו (Bitcoin-Qt) השתמש במפתחות פרטיים אקראיים שנשמרו בקובץ הבינארי `wallet.dat`. אם איבדת את הקובץ הזה, שום ביטוי של מילים לא יוכל לשחזר את הכספים, מכיוון שהסיד הדטרמיניסטי פשוט לא הומצא עדיין!
+
+---
+
+## 🛡️ רישיון, אבטחה וממשל
+
+ספרייה זו פועלת **100% במצב לא מקוון ומקומי** במחשב שלך. הקוד פתוח, נקי ואינו מבצע שום בקשת רשת כדי להעביר את המילים או המפתחות הפרטיים שלך. בטיחות קודמת לכל.
+
+*   **רישיון:** MIT (נוצר בשנת 2023)
+*   **קרדיטים:** פרויקט **b2 wallet** / [better2better](https://better2better.net) / [diegooris](https://diegohorantunes.web.app/).