...
Eroare Solidity · Tipuri și conversii

TypeError: Type rational_const 5 / 2 is not implicitly convertible to expected type uint256. Try converting to type ufixed8x1 or use an explicit conversion.

Pe scurt

Ai scris un număr cu zecimale (2.5) acolo unde Solidity așteaptă un întreg. Contractele nu au numere cu virgulă: lucrează în unități mai mici, de exemplu procente înmulțite cu 100 (250 = 2,5%) sau wei, și împarte la final.

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

Ce înseamnă

Solidity nu are încă numere zecimale utilizabile: tipurile fixed/ufixed există în gramatică, dar nu poți face calcule cu ele. Un literal ca 2.5 este pentru compilator o fracție exactă, rational_const 5 / 2, care nu încape într-un uint256. Sugestia din mesaj (ufixed8x1) nu te ajută în practică.

Soluția standard este aritmetica cu numere întregi scalate: în loc de 2,5% scrii 250 de „puncte de bază” (1 bp = 0,01%) și împarți la 10000; în loc de 0,5 ETH lucrezi în wei (0.5 ether e acceptat, pentru că rezultatul e un întreg: 500000000000000000). Tokenii fac la fel cu decimals(): 1,5 tokeni înseamnă 1500000000000000000 de unități.

Atenție la ordinea operațiilor: înmulțește întâi și împarte la final, altfel pierzi precizie (suma / 10000 * 250 dă 0 pentru sume mici).

De ce apare: cauzele frecvente

1Procent cu zecimale

Greșit
SOLIDITY
uint256 public constant DOBANDA = 2.5; // procente
Corect
SOLIDITY
uint256 public constant DOBANDA_BP = 250; // 2,50% în puncte de bază
// dobanda = suma * DOBANDA_BP / 10000

Valoarea scalată e un întreg, iar împărțirea la 10000 se face la final.

2Preț zecimal în ether

Greșit
SOLIDITY
uint256 public pret = 0.05;
Corect
SOLIDITY
uint256 public pret = 0.05 ether;

Cu unitatea ether, 0.05 se transformă în 50000000000000000 wei, un număr întreg.

3Împărțire înainte de înmulțire

Greșit
SOLIDITY
return suma / 10000 * DOBANDA_BP;
Corect
SOLIDITY
return suma * DOBANDA_BP / 10000;

Asta nu dă eroare de compilare, dar e greșeala care urmează de obicei: împărțirea întreagă la început rotunjește la 0.

Repară tu

Repară eroarea, direct în pagină

Contractul Imprumut calculează o dobândă de 2,5%, dar compilarea dă TypeError: Type rational_const 5 / 2 is not implicitly convertible to expected type uint256. Înlocuiește constanta cu DOBANDA_BP = 250 (2,5% în puncte de bază) și calculează dobânda ca suma * DOBANDA_BP / 10000. Scriptul afișează dobânda pentru 1000 și pentru 200.

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

contract Imprumut {
    uint256 public constant DOBANDA = 2.5;

    function dobanda(uint256 suma) external pure returns (uint256) {
        return suma * DOBANDA / 100;
    }
}
După reparație, programul afișează
Dobânda la 1000: 25
Dobânda la 200: 5
Indiciu

Un punct de bază este 0,01%, deci 100% înseamnă 10000.

Alte forme ale mesajului

  • TypeError: Type rational_const 1 / 2 is not implicitly convertible to expected type uint256. Try converting to type ufixed8x1 or use an explicit conversion.
  • TypeError: Built-in binary operator * cannot be applied to types uint256 and rational_const 5 / 2.

Cum o eviți pe viitor

  • Alege de la început o scală: puncte de bază (10000) pentru procente, wei pentru ether, 10 ** decimals() pentru tokeni.
  • Înmulțește întâi, împarte la final.
  • Scrie scala în numele constantei (DOBANDA_BP, PRET_WEI), ca să nu amesteci unitățile.
  • În scripturi, convertește la afișare cu ethers.formatEther / formatUnits, nu în contract.

Întrebări frecvente

De ce nu are Solidity numere zecimale?

Pentru că rezultatul oricărui calcul trebuie să fie identic pe toate nodurile, iar numerele cu virgulă mobilă se pot rotunji diferit. Întregii scalați sunt exacți și deterministici. Bibliotecile financiare (de exemplu PRBMath) oferă tipuri cu virgulă fixă construite tot pe întregi.

De ce merge 0.5 ether, dar nu 0.5?

Pentru că 0.5 ether înseamnă 0,5 × 10^18 wei, un număr întreg. Compilatorul acceptă literali fracționari doar dacă, după unitate, rezultatul e întreg.

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.