LandVer - Land Verification System

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

<!-- ALL-CONTRIBUTORS-BADGE:END -->

LandVer is a decentralized land registration and verification protocol, utilizing blockchain technology to provide a secure, transparent, and immutable system for managing land records. The protocol facilitates land transactions and ownership verification on the Starknet blockchain.

While initially built on Starknet, LandVer is designed to be cross-chain compatible, allowing land transactions and records to be securely managed across multiple blockchains. LandVer is one of the many products of Noshon Networks, which aims to bring innovation to the world of real estate.

Project Structure

The monorepo is organized into the following components:

• app/: Contains the main application code:

• Frontend client application
• Backend server implementation

• docs/: Project documentation, including setup guides and API references
• land-registry-backend/: Core backend service for land registry operations
• land-registry-indexer/: Blockchain indexer service for tracking land registry events
• land_registry/: Smart contract implementation for the land registry system
• landing_page/: Website and landing page
• scripts/: Utility scripts for development and deployment
• sdk/: JavaScript SDK for interacting with LandVer protocols
• tools/: Development and maintenance tools
• .github/: GitHub workflows and configuration files

Prerequisites

Before you begin, ensure you have the following installed.

• scarb: Smart contract development tool

• snfoundry: Smart contract testing framework

• install npm: JavaScript runtime and package manager

• install rust: Required for some development tools

Development Setup

Steps to build and run LandVer locally.

How to Run the Code

Running the landing page

From the root directory

 pnpm install 
 pnpm run landing

Running the Client

From the root directory

 pnpm install 
 pnpm run client

Running the Land Registry Contracts

Navigate to the land_registry directory, build the contracts

cd land_registry
scarb build

To run tests on the contract

cd land_registry
scarb test

Backend Services

Start the land registry backend:

cd land-registry-backend
npm install
npm run dev

Start the indexer service:

cd land-registry-indexer
npm install
npm start

Build for production:

pnpm  build

Project Flow Chart

Landver as a decentralized land registration and verification protocol has a very easy navigation system as illustrated below.

• Once the project is set up on your device as illustrated above,

• You can navigate through the protocol .

• Connect a Starknet compatible wallet. This sends a transaction to the starknet blockchain.

• This navigates to a Landing page that gives an option of the users; a Land owner or a Land Inspector. This sends another transaction to the starknet blockchain.

• On the Land owner's dashboard, a user can register a land with details like Longitude, Latitude, Area and the type of Land use. On submission, another successful transaction when the required tokens are available in the connected wallet. Other side bar links on the dashboard includes the Market store, Collection, Favorites, Notification, Wallet and the Log out button. An NFT is rewarded to a Landowner user on successful registration.

• On the Land Inspector's dashboard, Available side bar action links include Land, verify user, Transfer ownership, Reports & Logs, Notifications and Log out button.

• All onchain transactions are fetched on the Starknet blockchain while the offchain data are fetched the Land Registery backend.

Contributors

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://fishonsnote.medium.com/"><img src="https://avatars.githubusercontent.com/u/43862685?v=4?s=100" width="100px;" alt="Fishon Amos"/><br />_{<b>Fishon Amos</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=fishonamos" title="Code">💻</a> <a href="https://github.com/NoshonNetworks/landver/pulls?q=is%3Apr+reviewed-by%3Afishonamos" title="Reviewed Pull Requests">👀</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Solomonsolomonsolomon"><img src="https://avatars.githubusercontent.com/u/103282647?v=4?s=100" width="100px;" alt="Solomonsolomonsolomon"/><br />_{<b>Solomonsolomonsolomon</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=Solomonsolomonsolomon" title="Code">💻</a> <a href="#infra-Solomonsolomonsolomon" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/GoSTEAN"><img src="https://avatars.githubusercontent.com/u/63151237?v=4?s=100" width="100px;" alt="Stephanie Nwankwo"/><br />_{<b>Stephanie Nwankwo</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=GoSTEAN" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/rajiabdul"><img src="https://avatars.githubusercontent.com/u/119139404?v=4?s=100" width="100px;" alt="RAJI ABDUL"/><br />_{<b>RAJI ABDUL</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=rajiabdul" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/manlikeHB"><img src="https://avatars.githubusercontent.com/u/109147010?v=4?s=100" width="100px;" alt="Yusuf Habib"/><br />_{<b>Yusuf Habib</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=manlikeHB" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Akshola00"><img src="https://avatars.githubusercontent.com/u/114211385?v=4?s=100" width="100px;" alt="Akinshola"/><br />_{<b>Akinshola</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=Akshola00" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/SoarinSkySagar"><img src="https://avatars.githubusercontent.com/u/117727361?v=4?s=100" width="100px;" alt="Sagar Rana"/><br />_{<b>Sagar Rana</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=SoarinSkySagar" title="Code">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/saimeunt"><img src="https://avatars.githubusercontent.com/u/5597359?v=4?s=100" width="100px;" alt="saimeunt"/><br />_{<b>saimeunt</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=saimeunt" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://deveche.vercel.app/"><img src="https://avatars.githubusercontent.com/u/111073744?v=4?s=100" width="100px;" alt="Echefula Ndukwe"/><br />_{<b>Echefula Ndukwe</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=Eche5" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://poulav.vercel.app"><img src="https://avatars.githubusercontent.com/u/133862694?v=4?s=100" width="100px;" alt="Poulav Bhowmick"/><br />_{<b>Poulav Bhowmick</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=PoulavBhowmick03" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/No-bodyq"><img src="https://avatars.githubusercontent.com/u/141028690?v=4?s=100" width="100px;" alt="Asher"/><br />_<b>Asher</b></a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=No-bodyq" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Villarley"><img src="https://avatars.githubusercontent.com/u/115122095?v=4?s=100" width="100px;" alt="Santiago Villarreal Arley"/><br />_{<b>Santiago Villarreal Arley</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=Villarley" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Otaiki1"><img src="https://avatars.githubusercontent.com/u/38711713?v=4?s=100" width="100px;" alt="Abdulsamad sadiq"/><br />_{<b>Abdulsamad sadiq</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?author=Otaiki1" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Calebux"><img src="https://avatars.githubusercontent.com/u/119738245?v=4?s=100" width="100px;" alt="Caleb "/><br />_{<b>Caleb </b>}</a><br /><a href="#design-Calebux" title="Design">🎨</a> <a href="https://github.com/NoshonNetworks/landver/commits?author=Calebux" title="Documentation">📖</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Oshioke-Salaki"><img src="https://avatars.githubusercontent.com/u/105825121?v=4?s=100" width="100px;" alt="Oshioke Salaki"/><br />_{<b>Oshioke Salaki</b>}</a><br /><a href="https://github.com/NoshonNetworks/landver/commits?auth