Comment connecter Tonkeeper à une dApp TON

Préparation du portefeuille et vérification du réseau

1. Installez l'application officielle Tonkeeper depuis tonkeeper.com ou dans des magasins d'applications vérifiés pour les plates-formes iOS, Android ou de bureau.

2. Lancez Tonkeeper et confirmez qu'il fonctionne sur le réseau principal TON. Vérifiez-le en vérifiant l'indicateur de réseau dans la barre supérieure ; s'il affiche « Testnet », accédez aux paramètres, appuyez cinq fois sur le logo Tonkeeper pour ouvrir le menu développeur, puis basculez vers le réseau principal.

3. Assurez-vous que le portefeuille contient au moins 0,1 TON pour couvrir les frais de transaction initiaux et les coûts de déploiement du contrat requis par la plupart des dApps.

4. Sauvegardez la phrase de récupération de 24 mots dans un emplacement hors ligne sécurisé : cette étape est irréversible et obligatoire avant toute interaction en chaîne.

5. Confirmez qu'aucune extension ou superposition tierce n'interfère avec le rendu de l'interface utilisateur ou les invites de signature du portefeuille.

Initiation de connexion via l'interface dApp

1. Accédez à la dApp cible basée sur TON à l'aide d'un navigateur pris en charge tel que Chrome, Edge ou Safari avec JavaScript activé.

2. Localisez et cliquez sur le bouton « Connecter le portefeuille », généralement positionné dans le coin supérieur droit de l'interface dApp.

3. Sélectionnez « Tonkeeper » dans la liste des portefeuilles affichée ; évitez de scanner les codes QR, sauf indication explicite du flux de connexion de la dApp.

4. Une fenêtre contextuelle apparaîtra dans Tonkeeper vous demandant l'autorisation de partager votre adresse publique et de signer une demande de session : appuyez sur « Approuver ».

5. La dApp affichera votre adresse connectée et pourra déclencher une synchronisation automatique du solde ; aucune clé privée ou phrase de départ n'est jamais transmise.

Format d’adresse et gestion de la compatibilité

1. Tonkeeper génère des adresses au format rebondissant par défaut (par exemple, EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 ), qui prend en charge la correction automatique des erreurs et est préféré pour les interactions face à l'utilisateur.

2. Certaines dApps nécessitent des adresses non rebondissantes pour les appels de contrats intelligents. Tonkeeper propose les deux variantes sous « Informations sur le compte » > « Copier l'adresse » > option de bascule.

3. Vérifiez que la dApp analyse correctement les composants de l'ID de chaîne de travail (0 pour la chaîne de base) et de l'ID de compte ; une gestion incompatible de la chaîne de travail provoque des échecs de connexion silencieux.

4. Si le dApp utilise le protocole TonConnect v2, assurez-vous que la version de Tonkeeper est ≥4.12.0 : les anciennes versions ne prennent pas en charge les négociations de session multi-signatures.

5. Ne modifiez pas ou ne tronquez pas manuellement les chaînes d'adresse : la somme de contrôle et le codage du préfixe sont liés cryptographiquement à la clé publique sous-jacente.

Flux de signature et d’autorisation de transaction

1. Lors du lancement d'une demande de transaction ou de signature de données, la dApp envoie une charge utile structurée contenant le nom de la méthode, les paramètres et l'horodatage d'expiration.

2. Tonkeeper affiche un écran de confirmation natif affichant le type d'opération exact ( sendMessage ou signData ), l'adresse de destination, le montant et le mémo joint.

3. Les utilisateurs doivent approuver explicitement chaque action : aucune approbation par lots ni politique de signature automatique n'est autorisée par conception.

4. Après approbation, Tonkeeper calcule la signature Ed25519 sur la charge utile canonisée et la renvoie avec le hachage du message signé à la dApp.

5. Les signatures échouées entraînent toujours un rejet immédiat au niveau de la blockchain ; aucune exécution partielle ou de secours ne se produit.

Dépannage des échecs de connexion courants

1. Si le portefeuille n'apparaît pas dans la liste des connecteurs, videz le cache du navigateur et désactivez les bloqueurs de publicités ou les extensions de confidentialité qui filtrent les WebSockets ou les scripts injectés.

2. Les erreurs persistantes de « Session invalide » indiquent un couplage TonConnect expiré : reconnectez-vous en cliquant sur « Déconnecter le portefeuille » dans la dApp, puis relancez la connexion.

3. Les modalités de confirmation vierges ou gelées proviennent généralement de versions obsolètes de Tonkeeper : mise à jour via l'App Store officiel ou tonkeeper.com/download.

4. Les incohérences d'adresse entre l'affichage de dApp et les « Informations de compte » de Tonkeeper suggèrent un contexte réseau incorrect : vérifiez à nouveau que le backend et le portefeuille de dApp fonctionnent sur des points de terminaison de réseau TON identiques.

5. Les messages d'expiration répétés lors des demandes de signature indiquent un Internet local instable ou un blocage de WebSocket au niveau du FAI : passez aux données mobiles ou activez le mode Tor dans les paramètres de Tonkeeper.

Foire aux questions

Q : Puis-je connecter Tonkeeper à plusieurs dApps simultanément sans nouvelle approbation ? R : Oui : Tonkeeper conserve des clés de session persistantes par domaine dApp ; chaque nouvelle origine nécessite un appariement unique, mais les interactions ultérieures ignorent la réauthentification à moins d'être révoquées manuellement.

Q : La connexion à une dApp lui donne-t-elle accès à l'historique de mes transactions ou aux détails de mon solde ? R : Non : seule l'adresse publique est partagée ; toutes les requêtes de solde et d'historique doivent être effectuées via des points de terminaison de l'API TON contrôlés par le consentement de l'utilisateur et des appels RPC explicites.

Q : Pourquoi certaines dApp affichent-elles « Portefeuille non pris en charge » même lorsque Tonkeeper est sélectionné ? R : Cela se produit lorsque la dApp applique les anciens wrappers TonConnect v1 ou RPC personnalisés incompatibles avec la couche d'adaptateur actuelle de Tonkeeper : consultez la documentation de la dApp pour connaître les versions minimales du SDK prises en charge.

Q : Est-il sûr de connecter Tonkeeper à des dApps hébergées sur des domaines non HTTPS ? R : Non : Tonkeeper bloque entièrement les connexions aux origines HTTP ; seuls les domaines sécurisés TLS avec des certificats valides sont autorisés à lancer des sessions de portefeuille.