...
Eroare Solidity · Tipuri și conversii

TypeError: Type int_const 300 is not implicitly convertible to expected type uint8. Literal is too large to fit in uint8.

Pe scurt

Numărul scris direct în cod nu încape în tipul variabilei: un uint8 ține doar valori de la 0 la 255, deci 300 nu încape. Alege un tip mai mare (uint16 sau, cel mai simplu, uint256).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare tip întreg are un interval fix: uint8 de la 0 la 255, uint16 până la 65535, uint32 până la aproximativ 4,29 miliarde, uint256 până la 2^256 - 1. Când atribui un literal (un număr scris direct în cod), compilatorul verifică dacă încape și, dacă nu, se oprește cu Literal is too large to fit in uint8.

Eroarea apare de obicei când alegi un tip mic „ca să economisești gas” și apoi valoarea crește: număr de locuri, procente înmulțite cu 100, ani (2025 nu încape în uint8), sume în wei (nici 1 ether nu încape în uint32).

În realitate, un uint8 separat nu e mai ieftin decât un uint256; economia apare doar când mai multe variabile mici sunt împachetate în același slot de storage. Pentru variabile simple, uint256 e alegerea implicită.

De ce apare: cauzele frecvente

1Tip prea mic pentru o constantă

Greșit
SOLIDITY
uint8 public constant LOCURI = 300;
Corect
SOLIDITY
uint256 public constant LOCURI = 300;

300 depășește maximul unui uint8 (255). uint256 are loc pentru orice valoare realistă.

2An salvat într-un uint8

Greșit
SOLIDITY
uint8 public anInfiintare = 2020;
Corect
SOLIDITY
uint16 public anInfiintare = 2020;

Un uint16 ține până la 65535, suficient pentru ani.

3Sumă în wei într-un tip mic

Greșit
SOLIDITY
uint32 public pret = 1 ether;
Corect
SOLIDITY
uint256 public pret = 1 ether;

1 ether înseamnă 10^18 wei, mult peste limita unui uint32.

Repară tu

Repară eroarea, direct în pagină

Contractul Sala are 300 de locuri, dar compilarea dă TypeError: Type int_const 300 is not implicitly convertible to expected type uint8. Literal is too large to fit in uint8. Schimbă tipul constantei LOCURI într-unul în care încape 300. Scriptul rezervă 250 și apoi 50 de locuri, afișează locurile ocupate și încearcă încă o rezervare.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Sala {
    uint8 public constant LOCURI = 300;
    uint256 public ocupate;

    function rezerva(uint256 n) external {
        require(ocupate + n <= LOCURI, "Sala plina");
        ocupate += n;
    }
}
După reparație, programul afișează
Ocupate: 300 din 300
Încă un loc: Sala plina
Indiciu

Cel mai simplu este uint256.

Alte forme ale mesajului

  • TypeError: Type int_const 256 is not implicitly convertible to expected type uint8. Literal is too large to fit in uint8.
  • TypeError: Type int_const 1000000000000000000 is not implicitly convertible to expected type uint32. Literal is too large to fit in uint32.

Cum o eviți pe viitor

  • Folosește uint256 implicit; alege tipuri mici doar când le împachetezi conștient în același slot.
  • Verifică maximul cu type(uint8).max dacă nu ești sigur.
  • Gândește-te la valorile viitoare, nu doar la cele de azi: un contract publicat nu își mai poate schimba tipurile.
  • Pentru sume de bani, folosește mereu uint256.

Întrebări frecvente

Dacă valoarea crește la rulare peste 255, primesc aceeași eroare?

Nu. Aceasta e o eroare de compilare, pentru numere scrise direct în cod. La rulare, depășirea dă revert cu Panic(0x11) (overflow).

Economisesc gas cu uint8?

Doar dacă mai multe variabile mici încap împreună în același slot de 32 de octeți. O variabilă uint8 singură costă cât un uint256, iar la calcule poate costa chiar mai mult.

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.