...
Eroare Blockchain · Tranzacții, sume și UTXO

0.30000000000000004 în loc de 0.3 la sumele în monede

Pe scurt

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.

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

Ce înseamnă

Nu e o excepție, ci un rezultat neașteptat: un sold de 0.30000000000000004, o verificare sold == 0.3 care dă False sau o tranzacție respinsă pentru că „lipsește” o fracțiune infimă. Cauza: float stochează numerele în baza 2, iar 0.1 sau 0.2 nu au o reprezentare exactă în baza 2, la fel cum 1/3 nu are o reprezentare exactă în zecimal. Erorile mici se adună la fiecare operație.

Într-un registru de monede, asemenea erori sunt inacceptabile: fiecare nod trebuie să obțină exact aceleași solduri. De aceea Bitcoin ține sumele în satoshi (întregi), iar Ethereum în wei. Zecimalele apar doar la afișare. Pentru conversii din text cu zecimale folosește Decimal, apoi treci în unități întregi.

De ce apare: cauzele frecvente

1Sume în BTC ca float

Greșit
PYTHON
sold = 0.1 + 0.2
print(sold == 0.3)   # False
Corect
PYTHON
SAT = 100_000_000
sold = 10_000_000 + 20_000_000
print(sold == 30_000_000)   # True

În satoshi, sumele sunt întregi, iar adunarea întregilor e exactă.

2Conversie din text cu float

Greșit
PYTHON
sat = int(float("0.29") * 100_000_000)   # 28999999
Corect
PYTHON
from decimal import Decimal
sat = int(Decimal("0.29") * 100_000_000)   # 29000000

float("0.29") * 1e8 dă 28999999.999999996, iar int taie la 28999999. Decimal lucrează exact în zecimal.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos verifică dacă intrările unei tranzacții acoperă exact plata plus comisionul, dar lucrează cu BTC ca float și afișează Echilibrată: False. Repară-l ca să lucreze în satoshi (întregi) și afișează Intrări: 30000000 sat, Ieșiri + comision: 30000000 sat și Echilibrată: True.

Codul care dă eroarea
PYTHON
intrari = [0.1, 0.2]
iesiri = [0.25, 0.0499]
comision = 0.0001

total_in = sum(intrari)
total_out = sum(iesiri) + comision
print("Intrări:", total_in)
print("Ieșiri + comision:", total_out)
print("Echilibrată:", total_in == 0.3)
După reparație, programul afișează
Intrări: 30000000 sat
Ieșiri + comision: 30000000 sat
Echilibrată: True
Indiciu

Transformă fiecare sumă în satoshi, ca întreg, înainte de adunare.

Cum o eviți pe viitor

Ține toate sumele ca întregi în cea mai mică unitate: satoshi, wei sau, pentru tokenuri, unitatea definită de decimals. Convertește din text o singură dată, cu Decimal, și afișează cu zecimale doar la final: f"{sat / 100_000_000:.8f} BTC" (sau cu Decimal). Nu compara niciodată sume float cu ==.

Întrebări frecvente

E o greșeală a lui Python?

Nu. Toate limbajele care folosesc float-uri standard (IEEE 754) dau același rezultat, inclusiv JavaScript, Java și C. E un efect al reprezentării în baza 2.

round(..., 8) nu rezolvă problema?

Ascunde problema la afișare, dar erorile se pot aduna între rotunjiri și pot da rezultate diferite pe noduri diferite. Întregii elimină complet problema.

Erori înrudite

← Toate erorile Blockchain

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ță 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.