NFT-Funktionen und estimateGas: Release 2021
Was das Release von November 2021 ergänzt hat: getNFTOwner, getNFTURI, sendNFT und estimateGas, dazu NFT-Versand und Gas-Abfragen in der v2-API heute.
Geprüft von Maurice Sobiera
Die NFT-Funktionen von Chaingateway lesen den Besitzer und die Metadaten-URI eines ERC-721-, BEP-721- oder TRC-721-Tokens und senden das Token an eine andere Adresse. Das Release von November 2021 ergänzte getNFTOwner, getNFTURI und sendNFT für Ethereum, Tron und BSC. Außerdem kam estimateGas für Ethereum und BSC hinzu, das eine Gas-Schätzung für eine Transaktion liefert, ohne sie zu senden.
Was ist ein NFT?
Ein nicht fungibler Token (NFT) ist ein Token, bei dem jede Einheit eine eigene Token-ID hat. Er wurde zuerst auf Ethereum als ERC-721 standardisiert. ERC-20-Token sind austauschbar: Jede Einheit ist identisch mit jeder anderen. Ein ERC-721-Token ist anders, denn jede Token-ID kann einen eigenen Besitzer und eigene Metadaten haben.
Der Standard ist in EIP-721 definiert. Er legt fest, dass ownerOf(tokenId) den Besitzer zurückgibt und safeTransferFrom ein Token verschiebt. Die optionale Metadaten-Erweiterung ergänzt tokenURI(tokenId), das einen Link zu den Metadaten des Tokens zurückgibt. BEP-721 auf der BNB Smart Chain und TRC-721 auf Tron folgen demselben Modell.
EIP-721 standardisiert eine sichere Transferfunktion, safeTransferFrom, und eine unsichere, transferFrom. Bei transferFrom muss der Aufrufer bestätigen, dass die empfangende Adresse NFTs verarbeiten kann. Der Standard warnt, dass das Token sonst dauerhaft verloren gehen kann. Prüfen Sie den Empfänger, bevor Sie ein Token an eine Contract-Adresse senden. Eine ausführlichere Einführung finden Sie im Artikel ERC721-Token-Standard.
Welche NFT-Funktionen hat das Release 2021 ergänzt?
Das Release ergänzte drei NFT-Funktionen. Alle drei standen für die Ethereum-, Tron- und Binance-Smart-Chain-API zur Verfügung.
| Funktion | Was sie tut | Parameter |
|---|---|---|
| getNFTOwner | Gibt die Besitzeradresse eines NFTs zurück | Token-ID, Token-Contract-Adresse |
| getNFTURI | Gibt die URI eines NFTs zurück | Wie getNFTOwner |
| sendNFT | Sendet ein NFT an eine andere Adresse | Absenderadresse, Zieladresse, Contract-Adresse, Token-ID |
Diese Namen beschreiben die Funktionen, wie sie 2021 angekündigt wurden. Die damalige Dokumentation war die Referenz für ihre genaue Verwendung.
Kann Chaingateway NFTs minten?
Kein eigener Mint-Befehl war Teil dieses Releases. Sie konnten trotzdem minten, indem Sie den Contract-Aufruf selbst kodieren und als normale Transaktion mit den kodierten Daten senden.
Das entspricht dem Standard, denn EIP-721 definiert kein Minting. Die Spezifikation besagt, dass Erstellung und Vernichtung von NFTs nicht enthalten sind und ein Contract sie auf anderem Weg umsetzen kann. Wie Minting funktioniert, unterscheidet sich daher von Contract zu Contract. 2021 erklärte das Team, dass ihm eine Testumgebung für eine Mint-Funktion fehle, und bat Besitzer von ERC-721-, BEP-721- oder TRC-721-Contracts, bei einem Test zu helfen.
Was macht estimateGas?
estimateGas gibt die Gasmenge zurück, die eine Transaktion voraussichtlich benötigt, bevor Sie sie senden. Für Ethereum und BSC nimmt sie dieselben Parameter wie eine normale Transaktion, mit Ausnahme des Passworts. Die Funktion kam hinzu, weil viele Nutzer eine einfachere Möglichkeit wollten, Gasgebühren zu berechnen.
Dahinter steht die Methode eth_estimateGas der Ethereum-JSON-RPC-Schnittstelle. Laut der Ethereum-Entwicklerdokumentation erzeugt sie eine Schätzung, ohne die Transaktion zur Blockchain hinzuzufügen. Dieselbe Seite warnt, dass die Schätzung deutlich über dem Gas liegen kann, das die Transaktion tatsächlich verbraucht. Behandeln Sie das Ergebnis als obere Grenze für Ihr Gas-Limit, nicht als endgültige Kosten. Eine einfache Ether-Überweisung benötigt zum Beispiel 21000 Gas, was dieselbe Seite als 0x5208 angibt.
Was kann ich heute verwenden?
Die Funktionsnamen oben stammen aus der API-Generation von 2021. Die aktuelle öffentliche OpenAPI-Spezifikation (Version 2.1.0) ist anders aufgebaut, deshalb listet dieser Abschnitt auf, was sie am 5. November 2026 enthält.
| Aufgabe | Endpunkt in der v2-Spezifikation |
|---|---|
| ERC-721-Token auf Ethereum senden | POST /api/v2/ethereum/transactions/erc721 |
| BEP-721-Token auf BSC senden | POST /api/v2/bsc/transactions/bep721 |
| TRC-721-Token auf Tron senden | POST /api/v2/tron/transactions/trc721 |
| ERC-721-Token auf Polygon oder Arbitrum senden | POST /api/v2/polygon/transactions/erc721, POST /api/v2/arbitrum/transactions/erc721 |
| Aktuellen Gaspreis abfragen | GET /api/v2/ethereum/gasprice, und derselbe Pfad unter bsc, polygon und arbitrum |
Die Spezifikation listet keine eigenen Endpunkte für getNFTOwner, getNFTURI oder estimateGas auf. Um Besitzer oder URI zu lesen, rufen Sie ownerOf oder tokenURI am Token-Contract über einen beliebigen JSON-RPC-Endpunkt auf. Für eine Gas-Schätzung nutzen Sie eth_estimateGas auf dieselbe Weise. Der Artikel So schätzen Sie Gasgebühren erklärt die Berechnung.
Eine Sendeanfrage auf Ethereum benötigt from, contractaddress, to und tokenId. Das Feld password ist Pflicht, außer Sie übergeben einen privatekey. Gasfelder wie gas, gasprice oder maxFeePerGas sind optional.
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc721 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "contractaddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "to": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2", "tokenId": 1, "password": "your-wallet-password" }'Eine erfolgreiche Anfrage liefert Status 201 mit dem Transaktions-Hash in data.txid. Ein falsches Wallet-Passwort liefert 401. Ein Wallet ohne genug Guthaben für die Gasgebühr liefert 422, zum Beispiel mit der Meldung „insufficient funds for gas * price + value“. Die Adressen oben sind die Platzhalterwerte aus der Spezifikation. Eine vollständige Anleitung finden Sie unter So übertragen Sie NFTs per API.
Möchten Sie neue Funktionen besprechen?
Feedback ist willkommen in der Chaingateway-Telegram-Gruppe.
Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Blockchain-API für die vollständige Endpoint-Referenz.