So verbinden Sie Tonkeeper mit einer TON-dApp

Wallet-Vorbereitung und Netzwerküberprüfung

1. Installieren Sie die offizielle Tonkeeper-Anwendung von tonkeeper.com oder verifizierten App-Stores für iOS, Android oder Desktop-Plattformen.

2. Starten Sie Tonkeeper und bestätigen Sie, dass es im TON-Hauptnetz läuft. Überprüfen Sie dies, indem Sie die Netzwerkanzeige in der oberen Leiste überprüfen. Wenn „Testnet“ angezeigt wird, rufen Sie die Einstellungen auf, tippen Sie fünfmal auf das Tonkeeper-Logo, um das Entwicklermenü zu öffnen, und wechseln Sie dann zum Mainnet.

3. Stellen Sie sicher, dass das Wallet mindestens 0,1 TON enthält, um die anfänglichen Transaktionsgebühren und Vertragsbereitstellungskosten zu decken, die für die meisten dApps erforderlich sind.

4. Sichern Sie die 24-Wörter-Wiederherstellungsphrase an einem sicheren Offline-Speicherort – dieser Schritt ist unumkehrbar und vor jeder Interaktion in der Kette obligatorisch.

5. Stellen Sie sicher, dass keine Erweiterungen oder Overlays von Drittanbietern die Darstellung der Benutzeroberfläche oder die Signaturaufforderungen des Wallets beeinträchtigen.

Verbindungsinitiierung über die dApp-Schnittstelle

1. Navigieren Sie mit einem unterstützten Browser wie Chrome, Edge oder Safari und aktiviertem JavaScript zur Ziel-TON-basierten dApp.

2. Suchen Sie die Schaltfläche „Wallet verbinden“ und klicken Sie darauf – normalerweise in der oberen rechten Ecke der dApp-Oberfläche.

3. Wählen Sie „Tonkeeper“ aus der angezeigten Wallet-Liste; Vermeiden Sie das Scannen von QR-Codes, es sei denn, der Verbindungsablauf der dApp weist ausdrücklich darauf hin.

4. In Tonkeeper erscheint ein Popup-Fenster, in dem Sie um Erlaubnis gebeten werden, Ihre öffentliche Adresse weiterzugeben und eine Sitzungsanfrage zu signieren. Tippen Sie auf „Genehmigen“.

5. Die dApp zeigt Ihre verbundene Adresse an und löst möglicherweise eine automatische Balance-Synchronisierung aus; Es wird niemals ein privater Schlüssel oder eine Seed-Phrase übertragen.

Adressformat und Kompatibilitätsbehandlung

1. Tonkeeper generiert Adressen standardmäßig im Bounce-Format (z. B. EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 ), das die automatische Fehlerkorrektur unterstützt und für Interaktionen mit Benutzerkontakt bevorzugt wird.

2. Einige dApps erfordern nicht-bouncebare Adressen für Smart-Contract-Aufrufe – Tonkeeper bietet beide Varianten unter „Kontoinformationen“ > „Adresse kopieren“ > Umschaltoption.

3. Stellen Sie sicher, dass die dApp die Komponenten Arbeitsketten-ID (0 für Basiskette) und Konto-ID korrekt analysiert. Eine nicht übereinstimmende Arbeitskettenverarbeitung führt zu stillen Verbindungsfehlern.

4. Wenn die dApp das TonConnect-Protokoll v2 verwendet, stellen Sie sicher, dass die Tonkeeper-Version ≥4.12.0 ist – ältere Versionen bieten keine Unterstützung für Sitzungs-Handshakes mit mehreren Signaturen.

5. Bearbeiten oder kürzen Sie Adresszeichenfolgen nicht manuell – die Prüfsumme und die Präfixkodierung sind kryptografisch an den zugrunde liegenden öffentlichen Schlüssel gebunden.

Signatur- und Transaktionsautorisierungsablauf

1. Beim Initiieren einer Transaktion oder Datensignaturanforderung sendet die dApp eine strukturierte Nutzlast mit Methodennamen, Parametern und Ablaufzeitstempel.

