VM Exception while processing transaction: reverted with panic code 0x32 (Array accessed at an out-of-bounds or negative index)
Ai citit sau scris un element de array la un index care nu există: indexul e egal cu length sau mai mare (de exemplu i <= v.length într-o buclă) ori array-ul e gol. Indicii merg de la 0 la length - 1, deci bucla corectă este for (i = 0; i < v.length; i++).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un array cu 3 elemente are indicii 0, 1 și 2. Accesul la v[3] (sau la orice index mai mare) nu întoarce o valoare goală, ca în JavaScript, ci oprește execuția cu Panic(0x32). Același lucru se întâmplă la v[0] pe un array gol și la scrierea într-un array memory de lungime fixă dincolo de capăt.
Cele mai frecvente cauze: bucla cu <= în loc de < (off-by-one), citirea „ultimului element” cu v[v.length] în loc de v[v.length - 1], un index primit de la utilizator fără verificare și un array memory creat cu new uint256[](n) cu n prea mic.
Atenție: getter-ul automat al unui array public (v(5)) se comportă puțin diferit, dă revert fără motiv, nu Panic, dar cauza e aceeași.
De ce apare: cauzele frecvente
1Buclă cu <= în loc de <
for (uint256 i = 0; i <= scoruri.length; i++) {
total += scoruri[i];
}for (uint256 i = 0; i < scoruri.length; i++) {
total += scoruri[i];
}Ultimul index valid este length - 1. Cu <=, ultimul pas citește scoruri[length], care nu există.
2Ultimul element citit cu indexul greșit
return comenzi[comenzi.length];require(comenzi.length > 0, "Nicio comanda");
return comenzi[comenzi.length - 1];Ultimul element e la length - 1, iar pentru un array gol nu există deloc (și length - 1 ar da Panic 0x11).
3Index primit de la utilizator fără verificare
function produs(uint256 id) external view returns (string memory) {
return produse[id];
}function produs(uint256 id) external view returns (string memory) {
require(id < produse.length, "Produs inexistent");
return produse[id];
}Cu verificarea, utilizatorul primește un mesaj clar în loc de Panic.
Repară eroarea, direct în pagină
Contractul Clasament adună scorurile salvate într-un array. Scriptul adaugă scorurile 40, 25 și 35 și cere totalul, dar primește Panic(0x32), acces în afara array-ului. Repară condiția buclei din total, ca să parcurgă exact elementele existente. Scriptul afișează totalul.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Clasament {
uint256[] public scoruri;
function adauga(uint256 scor) external {
scoruri.push(scor);
}
function total() external view returns (uint256 suma) {
for (uint256 i = 0; i <= scoruri.length; i++) {
suma += scoruri[i];
}
}
}Total: 100
Indiciu
Ultimul index valid este scoruri.length - 1.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Clasament {
uint256[] public scoruri;
function adauga(uint256 scor) external {
scoruri.push(scor);
}
function total() external view returns (uint256 suma) {
for (uint256 i = 0; i < scoruri.length; i++) {
suma += scoruri[i];
}
}
}De ce merge
Array-ul are 3 elemente, cu indicii 0, 1 și 2. Cu i <= scoruri.length, ultimul pas citea scoruri[3], care nu există, iar EVM a oprit apelul cu Panic(0x32). Cu i < scoruri.length, bucla se oprește după ultimul element valid, iar totalul este 100.
Alte forme ale mesajului
execution reverted: Panic due to ARRAY_RANGE_ERROR(50)panic: array out-of-bounds access (0x32)
Cum o eviți pe viitor
- Scrie buclele mereu cu
i < v.length. - Verifică indecșii primiți din afară:
require(id < v.length, "..."). - Pentru date căutate după ID, un
mappinge adesea mai potrivit decât un array. - Testează cu array gol, cu un element și cu ultimul index.
Întrebări frecvente
Ce înseamnă „negative index” în mesaj, dacă indexul e uint?
Indexul nu poate fi negativ în Solidity; textul vine din descrierea generală a codului 0x32. În practică, înseamnă doar index mai mare sau egal cu length.
De ce pop() pe un array gol dă alt cod?
pop() pe un array gol are propriul cod, Panic(0x31). Ambele semnalează că ai lucrat cu un element care nu există; verifică length > 0 înainte.
Erori înrudite
VM Exception while processing transaction: reverted with panic code 0x11 (Arithmetic operation underflowed or overflowed outside of an unchecked block) Un calcul a ieșit din limitele tipului: de obicei o scădere care ar da un număr negativ într-un uint (underflow), de exemplu sold -= suma când suma e mai mare decât soldul. Verifică înainte de calcul cu require(sold >= suma, "Sold insuficient"). VM Exception while processing transaction: reverted with panic code 0x12 (Division or modulo division by zero) Contractul a împărțit (sau a calculat restul cu %) la zero, de obicei o medie calculată înainte să existe date sau un număr de participanți egal cu 0. Verifică împărțitorul înainte: if (numar == 0) return 0; sau require(numar > 0, "..."). Transaction ran out of gas Tranzacția a consumat tot gas-ul pe care l-a primit (gasLimit) înainte să se termine, de obicei din cauza unei bucle care scrie de multe ori în storage sau a unei limite de gas setate prea mic. Fă funcția să lucreze în pași constanți (fără bucle care cresc cu datele) sau mărește gasLimit-ul. Î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.
