Wer hält ein NFT? ERC-721 und ERC-1155 prüfen
Ein NFT-Bild oder die Anzahl einer Sammlung verrät nicht, wer einen bestimmten Token hält. Wählen Sie die passende Leseabfrage.
Bei einem bestehenden ERC-721-Token liefert ownerOf(tokenId) am richtigen Sammlungsvertrag den aktuell eingetragenen Inhaber. Bei ERC-1155 zeigt balanceOf(account, id), wie viele Einheiten dieser ID ein Konto hält. Das sind unterschiedliche Fragen: Einheiten eines ERC-1155-Typs können auf mehrere Konten verteilt sein.
Beginnen Sie mit Netzwerk, vollständiger Adresse des Sammlungsvertrags und Token-ID. Behalten Sie diese drei Kennungen zusammen, während Sie einen vertrauten Explorer oder Vertragsleser verwenden. Ein passendes Bild, ein Sammlungsname oder eine NFT-Gesamtzahl identifiziert keinen bestimmten Bestand.
Diese Anleitung prüft öffentliche Token-Einträge. Sie bestimmt weder die Person hinter einer Adresse noch Echtheit oder Preis eines Kunstwerks oder Ihre Ansprüche gegenüber einem Verwahrdienst. Zur Prüfung gehören weder Übertragung noch Wallet-Verbindung.
Die Abfrage passend zum Token-Standard wählen
Die ERC-721-Schnittstelle bietet sowohl eine Anzahl pro Konto als auch die Abfrage eines einzelnen Tokens. Bei ERC-1155 verlangt die Standardschnittstelle Konto und Token-Typ-ID gemeinsam.
| Standard und Abfrage | Ihre Eingabe | Bedeutung des Ergebnisses |
|---|---|---|
ERC-721 ownerOf(tokenId) |
Eine Token-ID | Inhaberadresse dieses bestehenden Tokens |
ERC-721 balanceOf(account) |
Eine Kontoadresse | Anzahl der NFTs dieses Vertrags auf dem Konto |
ERC-1155 balanceOf(account, id) |
Konto und Token-Typ-ID | Anzahl der Einheiten dieser ID auf dem Konto |
Angenommen, eine hypothetische ERC-721-Sammlung enthält die IDs 42 und 43. Konto A hält 42, Konto B hält 43. Beide Kontozähler ergeben 1. Daraus lässt sich nicht ablesen, welches Konto 42 hält; die Abfrage dieser ID kann es zeigen.
Betrachten wir nun einen anderen hypothetischen ERC-1155-Vertrag. Konto A hält 3 Einheiten der ID 42, Konto B hält 2. Beide Bestände können zum selben Zeitpunkt positiv sein. Wer A als einzigen Inhaber von ID 42 bezeichnet, übersieht die Einheiten auf B. Diese Beispiele erklären die Abfragen; sie sind keine Ergebnisse einer realen Sammlung.
Sammlung und ID vor einem vermeintlichen Treffer bestimmen
Eine Token-ID gehört zu einem bestimmten Vertrag. ID 42 einer Sammlung bezeichnet nicht ID 42 einer anderen. Die Kennungsregeln von ERC-721 beschreiben das Paar aus Vertrag und ID auf einer Blockchain; setzen Sie keine fortlaufenden IDs voraus.
Suchen Sie über einen vertrauenswürdigen Zugang nach den offiziellen Bereitstellungsdaten der Sammlung oder verwenden Sie einen bekannten Transaktionseintrag, um Netzwerk und vollständige Vertragsadresse zu bestätigen. Ein Nachahmervertrag kann einen vertrauten Namen und dasselbe Bild verwenden. Eine scheinbar übliche Funktionsantwort macht diese Kopie nicht zur gesuchten Sammlung.
Übernehmen Sie die ID aus den Objektdetails, statt sie aus dem Namen zu erraten. Bewahren Sie den Wert exakt. Zeigt eine Oberfläche eine hexadezimale ID und eine andere eine dezimale, prüfen Sie vor dem Vergleich, ob beide dieselbe ganze Zahl darstellen. Die Vertragsadresse bezeichnet die Sammlung; die Kontoadresse bezeichnet den geprüften Inhaber. Der Leitfaden zu Wallet-Adresse und Token-Vertrag erklärt den Unterschied.
Lesen Sie bei einem unerwarteten Objekt den Sicherheitsleitfaden zu Spam-NFTs, bevor Sie Links in dessen Beschreibung öffnen. Öffentliche Einträge lassen sich über einen bereits vertrauten Zugang prüfen, ohne einem Claim-Link zu folgen.
Nur lesen und das Ergebnis festhalten
Die folgenden Schritte beschreiben die Prüfung öffentlicher Einträge. Für diesen Artikel wurden sie nicht mit einer realen Wallet getestet. Die Primärdokumentation der Methoden wurde am 24. Oktober 2026 geprüft.
- Die vollständige Kennung notieren. Halten Sie Netzwerk, Sammlungsvertrag und genaue Token-ID fest. Ergänzen Sie die Kontoadresse, wenn Sie eine bestimmte Wallet prüfen.
- Den Standard bestätigen und die öffentliche Lesemethode wählen. Verwenden Sie Vertragsdetails und verifizierte Schnittstelle des vertrauten Explorers. Die Beschriftungen unterscheiden sich. Für ERC-721 verwenden Sie
ownerOfmit der ID, für ERC-1155balanceOfmit Konto und ID. Eine fehlende oder nicht unterstützte Schnittstelle erfordert weitere Prüfung und rechtfertigt keine Annahme eines anderen Standards. - Den aktuellen Zustand lesen und den Beobachtungszeitpunkt notieren. Speichern Sie zurückgegebene Adresse oder Stückzahl sowie, falls verfügbar, die Blocknummer. Vergleichen Sie Abfragen möglichst am selben Block: Zwischen getrennten Abfragen des neuesten Zustands kann eine Übertragung stattfinden.
- Die Antwort im richtigen Umfang deuten. Vergleichen Sie die vollständige ERC-721-Antwortadresse mit dem beabsichtigten Konto. Bei ERC-1155 bestätigt eine positive Zahl eingetragene Einheiten dieses Kontos; eine gültige Nullantwort meldet dort zum beobachteten Zustand keine Einheiten. Keine der Antworten zählt alle anderen Inhaber auf.
- Fehlgeschlagene oder nicht verfügbare Abfragen als unbekannt markieren. Bewahren Sie Fehler oder Verfügbarkeitshinweis auf. Prüfen Sie ID, Vertrag, Netzwerk und Lesewerkzeug, bevor Sie auf einen fehlenden Token schließen. Ein Abfragefehler ist kein Nullbestand.
Die OpenZeppelin-Referenz zu ERC721 verlangt für die öffentliche Methode ownerOf einen bestehenden Token. Eine nicht vorhandene oder verbrannte ID kann daher einen Fehler auslösen, statt einen brauchbaren Inhaber zu liefern. Der Fehler allein erklärt nicht, ob Sie sich bei der ID vertippt, einen anderen Vertrag ausgewählt oder einen ungültigen Token abgefragt haben.
Verwechseln Sie diese öffentliche Funktion nicht mit einer internen Hilfsfunktion, deren Name mit einem Unterstrich beginnt. Sie prüfen die dokumentierte öffentliche Schnittstelle. Diese Abfragen benötigen weder Signatur noch Freigabe oder Wiederherstellungsphrase. Fordert eine Website etwas davon allein zur Anzeige des Inhabers, brechen Sie diesen Ablauf ab.
Wenn der eingetragene Inhaber ein Vertrag ist
Ein NFT kann von einem Vertragskonto gehalten werden. Die abgefragte Adresse kann deshalb zu einem Tresor, einer Treuhandlösung, einem Staking-System oder einem anderen Dienst gehören statt zu Ihrer signierenden Wallet. Das entscheidet für sich genommen weder über wirtschaftliche Ansprüche noch über die Rückholbarkeit des Objekts.
Haben Sie das NFT bewusst bei einem Dienst hinterlegt, prüfen Sie dessen offizielle Einträge und die bekannte Einzahlungstransaktion. Ordnen Sie den Anspruch Ihres Kontos der exakten Sammlung und ID zu. Übertragen oder entnehmen Sie keine Vermögenswerte allein dafür, dass die Wallet-Galerie das erwartete Bild zeigt.
Bei einer Liquiditätsposition zeigt die Inhaberprüfung nur, welche Adresse das NFT hält. Der Leitfaden zum Uniswap-v3-Positions-NFT behandelt die gesonderte Prüfung der zugrunde liegenden Vermögenswerte und Gebühren. Die NFT-Inhaberadresse allein nennt keinen dieser Beträge.
Mit einem zugeordneten Bestand abschließen
Die OpenZeppelin-Referenz zu ERC1155 beschreibt das Ergebnis als Einheiten eines bestimmten Typs auf einem Konto. Speichern Sie diese Menge zusammen mit Konto und ID. Ersetzen Sie sie nicht durch eine Bezeichnung als alleiniger Eigentümer nach ERC-721-Art und teilen Sie sie nicht durch eine sachfremde ERC-20-Dezimalskala.
Ihr Eintrag ist vollständig, wenn er Netzwerk, Vertrag, Token-ID, Standard, zurückgegebenen Inhaber oder Einheiten pro Konto sowie Beobachtungsblock oder Zeitpunkt enthält. Ergänzen Sie einen Verwahrungshinweis, wenn der eingetragene Inhaber ein Dienstvertrag ist. Bleibt ein wesentliches Feld ungeklärt, markieren Sie den Bestand als ungeprüft.
Eine Galerie hilft beim Stöbern; dieser Eintrag beantwortet die engere Frage, was der gewählte Vertrag über den konkreten Token meldet. Er bestätigt weder die Sammlung noch erteilt er Übertragungsrechte, identifiziert eine Person oder berechnet einen Verkaufspreis.
Häufige Fragen
Beweist ein ERC-721-Bestand von 1, dass diese Wallet mein bestimmtes NFT hält?
Nein. balanceOf zählt die NFTs dieses Vertrags auf einem Konto. Fragen Sie ownerOf mit der konkreten Token-ID ab, um den aktuell eingetragenen Inhaber zu ermitteln. Netzwerk und Sammlungsvertrag müssen übereinstimmen.
Können mehrere Wallets dieselbe ERC-1155-ID halten?
Ja. Eine ERC-1155-ID kann mehrere Einheiten bezeichnen. balanceOf erhält Konto und ID und meldet die Einheiten dieses Typs auf diesem Konto. Ein positiver Wert beweist keinen alleinigen Besitz.
Muss ich meine Wallet verbinden oder unterschreiben?
Diese öffentlichen Leseabfragen benötigen weder Wallet-Signatur noch Freigabe oder Wiederherstellungsphrase. Das Ergebnis zeigt eingetragene Bestände, nicht die Person hinter einer Adresse oder gesonderte Ansprüche gegenüber einem Verwahrer.