...
Eroare Solidity · Moștenire, override și contracte abstracte

TypeError: Linearization of inheritance graph impossible

Pe scurt

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

Greșit
SOLIDITY
contract ContorDublu is Contor { ... }
contract Aplicatie is ContorDublu, Contor {}
Corect
SOLIDITY
contract ContorDublu is Contor { ... }
contract Aplicatie is ContorDublu {}

Contor vine deja prin ContorDublu; nu trebuie repetat.

2Extensie OpenZeppelin înaintea bazei

Greșit
SOLIDITY
contract Token is ERC20Burnable, ERC20 { ... }
Corect
SOLIDITY
contract Token is ERC20, ERC20Burnable { ... }

Baza (ERC20) se scrie înaintea extensiei care o moștenește (ERC20Burnable).

Repară tu

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.

Codul care dă eroarea
SOLIDITY
// 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 {}
După reparație, programul afișează
Valoare: 2
Indiciu

Contor vine deja prin ContorDublu.

Cum o eviți pe viitor

  • Scrie în is pă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

← 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.