...
Eroare Solidity · Erori de sintaxă, pragma și licență

SyntaxError: This looks like an address but has an invalid checksum. Correct checksummed address: "0xFe95ca6E619dF220150A486849D34dD898bfbF41". If this is not used as an address, please prepend '00'. For more information please see https://docs.soliditylang.org/en/develop/types.html#address-literals

Pe scurt

O adresă scrisă direct în cod trebuie să aibă literele mari și mici exact ca în forma checksum (EIP-55). Ai scris-o cu litere mici sau cu o greșeală. Copiază adresa corectă din mesajul erorii sau din ethers.getAddress().

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

Ce înseamnă

Adresele Ethereum sunt numere în hexazecimal, deci 0xfe95... și 0xFE95... sunt aceeași valoare. Standardul EIP-55 folosește însă literele mari și mici ca sumă de control: din hash-ul adresei se calculează care litere trebuie să fie mari. O greșeală de tastare schimbă aproape sigur tiparul, așa că o adresă cu checksum corect e foarte probabil și copiată corect.

Compilatorul cere ca orice adresă scrisă direct în cod (literal) să respecte checksum-ul. Dacă ai scris-o doar cu litere mici, ai copiat-o dintr-un loc care o afișa așa, ori ai schimbat o cifră, primești eroarea, iar mesajul îți dă forma corectă calculată pentru exact ce ai scris.

Atenție: dacă ai greșit o cifră, adresa „corectă” din mesaj e checksum-ul adresei greșite. Verifică întâi cifrele cu sursa.

De ce apare: cauzele frecvente

1Adresă copiată cu litere mici

Greșit
SOLIDITY
address public constant TREZORERIE = 0xfe95ca6e619df220150a486849d34dd898bfbf41;
Corect
SOLIDITY
address public constant TREZORERIE = 0xFe95ca6E619dF220150A486849D34dD898bfbF41;

Forma checksum are exact literele mari cerute de EIP-55.

2Valoare de 20 de octeți care nu e o adresă

Greșit
SOLIDITY
bytes20 cod = 0x1234567890abcdef1234567890abcdef12345678;
Corect
SOLIDITY
bytes20 cod = hex"1234567890abcdef1234567890abcdef12345678";

Un număr hex de 40 de cifre arată ca o adresă. Dacă nu e una, scrie-l ca hex"..." sau prefixează-l cu 00, cum spune mesajul.

Repară tu

Repară eroarea, direct în pagină

Contractul Donatii trimite fiecare donație la trezoreria de la adresa lui bogdan, dar nu se compilează: SyntaxError: This looks like an address but has an invalid checksum. Adresa a fost copiată cu litere mici. Scrie-o în forma checksum (cifrele sunt corecte). Scriptul donează 0,5 ETH și afișează cât a primit bogdan.

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

contract Donatii {
    address public constant TREZORERIE = 0xfe95ca6e619df220150a486849d34dd898bfbf41;

    function doneaza() external payable {
        payable(TREZORERIE).transfer(msg.value);
    }
}
După reparație, programul afișează
Bogdan a primit: 0.5 ETH
Indiciu

Mesajul erorii îți dă chiar forma corectă a adresei.

Cum o eviți pe viitor

  • Nu tasta adresele de mână: copiază-le din portofel, din explorer sau din ethers.getAddress(adresa), care întoarce forma checksum.
  • Când compilatorul îți propune o adresă, compar-o cifră cu cifră cu sursa: el corectează doar literele, nu și cifrele greșite.
  • Pune adresele fixe într-o constantă cu nume (TREZORERIE), nu împrăștiate prin cod.
  • Mai bine: primește adresele în constructor, ca să le poți schimba la publicare.

Întrebări frecvente

De ce nu acceptă compilatorul adresa cu litere mici, dacă e același număr?

Pentru că o adresă greșită înseamnă bani trimiși unde nu trebuie, fără cale de întoarcere. Checksum-ul obligatoriu prinde majoritatea greșelilor de copiere chiar la compilare.

Cum obțin forma checksum din JavaScript?

Cu ethers.getAddress("0xfe95..."). Funcția întoarce adresa cu literele corecte și aruncă o eroare dacă primește o adresă cu litere amestecate greșit.

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.