...
Eroare Solidity · Cod scris pentru versiuni vechi de Solidity

TypeError: "sha3" has been deprecated in favour of "keccak256".

Pe scurt

sha3 era vechiul nume al funcției de hash din Solidity. Folosește keccak256, care primește un singur argument de tip bytes: keccak256(bytes(text)) pentru un text, keccak256(abi.encode(a, b)) pentru mai multe valori.

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

Ce înseamnă

În primele versiuni de Solidity, funcția de hash Keccak-256 se numea sha3. Numele era înșelător, pentru că standardul final SHA-3 diferă puțin de Keccak-ul folosit de Ethereum, așa că a fost redenumită keccak256, iar sha3 a fost eliminat în 0.5. Compilatorul 0.8 îți spune exact ce să folosești: "sha3" has been deprecated in favour of "keccak256".

Odată cu redenumirea s-a schimbat și modul de apel: sha3(a, b) accepta mai multe argumente, pe care le lipea automat, iar keccak256 primește un singur argument de tip bytes. Deci:

  • un text devine keccak256(bytes(text)) sau keccak256(abi.encodePacked(text));
  • mai multe valori devin keccak256(abi.encode(a, b)).

Rezultatul e același bytes32 ca înainte, deci hash-urile salvate cu codul vechi rămân valide.

De ce apare: cauzele frecvente

1Hash-ul unui text

Greșit
SOLIDITY
return sha3(raspuns) == HASH_CORECT;
Corect
SOLIDITY
return keccak256(bytes(raspuns)) == HASH_CORECT;

keccak256 primește bytes; conversia bytes(text) dă exact bytes-ii textului.

2Hash din mai multe valori

Greșit
SOLIDITY
bytes32 id = sha3(msg.sender, nonce);
Corect
SOLIDITY
bytes32 id = keccak256(abi.encode(msg.sender, nonce));

abi.encode combină valorile într-un singur bytes, fără ambiguități.

Repară tu

Repară eroarea, direct în pagină

Contractul Ghicitoare verifică răspunsul la o ghicitoare comparând hash-uri, dar folosește sha3, iar compilarea dă TypeError: "sha3" has been deprecated in favour of "keccak256".. Rescrie calculul hash-ului cu keccak256. Scriptul verifică răspunsurile „albastru” (corect) și „rosu”.

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

contract Ghicitoare {
    bytes32 public constant HASH_CORECT = keccak256("albastru");

    function verifica(string memory raspuns) external pure returns (bool) {
        return sha3(raspuns) == HASH_CORECT;
    }
}
După reparație, programul afișează
albastru: true
rosu: false
Indiciu

keccak256 primește un singur argument de tip bytes: keccak256(bytes(raspuns)).

Cum o eviți pe viitor

  • Folosește mereu keccak256 cu un singur argument bytes.
  • Pentru mai multe valori, preferă abi.encode lui abi.encodePacked (evită coliziunile între texte de lungime variabilă).
  • În JavaScript, același hash îl obții cu ethers.keccak256(ethers.toUtf8Bytes(text)) sau ethers.id(text).
  • Când actualizezi cod vechi, caută în fișier toate aparițiile lui sha3.

Întrebări frecvente

keccak256 e același lucru cu SHA-3?

Aproape, dar nu identic: Ethereum folosește Keccak-256 în varianta de dinainte de standardizarea SHA-3, cu alt padding. De aceea un hash SHA-3 calculat cu o bibliotecă standard nu se potrivește cu keccak256.

Există și sha256 în Solidity?

Da, sha256(bytes) există ca precompilat și dă hash-ul SHA-256 obișnuit. E folosit mai rar, de exemplu pentru compatibilitate cu Bitcoin.

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.