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.
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.
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 parametrilor | require(suma > 0, "Suma zero"); |
| Cine are voie | require(msg.sender == proprietar, "Nu esti proprietarul"); |
| Starea contractului | require(!inchis, "Licitatia s-a inchis"); |
| Soldul | require(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.
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.
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;
}
} 