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

28999999 satoshi în loc de 29000000: int() taie zecimalele

Pe scurt

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.

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

Ce înseamnă

Nu primești nicio eroare: suma pur și simplu iese cu 1 satoshi mai mică. Float-urile sunt numere în baza 2, iar majoritatea zecimalelor (0.1, 0.29, 0.57) nu au o reprezentare exactă: în memorie, 0.29 este de fapt puțin sub 0.29. Înmulțit cu 100 000 000 dă 28999999.999999996. int() nu rotunjește, ci taie tot ce e după virgulă, deci obții 28999999.

În aplicații de plăți, un satoshi lipsă înseamnă o tranzacție care nu se mai potrivește cu suma cerută, un sold care nu se închide sau un comision calculat greșit. Regula din curs: sumele se țin în unități întregi (satoshi, wei) peste tot în program. Conversia din text sau din BTC se face o singură dată, cu Decimal din text sau cu round, niciodată cu int pe un float.

De ce apare: cauzele frecvente

1int() pe rezultatul unui float

Greșit
PYTHON
suma_btc = 0.29
sat = int(suma_btc * 100_000_000)
Corect
PYTHON
suma_btc = 0.29
sat = round(suma_btc * 100_000_000)

round duce la cel mai apropiat întreg, deci 28999999.999999996 devine 29000000.

2Suma vine ca text

Greșit
PYTHON
suma = "0.57"
sat = int(float(suma) * 10**8)
Corect
PYTHON
from decimal import Decimal

suma = "0.57"
sat = int(Decimal(suma) * 10**8)

Decimal("0.57") păstrează exact zecimalele din text, deci înmulțirea dă exact 57000000.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos transformă sume în BTC, primite ca text, în satoshi, dar unele ies cu un satoshi mai puțin (de exemplu 0.29 -> 28999999). Repară funcția in_satoshi folosind Decimal, ca toate sumele să fie exacte și totalul să fie Total: 90000000.

Codul care dă eroarea
PYTHON
sume = ["0.29", "0.57", "0.04"]

def in_satoshi(text):
    return int(float(text) * 100_000_000)

total = 0
for s in sume:
    sat = in_satoshi(s)
    total += sat
    print(s, "->", sat)
print("Total:", total)
După reparație, programul afișează
0.29 -> 29000000
0.57 -> 57000000
0.04 -> 4000000
Total: 90000000
Indiciu

Construiește un Decimal direct din text, nu din float.

Cum o eviți pe viitor

Lucrează în unități întregi peste tot: satoshi pentru Bitcoin, wei pentru Ethereum. Convertește la intrare, din text, cu Decimal (nu din float) și verifică dacă suma are mai multe zecimale decât permite moneda (8 la BTC, 18 la ETH). La afișare, împarte cu Decimal sau formatează: f"{sat // 108}.{sat % 108:08d}".

Întrebări frecvente

De ce round și nu int?

int taie spre zero, round alege cel mai apropiat întreg. Pentru o valoare ca 28999999.999999996, doar round dă rezultatul corect.

Dacă folosesc round, mai am probleme?

Pentru sume obișnuite, nu. Pentru sume foarte mari sau calcule în lanț, float-ul pierde precizie, de aceea Decimal din text e varianta sigură.

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.