...
← Curs Solidity și Smart Contracts: toate lecțiile
Lecția 12 · Validare

require: regulile contractului

Un contract public poate fi apelat de oricine, cu orice valori. Cu require scrii regulile pe care orice apel trebuie să le respecte: dacă o regulă nu e îndeplinită, tranzacția se anulează complet (revert) și starea rămâne exact cum era.

De ce ai nevoie de reguli

Într-o aplicație obișnuită, validezi datele în formular și pe server. Pe blockchain nu există server: contractul este singurul loc în care poți opri un apel greșit sau rău intenționat. Orice funcție public poate fi apelată direct, ocolind interfața aplicației.

require(conditie, "mesaj") verifică o condiție. Dacă este adevărată, codul continuă. Dacă este falsă, execuția se oprește cu mesajul dat și toate modificările făcute de tranzacție sunt anulate.

seteaza(25)tranzacțieseteaza(40)tranzacțiebarierarequire(t <= 30)25 ≤ 30 → trece40 ≤ 30 → oprittemperatura = 25starea se schimbărevert: Prea caldtemperatura rămâne 25
Tranzacția cu 25 trece de bariera require și schimbă starea; cea cu 40 este oprită, iar temperatura rămâne 25.

Primul require

Un contract pentru bilete de concert acceptă doar vârste de cel puțin 18 ani:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Bilete {
    uint public vandute;

    function cumpara(uint varsta) public {
        require(varsta >= 18, "Doar pentru adulti");
        vandute = vandute + 1;
    }
}
const bilete = await deploy("Bilete");
await bilete.cumpara(20);
console.log("Vândute:", await bilete.vandute());

try {
    await bilete.cumpara(15);
} catch (e) {
    console.log("Refuzat:", motivRevert(e));
}
console.log("Vândute:", await bilete.vandute());
Vândute: 1
Refuzat: Doar pentru adulti
Vândute: 1

Al doilea apel a dat revert, deci vandute nu a crescut. În JavaScript, revert-ul ajunge ca o eroare pe care o prinzi cu try/catch; motivRevert(e) îți dă mesajul din require.

Mesajele fără diacritice

Textele din Solidity cu diacritice trebuie scrise unicode"...". Pentru mesajele din require folosește text simplu, fără diacritice: e mai scurt și costă mai puțin gas la publicare.

Ce se întâmplă la revert

  • Toate variabilele modificate în tranzacție revin la valorile de dinainte, chiar și cele schimbate înainte de require.
  • Ether-ul trimis cu tranzacția se întoarce la expeditor.
  • Gas-ul consumat până la revert se plătește totuși: nodurile au muncit să execute codul.
  • Aplicația primește mesajul erorii și îl poate arăta utilizatorului.

Dacă nu prinzi eroarea, scriptul se oprește, iar consola afișează în roșu Tranzacția a fost anulată (revert): Doar pentru adulti.

if + revert și mai multe reguli

revert("mesaj") oprește execuția fără condiție; îl folosești în interiorul unui if când regula este mai complicată. O funcție poate avea oricâte require, verificate în ordine:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Parcare {
    uint public locuriLibere = 2;

    function intra(uint ora) public {
        require(ora < 24, "Ora invalida");
        if (locuriLibere == 0) {
            revert("Parcare plina");
        }
        locuriLibere = locuriLibere - 1;
    }
}
const parcare = await deploy("Parcare");
console.log(await expectRevert(parcare.intra(25), "Ora invalida"));
await parcare.intra(9);
await parcare.intra(10);
console.log(await expectRevert(parcare.intra(11), "Parcare plina"));
console.log("Locuri libere:", await parcare.locuriLibere());
Ora invalida
Parcare plina
Locuri libere: 0

expectRevert(promisiune, "mesaj") verifică faptul că apelul dă revert cu mesajul așteptat și îți întoarce mesajul. Dacă apelul reușește, testul pică. Îl vei folosi des în teste.

Unde pui require

RegulăExemplu
Validarea parametrilorrequire(suma > 0, "Suma zero");
Cine are voierequire(msg.sender == proprietar, "Nu esti proprietarul");
Starea contractuluirequire(!inchis, "Licitatia s-a inchis");
Soldulrequire(solduri[msg.sender] >= suma, "Sold insuficient");

Pune verificările la începutul funcției, înainte de orice modificare. Așa citești ușor regulile și nu consumi gas degeaba.

Exercițiul tău

Scrie contractul Termostat cu variabila publică temperatura (uint) și funcția seteaza(uint t), care acceptă doar temperaturi de cel mult 30 de grade. Altfel, tranzacția dă revert cu mesajul Prea cald. Scriptul lecției setează 25, încearcă 40 și afișează eroarea și temperatura rămasă.

  • Declară uint public temperatura;.
  • În seteaza, verifică t <= 30 cu require și mesajul Prea cald.
  • Dacă regula trece, salvează t în temperatura.
require(t <= 30, "Prea cald"); apoi temperatura = t;

Soluția exercițiului

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Termostat {
    uint public temperatura;

    function seteaza(uint t) public {
        require(t <= 30, "Prea cald");
        temperatura = t;
    }
}
Excelent! Continuă cu lecția următoare →
Contract.solSolidity
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu smart contracts Lecția 12 · require: regulile contractului
Progres 0% 0 din 17
Lecția curentă 12 / 15 Validare