TypeError: contract.adauga is not a function
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
internalsauprivate, deci nu face parte din ABI (de exemplu o funcție ajutătoare_adaugape 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
function adauga(uint256 suma) internal {
total += suma;
}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
uint256 total;
// în script: await c.total()uint256 public total;
// în script: await c.total()public generează getter-ul total().
3Numele scris diferit
await c.Adauga(5);await c.adauga(5);Numele funcțiilor sunt sensibile la litere mari și mici.
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.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Pusculita {
uint256 public total;
function adauga(uint256 suma) internal {
total += suma;
}
}Total: 35 lei
Indiciu
Doar funcțiile external sau public apar în ABI.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Pusculita {
uint256 public total;
function adauga(uint256 suma) external {
total += suma;
}
}De ce merge
ethers creează metodele obiectului contract din ABI, iar ABI-ul conține doar funcțiile external și public. Fiind internal, adauga nu exista pentru script, așa că contract.adauga era undefined. Ca external, funcția apare în ABI, iar scriptul o poate apela: totalul devine 35.
Alte forme ale mesajului
TypeError: c.adauga is not a functionTypeError: token.mint is not a functionTypeError: 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
externalsaupublic. - 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
TypeError: Do not know how to serialize a BigInt ethers v6 întoarce numerele din contract (uint256) ca BigInt, iar JSON.stringify nu știe să le transforme în text. Convertește-le înainte: valoare.toString(), sau dă-i lui JSON.stringify un replacer: (k, v) => typeof v === "bigint" ? v.toString() : v. HardhatError: HH700: Artifact for contract "contor" not found. Hardhat nu găsește contractul compilat cu numele cerut în getContractFactory / deployContract. Numele trebuie să fie exact numele contractului din cod (cu litere mari și mici), nu numele fișierului. Verifică și că fișierul e în contracts/ și că s-a compilat (npx hardhat compile). SyntaxError: No visibility specified. Did you intend to add "public"? Funcției îi lipsește vizibilitatea. Din Solidity 0.5 trebuie să scrii explicit cine o poate apela: external sau public (din afară), internal sau private (doar din contract). Adaugă cuvântul după paranteza cu parametrii. Î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.
