...
Eroare Solidity · Importuri și erorile OpenZeppelin

VM Exception while processing transaction: reverted with custom error 'ERC721NonexistentToken(2)'

Pe scurt

Ai cerut un NFT (ownerOf, tokenURI, getApproved, transfer) cu un ID care nu a fost emis sau a fost ars. Argumentul erorii e ID-ul cerut. De obicei e o greșeală de numărare: ID-urile pornesc de la 0 sau de la 1, iar ultimul emis e total - 1 sau total.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Tokenurile ERC-721 din OpenZeppelin 5 dau ERC721NonexistentToken(tokenId) ori de câte ori o funcție are nevoie de proprietarul unui token care nu există: ownerOf, tokenURI, getApproved, approve, _burn. În OpenZeppelin 4, mesajul era ERC721: invalid token ID (și, mai demult, ERC721: owner query for nonexistent token).

Cauza obișnuită e o nepotrivire între cum emiți ID-urile și cum le citești: emiți 0, 1, 2 și ceri tokenul cu numărul total (care ar fi următorul), sau emiți începând de la 1 și citești tokenul 0. Alte cauze: tokenul a fost ars, aplicația încearcă tokenURI înainte ca tranzacția de emitere să fie confirmată, sau ID-ul vine din altă colecție.

Argumentul din eroare e ID-ul cerut; compară-l cu ID-urile emise (din evenimentele Transfer cu from = adresa zero).

De ce apare: cauzele frecvente

1Ultimul ID calculat greșit

Greșit
SOLIDITY
// ID-urile emise: 0, 1, ..., total - 1
function proprietarUltimei() external view returns (address) {
    return ownerOf(total);
}
Corect
SOLIDITY
function proprietarUltimei() external view returns (address) {
    require(total > 0, "Nicio diploma");
    return ownerOf(total - 1);
}

Dacă ID-urile pornesc de la 0, ultimul este total - 1.

2Citire înainte de emitere

Greșit
SOLIDITY
const tx = await nft.emite(bogdan.address);
console.log(await nft.tokenURI(0));
Corect
SOLIDITY
await (await nft.emite(bogdan.address)).wait();
console.log(await nft.tokenURI(0));

Pe o rețea reală, așteaptă confirmarea tranzacției înainte să citești tokenul.

3Token ars

Greșit
SOLIDITY
await nft.ardere(0);
await nft.ownerOf(0);
Corect
SOLIDITY
await nft.ardere(0);
console.log(await nft.balanceOf(bogdan.address));

După ardere tokenul nu mai există; verifică soldurile sau evenimentele, nu proprietarul.

Repară tu

Repară eroarea, direct în pagină

Contractul Diplome emite NFT-uri cu ID-uri de la 0, iar proprietarUltimei() trebuie să întoarcă proprietarul ultimei diplome emise. După două diplome (pentru bogdan și cristina), funcția dă ERC721NonexistentToken(2). Repară ID-ul citit. Scriptul emite cele două diplome și verifică proprietarul ultimei.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {ERC721} from "./ERC721.sol";

contract Diplome is ERC721 {
    uint256 public total;

    constructor() ERC721("Diplome", "DPL") {}

    function emite(address absolvent) external {
        _mint(absolvent, total);
        total += 1;
    }

    function proprietarUltimei() external view returns (address) {
        return ownerOf(total);
    }
}
După reparație, programul afișează
Diplome emise: 2
Ultima este a cristinei: true
Indiciu

Cu ID-uri 0 și 1, ultimul ID este total - 1.

Alte forme ale mesajului

  • execution reverted: custom error 'ERC721NonexistentToken(2)'
  • ERC721: invalid token ID
  • ERC721: owner query for nonexistent token

Cum o eviți pe viitor

  • Alege o convenție pentru ID-uri (de la 0 sau de la 1) și folosește-o peste tot, inclusiv în aplicație.
  • Ține un contor total și calculează ultimul ID din el într-un singur loc.
  • În aplicații, citește ID-ul din evenimentul Transfer al tranzacției de emitere, nu-l ghici.
  • Verifică existența cu un try sau cu un require propriu înainte de a apela ownerOf din alt contract.

Întrebări frecvente

De la ce număr pornesc ID-urile în OpenZeppelin?

OpenZeppelin nu impune nimic: tu alegi ID-ul la _mint(to, id). Multe colecții pornesc de la 0 cu un contor, altele de la 1 (ca 0 să însemne „niciun token”).

De ce balanceOf merge, iar ownerOf dă eroare?

balanceOf numără tokenii unei adrese și întoarce 0 fără eroare. ownerOf cere un token anume și, dacă nu există, nu are ce adresă să întoarcă.

Erori înrudite

← Toate erorile Solidity

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Solidity de la zero, cu exerciții la fiecare lecție

Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.