...
Eroare Solidity · Funcții: locația datelor, vizibilitate, view și pure

TypeError: Calldata arrays are read-only.

Pe scurt

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 cu new 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

Greșit
SOLIDITY
function dubleaza(uint256[] calldata v) external pure returns (uint256[] memory) {
    for (uint256 i = 0; i < v.length; i++) v[i] *= 2;
    return v;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
v[i] = v[i] * 2;
Corect
SOLIDITY
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

Greșit
SOLIDITY
function corecteaza(Comanda calldata c) external { c.pret = 0; }
Corect
SOLIDITY
function corecteaza(Comanda memory c) external { c.pret = 0; }

Aceeași regulă la struct-uri: mesajul e Calldata structs are read-only.

Repară tu

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.

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
Puncte dublate: [ 20, 50, 80 ]
Indiciu

Ai nevoie de o copie care se poate modifica: memory.

Alte forme ale mesajului

  • TypeError: Calldata structs are read-only.

Cum o eviți pe viitor

  • Folosește calldata pentru parametrii external pe care doar îi citești.
  • Când trebuie să modifici datele primite, declară parametrul memory sau 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

← 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.