Presentation date: May 1st, 2025
Members:
- Prathmesh Sonawane
- Tien Le
- Charles Li
- Declan Young
We aim to construct an immutable, blockchain-based "source of truth" for work agreements, enabled by a smart-contract that automates payments when work hours have been fulfilled.
A Smart Contract that has:
- Sign-Up System: Allow workers and contractors to sign-up while preventing identity duplication
- Contract Creation: Allow contracts to be made, specifying #days and $/day
- Automated Payment: Instantly pay workers when #days worked is verified
To run and test our solitiy contract implementation, we deploy on a local Hardhat blockchain test network, an Ethereum testnet development environment. We similarly utilize a Mock ERC20 Implemntation, but when deployed on a real-world chain, any ERC20 token could be used as payment.
- Start up the Hardhat Node instances:
npx hardhat node - Recompile the project, in another terminal instance:
npm run full - Serve the DApp:
npx serve nirmaan-dapp
Take note of:
- Accounts, and their private keys (You will need this for MetaMask)
- Contract Address of MockERC20(might be different per machine):
0x5fbdb2315678afecb367f032d93f642f64180aa3 - Contract Address of Nirmaan:
0xe7f1725e7734ce288f8367e1bb143e90bb3f0512- If, for whatever reason, either contract is not currently deployed or the address is not known, run "npx hardhat run scripts/deploy.js --network localhost". After completion, you should see the contract addresses in the log.
Open Metamask, and ensure you are on the localhost testnet(Hardhat Localhost). To do so:
- Open MetaMask and add a custom network. Then, add the following:
- Network name: Hardhat
- Default RPC URL: 127.0.0.1:8545
- ChainID: 31337
- Currency Symbol: HardhatETH
- Once done, you can now switch over to the Hardhat network and add accounts via the private keys given to you by npx hardhat node
- Through MetaMask: Log into Account #0 Using the provided private key from the Hardhat Node launch. This account owns the ERC20 deployed contract which we deployed earlier, and thus, can create contracts using it.
- Through the DApp, connect to the contract via the Nirmaan contract address
- Select: Register the current Address
- Through MetaMask: Log into Account #1 (Or any another account) using the provided private key from the Hardhat Node launch
- Through the DApp, select
Connect / Reconnect Walletto connect through this second account and then click connect to contract via the Nirmaan contract address - Select: Register the current Address
- Through MetaMask: Switch back into Account #0(The Employers Account with access to an ERC 20 token)
- Through the DApp, select
Connect / Reconnect Walletto reconnect - Check if Employee is registered: Use Registration section, input Employee Address, select
Check if Registered - Use this Employee Address and the MockERC20 Address to create a work Contract
- As an Employer: Pay the employee by selecting :
Employer: Verify Work - As an Employee: Contest the employer by selecting :
Employee: Raise Dispute
Tested on:
- NPM 10.9.2
