Recapitulare: avizierul
Ai terminat primul modul. Ai învățat ce este un contract, cum rulează în EVM, cum îi scrii variabilele, funcțiile și regulile și cum anunță ce s-a întâmplat. În această lecție le pui pe toate împreună într-un mini-proiect: avizierul unei asociații, cu mesajul zilei.
Ce știi deja
| Concept | Cum arată | Lecția |
|---|---|---|
| Variabile de stare | string public mesaj; | 6 |
| Constructor | constructor(string memory m) { ... } | 11 |
| Funcție care schimbă starea | function schimbaMesaj(...) public | 8 |
| view / pure | function total() public view returns (uint) | 9 |
| Reguli | require(conditie, "mesaj"); | 12 |
| Cine apelează | msg.sender == proprietar | 13 |
| Evenimente | event X(...) + emit X(...) | 14 |
Totul într-un singur contract: sondajul
Înainte de proiectul tău, un exemplu complet care folosește toate elementele: un sondaj în care autorul pune o întrebare, iar ceilalți votează da sau nu. Am folosit și if / else (îl vei studia în detaliu în lecția 20), cu aceeași formă ca în JavaScript.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Sondaj {
string public intrebare;
address public autor;
uint public voturiDa;
uint public voturiNu;
event Vot(address indexed votant, bool raspuns);
constructor(string memory intrebareInitiala) {
intrebare = intrebareInitiala;
autor = msg.sender;
}
function voteaza(bool raspuns) public {
require(msg.sender != autor, "Autorul nu voteaza");
if (raspuns) {
voturiDa = voturiDa + 1;
} else {
voturiNu = voturiNu + 1;
}
emit Vot(msg.sender, raspuns);
}
function totalVoturi() public view returns (uint) {
return voturiDa + voturiNu;
}
}const sondaj = await deploy("Sondaj", "Facem excursie vineri?");
await (await sondaj.connect(bogdan).voteaza(true)).wait();
await (await sondaj.connect(cristina).voteaza(true)).wait();
await (await sondaj.connect(dan).voteaza(false)).wait();
console.log(await expectRevert(sondaj.voteaza(true), "Autorul nu voteaza"));
console.log(await sondaj.intrebare());
console.log("Da:", await sondaj.voturiDa(), "Nu:", await sondaj.voturiNu());
console.log("Total:", await sondaj.totalVoturi());
console.log("Evenimente Vot:", (await sondaj.queryFilter("Vot")).length);Autorul nu voteaza Facem excursie vineri? Da: 2 Nu: 1 Total: 3 Evenimente Vot: 3
- Constructorul salvează întrebarea și autorul.
- **require** cu msg.sender îl oprește pe autor să voteze.
- **voteaza** schimbă starea, deci fiecare vot este o tranzacție.
- **totalVoturi** doar citește, deci este view și gratuită.
- **Vot** are votantul indexed, ca să poți căuta voturile unei persoane.
Proiectul: avizierul
Asociația de proprietari vrea un avizier digital: un singur mesaj al zilei, pe care oricine îl poate citi, dar numai administratorul (contul care a publicat contractul) îl poate schimba. Fiecare schimbare se numără și se anunță printr-un eveniment, ca aplicația locatarilor să trimită o notificare.
Mai întâi verificările (require), apoi modificările de stare, la final emit. Este ordinea pe care o vei folosi în aproape orice funcție.
Verifică-te înainte de exercițiu
- De ce schimbaMesaj costă gas, iar mesaj() nu? (tranzacție față de apel)
- Ce rămâne în mesaj după ce Bogdan primește revert? (mesajul anterior: revert-ul anulează tot)
- Unde se salvează evenimentul? (în receipt, nu în storage)
- Ce s-ar întâmpla dacă ai uita proprietar = msg.sender în constructor? (proprietarul ar rămâne adresa zero și nimeni nu ar putea schimba mesajul)
Greșeli frecvente
- **require pus după modificări**: funcționează (revert-ul anulează tot), dar e greu de citit și consumă gas inutil.
- **Contorul crescut înainte de require**: la fel, nu strică starea, dar ordinea corectă e verificare → modificare → eveniment.
- **emit cu valoarea veche**: emite după ce ai crescut modificari, ca evenimentul să conțină numărul nou.
- Diacritice în textele din Solidity: mesajele din require scrie-le fără diacritice.
Unde întâlnești acest tipar
Unele DAO-uri publică pe lanț hash-ul fiecărei decizii, cu evenimente pentru fiecare actualizare.
Parametrii schimbabili doar de administrator, cu un eveniment la fiecare schimbare, sunt peste tot în DeFi.
Aplicațiile ascultă evenimentele și anunță utilizatorii, exact ca aplicația locatarilor.
Scrie contractul Avizier după pașii din lecție: variabilele publice mesaj, proprietar, modificari, evenimentul MesajSchimbat(string mesajNou, uint numar), constructorul care primește mesajul inițial și funcția schimbaMesaj(string memory mesajNou), permisă doar proprietarului (altfel revert cu Doar proprietarul). Scriptul lecției publică avizierul cu Bine ati venit!, îl schimbă din contul Anei, încearcă din contul lui Bogdan și afișează rezultatele.
- Declară string public mesaj;, address public proprietar; și uint public modificari;.
- Declară evenimentul MesajSchimbat(string mesajNou, uint numar).
- Constructorul salvează mesajInitial și proprietar = msg.sender.
- schimbaMesaj: require(msg.sender == proprietar, "Doar proprietarul"), salvează mesajul, modificari = modificari + 1, apoi emit MesajSchimbat(mesajNou, modificari).
Soluția exercițiului
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Avizier {
string public mesaj;
address public proprietar;
uint public modificari;
event MesajSchimbat(string mesajNou, uint numar);
constructor(string memory mesajInitial) {
mesaj = mesajInitial;
proprietar = msg.sender;
}
function schimbaMesaj(string memory mesajNou) public {
require(msg.sender == proprietar, "Doar proprietarul");
mesaj = mesajNou;
modificari = modificari + 1;
emit MesajSchimbat(mesajNou, modificari);
}
} 