← Blog
10 Min. Lesezeit
|
Veröffentlicht
|
Aktualisiert

BNB-Smart-Chain-API: Was Sie damit bauen können

Was eine BNB-Smart-Chain-API (BSC) bietet: Wallets, BNB- und BEP-20-Transfers, Salden und Webhooks, mit Beispielen und den Grenzen öffentlicher RPC-Endpunkte.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Eine BNB-Smart-Chain-API ist eine Web-Schnittstelle für BNB Smart Chain (BSC), früher Binance Smart Chain. Sie erlaubt einer Anwendung, Wallets anzulegen, BNB und BEP-20-Token zu senden, Salden zu lesen und Einzahlungen zu melden, ohne einen BSC-Node zu betreiben. Ihr Backend sendet HTTPS-Anfragen. Der Anbieter übernimmt Signierung, Übertragung und Zugriff auf die Chain.

Dieser Artikel listet auf, was eine solche API abdeckt. Er zeigt zwei Anfragen an die BSC-Endpunkte von Chaingateway und erklärt, wann öffentliche RPC-Endpunkte genügen.

Was deckt eine BSC-API ab?

Eine BSC-API deckt die Vorgänge ab, die ein Zahlungs- oder Wallet-Backend braucht. Die Chaingateway-Endpunkte, wie sie in der OpenAPI-Datei stehen, fallen in fünf Gruppen:

GruppeEndpunkte
AdressenPOST /api/v2/bsc/addresses erstellt eine Wallet, GET listet Wallets, POST /api/v2/bsc/addresses/import importiert einen privaten Schlüssel
SaldenGET /api/v2/bsc/balances/{address} für BNB, GET /api/v2/bsc/balances/{address}/bep20/{contract_address} für einen BEP-20-Token
TransfersPOST /api/v2/bsc/transactions für BNB, POST /api/v2/bsc/transactions/bep20 für BEP-20-Token, POST /api/v2/bsc/transactions/bep721 für NFTs
Chain-DatenNeuester Block, Block nach Nummer oder Hash, Transaktion, Receipt, Gaspreis, NFT-Besitzer und Token-URI
WebhooksWebhooks anlegen, aktualisieren und löschen, Benachrichtigungen und fehlgeschlagene Benachrichtigungen auflisten und erneut senden

Alle Anfragen verwenden ein Bearer-Token im Header Authorization. Senden Sie X-Network: testnet, um das Testnetz zu nutzen. Ohne den Header geht die Anfrage ins Mainnet.

Wie prüfen Sie einen Saldo und senden BNB?

Prüfen Sie den Saldo mit einer GET-Anfrage. Dann senden Sie BNB mit einer POST-Anfrage. Beide Beispiele verwenden die Basis-URL https://app.chaingateway.io und ein Token aus Ihrem Dashboard.

Terminal window
curl https://app.chaingateway.io/api/v2/bsc/balances/0x0000000000000000000000000000000000001000 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet"

Die Antwort enthält den Saldo als Dezimal-String:

