TypeError: Linearization of inheritance graph impossible
Ordinea contractelor din lista is nu se poate aranja într-un lanț valid. Regula: scrii părinții de la cel mai general la cel mai specific. Dacă B îl moștenește deja pe A, scrie is A, B (nu is B, A) sau, mai simplu, doar is B.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Solidity transformă moștenirea multiplă într-un singur lanț (algoritmul C3, ca în Python), ca să știe în ce ordine se apelează super și ce funcție câștigă. Lista din contract X is A, B se citește de la cel mai general (stânga) la cel mai specific (dreapta). Dacă în listă pui un contract mai specific înaintea unuia de care depinde, lanțul nu mai poate fi construit și primești acest mesaj.
Exemplul tipic: ContorDublu is Contor, apoi Aplicatie is ContorDublu, Contor. Lista spune că Contor e mai specific decât ContorDublu, dar ContorDublu îl moștenește pe Contor: contradicție. Cu OpenZeppelin apare la is ERC20Burnable, ERC20 în loc de is ERC20, ERC20Burnable.
De cele mai multe ori, contractul general nici nu trebuie scris în listă: îl moștenești deja prin cel specific.
De ce apare: cauzele frecvente
1Părintele specific scris primul
contract ContorDublu is Contor { ... }
contract Aplicatie is ContorDublu, Contor {}contract ContorDublu is Contor { ... }
contract Aplicatie is ContorDublu {}Contor vine deja prin ContorDublu; nu trebuie repetat.
2Extensie OpenZeppelin înaintea bazei
contract Token is ERC20Burnable, ERC20 { ... }contract Token is ERC20, ERC20Burnable { ... }Baza (ERC20) se scrie înaintea extensiei care o moștenește (ERC20Burnable).
Repară eroarea, direct în pagină
Contractul Aplicatie trebuie să folosească ContorDublu, care moștenește Contor și crește valoarea cu 2. Compilarea dă TypeError: Linearization of inheritance graph impossible. Repară lista de moștenire a lui Aplicatie. Scriptul apelează o dată creste() și afișează valoarea.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Contor {
uint256 public valoare;
function creste() public virtual {
valoare += 1;
}
}
contract ContorDublu is Contor {
function creste() public virtual override {
super.creste();
valoare += 1;
}
}
contract Aplicatie is ContorDublu, Contor {}Valoare: 2
Indiciu
Contor vine deja prin ContorDublu.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Contor {
uint256 public valoare;
function creste() public virtual {
valoare += 1;
}
}
contract ContorDublu is Contor {
function creste() public virtual override {
super.creste();
valoare += 1;
}
}
contract Aplicatie is ContorDublu {}De ce merge
Lista is ContorDublu, Contor spunea că Contor e mai specific decât ContorDublu, deși ContorDublu îl moștenește pe Contor, deci nu exista un lanț valid. Contor vine oricum prin ContorDublu, așa că lista corectă e doar is ContorDublu. Apelul creste() trece prin ContorDublu, care apelează super.creste() din Contor și mai adaugă 1: valoarea devine 2.
Cum o eviți pe viitor
- Scrie în
ispărinții de la cel mai general la cel mai specific. - Nu repeta în listă un contract pe care îl moștenești deja prin altul, decât dacă ai nevoie de el pentru
override(...). - Pentru combinații OpenZeppelin, pornește de la codul generat de OpenZeppelin Wizard.
- Ține ierarhiile scurte: două-trei niveluri sunt ușor de urmărit.
Întrebări frecvente
De ce contează ordinea?
Pentru că din ea rezultă ordinea apelurilor super și funcția care câștigă când mai mulți părinți o definesc. O ordine imposibilă ar face comportamentul ambiguu.
Am pus ordinea corectă și acum primesc „Derived contract must override function”. De ce?
Pentru că, scriind ambii părinți în listă, compilatorul îți cere să unifici funcțiile pe care amândoi le definesc. Fie le suprascrii cu override(A, B), fie scoți din listă părintele general, care vine oricum prin cel specific.
Erori înrudite
TypeError: Derived contract must override function "descriere". Two or more base classes define function with same name and parameter types. Moștenești două contracte care au amândouă o funcție cu același nume și aceiași parametri, iar compilatorul nu știe pe care s-o folosească. Suprascrie funcția în contractul tău cu override(A, B) și alege explicit ce face (poți apela A.f() și B.f()). TypeError: Overriding function is missing "override" specifier. Ai rescris în contractul copil o funcție care există deja în părinte, dar fără cuvântul override. Adaugă override în declarația funcției din copil (iar în părinte funcția trebuie să fie virtual). TypeError: Contract "Cerc" should be marked as abstract. Contractul are (sau moștenește) funcții fără implementare, deci nu poate fi publicat. Implementează toate funcțiile cerute de părinte sau de interfață, cu aceeași semnătură și override, ori marchează contractul abstract dacă e doar o bază pentru alții. Î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.
