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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Din ethers v6, orice număr întreg din Solidity (uint256, int256, uint8...) ajunge în JavaScript ca BigInt (25n), pentru că valorile pot depăși cu mult limita de precizie a tipului Number. console.log le afișează fără probleme, dar JSON.stringify nu are o regulă pentru BigInt și aruncă TypeError: Do not know how to serialize a BigInt.
Apare când trimiți rezultatele unui contract într-un răspuns HTTP (res.json(...)), le salvezi într-un fișier, le pui în localStorage sau le afișezi cu JSON.stringify ca să fie mai ușor de citit. În ethers v5, numerele erau obiecte BigNumber, iar codul vechi care le serializa produce acum această eroare.
Reparația: convertește valorile în text (.toString()) sau în număr (Number(x), doar dacă sigur încap în 2^53), ori folosește un replacer care face asta pentru toate valorile BigInt din obiect.
De ce apare: cauzele frecvente
1Rezultatul contractului pus direct în JSON
console.log(JSON.stringify({ pret: await p.pret() }));console.log(JSON.stringify({ pret: (await p.pret()).toString() }));Textul "25" se poate serializa; BigInt-ul 25n, nu.
2Replacer pentru tot obiectul
res.json(await citesteStatistici());const text = JSON.stringify(await citesteStatistici(), (k, v) => typeof v === "bigint" ? v.toString() : v);
res.type("json").send(text);Replacer-ul convertește fiecare BigInt, oriunde ar fi în obiect.
3Conversie în Number pentru valori mici
localStorage.setItem("stoc", JSON.stringify({ stoc: await p.stoc() }));localStorage.setItem("stoc", JSON.stringify({ stoc: Number(await p.stoc()) }));Merge pentru valori mici (stocuri, ID-uri); pentru sume în wei, păstrează textul.
Repară eroarea, direct în pagină
Scriptul de mai jos (fișierul test.js) publică contractul Produs și vrea să afișeze prețul și stocul ca JSON, dar dă TypeError: Do not know how to serialize a BigInt. Convertește valorile citite din contract în text înainte de JSON.stringify. Scriptul trebuie să afișeze {"pret":"25","stoc":"4"}.
const p = await deploy("Produs");
const date = {
pret: await p.pret(),
stoc: await p.stoc(),
};
console.log(JSON.stringify(date));{"pret":"25","stoc":"4"}Indiciu
Valorile uint256 vin ca BigInt; .toString() le transformă în text.
Reparația
const p = await deploy("Produs");
const date = {
pret: (await p.pret()).toString(),
stoc: (await p.stoc()).toString(),
};
console.log(JSON.stringify(date));De ce merge
ethers v6 întoarce fiecare uint256 ca BigInt, iar standardul JSON nu are un tip pentru numere de mărime arbitrară, deci JSON.stringify refuză să le serializeze. După .toString(), valorile sunt texte ("25", "4"), pe care JSON le acceptă. La citire, le poți transforma înapoi cu BigInt(text).
Cum o eviți pe viitor
- Tratează orice
uintvenit din contract ca BigInt în JavaScript. - Convertește în text înainte de JSON, iar la citire înapoi folosește
BigInt(text). - Pentru sume în ether, afișează cu
ethers.formatEther(x), care întoarce text. - Nu converti sume în wei cu
Number(x): pierzi precizie peste 2^53.
Întrebări frecvente
De ce console.log merge, dar JSON.stringify nu?
console.log are propriul mod de afișare pentru BigInt (în Node apare cu n, în mediul cursului fără). JSON.stringify urmează standardul JSON, care nu are un tip pentru numere mari, așa că refuză să ghicească.
Pot adăuga BigInt.prototype.toJSON?
Se poate (BigInt.prototype.toJSON = function () { return this.toString(); }), dar modifică comportamentul global pentru tot proiectul și poate surprinde alte biblioteci. Un replacer local e mai sigur.
Erori înrudite
TypeError: Cannot mix BigInt and other types, use explicit conversions Ai făcut un calcul între un BigInt (un număr citit din contract cu ethers v6) și un Number obișnuit, de exemplu (await c.pret()) * 3. Scrie și celălalt număr ca BigInt, cu n la final (3n), sau convertește explicit cu BigInt(x). 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ă. TypeError: Type literal_string "100" is not implicitly convertible to expected type uint256. Ai pus un text între ghilimele acolo unde se aștepta un număr (sau o adresă). În Solidity, "100" este un string, nu un număr: scrie valoarea fără ghilimele, 100, sau schimbă tipul variabilei dacă chiar voiai text. Î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.
