Skip to content

Latest commit

 

History

History
273 lines (177 loc) · 14.5 KB

README.md

File metadata and controls

273 lines (177 loc) · 14.5 KB

GitHub License devContainer


Block Foundation Logo

Decentralized Land Registry

Block Foundation Smart Contract Series [Solidity]


Block Foundation Brand

Contents



Report a Bug Request a Feature Ask a Question Make a Suggestion Start a Discussion

Welcome to Block Foundation's Decentralized Land Registry project as part of our Smart Contract Series. It leverages the full potential of smart contracts to deliver a secure and transparent system for land transactions.

Introduction

Land registries have long been known for their lack of transparency and the potential for fraud, with numerous cases of illegal land acquisition and property disputes marring their history [^1]. Our solution, a Decentralized Land Registry, built on the foundation of blockchain technology, addresses these issues by providing a public, transparent, and immutable record of land transactions.

With our smart contract for the land registry system, an owner can register their land, update the land details, and even transfer ownership in a seamless and secure manner. Not only does this bring about a new level of trust and reliability to land transactions, but it also significantly reduces the potential for fraudulent activities.

This smart contract for a land registry system in which land transactions are more transparent and trustworthy, and allows an owner to register their land, update the land details, and transfer ownership in a secure way.

The primary functionalities include:

  1. Registration: When a user first registers a parcel of land, they are recorded as the owner of that parcel in the global state of the smart contract.

  2. Land Update: The owner can update the details of their registered land. Any updates are recorded in the global state, ensuring that a history of changes is kept.

  3. Ownership Transfer: If the owner decides to transfer their land, the contract allows for a seamless and secure transfer of ownership.

Quick Start

Before you dive in, make sure you have Node.js and npm installed. You can then proceed to install the necessary dependencies:

Install

npm i

To compile the smart contract:

npm run compile

Contract

This is a simple implementation and can be expanded to include more complex features, like adding permissions to prevent unauthorized people from registering or transferring land.

Class Overview

classDiagram 

    class LandRegistry {
        -Land lands
        +registerLand(string, string, uint256)
        +transferLand(address, string)
        +sellLand(address, string)
        +verifyLand(string)
    }

    class Land {
        -address owner
        -string location
        -string parcelID
        -uint256 price
    }


    LandRegistry "1" -- "*" Land: has

    note for LandRegistry "can register\ncan transfer\ncan sell\ncan verify"
    note for Land "can be owned\nhas a location\nhas a name\nhas a price"


Loading

Class Flow

