Hack Chain is a web platform for issuing, validating, and tracing NFT-based certifications for ethical hacking and cybersecurity education. It uses blockchain to ensure transparent, immutable, and verifiable credentials.
main– Production-ready, stable code.develop– Active development branch. Create your branches off this one.
/frontend– Find it's README.md here./backend– Allows interaction between frontend and deployed smart contract by using ether.js library. Find it's README.md here./contracts- Contains the base smart contract, it's testing, and soon, a script for deploying the smart contact to some network. Find it's README.md here.
To contribute locally, follow these steps:
- Node.js & npm installed — Use NVM
- Git installed
# 1. Clone the repository
git clone <YOUR_GIT_URL>
# 2. Move into the project folder
cd hack-chain
# 3. Install dependencies
npm install
# 4. Run the dev server (inside frontend/)
cd frontend
npm run devNote: Backend and smart contracts have their own package.json, install and run them separately.
We're a small but passionate team, and we love collaborating!
- 📄 Please read the CONTRIBUTING guide to get started.
- Always create a branch from
developbefore starting any feature or fix. - Pull Requests should also be opened into
develop.
- 📢 Join us on Discord – Real-time discussion, help, and collaboration.
- 📱 Chat with us on Telegram – Stay updated and meet the team.
We welcome beginners, questions, feedback, and contributors of all skill levels!