...
Eroare Solidity · Tipuri și conversii

TypeError: Type int_const -5 is not implicitly convertible to expected type uint256. Cannot implicitly convert signed literal to unsigned type.

Pe scurt

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.

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

Ce înseamnă

uint vine de la „unsigned integer”, întreg fără semn: uint256 ține doar numere de la 0 în sus. int256 ține și numere negative (de la aproximativ -5,7 × 10^76 la +5,7 × 10^76).

Mesajul spune că ai scris un literal numeric cu semn (int_const -5, adică constanta -5) într-un loc unde se aștepta uint256, iar a doua propoziție explică de ce nu merge: un literal negativ nu poate fi convertit într-un tip fără semn.

Apare când modelezi valori care chiar pot fi negative (temperaturi, diferențe, profit / pierdere) cu uint256, sau când vrei să folosești -1 ca „valoare lipsă”, obicei adus din alte limbaje. În Solidity, pentru „nu există” se folosește de obicei 0 sau o variabilă bool separată.

De ce apare: cauzele frecvente

1Valoare care poate fi negativă, declarată uint

Greșit
SOLIDITY
uint256 public temperatura = -5;
Corect
SOLIDITY
int256 public temperatura = -5;

int256 acceptă și valori negative.

2-1 folosit ca valoare „nu există”

Greșit
SOLIDITY
function cauta(uint256 x) external view returns (uint256) {
    // ...
    return -1;
}
Corect
SOLIDITY
function cauta(uint256 x) external view returns (bool gasit, uint256 index) {
    // ...
    return (false, 0);
}

Întoarce două valori: un bool care spune dacă ai găsit elementul și indexul.

3Minus pus în fața unei variabile uint

Greșit
SOLIDITY
uint256 x = 5;
int256 y = -x;
Corect
SOLIDITY
uint256 x = 5;
int256 y = -int256(x);

Minusul unar nu e permis pe uint. Convertește întâi la int256 (după ce știi că valoarea încape).

Repară tu

Repară eroarea, direct în pagină

Contractul Termometru nu se compilează: temperatura minimă de pornire este -5 grade, dar variabila e uint256, așa că apare Cannot implicitly convert signed literal to unsigned type. Schimbă tipul variabilei minima și al parametrului lui inregistreaza, ca să accepte valori negative. Scriptul înregistrează -12 și apoi 3 grade și afișează minima.

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

contract Termometru {
    uint256 public minima = -5;

    function inregistreaza(uint256 grade) external {
        if (grade < minima) {
            minima = grade;
        }
    }
}
După reparație, programul afișează
La început: -5
Minima: -12
Indiciu

Tipul cu semn este int256.

Alte forme ale mesajului

  • TypeError: Type int_const -1 is not implicitly convertible to expected type uint256. Cannot implicitly convert signed literal to unsigned type.
  • TypeError: Unary negation is only allowed for signed integers.

Cum o eviți pe viitor

  • Alege tipul după valorile posibile: uint256 pentru sume, cantități, timestamp-uri, int256 doar pentru valori care chiar pot fi negative.
  • Nu folosi -1 ca semnal special; folosește un bool sau o eroare custom.
  • La diferențe între două uint (a - b), verifică întâi care e mai mare, altfel tranzacția dă Panic 0x11.

Întrebări frecvente

De ce nu folosesc int256 peste tot, ca să fiu sigur?

Pentru că majoritatea valorilor dintr-un contract (solduri, sume în wei, cantități) nu au voie să fie negative, iar uint256 exprimă exact asta. Standardele (ERC-20, ERC-721) folosesc uint256, iar amestecul de int și uint cere conversii peste tot.

Ce se întâmplă dacă scad și rezultatul ar fi negativ la uint256?

În Solidity 0.8 tranzacția dă revert cu Panic(0x11) (underflow). Nu primești un număr negativ și nici unul uriaș, ca în versiunile vechi.

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.