flowchart TD

    registerLand["(mehod)
    registerLand"]:::class_dark
    transferLand["(mehod)
    transferLand"]:::class_dark
    sellLand["(mehod)
    sellLand"]:::class_dark

    LandRegistered["(event)
    LandRegistered"]:::class_light
    LandTransferred["(event)
    LandTransferred"]:::class_light

    lands["(mapping)
    lands"]:::class_neutral
    ownerToLands["(mapping)
    ownerToLands"]:::class_neutral

    verifyLand["(mehod)
    verifyLand"]:::class_dark

    registerLand --> LandRegistered
    transferLand --> LandTransferred
    sellLand --> LandTransferred
    LandRegistered --> lands
    LandTransferred --> lands
    LandRegistered --> ownerToLands
    LandTransferred --> ownerToLands
    lands <--> verifyLand
    ownerToLands <--> verifyLand

    classDef class_light fill:#FFFFFF,color:#041B26,stroke:#041B26,stroke-width:2px;
    classDef class_neutral fill:#E1E4E5,color:#041B26,stroke:#041B26,stroke-width:2px;
    classDef class_dark fill:#041B26,color:#FFFFFF,stroke:#041B26,stroke-width:2px;

Loading
  • registerLand() allows an address to register a new parcel of land with its location and a unique parcel ID. Emits a LandRegistered event when land is registered.
  • transferLand() allows the current owner of a land parcel to transfer it to a new owner. Emits a LandTransferred event when land is transferred.
  • sellLand() allows a landowner to sell their land to a buyer. This also involves the transfer of Ether (the currency on Ethereum) from the buyer to the seller, representing the payment for the land.
  • verifyLand() allows anyone to verify the details of a land parcel.
  • listLandsByOwner() allows for querying all land parcels owned by a specific address, making it easier to get an overview of one's properties

Moreover:

  • price on the Land struct handles selling land parcels.
  • onlyLandOwner modifier to ensures that only the owner of a land parcel can perform certain actions.

There is also a PyTeal version of this smart-contract, which offers similar functionality for the Algorand blockchain.

Background

Evolving Land Management Systems

As we move deeper into the 21st century, traditional methods of managing land registries have proven to be insufficient, vulnerable to fraud, and fraught with red tape. In response, our project introduces a pioneering vision for the future of land management – the Decentralized Land Registry. By marrying the infallible security of blockchain with the expansive realm of property management, we're reshaping how property transactions are executed and recorded. This transformative project strives to make property transactions as seamless and as transparent as possible, thereby fortifying trust among parties involved.

Incorporating Advanced Technologies

Our Decentralized Land Registry project employs advanced technologies, such as Ethereum's blockchain and Solidity, to craft a robust and secure framework for land transactions. The project is part of our Smart Contract Series that aims to demonstrate how blockchain can revolutionize various sectors and industries. The contract allows landowners to register land parcels, update details, and transfer ownership in a tamper-proof, transparent, and efficient manner.

A Step towards Greater Transparency

Transparency is the cornerstone of any trusted system. Our project ensures complete transparency in land transactions, thereby minimizing disputes and fraudulent activities. By recording transactions on the blockchain, we provide a public and immutable ledger, thus instilling a greater level of confidence in the process. As a result, the Decentralized Land Registry is set to change the way we perceive land transactions, ushering in a new era of trust, transparency, and efficiency.

Open Source and Community Oriented

As an open-source project, the Decentralized Land Registry encourages community participation and contribution. We believe that the combined efforts and creativity of the global developer community can accelerate the evolution of our project and bring innovative solutions to the fore. We warmly welcome developers worldwide to join our mission, contribute to our codebase, and help us build a more transparent, efficient, and secure system for land transactions.

Development Resources

Authors

This is an open-source project by the Block Foundation.

The Block Foundation mission is enabling architects to take back initiative and contribute in solving the mismatch in housing through blockchain technology. Therefore the Block Foundation seeks to unschackle the traditional constraints and construct middle ground between rent and the rigidity of traditional mortgages.

website: www.blockfoundation.io

Contributing

We'd love for you to contribute and to make this project even better than it is today! Please refer to the contribution guidelines for information.

Other Repositories

Block Foundation Smart Contract Series

Solidity Teal
Template >>> >>>
Architectural Design >>> >>>
Architecture Competition >>> >>>
Housing Cooporative >>> >>>
Land Registry >>> >>>
Real-Estate Crowdfunding >>> >>>
Rent-to-Own >>> >>>
Self-Owning Building >>> >>>
Smart Home >>> >>>

Academic Resources

Citation

A sample citation (APA 6th edition) might look like:

van Vianen, L. B. (2023). solidity-land-registry (Version 0.0.1) [Computer software].

BibTeX

@misc{van_vianen_solidity-land-registry_2023,
	title = {solidity-land-registry},
	copyright = {CC-BY-SA-4.0},
	url = {https://github.com/block-foundation/solidity-land-registry},
	abstract = {Solidity Smart Contract: Decentralized Land Registry},
	urldate = {2023-07-25},
	author = {van Vianen, Lars Bastiaan},
	month = jul,
	year = {2023},
	note = {original-date: 2023-07-23T22:52:59Z},
}

Colophon

Authors

This is an open-source project by the Block Foundation.

The Block Foundation mission is enabling architects to take back initiative and contribute in solving the mismatch in housing through blockchain technology. Therefore the Block Foundation seeks to unschackle the traditional constraints and construct middle ground between rent and the rigidity of traditional mortgages.

website: www.blockfoundation.io

Development Resources

Contributing

We'd love for you to contribute and to make this project even better than it is today! Please refer to the contribution guidelines for information.

Legal Information

Copyright

Copyright © 2023 Stichting Block Foundation. All Rights Reserved.

License

Except as otherwise noted, the content in this repository is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) License, and code samples are licensed under the Apache 2.0 License.

Also see LICENSE and LICENSE-CODE.

Disclaimer

THIS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.