Auf dieser Seite
Integration auswählen
Beginnen Sie damit, womit sich Ihre Anwendung verbinden soll. Wallet-Provider-API, Hardware-SDK und QR-SDK dienen unterschiedlichen Integrationswegen.
| Sie möchten … | Verwenden Sie | Hier beginnen |
|---|---|---|
| Nutzern ermöglichen, ihre OneKey-Wallet mit einer Website oder dApp zu verbinden | Einen chainspezifischen Wallet-Provider oder eine Wallet-UI-Bibliothek | Schnellstart für dApps |
| Ihre eigene Wallet oder App direkt mit einem OneKey-Gerät verbinden | Hardware-SDK mit einem Transport für Ihre Laufzeit | Hardware-SDK-Schnellstart |
| Signieranfragen mit einem QR-fähigen Gerät austauschen | Air-Gap-SDK | Übersicht zum Signieren per QR-Code |
Eine dApp-Integration bittet die OneKey-Wallet, die Konten und den Signierablauf des Nutzers zu verwalten. Bei einer direkten Hardware-Integration ist Ihre Anwendung für Geräteerkennung, Verbindungsstatus, UI-Ereignisse und Transaktionsvorbereitung verantwortlich.
Eine dApp verbinden
- Installieren Sie OneKey in Ihrer Entwicklungsumgebung.
- Befolgen Sie Schnellstart für dApps, um den Provider zu erkennen und Konten über eine Nutzeraktion anzufordern.
- Wählen Sie Ihre Chain in der Provider-API-Referenz. Methoden und Rückgabewerte unterscheiden sich je nach Chain.
- Behandeln Sie eine fehlende Wallet, eine leere Kontoliste, eine abgelehnte Anfrage sowie Konto- oder Netzwerkänderungen.
Wenn Ihre Anwendung bereits eine Wallet-UI-Bibliothek verwendet, beginnen Sie mit deren OneKey-Integration. Für die Übergabe an Mobilgeräte lesen Sie Mobilgeräte und Deeplinks.
Hardware direkt verbinden
Wählen Sie Ihre Laufzeit, bevor Sie ein SDK installieren:
| Laufzeit | Anleitung |
|---|---|
| Browser mit WebUSB-Unterstützung | WebUSB |
| React Native mit Bluetooth | React Native BLE |
| Natives Android, iOS oder Flutter | Native mobile Integration |
Folgen Sie dann dem Schnellstart. Initialisieren Sie das SDK, behandeln Sie seine UI-Anfragen, wählen Sie ein Gerät und rufen Sie eine Adresse ab, bevor Sie zum Signieren übergehen. Prüfen Sie Geräte- und Chain-Unterstützung für die genaue Methode und das Gerät, die Sie verwenden möchten.
Die Hardware-Testumgebung eignet sich zum Erkunden der APIs. Ein Emulator oder ein erfolgreicher Build ersetzt keine Tests Ihrer Integration mit dem vorgesehenen Gerät, der Firmware und der Laufzeit.
QR-Signieren verwenden
Beginnen Sie mit der Air-Gap-Übersicht, folgen Sie dann einer chainspezifischen Anleitung wie Ethereum und EVM. Ihre App kodiert eine Anfrage, zeigt sie als QR-Daten an, liest die Geräteantwort und validiert das Ergebnis, bevor sie es über ihre eigene Netzwerkverbindung überträgt.
Vor der Veröffentlichung
- Testen Sie Ablehnung, Abbruch, Trennung und Wiederverbindung sowie den Erfolgsfall.
- Zeigen Sie das verwendete Konto und Netzwerk an. Geben Sie dem Nutzer weiterhin die Möglichkeit, Signieranfragen zu prüfen.
- Erfassen Sie niemals Wiederherstellungsphrasen oder private Schlüssel. Halten Sie PINs, Passphrasen, Tokens und Wallet-Sitzungsdaten aus Protokollen und Fehlerberichten heraus.
- Legen Sie die in Ihrer Integration verwendeten Versionen fest und dokumentieren Sie sie. Testen Sie nach SDK-, Firmware- oder Wallet-Upgrades erneut.
- Verwenden Sie die Anleitung zur Fehlerbehebung, wenn eine Anfrage fehlschlägt oder hängen bleibt.