Anleitung

Übersicht

Diese Anleitung zeigt, wie Sie mit der OneKey-Provider-API einfach Webanwendungen erstellen, die mit BTC interagieren können.

Installieren

1. OneKey Wallet herunterladen

Laden Sie OneKey Wallet . Installieren Sie die OneKey-Browsererweiterung.

2. Erklärung der API-Injektion

• Die OneKey-Browsererweiterung injiziert Provider API in besuchte Websites.
• Es werden zwei API-Typen bereitgestellt: window.unisat und window.$onekey.btc.
• Empfohlen wird window.$onekey.btc.

Bevorzugen Sie window.$onekey.btc, um gezielt OneKey auszuwählen. Die globale Variable window.unisat kann zu einer anderen Wallet gehören, wenn mehrere Erweiterungen installiert sind.

Unterstützung der Provider-API erkennen

Prüfen Sie vor Anfragen, ob ein Provider verfügbar ist:

const provider = (window.$onekey && window.$onekey.btc) || window.unisat;
 
if (!provider) {
  throw new Error("No Bitcoin provider is available.");
}

Mit OneKey verbinden

Bevor Sie die folgende API verwenden, müssen Sie zuerst mit der Methode provider.requestAccounts beim Nutzer Zugriff auf das entsprechende BTC-Konto anfordern.

await provider.requestAccounts();

Andere APIs können erst nach Autorisierung durch den Nutzer aufgerufen werden.

API

Wählen Sie die API für den Vorgang, den Ihre Anwendung benötigt.

• Kontoinformationen des Nutzers abrufen: provider.getAccounts
• Zahlung senden: provider.sendBitcoin
• Signatur für eine beliebige Nachricht anfordern: provider.signMessage

Weitere Schnittstellen: Details anzeigen

Ereignis

• Wichtige Vorgänge: Zum Beispiel Kontowechsel
• Weitere Informationen: Mehr anzeigen

Anfragen behandeln

Führen Sie Wallet-Anfragen in einer asynchronen Funktion oder einem ES-Modul aus. Fangen Sie abgelehnte Promises ab und zeigen Sie den Fehler in Ihrer Anwendung an. Fordern Sie Verbindungen, Signaturen und Zahlungen über eine Nutzeraktion an und deaktivieren Sie die auslösende Schaltfläche, solange eine Anfrage aussteht.