Decimal(0.1) dă 0.1000000000000000055511151231257827: Decimal creat din float
Decimal(0.1) copiază exact valoarea float-ului 0.1, care în binar nu este 0.1, ci 0.1000000000000000055511... Pentru sume exacte creează Decimal din text: Decimal("0.1"). Altfel conversia în wei sau satoshi iese greșită.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Nu primești nicio eroare, dar 0.1 ether devine 100000000000000005 wei în loc de 100000000000000000. Numărul 0.1 scris în cod este un float, iar un float se păstrează în binar și nu poate reprezenta exact 0.1; valoarea reală e foarte puțin peste. Decimal(0.1) nu „repară” float-ul, ci îl copiază fidel, cu toate cifrele lui ascunse. Abia Decimal("0.1") înseamnă exact zece la minus unu.
În aplicațiile cu monede asta se vede la conversii între unități: ether → wei (10^18), BTC → satoshi (10^8), tokeni cu 6 sau 18 zecimale. O diferență de câțiva wei pare neglijabilă, dar o tranzacție semnată cu o sumă greșită e altă tranzacție, iar comparațiile de solduri nu mai ies egale. Regula: sumele intră în program ca text (din JSON, formular, API) sau direct ca întregi în unitatea cea mai mică, niciodată ca float.
De ce apare: cauzele frecvente
1Decimal construit dintr-un float
from decimal import Decimal
wei = int(Decimal(0.1) * 10 ** 18)from decimal import Decimal
wei = int(Decimal("0.1") * 10 ** 18)Textul "0.1" e citit exact, cifră cu cifră; float-ul 0.1 nu e exact.
2Suma citită din JSON ca float
import json
tx = json.loads('{"suma": 0.3}')
suma = Decimal(tx["suma"])import json
from decimal import Decimal
tx = json.loads('{"suma": 0.3}', parse_float=Decimal)
suma = tx["suma"]parse_float=Decimal citește numerele zecimale din JSON direct ca Decimal, fără să treacă prin float.
Repară eroarea, direct în pagină
Funcția in_wei de mai jos transformă sume în ether în wei, dar creează Decimal din float, așa că 0.1 ether devine 100000000000000005 wei. Repară funcția și apelurile ca sumele să fie primite ca text și transformate exact, iar programul să afișeze valorile în wei și totalul.
from decimal import Decimal
def in_wei(eth):
return int(Decimal(eth) * 10 ** 18)
sume = [0.1, 0.2, 1.15]
total = 0
for s in sume:
w = in_wei(s)
total += w
print(s, "ETH =", w, "wei")
print("Total:", total)0.1 ETH = 100000000000000000 wei 0.2 ETH = 200000000000000000 wei 1.15 ETH = 1150000000000000000 wei Total: 1450000000000000000
Indiciu
Decimal citește exact o sumă dată ca text.
Reparația
from decimal import Decimal
def in_wei(eth):
return int(Decimal(eth) * 10 ** 18)
sume = ["0.1", "0.2", "1.15"]
total = 0
for s in sume:
w = in_wei(s)
total += w
print(s, "ETH =", w, "wei")
print("Total:", total)De ce merge
Float-urile 0.1, 0.2 și 1.15 nu pot fi păstrate exact în binar, iar Decimal(float) copia exact eroarea lor de reprezentare. Date ca text, Decimal("0.1") înseamnă exact o zecime, deci înmulțirea cu 10 la puterea 18 dă un număr întreg de wei. Totalul iese exact 1450000000000000000.
Cum o eviți pe viitor
Ține sumele ca întregi în unitatea cea mai mică (wei, satoshi) și convertește doar la afișare. Când primești o sumă zecimală, creează Decimal din textul ei, iar la JSON folosește json.loads(..., parse_float=Decimal). Poți activa și capcana decimal.FloatOperation, care aruncă o excepție când cineva amestecă float cu Decimal.
Întrebări frecvente
Dar print(0.1) afișează 0.1. De ce?
Pentru că Python afișează cel mai scurt text care se citește înapoi în același float. Valoarea păstrată în memorie e tot puțin peste 0.1, iar Decimal(0.1) o arată complet.
round(Decimal(0.1), 18) nu ajunge?
Ascunde problema pentru 0.1, dar nu și în general. Corect e să nu treci niciodată prin float: Decimal("0.1").
Erori înrudite
0.30000000000000004 în loc de 0.3 la sumele în monede Float-urile nu pot reprezenta exact majoritatea zecimalelor, deci 0.1 + 0.2 dă 0.30000000000000004, iar comparațiile de solduri ies greșit. Lucrează în unități întregi (1 BTC = 100 000 000 satoshi, 1 ETH = 10**18 wei) sau cu Decimal. TypeError: unsupported operand type(s) for *: 'decimal.Decimal' and 'float' Ai înmulțit (sau adunat) un Decimal cu un float, de obicei cu 1e18 sau 1e8. Decimal nu se amestecă cu float: folosește un întreg (10 ** 18) sau Decimal("1e18"). 28999999 satoshi în loc de 29000000: int() taie zecimalele 0.29 nu se poate reprezenta exact ca float, deci 0.29 * 100_000_000 dă 28999999.999999996, iar int() taie partea zecimală și pierzi un satoshi. Folosește round(...) sau, mai sigur, Decimal("0.29") * 100_000_000. Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
