TypeError: Type uint256 is not implicitly convertible to expected type uint8.
Încerci să pui o valoare uint256 într-o variabilă mai mică (uint8, uint16, uint128), unde s-ar putea să nu încapă. Solidity cere o conversie explicită, uint8(valoare), după ce verifici că valoarea încape, sau tipuri egale peste tot.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
uint8 ține numere de la 0 la 255, uint16 până la 65535, iar uint256 până la un număr cu 78 de cifre. Compilatorul permite automat doar conversiile sigure, de la un tip mai mic la unul mai mare (uint8 în uint256). Invers, de la uint256 la uint8, valoarea s-ar putea să nu încapă, așa că îți cere să scrii explicit conversia.
Atenție la conversia explicită: uint8(300) nu dă eroare, ci taie biții în plus și dă 44. De aceea, înainte de uint8(x), verifică cu require(x <= 255) (sau o limită mai strictă, ca nota maximă 10).
Aceeași regulă se aplică între int și uint (nu poți pune automat un int256 într-un uint256) și la parametrii funcțiilor: dacă funcția primește uint8, nu îi poți da direct o variabilă uint256.
De ce apare: cauzele frecvente
1Parametru uint256 pus într-o variabilă uint8
uint8 public nota;
function seteaza(uint256 n) external {
nota = n;
}uint8 public nota;
function seteaza(uint256 n) external {
require(n <= 10, "Nota maxima 10");
nota = uint8(n);
}După require, știi sigur că n încape, iar uint8(n) face conversia explicită.
2Rezultatul unui calcul are tipul mai mare
uint8 a = 5;
uint256 b = 10;
uint8 c = a + b;uint8 a = 5;
uint256 b = 10;
uint256 c = a + b;a + b are tipul cel mai mare dintre cele două (uint256). Cel mai simplu e să păstrezi rezultatul în uint256.
3Tipuri diferite între parametru și argument
function zile(uint8 luna) internal pure returns (uint8) { /* ... */ }
uint256 l = 2;
zile(l);function zile(uint8 luna) internal pure returns (uint8) { /* ... */ }
uint8 l = 2;
zile(l);Argumentul trebuie să aibă un tip convertibil automat la tipul parametrului.
Repară eroarea, direct în pagină
Contractul Catalog nu se compilează și dă TypeError: Type uint256 is not implicitly convertible to expected type uint8. Nota se salvează ca uint8, dar parametrul e uint256. Repară funcția noteaza: respinge notele peste 10 cu mesajul "Nota maxima 10" și apoi salvează nota cu o conversie explicită. Scriptul pune nota 9 și încearcă nota 300.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Catalog {
mapping(address => uint8) public note;
function noteaza(address elev, uint256 nota) external {
note[elev] = nota;
}
}Nota lui Bogdan: 9 Nota 300: Nota maxima 10
Indiciu
Întâi require(nota <= 10, ...), apoi uint8(nota).
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Catalog {
mapping(address => uint8) public note;
function noteaza(address elev, uint256 nota) external {
require(nota <= 10, "Nota maxima 10");
note[elev] = uint8(nota);
}
}De ce merge
Un uint256 poate fi mult mai mare decât 255, maximul unui uint8, deci compilatorul nu face conversia singur. require(nota <= 10, ...) garantează că valoarea încape, iar uint8(nota) spune explicit că vrei conversia. Ordinea contează: fără require, uint8(300) ar fi salvat 44 fără nicio eroare. Așa, nota 9 se salvează, iar nota 300 e respinsă cu mesajul tău.
Alte forme ale mesajului
TypeError: Type int256 is not implicitly convertible to expected type uint256.TypeError: Type uint256 is not implicitly convertible to expected type uint128.TypeError: Invalid type for argument in function call. Invalid implicit conversion from uint256 to uint8 requested.
Cum o eviți pe viitor
- Folosește
uint256peste tot, cu excepția cazurilor în care împachetezi intenționat variabile mici într-un slot de storage. - Când folosești tipuri mici, verifică limita înainte de conversie:
require(x <= type(uint8).max). - Nu converti „ca să tacă compilatorul”:
uint8(x)taie valorile mari fără niciun mesaj.
Întrebări frecvente
uint8 e mai ieftin decât uint256?
Nu neapărat. EVM lucrează pe cuvinte de 256 de biți, iar o variabilă locală uint8 costă chiar puțin mai mult (se adaugă operații de mascare). Tipurile mici economisesc gas doar când mai multe variabile de stare încap împreună în același slot.
Ce se întâmplă la uint8(256)?
Rezultatul este 0, pentru că se păstrează doar ultimii 8 biți. Conversiile explicite între numere nu dau revert la depășire; doar operațiile aritmetice (+, -, *) sunt verificate în 0.8.
Erori înrudite
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. TypeError: Type int_const -5 is not implicitly convertible to expected type uint256. Cannot implicitly convert signed literal to unsigned type. Ai pus un număr negativ într-o variabilă uint (fără semn), care poate ține doar valori de la 0 în sus. Dacă valoarea poate fi negativă, folosește int256; dacă nu, verifică de ce ai ajuns la un număr negativ. VM Exception while processing transaction: reverted with panic code 0x11 (Arithmetic operation underflowed or overflowed outside of an unchecked block) Un calcul a ieșit din limitele tipului: de obicei o scădere care ar da un număr negativ într-un uint (underflow), de exemplu sold -= suma când suma e mai mare decât soldul. Verifică înainte de calcul cu require(sold >= suma, "Sold insuficient"). Î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.
