Welcome to the Web3 OFinder DApp project repository! This decentralized application (DApp) is designed for reporting lost documents such as identification cards and driver's licenses. The information on the document is hashed and stored. When a person who has found a document enters their information, a hash comparison is performed. If the data matches, the specified amount of locked SUI tokens, determined by the person reporting the loss, is transferred to the individual who found the document.
- Overview
- Features
- Getting Started
- Usage
- Devnet Contracts Address
- Testing
- Frontend
- Contributing
- License
The Web3 OFinder DApp The application facilitates the secure and rapid recovery of lost documents through its user-friendly interface and transparent operation. It prevents the dissemination of data on the internet.
- View the number of active appeals.
- Post a lost document announcement.
- Have fair rewards.
- Integrated with SUI wallets.
- zkLogin (upcoming feature).
Follow these steps to set up the project locally and start participating in web3 auctions.
- Node.js: Ensure Node.js is installed. Download it from nodejs.org.
- Clone the repository:
git clone https://github.com/oguzhaniptes/Sui-Bootcamp-Final-Project.git- Navigate to the project directory:
cd Sui-Bootcamp-Final-Project- Install required npm packages:
npm install- Start the development server:
npm run dev-
Open your web browser and navigate to
http://localhost:3000to access the DApp. -
Connect your Sui wallet to the DApp.
-
Post an announcement or claim your reward for the found document.
The smart contracts in this project facilitate the auction process. They handle bids, auction creation, and winner determination. These contracts are deployed on the Ethereum blockchain.
-
finder.move:- Contact ID: 0x03ab598f0997899fba06a23f7739492c74e52b0e256a87207c438139b922694d,
- Ofinder Object ID 0x767559cbf5ac92435f91fddf9fbac0dfc13ffe7007670670e177181e0d40d5c8
Test not ready yet !
The DApp frontend is built using modern web technologies including React.js. It provides an intuitive and interactive user interface for auction participation.
- React.js: Powers the DApp's user interface.
- @mysten/create-dapp is a CLI tool that helps you to create a new dApp project.
- @mysten/sui.js: Sui Wallet Kit is a library that makes it easy to connect your dApp to Sui wallets.
- @mysten/dapp-kit The Sui dApp Kit is a set of React components, hooks, and utilities that make it easy to build a dApp for the Sui ecosystem. It provides hooks and components for querying data from the Sui blockchain, and connecting to Sui wallets.
- Sui Wallet: Sui wallet browser extension.
This project is licensed under the MIT License.