{"status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}

Um BNB aus einer Wallet zu senden, die Sie mit der API erstellt haben, senden Sie Absender, Empfänger, Betrag und das Wallet-Passwort. Die Gas-Felder sind optional.

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/bsc/transactions \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet" \
-H "Content-Type: application/json" \
-d '{"from": "0x...", "to": "0x...", "amount": "0.001", "password": "wallet-password"}'

Hat der Absender zu wenig BNB für Betrag plus Gas, antwortet die API mit Status 422 und der Meldung insufficient funds des Nodes. Ein falsches Wallet-Passwort ergibt 401.

Wie lesen Sie einen Token-Saldo und eine Transaktion?

Den BEP-20-Token-Saldo lesen Sie mit der Wallet-Adresse und der Vertragsadresse des Tokens im Pfad. Eine Transaktion lesen Sie über ihren Hash. Beide sind GET-Anfragen mit denselben Headern wie oben.

Terminal window
# BEP-20 token balance
curl https://app.chaingateway.io/api/v2/bsc/balances/0xWalletAddress/bep20/0xTokenContract \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Transaction with decoded data
curl https://app.chaingateway.io/api/v2/bsc/transactions/0xTransactionHash/decoded \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Current gas price
curl https://app.chaingateway.io/api/v2/bsc/gasprice \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"

Der Saldo-Endpunkt liefert den Token-Betrag als Dezimal-String. Sie skalieren ihn also nicht selbst mit den Dezimalstellen des Tokens. Der Endpunkt für decodierte Transaktionen liefert eine Transaktion in lesbaren Feldern statt in rohen Hex-Daten. Ein unbekannter Hash ergibt eine 422-Antwort mit der Meldung transaction not found.

GET /api/v2/bsc/transactions listet Ihre eigene Transaktionshistorie. Sie enthält nur Transaktionen, die über die Chaingateway-API erstellt wurden, weil Chaingateway Ihre Adressen nicht selbst indexiert. Für eingehende Transfers nutzen Sie einen Webhook.

Wenn Sie bereits eine Wallet besitzen, importiert POST /api/v2/bsc/addresses/import deren privaten Schlüssel. Importierte und neue Wallets nutzen dieselben Sende- und Webhook-Endpunkte.

Wie werden Sie über Einzahlungen benachrichtigt?

Legen Sie einen Webhook mit POST /api/v2/bsc/webhooks an. Das Feld url ist Pflicht. Filtern Sie nach to (einer Empfangsadresse), nach from oder nach contractaddress für einen Token. Setzen Sie type auf BNB, BEP20 oder BEP721. Wird eine passende Transaktion erkannt, sendet Chaingateway die Transaktionsdaten an Ihre URL.

Webhooks werden nicht automatisch wiederholt. Eine fehlgeschlagene Zustellung erscheint unter GET /api/v2/bsc/webhooks/notifications/failed. POST /api/v2/bsc/webhooks/notifications/{id}/retry sendet sie erneut. Machen Sie Ihren Empfangsendpunkt idempotent, mit der Transaktions-ID als Schlüssel. So bucht ein erneuter Versuch kein Guthaben doppelt.

Was ist BEP-20?

BEP-20 ist der Token-Standard der BNB Smart Chain. Laut der Spezifikation ist er von ERC-20 abgeleitet. Er verlangt die Funktionen symbol(), decimals(), totalSupply(), balanceOf(), transfer(), transferFrom(), approve() und allowance(). Deshalb funktioniert derselbe Wallet-Code für Token auf BSC und auf Ethereum. Aus demselben Grund spiegeln die BSC-Endpunkte von Chaingateway die Ethereum-Endpunkte.

Wann reichen öffentliche RPC-Endpunkte?

BNB Chain stellt öffentliche JSON-RPC-Endpunkte für Mainnet und Testnet bereit. Die BNB-Chain-Dokumentation nennt ein Limit von 10.000 Anfragen pro 5 Minuten. Außerdem hält sie fest, dass eth_getLogs auf den öffentlichen Mainnet-Endpunkten deaktiviert ist.

Für Prototypen und gelegentliche Lesezugriffe genügt das. Für einen Dienst, der viele Adressen überwacht, brauchen Sie entweder einen eigenen Node, einen Anbieter oder eine API, die Events an Sie schickt. Zum Node-Weg siehe Interaktion mit Blockchain-Nodes per JSON-RPC. Mehr zur Seite von Chaingateway finden Sie auf der BSC-API-Seite.

So entstehen diese Artikel

Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Binance-Smart-Chain-API für die vollständige Endpoint-Referenz.

C
Chaingateway Team
Blockchain-Experten

Das Chaingateway-Team hat es sich zur Aufgabe gemacht, die Blockchain-Integration für Entwickler weltweit zu vereinfachen.