2. Tonkeeper zeigt einen nativen Bestätigungsbildschirm an, der den genauen Vorgangstyp ( sendMessage oder signData ), die Zieladresse, den Betrag und das angehängte Memo anzeigt.

3. Benutzer müssen jede Aktion explizit genehmigen – Batch-Genehmigungen oder automatische Signaturrichtlinien sind konstruktionsbedingt nicht zulässig.

4. Nach der Genehmigung berechnet Tonkeeper die Ed25519-Signatur über die kanonisierte Nutzlast und sendet sie zusammen mit dem signierten Nachrichten-Hash an die dApp zurück.

5. Fehlgeschlagene Signaturen führen immer zu einer sofortigen Ablehnung auf Blockchain-Ebene; Es findet keine Teil- oder Fallback-Ausführung statt.

Fehlerbehebung bei häufigen Verbindungsfehlern

1. Wenn das Wallet nicht in der Connector-Liste angezeigt wird, leeren Sie den Browser-Cache und deaktivieren Sie Werbeblocker oder Datenschutzerweiterungen, die WebSockets oder injizierte Skripte filtern.

2. Anhaltende „Ungültige Sitzung“-Fehler weisen auf eine abgelaufene TonConnect-Kopplung hin – stellen Sie die Verbindung wieder her, indem Sie in der dApp auf „Wallet trennen“ klicken, und stellen Sie dann die Verbindung erneut her.

3. Leere oder eingefrorene Bestätigungsmodalitäten stammen normalerweise von veralteten Tonkeeper-Versionen – Aktualisierung über den offiziellen App Store oder tonkeeper.com/download.

4. Adresskonflikte zwischen der dApp-Anzeige und den „Kontoinformationen“ von Tonkeeper deuten auf einen falschen Netzwerkkontext hin – überprüfen Sie noch einmal, ob sowohl das dApp-Backend als auch das Wallet auf identischen TON-Netzwerkendpunkten funktionieren.

5. Wiederholte Timeout-Meldungen während Signaturanfragen deuten auf ein instabiles lokales Internet oder eine WebSocket-Blockierung auf ISP-Ebene hin. Wechseln Sie zu mobilen Daten oder aktivieren Sie den Tor-Modus in den Tonkeeper-Einstellungen.

Häufig gestellte Fragen

F: Kann ich Tonkeeper ohne erneute Genehmigung gleichzeitig mit mehreren dApps verbinden? A: Ja – Tonkeeper verwaltet persistente Sitzungsschlüssel pro dApp-Domäne; Für jeden neuen Ursprung ist eine einmalige Kopplung erforderlich. Bei nachfolgenden Interaktionen wird die erneute Authentifizierung jedoch übersprungen, sofern sie nicht manuell widerrufen wird.

F: Gewährt die Verbindung zu einer dApp Zugriff auf meinen Transaktionsverlauf oder meine Kontostandsdetails? A: Nein – nur die öffentliche Adresse wird geteilt; Alle Kontostand- und Verlaufsabfragen müssen über TON-API-Endpunkte durchgeführt werden, die durch die Zustimmung des Benutzers und explizite RPC-Aufrufe gesteuert werden.

F: Warum wird bei manchen dApps „Unsupported Wallet“ angezeigt, selbst wenn Tonkeeper ausgewählt ist? A: Dies tritt auf, wenn die dApp ältere TonConnect v1- oder benutzerdefinierte RPC-Wrapper erzwingt, die nicht mit der aktuellen Adapterschicht von Tonkeeper kompatibel sind. Sehen Sie in der Dokumentation der dApp nach, welche SDK-Mindestversionen unterstützt werden.

F: Ist es sicher, Tonkeeper mit dApps zu verbinden, die auf Nicht-HTTPS-Domänen gehostet werden? A: Nein – Tonkeeper blockiert Verbindungen zu HTTP-Ursprüngen vollständig; Nur TLS-gesicherte Domänen mit gültigen Zertifikaten dürfen Wallet-Sitzungen initiieren.