Donation é uma aplicação descentralizada desenvolvida por Gabriel Santa Ritta que permite o envio de doações em ETH para um contrato inteligente, armazenando o histórico on-chain. Ideal para projetos filantrópicos, arrecadações e experimentos com Web3.
- Solidity 0.8.x – Linguagem de contratos inteligentes na EVM
- Hardhat – Framework para desenvolvimento, testes e deploy
- Ethers.js – Biblioteca para interação com Ethereum via JavaScript
- Metamask – Extensão de carteira para interagir com o DApp
- ✅ Envio de doações em ETH para o contrato
- 📦 Registro de cada doação com valor e endereço do doador
- 🔍 Consulta pública do histórico de doações
- 🔐 Apenas o proprietário do contrato pode sacar os fundos
donation/
├── contracts/
│ └── Donation.sol # Contrato inteligente principal
├── scripts/
│ └── deploy.js # Script de deploy via Hardhat
├── test/
│ └── Donation.test.js # Testes automatizados
├── hardhat.config.js # Configuração do projeto
└── README.md
- Node.js
- NPM ou Yarn
- Hardhat instalado globalmente ou via
npx
# Clone o repositório
git clone https://github.com/gabrielfst30/donation.git
cd donation
# Instale as dependências
npm install
# Compile os contratos
npx hardhat compile
# Execute os testes
npx hardhat testConfigure as credenciais no .env:
PRIVATE_KEY=SEU_PRIVATE_KEY
ALCHEMY_API_KEY=SUA_API_KEYAtualize hardhat.config.js com as credenciais e execute:
npx hardhat run scripts/deploy.js --network sepolia- Usuário conecta sua wallet ao front-end
- Escolhe um valor em ETH e envia como doação
- O contrato registra o valor e o endereço
- O dono do contrato pode futuramente sacar os fundos
Desenvolvido por Gabriel Santa Ritta Fullstack & Blockchain Developer com foco em soluções descentralizadas, smart contracts e Web3.