Blockchain based, near transparent, trustworthy and secure donation platform
- 🌐 React + Vite for a fast and modern frontend experience
- ⚙️ FastAPI for a high-performance backend API in Python
- 🔗 XRP Ledger (XRPL) for blockchain interactions (sending transactions, checking balances, etc.)
The backend uses xrpl-py to interact with the XRP Ledger.
| Feature | Purpose |
|---|---|
| Mint NFTs | Mints a new NFT on the XRP Ledger using the provided metadata and wallet seed. |
| Fetch NFTs | Retrieves all NFTs associated with a specified XRP Ledger account. |
| Create Escrow Donations | Creates time-locked escrow payments linked to milestone deadlines for secure, conditional donations. |
| Verify Milestones | Verifies milestone completion and either releases or cancels escrowed funds accordingly. |
git clone https://github.com/Unknown-Blaze/easya-hackathon.git cd easya-hackathon
cd backend python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt
fastapi uvicorn xrpl-py python-dotenv firebase-admin pydantic email-validator web3
uvicorn app.main:app --reload
Default API URL: http://localhost:8000
cd frontend npm install npm run dev
Frontend runs on: http://localhost:5173
| Endpoint | Method | Description |
|---|---|---|
/donate |
POST | Accept a donation transaction (via XRP payment) |
/verify |
POST | Verify the authenticity of a donation or wallet |
/mint |
POST | Mint a token (e.g., NFT) after successful verification |
/token |
GET | Retrieve information about a specific token |
/latest-transactions |
GET | Get a list of the latest donation transactions |
Block explorer link - https://testnet.xrpl.org/accounts/r4sXNGwP85VZ4PQbceXD66Xp8cJHL6mT9B
