...
Eroare Solidity · Scripturi și teste: ethers.js și Hardhat

TypeError: contract.adauga is not a function

Pe scurt

Obiectul contractului din ethers nu are funcția pe care o apelezi: numele e scris greșit, funcția e internal / private (nu apare în ABI) sau folosești un ABI vechi. Verifică numele exact și fă funcția external sau public, apoi recompilează.

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

Ce înseamnă

ethers construiește obiectul contract din ABI, lista funcțiilor publice ale contractului generată la compilare. Pentru fiecare funcție public sau external (și pentru fiecare getter al unei variabile public), obiectul primește o metodă cu același nume. Dacă apelezi o metodă care nu e în ABI, JavaScript spune TypeError: contract.adauga is not a function.

Cauzele frecvente:

  • funcția e internal sau private, deci nu face parte din ABI (de exemplu o funcție ajutătoare _adauga pe care o apelezi din test);
  • numele diferă: litere mari/mici (Adauga), o literă greșită, sau ai redenumit funcția în contract;
  • ABI-ul e vechi: un fișier JSON copiat înainte de ultima compilare sau un artifacts/ neactualizat;
  • variabila de stare nu e public, deci nu are getter.

Verifică rapid ce conține ABI-ul: contract.interface.fragments sau, în Hardhat, fișierul din artifacts/.

De ce apare: cauzele frecvente

1Funcția e internal

Greșit
SOLIDITY
function adauga(uint256 suma) internal {
    total += suma;
}
Corect
SOLIDITY
function adauga(uint256 suma) external {
    total += suma;
}

Doar funcțiile external și public apar în ABI și pot fi apelate din JavaScript.

2Variabila nu e public

Greșit
SOLIDITY
uint256 total;
// în script: await c.total()
Corect
SOLIDITY
uint256 public total;
// în script: await c.total()

public generează getter-ul total().

3Numele scris diferit

Greșit
SOLIDITY
await c.Adauga(5);
Corect
SOLIDITY
await c.adauga(5);

Numele funcțiilor sunt sensibile la litere mari și mici.

Repară tu

Repară eroarea, direct în pagină

Contractul Pusculita are funcția adauga declarată internal, iar scriptul care o apelează dă TypeError: contract.adauga is not a function. Fă funcția accesibilă din afara contractului. Scriptul adaugă 20 și 15 lei și afișează totalul.

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

contract Pusculita {
    uint256 public total;

    function adauga(uint256 suma) internal {
        total += suma;
    }
}
După reparație, programul afișează
Total: 35 lei
Indiciu

Doar funcțiile external sau public apar în ABI.

Alte forme ale mesajului

  • TypeError: c.adauga is not a function
  • TypeError: token.mint is not a function
  • TypeError: contract.total is not a function

Cum o eviți pe viitor

  • Când adaugi o funcție care trebuie folosită din afară, declar-o external sau public.
  • Recompilează și reîncarcă ABI-ul după fiecare schimbare de contract.
  • Folosește aceleași nume în contract și în script; copiază-le, nu le rescrie.
  • În TypeScript, cu TypeChain, astfel de greșeli apar încă de la scriere.

Întrebări frecvente

De ce nu primesc o eroare de la blockchain?

Pentru că apelul nici nu pleacă spre nod: ethers nu găsește metoda în obiect, iar eroarea e una de JavaScript, aruncată local.

Cum apelez o funcție supraîncărcată?

Dacă există două funcții cu același nume și parametri diferiți, ethers v6 cere semnătura completă: c["adauga(uint256,address)"](5, adresa).

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.