...
Eroare Solidity · Tipuri și conversii

TypeError: Type uint256 is not implicitly convertible to expected type uint8.

Pe scurt

Î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

Greșit
SOLIDITY
uint8 public nota;

function seteaza(uint256 n) external {
    nota = n;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
uint8 a = 5;
uint256 b = 10;
uint8 c = a + b;
Corect
SOLIDITY
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

Greșit
SOLIDITY
function zile(uint8 luna) internal pure returns (uint8) { /* ... */ }
uint256 l = 2;
zile(l);
Corect
SOLIDITY
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ă tu

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.

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
Nota lui Bogdan: 9
Nota 300: Nota maxima 10
Indiciu

Întâi require(nota <= 10, ...), apoi uint8(nota).

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 uint256 peste 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

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