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

TypeError: Do not know how to serialize a BigInt

Pe scurt

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

Greșit
SOLIDITY
console.log(JSON.stringify({ pret: await p.pret() }));
Corect
SOLIDITY
console.log(JSON.stringify({ pret: (await p.pret()).toString() }));

Textul "25" se poate serializa; BigInt-ul 25n, nu.

2Replacer pentru tot obiectul

Greșit
SOLIDITY
res.json(await citesteStatistici());
Corect
SOLIDITY
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

Greșit
SOLIDITY
localStorage.setItem("stoc", JSON.stringify({ stoc: await p.stoc() }));
Corect
SOLIDITY
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ă tu

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"}.

Codul care dă eroarea
SOLIDITY
const p = await deploy("Produs");
const date = {
    pret: await p.pret(),
    stoc: await p.stoc(),
};
console.log(JSON.stringify(date));
După reparație, programul afișează
{"pret":"25","stoc":"4"}
Indiciu

Valorile uint256 vin ca BigInt; .toString() le transformă în text.

Cum o eviți pe viitor

  • Tratează orice uint venit 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

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