...
Eroare Blockchain · Hex, bytes și numere mari

OverflowError: int too big to convert

Pe scurt

Numărul nu încape în câți bytes ai cerut la n.to_bytes(lungime, ...). Mărește lungimea (32 de bytes pentru chei și hash-uri) sau calculeaz-o din n.bit_length().

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

Ce înseamnă

n.to_bytes(lungime, "big") scrie numărul pe exact lungime octeți. Un octet poate ține valori până la 255, doi octeți până la 65 535, patru până la aproape 4,3 miliarde. Dacă numărul e mai mare decât încape, Python nu taie în tăcere, ci oprește programul cu OverflowError.

În cod de blockchain apare când pui un nonce, un timestamp sau o sumă în wei pe prea puțini bytes, când scrii o cheie privată sau un hash (256 de biți) pe mai puțin de 32 de bytes, sau când un număr negativ e convertit fără signed=True (atunci mesajul e „can't convert negative int to unsigned”). Lungimea necesară este (n.bit_length() + 7) // 8.

De ce apare: cauzele frecvente

1Nonce-ul crește peste 4 bytes

Greșit
PYTHON
nonce = 5_000_000_000
date = nonce.to_bytes(4, "little")
Corect
PYTHON
nonce = 5_000_000_000
date = nonce.to_bytes(8, "little")

4 bytes țin maximum 4 294 967 295. Pe 8 bytes încape.

2Suma în wei pe prea puțini bytes

Greșit
PYTHON
wei = 2 * 10**18
b = wei.to_bytes(4, "big")
Corect
PYTHON
wei = 2 * 10**18
b = wei.to_bytes(32, "big")

Ethereum ține sumele pe 256 de biți, adică 32 de bytes.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos scrie trei sume în wei ca bytes, cum le pune Ethereum în tranzacții, dar dă OverflowError: int too big to convert. Repară funcția in_bytes ca să folosească lungimea unui uint256 și afișează pentru fiecare sumă numărul de bytes și ultimii 8 bytes în hex.

Codul care dă eroarea
PYTHON
sume = [21000, 10**18, 2 * 10**18 + 5]

def in_bytes(n):
    return n.to_bytes(4, "big")

for s in sume:
    b = in_bytes(s)
    print(len(b), b[-8:].hex())
După reparație, programul afișează
32 0000000000005208
32 0de0b6b3a7640000
32 1bc16d674ec80005
Indiciu

Un uint256 are 256 de biți.

Alte forme ale mesajului

  • OverflowError: can't convert negative int to unsigned

Cum o eviți pe viitor

Folosește lungimile din protocol: 32 de bytes pentru chei private, hash-uri și sume uint256, 20 pentru adrese, 4 sau 8 pentru nonce. Dacă lungimea nu e fixă, calculeaz-o cu (n.bit_length() + 7) // 8 (cu minim 1 pentru n = 0). Testează funcțiile și cu valori mari, nu doar cu numere mici de exemplu.

Întrebări frecvente

De ce Bitcoin are nonce-ul pe 4 bytes dacă nu ajunge?

Nonce-ul din antetul unui bloc Bitcoin chiar are 4 bytes. Când minerii le epuizează, schimbă alt câmp (extraNonce din tranzacția coinbase sau timestamp-ul) și reiau nonce-ul de la 0.

Ce înseamnă „big” și „little”?

Ordinea octeților: big-endian pune octetul cel mai semnificativ primul, little-endian ultimul. Bitcoin folosește little-endian pentru multe câmpuri, Ethereum big-endian.

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.