Welcome to ElimuChain!
ElimuChain is an innovative platform aimed at transforming academic credential verification in Kenya. By harnessing the power of both the Lisk blockchain for scalable sidechain functionality and Solidity for smart contract execution on the Ethereum Virtual Machine (EVM), we are dedicated to combating educational fraud, streamlining verification processes, and fostering trust in academic qualifications.
Purpose: ElimuChain provides a secure, transparent, and immutable system for issuing, managing, and verifying academic credentials. By integrating blockchain technology, we ensure the authenticity of educational certificates, reducing fraud and enhancing verification efficiency for educational institutions, students, and employers.
Technology Stack:
- Front-end: TBD (e.g., React, Vue.js)
- Backend: Solidity (Smart Contracts) on Ethereum/Lisk's EVM
- Blockchain: Lisk for sidechain scalability; Ethereum for smart contract functionality
Target Audience:
- Educational Institutions (Universities, Colleges, Schools)
- Students and Graduates
- Employers
- Government Bodies
- International Educational Partners
ElimuChain offers key functionalities:
- Credential Issuance: Institutions can issue digital certificates via Solidity smart contracts, recorded on the blockchain.
- Verification: Employers or authorized parties can verify credentials instantly using smart contract functions with unique certificate IDs.
- Data Privacy: Users maintain control over their data through blockchain's cryptographic methods.
- Interoperability: Designed for seamless integration with existing educational systems.
- Hybrid Blockchain Approach: Combines Lisk's scalability with Ethereum's Solidity for robust and secure backend operations.
- User Empowerment: Students have direct control over their educational data, managing access permissions through smart contracts.
- Cultural Adaptation: Specifically tailored to meet the needs of the Kenyan educational context.
- Anti-Fraud Mechanism: The immutable nature of blockchain ensures the integrity of issued credentials.
- Node.js (version 14 or higher)
- Lisk SDK (version 5.x)
- Truffle Suite for Solidity development
- Git
- An Ethereum-compatible development environment (e.g., Ganache for local testing)
-
Clone the Repository:
git clone https://github.com/Adamur-Tribe/elimuchain cd elimuchain
-
Install Node Dependencies:
npm install
-
Install Solidity Dependencies:
- Ensure Truffle is installed globally:
npm install -g truffle
- Install project-specific Solidity dependencies:
truffle compile
-
Configure Lisk Node & Ethereum Environment:
- Edit
config.json
for Lisk node settings. - Set up your local Ethereum network or use an existing testnet.
- Edit
-
Start the Node:
npm run start
For development mode:
npm run dev
Deploy and interact with the CertificateIssuer
contract:
contract CertificateIssuer {
function issueCertificate(address student, string memory course, string memory institution) public;
// Additional functions...
}
Verify credentials using the CertificateVerifier
contract:
contract CertificateVerifier {
function verifyCertificate(uint certificateId) public view returns (bool);
}
Access your certificates through the frontend or directly interact with contracts.
We welcome contributions to enhance ElimuChain! Here’s how you can help:
- Fork the repository.
- Create a feature branch:
git checkout -b feature/AmazingFeature
- Commit your changes:
git commit -m "Add AmazingFeature"
- Push to your branch:
git push origin feature/AmazingFeature
- Open a pull request.
Please ensure your code adheres to our standards and passes all tests. Refer to our Contribution Guidelines for more information.
This project is licensed under the MIT License. See LICENSE.md for details.