...
Eroare Solidity · Importuri și erorile OpenZeppelin

VM Exception while processing transaction: reverted with custom error 'AccessControlUnauthorizedAccount("0xFe95ca6E619dF220150A486849D34dD898bfbF41", "0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6")'

Pe scurt

Contul din primul argument nu are rolul cerut de funcție (al doilea argument, hash-ul rolului, de exemplu keccak256("MINTER_ROLE")). Dă-i rolul cu grantRole (din contul de admin) sau din constructor cu _grantRole, ori apelează funcția din contul care are rolul.

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

Ce înseamnă

AccessControl din OpenZeppelin împarte drepturile pe roluri: fiecare rol e un bytes32, de obicei keccak256("MINTER_ROLE"), iar funcțiile protejate cu onlyRole(ROL) verifică dacă msg.sender îl are. Dacă nu, apelul dă AccessControlUnauthorizedAccount(account, neededRole): primul argument e contul care a încercat, al doilea e rolul lipsă, ca hash. În OpenZeppelin 4, mesajul era un text lung: AccessControl: account 0x... is missing role 0x....

Cauzele frecvente: în constructor ai dat rolul lui msg.sender (cel care publică) în loc de adresa primită ca parametru; ai dat doar DEFAULT_ADMIN_ROLE, care permite să acorzi roluri, dar nu le include automat pe celelalte; scriptul apelează din alt cont (lipsește connect).

Ca să afli rolul din hash, calculează în script ethers.id("MINTER_ROLE") și compară. 0x9f2df0fe... este chiar keccak256("MINTER_ROLE").

De ce apare: cauzele frecvente

1Rolul dat celui care publică, nu emitentului

Greșit
SOLIDITY
constructor(address emitent) ERC20("Puncte", "PCT") {
    _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
    _grantRole(MINTER_ROLE, msg.sender);
}
Corect
SOLIDITY
constructor(address emitent) ERC20("Puncte", "PCT") {
    _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
    _grantRole(MINTER_ROLE, emitent);
}

Parametrul emitent trebuie să primească rolul pe care îl folosește.

2Adminul presupus că are toate rolurile

Greșit
SOLIDITY
_grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
// apoi ana apelează emite(...) cu onlyRole(MINTER_ROLE)
Corect
SOLIDITY
_grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
_grantRole(MINTER_ROLE, msg.sender);

DEFAULT_ADMIN_ROLE poate acorda și retrage roluri, dar nu le are automat.

3Rol acordat ulterior, din script

Greșit
SOLIDITY
await token.connect(bogdan).emite(bogdan.address, 10);
Corect
SOLIDITY
await token.grantRole(await token.MINTER_ROLE(), bogdan.address);
await token.connect(bogdan).emite(bogdan.address, 10);

Adminul (aici ana) poate acorda rolul oricând cu grantRole.

Repară tu

Repară eroarea, direct în pagină

Tokenul Puncte primește la publicare adresa emitentului, care trebuie să poată emite puncte. Scriptul publică tokenul din contul anei cu emitentul bogdan, dar când bogdan emite puncte primește AccessControlUnauthorizedAccount pentru MINTER_ROLE. Repară constructorul, ca rolul de emitent să ajungă la adresa primită. Scriptul afișează punctele cristinei și încercarea anei de a emite.

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

import {ERC20} from "./ERC20.sol";
import {AccessControl} from "./AccessControl.sol";

contract Puncte is ERC20, AccessControl {
    bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");

    constructor(address emitent) ERC20("Puncte", "PCT") {
        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
        _grantRole(MINTER_ROLE, msg.sender);
    }

    function emite(address catre, uint256 suma) external onlyRole(MINTER_ROLE) {
        _mint(catre, suma);
    }
}
După reparație, programul afișează
Cristina are 50 puncte
Ana emite: AccessControlUnauthorizedAccount("0xb3E0A4A6FC903B00c73497DF23dfD21EF92a2706", "0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6")
Indiciu

MINTER_ROLE trebuie acordat parametrului emitent, nu lui msg.sender.

Alte forme ale mesajului

  • execution reverted: custom error 'AccessControlUnauthorizedAccount(0xFe95ca6E619dF220150A486849D34dD898bfbF41, 0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6)'
  • AccessControl: account 0xfe95ca6e619df220150a486849d34dd898bfbf41 is missing role 0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6

Cum o eviți pe viitor

  • Scrie în constructor, explicit, cine primește fiecare rol.
  • Testează fiecare funcție protejată și din contul cu rol, și din unul fără.
  • Declară rolurile ca bytes32 public constant, ca să le poți citi din script.
  • Nu lăsa DEFAULT_ADMIN_ROLE unui cont obișnuit în producție: pune-l pe un multisig.

Întrebări frecvente

Cum aflu ce rol înseamnă hash-ul din eroare?

Calculează hash-urile rolurilor cunoscute și compară: ethers.id("MINTER_ROLE"), ethers.id("PAUSER_ROLE"). DEFAULT_ADMIN_ROLE este 0x00...00.

Ce diferență e față de Ownable?

Ownable are un singur proprietar cu toate drepturile. AccessControl permite mai multe roluri și mai multe conturi pe fiecare rol: de exemplu un emitent de tokeni și un administrator de pauză diferiți.

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.