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

TypeError: Types containing (nested) mappings can only be parameters or return variables of internal or library functions.

Pe scurt

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

Greșit
SOLIDITY
function detalii() external view returns (Echipa memory) {
    return echipa;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function salveaza(Echipa memory e) external { }
Corect
SOLIDITY
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ă

Greșit
SOLIDITY
struct Echipa { string nume; mapping(address => bool) membri; }
Corect
SOLIDITY
struct Echipa { string nume; uint256 puncte; }
mapping(uint256 => mapping(address => bool)) public membri;

Fără mapping, structura poate fi întoarsă întreagă.

Repară tu

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.

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
Delfinii 7
Indiciu

Întoarce (string memory nume, uint256 puncte), nu Echipa memory.

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

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