TypeError: Types containing (nested) mappings can only be parameters or return variables of internal or library functions.
O funcție publică sau externă primește sau întoarce o structură care conține un mapping. Asemenea tipuri nu pot fi codificate în ABI. Întoarce câmpurile simple separat (returns (string memory nume, uint256 puncte)) sau scoate mapping-ul din structură.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tot ce intră sau iese dintr-o funcție public / external trebuie codificat în ABI, ca să-l poată trimite sau citi o aplicație (ethers, Remix, alt contract). Un mapping nu poate fi codificat: nu are lungime și nu are o listă de chei. Prin urmare, nici o structură care conține un mapping nu poate fi parametru sau valoare întoarsă a unei funcții publice.
Funcțiile internal și private nu folosesc ABI-ul: primesc structura ca referință storage, deci acolo e permis. Mesajul îți spune exact asta.
Reparații uzuale: un getter care întoarce câmpurile simple ca listă de valori, o structură separată fără mapping (de exemplu EchipaInfo) construită în funcție, sau mutarea mapping-ului în afara structurii, ca variabilă de stare separată indexată după ID. Getter-ul automat al unei variabile public de tipul acesta omite oricum mapping-ul.
De ce apare: cauzele frecvente
1Întorci toată structura
function detalii() external view returns (Echipa memory) {
return echipa;
}function detalii() external view returns (string memory nume, uint256 puncte) {
return (echipa.nume, echipa.puncte);
}Câmpurile simple se pot codifica în ABI; mapping-ul nu.
2Structură primită ca parametru public
function salveaza(Echipa memory e) external { }function salveaza(string calldata nume, uint256 puncte) external {
echipa.nume = nume;
echipa.puncte = puncte;
}Aplicația trimite valorile simple, iar contractul le scrie în structura din storage.
3Mapping-ul scos din structură
struct Echipa { string nume; mapping(address => bool) membri; }struct Echipa { string nume; uint256 puncte; }
mapping(uint256 => mapping(address => bool)) public membri;Fără mapping, structura poate fi întoarsă întreagă.
Repară eroarea, direct în pagină
Contractul Concurs are o echipă cu nume, puncte și un mapping de membri. Funcția detalii întoarce toată structura, iar compilarea dă TypeError: Types containing (nested) mappings can only be parameters or return variables of internal or library functions. Fă-o să întoarcă două valori numite, nume și puncte. Scriptul intră în echipă, adaugă 7 puncte și afișează detaliile.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Concurs {
struct Echipa {
string nume;
uint256 puncte;
mapping(address => bool) membri;
}
Echipa private echipa;
constructor() {
echipa.nume = "Delfinii";
}
function intra() external {
echipa.membri[msg.sender] = true;
}
function adaugaPuncte(uint256 p) external {
require(echipa.membri[msg.sender], "Nu esti in echipa");
echipa.puncte += p;
}
function detalii() external view returns (Echipa memory) {
return echipa;
}
}Delfinii 7
Indiciu
Întoarce (string memory nume, uint256 puncte), nu Echipa memory.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Concurs {
struct Echipa {
string nume;
uint256 puncte;
mapping(address => bool) membri;
}
Echipa private echipa;
constructor() {
echipa.nume = "Delfinii";
}
function intra() external {
echipa.membri[msg.sender] = true;
}
function adaugaPuncte(uint256 p) external {
require(echipa.membri[msg.sender], "Nu esti in echipa");
echipa.puncte += p;
}
function detalii() external view returns (string memory nume, uint256 puncte) {
return (echipa.nume, echipa.puncte);
}
}De ce merge
Valorile întoarse de o funcție externă se codifică în ABI, iar un mapping nu se poate codifica, deci nici structura care îl conține. Întorcând doar nume și puncte, funcția trimite exact datele care au sens în afara contractului. ethers le primește ca listă cu nume, deci scriptul afișează Delfinii 7.
Cum o eviți pe viitor
- Ține mapping-urile ca variabile de stare separate, nu în structurile pe care vrei să le întorci.
- Pentru citirea din aplicații, scrie getter-e care întorc câmpuri simple.
- Folosește structurile cu mapping doar în funcții interne, ca
storage. - Când adaugi un mapping într-o structură existentă, verifică toate funcțiile publice care o primesc sau o întorc.
Întrebări frecvente
Getter-ul automat al lui public echipa merge?
Da: pentru o variabilă public de tip structură, compilatorul generează un getter care întoarce doar câmpurile simple și sare peste mapping-uri și array-uri.
Cum citesc atunci membrii?
Cu o funcție separată: function esteMembru(address a) external view returns (bool) { return echipa.membri[a]; }.
Erori înrudite
TypeError: Types in storage containing (nested) mappings cannot be assigned to. Ai încercat să copiezi dintr-o variabilă de stare în alta o structură (sau un mapping) care conține un mapping. Mapping-urile nu se pot copia, pentru că nu au o listă de chei. Copiază câmpurile simple unul câte unul și lasă mapping-ul deoparte. TypeError: Struct containing a (nested) mapping cannot be constructed. Un struct care conține un mapping nu poate fi creat cu Propunere(...) și nu poate exista în memory. Adaugă un element gol direct în storage, cu Propunere storage p = propuneri.push();, apoi setează câmpurile pe rând. TypeError: Uninitialized mapping. Mappings cannot be created dynamically, you have to assign them from a state variable. Ai declarat un mapping ca variabilă locală, fără să-l legi de un mapping de stare. Mapping-urile există doar în storage, ca variabile de stare. O variabilă locală de tip mapping poate fi doar un alias: mapping(address => uint256) storage t = puncteAur; Î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.
