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
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
address public constant TREZORERIE = 0xfe95ca6e619df220150a486849d34dd898bfbf41;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ă
bytes20 cod = 0x1234567890abcdef1234567890abcdef12345678;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ă 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.
// 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);
}
}Bogdan a primit: 0.5 ETH
Indiciu
Mesajul erorii îți dă chiar forma corectă a adresei.
Reparația
// 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);
}
}De ce merge
Literele mari și mici dintr-o adresă sunt o sumă de control (EIP-55). Adresa scrisă doar cu litere mici are aceeași valoare, dar compilatorul o respinge, pentru că nu poate verifica dacă a fost copiată corect. Cu forma 0xFe95ca6E619dF220150A486849D34dD898bfbF41, contractul se compilează, iar cei 0,5 ETH ajung la bogdan.
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
TypeError: Type literal_string "100" is not implicitly convertible to expected type uint256. Ai pus un text între ghilimele acolo unde se aștepta un număr (sau o adresă). În Solidity, "100" este un string, nu un număr: scrie valoarea fără ghilimele, 100, sau schimbă tipul variabilei dacă chiar voiai text. TypeError: Explicit type conversion not allowed from "uint256" to "address". Încerci o conversie directă pe care Solidity 0.8 nu o permite, de exemplu address(numar) sau address(hash). Fă conversia în pași, prin tipul intermediar potrivit: address(uint160(numar)) sau address(uint160(uint256(hash))). TypeError: "send" and "transfer" are only available for objects of type "address payable", not "address". Apelezi transfer() sau send() pe o adresă simplă, de exemplu msg.sender.transfer(suma). În 0.8 trebuie payable(msg.sender).transfer(suma) sau, varianta recomandată, (bool ok, ) = payable(msg.sender).call{value: suma}(""); require(ok); Î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.
