Comment connecter Ledger à Cosmos Hub ? (Tutoriel Keplr)

Conditions préalables à l'intégration du grand livre

1. Un appareil Ledger Nano S ou Nano X avec la version 2.0 ou supérieure du micrologiciel installé.

2. L'application Ledger Live mise à jour vers la dernière version stable.

3. L'application Cosmos installée et ouverte sur l'appareil Ledger.

4. Extension de navigateur Keplr version 10.9.0 ou ultérieure, compatible avec Chrome, Edge ou Brave.

5. Une connexion Internet stable et un système d'exploitation pris en charge (Windows 10+, macOS 11+ ou Linux avec les règles udev configurées).

Installation et configuration de l'application Cosmos sur Ledger

1. Connectez l'appareil Ledger à votre ordinateur à l'aide du câble USB d'origine.

2. Ouvrez Ledger Live et accédez à la section Gestionnaire.

3. Assurez-vous que l'appareil est déverrouillé et dans la vue du tableau de bord. N'entrez aucune phrase secrète sauf si cela est nécessaire.

4. Recherchez « Cosmos » dans le catalogue d'applications et cliquez sur Installer.

5. Attendez la fin de l'installation et vérifiez que l'icône Cosmos apparaît sur l'écran d'accueil de Ledger.

Configuration de Keplr avec la prise en charge matérielle de Ledger

1. Visitez https://www.keplr.app et téléchargez l'extension officielle Keplr.

2. Ajoutez l'extension à votre navigateur et redémarrez le navigateur après l'installation.

3. Cliquez sur l'icône Keplr dans la barre d'outils du navigateur et sélectionnez « Commencer ».

4. Choisissez « Portefeuille matériel » lorsque vous êtes invité à indiquer le type de portefeuille.

5. Sélectionnez « Ledger » dans les options matérielles et confirmez l'invite de connexion sur votre appareil Ledger.

Ajout du réseau Cosmos Hub dans Keplr

1. Dans Keplr, ouvrez le menu des paramètres réseau et localisez « Ajouter un réseau ».

2. Collez le JSON de configuration officielle de la chaîne Cosmos Hub ou saisissez manuellement les éléments suivants : ID de chaîne cosmoshub-4 , URL RPC https://rpc.cosmos.network , URL REST https://api.cosmos.network .

3. Réglez la dénomination de la pièce sur ATOM et les décimales sur 6.

4. Confirmez l'ajout du réseau et attendez que Keplr récupère les paramètres de la chaîne.

5. Vérifiez que le réseau Cosmos Hub apparaît dans la liste déroulante du sélecteur de réseau avec les indicateurs d'état corrects.

Dépannage des échecs de connexion courants

1. Si Keplr ne parvient pas à détecter le Ledger, assurez-vous que l'application Cosmos est en cours d'exécution (et pas seulement installée) et que l'appareil reste déverrouillé.

2. Désactivez les extensions de navigateur susceptibles d'interférer avec la communication USB, telles que les bloqueurs de publicités ou les outils de confidentialité.

3. Sur les systèmes Linux, confirmez que les règles udev sont appliquées en exécutant sudo cp 85-ledger.rules /etc/udev/rules.d/ et en rechargeant les règles.

4. Videz le cache de Keplr via Paramètres > Avancé > Réinitialiser les données du compte si les adresses de compte ne se chargent pas.

5. Évitez d'utiliser des forks Cosmos ou des réseaux de test tiers étiquetés « cosmoshub-4 » : seul le point de terminaison canonique du réseau principal est vérifié pour la signature du grand livre.

Foire aux questions

Q : Puis-je utiliser mon Ledger avec plusieurs chaînes basées sur Cosmos simultanément ? Oui. Keplr prend en charge les comptes multi-chaînes. Chaque chaîne nécessite son propre chemin de dérivation, mais Ledger stocke la graine principale en toute sécurité sur tous les réseaux compatibles.

Q : Pourquoi ma transaction affiche-t-elle indéfiniment « En attente de confirmation du grand livre » ? Cela se produit lorsque l'appareil Ledger est verrouillé, que l'application Cosmos est fermée ou que l'utilisateur n'a pas approuvé la demande de signature sur l'écran de l'appareil dans les 60 secondes.

Q : Est-il sûr d'exporter mon adresse publique Ledger depuis Keplr ? Oui. Les adresses publiques ne sont pas sensibles. Keplr affiche uniquement les identifiants en lecture seule ; les clés privées ne quittent jamais la puce Ledger.

Q : Keplr prend-il en charge Ledger Stax pour Cosmos Hub ? À partir du firmware actuel, Ledger Stax n'est pas officiellement pris en charge par l'application Cosmos. Les utilisateurs doivent s'appuyer sur Nano S ou Nano X jusqu'à ce que Ledger publie une mise à jour de la compatibilité de l'application Cosmos.