TypeError: Calldata arrays are read-only.
Ai încercat să modifici un parametru calldata (v[i] = ..., v[i] *= 2). Datele din calldata vin direct din tranzacție și nu pot fi schimbate. Dacă vrei să le modifici, declară parametrul memory (se face o copie) sau scrie rezultatele într-un array nou.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
calldata este zona în care stau argumentele trimise funcției, exact cum au venit în tranzacție. Citirea din ea e cea mai ieftină, de aceea se recomandă calldata pentru parametrii external de tip array, string sau struct. Prețul este că datele sunt doar pentru citire: orice atribuire v[i] = ..., v[i] += ... sau delete v[i] dă Calldata arrays are read-only. (la struct-uri, Calldata structs are read-only.).
Ai două variante:
- declari parametrul
memory: la apel se face o copie în memorie, pe care o poți modifica (costă puțin mai mult gas); - îl lași
calldatași scrii rezultatul într-un array nou, creat cunew uint256[](v.length), sau în storage.
Alegerea depinde de ce face funcția: dacă doar citește (suma, căutare, validare), calldata e ideal; dacă transformă datele pe loc, ai nevoie de memory.
De ce apare: cauzele frecvente
1Transformare pe loc a unui parametru calldata
function dubleaza(uint256[] calldata v) external pure returns (uint256[] memory) {
for (uint256 i = 0; i < v.length; i++) v[i] *= 2;
return v;
}function dubleaza(uint256[] memory v) external pure returns (uint256[] memory) {
for (uint256 i = 0; i < v.length; i++) v[i] *= 2;
return v;
}Cu memory, funcția lucrează pe o copie, care se poate modifica.
2Păstrezi calldata și scrii într-un array nou
v[i] = v[i] * 2;uint256[] memory rezultat = new uint256[](v.length);
for (uint256 i = 0; i < v.length; i++) rezultat[i] = v[i] * 2;Citești din calldata (ieftin) și scrii în memorie.
3Câmp al unui struct calldata
function corecteaza(Comanda calldata c) external { c.pret = 0; }function corecteaza(Comanda memory c) external { c.pret = 0; }Aceeași regulă la struct-uri: mesajul e Calldata structs are read-only.
Repară eroarea, direct în pagină
Contractul Promotii dublează punctele de fidelitate primite într-o listă, dar compilarea dă TypeError: Calldata arrays are read-only.. Schimbă locația parametrului, ca funcția să poată modifica lista pe loc. Scriptul trimite punctele [10, 25, 40] și afișează rezultatul.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Promotii {
function dubleaza(uint256[] calldata puncte) external pure returns (uint256[] memory) {
for (uint256 i = 0; i < puncte.length; i++) {
puncte[i] *= 2;
}
return puncte;
}
}Puncte dublate: [ 20, 50, 80 ]
Indiciu
Ai nevoie de o copie care se poate modifica: memory.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Promotii {
function dubleaza(uint256[] memory puncte) external pure returns (uint256[] memory) {
for (uint256 i = 0; i < puncte.length; i++) {
puncte[i] *= 2;
}
return puncte;
}
}De ce merge
Parametrii calldata sunt chiar datele tranzacției, așa că nu se pot modifica. Cu memory, la apel se face o copie a listei în memoria funcției, iar puncte[i] *= 2 modifică acea copie. Funcția întoarce lista dublată: 20, 50 și 80.
Alte forme ale mesajului
TypeError: Calldata structs are read-only.
Cum o eviți pe viitor
- Folosește
calldatapentru parametrii external pe care doar îi citești. - Când trebuie să modifici datele primite, declară parametrul
memorysau copiază-le într-un array nou. - Nu încerca să „cureți” datele primite pe loc; validează-le cu
requireși salvează în storage doar ce e corect.
Întrebări frecvente
calldata merge și la funcțiile public?
Da, din 0.6.9 poți folosi calldata la orice funcție, nu doar la cele external. Regula rămâne: datele sunt doar pentru citire.
De ce calldata e mai ieftin?
Pentru că nu se face nicio copie: funcția citește direct din datele tranzacției. Cu memory, compilatorul copiază tot array-ul în memorie la intrarea în funcție.
Erori înrudite
TypeError: Data location must be "memory" or "calldata" for parameter in function, but none was given. Un parametru de tip string, bytes, array sau struct trebuie să spună unde stau datele. Adaugă memory sau calldata după tip: string memory nume (sau string calldata nume în funcțiile external, unde e mai ieftin). TypeError: Member "push" is not available in uint256[] memory outside of storage. push() și pop() există doar pentru array-urile din storage. Un array memory are lungimea fixă, stabilită la creare cu new uint256[](n). Creează-l cu lungimea potrivită și scrie elementele după index, sau folosește un array de stare. TypeError: Member "length" is read-only and cannot be used to resize arrays. Din Solidity 0.6, lungimea unui array nu se mai poate seta (lista.length = 0 sau lista.length--). Ca să golești array-ul folosește delete lista, ca să scoți ultimul element folosește lista.pop(), iar ca să adaugi, lista.push(x). Î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.
