{"id":15930806,"url":"https://github.com/sripwoud/decentralized_house_listing","last_synced_at":"2025-03-24T18:31:36.076Z","repository":{"id":43806940,"uuid":"179834174","full_name":"sripwoud/decentralized_house_listing","owner":"sripwoud","description":"🏘️ Decentralized house listing service using ERC721 standard, ZKSNARK, and OpenSea","archived":false,"fork":false,"pushed_at":"2024-02-11T17:09:11.000Z","size":453,"stargazers_count":7,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-19T04:04:34.610Z","etag":null,"topics":["erc721","ethereum","infura","marketplace","metamask","opensea","solidity","truffle","udacity","udacity-blockchain-nanodegree","zksnark","zokrates"],"latest_commit_sha":null,"homepage":"https://rinkeby.opensea.io","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sripwoud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-04-06T13:02:49.000Z","updated_at":"2024-12-12T13:57:42.000Z","dependencies_parsed_at":"2024-02-11T18:24:49.636Z","dependency_job_id":"79d7f23b-9b7b-4c70-ae12-5e2687b0833a","html_url":"https://github.com/sripwoud/decentralized_house_listing","commit_stats":null,"previous_names":["sripwoud/decentralized_house_listing"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sripwoud%2Fdecentralized_house_listing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sripwoud%2Fdecentralized_house_listing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sripwoud%2Fdecentralized_house_listing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sripwoud%2Fdecentralized_house_listing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sripwoud","download_url":"https://codeload.github.com/sripwoud/decentralized_house_listing/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245328229,"owners_count":20597390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["erc721","ethereum","infura","marketplace","metamask","opensea","solidity","truffle","udacity","udacity-blockchain-nanodegree","zksnark","zokrates"],"created_at":"2024-10-07T01:01:48.650Z","updated_at":"2025-03-24T18:31:35.720Z","avatar_url":"https://github.com/sripwoud.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Decentralized Housing Service\n## Introduction\n### Issue\nAt present, property titles are often paper-based, creating opportunities for errors and fraud. Title professionals find defects in 25% of all titles during the transaction process, according to the American Land Title Association.  \nAny identified defect makes it illegal to transfer a property title to a buyer until it is rectified. This means property owners often incur high legal fees to ensure authenticity and accuracy of their property titles.  \nMoreover, title fraud poses a risk to homeowners worldwide. US losses associated with title fraud reportedly averaged around $103,000 per case in 2015, compelling many property buyers to purchase title insurance.\n### Solution\nThese title management issues could potentially be mitigated by using blockchain technology to build immutable digital records of land titles and using blockchain for transparent transactions. This approach could simplify property title management, making it more transparent and helping to reduce the risk of title fraud and the need for additional insurance.\nAs a solution I developed a **Decentralized Housing Service** featuring:\n- Tokens ([ERC721 Standard](http://erc721.org/)) to represent the titles of properties\n- Zero Knowledge Proof of property's (token) ownership using the [ZoKrates](https://zokrates.github.io/introduction.html) toolbox for ZkSNARKS on Ethereum\n- Listing of properties on [OpenSea marketplace](https://opensea.io/)\n\n## Getting started\n1. Clone or download this repository\n1. `cd` to project folder\n2. Install dependencies\n```\n$ npm install\n$ cd eth-contracts\n$ npm install\n```\n3. Run tests:\n```\n$ truffle develop\ntruffle(develop)\u003e test\n```\n\n## Zokrates proofs generation (Info)\n**Prerequesite**: [Docker](https://docs.docker.com/install/)\nAt contract migration, 10 initial tokens are minted. For it to succeed, 10\ncorresponding proofs are required. To automate the generation of 10 proofs, I wrote\nthe [script.sh](./zokrates/code/square/generateProofs.sh) script. From the\nproject root directory, execute it as follow:\n```\n$ cd zokrates/code\n$ chmod +x generateProofs.sh\n$ docker run -v /path/to/project/root/directory/zokrates/code/:/home/zokrates/code -ti zokrates/zokrates /bin/bash\nzokrates@0xxxxxxxxxxxx:~$ cd code/square\nzokrates@0xxxxxxxxxxxx:~$ ./generateProofs.sh\n```\n\nThe proofs.json generated includes then the 10 proofs. It is read during migration to mint the tokens.\n\n## Contract Details\n- address: 0x3cba03458005c8425Fc3B93755aA1B93535a85a8\n- [EtherScan](https://rinkeby.etherscan.io/address/0x3cba03458005c8425Fc3B93755aA1B93535a85a8)\n\n## OpenSea listing\n1. Go to [OpenSea rinkeby](https://rinkeby.opensea.io/)\n2. Load your migrated contract: `Develop \u003e Live on Rinkeby`\n3. Sell your items! (Multiple metamask transactions will have to be confirmed or signed)\n\n**Token purchases:**\n- https://rinkeby.opensea.io/assets/0xa75b004d71398347f1e9af3bc526fef133db4353/5\n- https://rinkeby.opensea.io/assets/0xa75b004d71398347f1e9af3bc526fef133db4353/3\n- https://rinkeby.opensea.io/assets/0xa75b004d71398347f1e9af3bc526fef133db4353/2\n- https://rinkeby.opensea.io/assets/0xa75b004d71398347f1e9af3bc526fef133db4353/1\n- https://rinkeby.opensea.io/assets/0xa75b004d71398347f1e9af3bc526fef133db4353/0\n\n\n## Project Resources\n* [Truffle Framework](https://truffleframework.com/)\n* [Ganache - One Click Blockchain](https://truffleframework.com/ganache)\n* [Open Zeppelin ](https://openzeppelin.org/)\n* [Interactive zero knowledge 3-colorability demonstration](http://web.mit.edu/~ezyang/Public/graph/svg.html)\n* [Docker](https://docs.docker.com/install/)\n* [ZoKrates](https://github.com/Zokrates/ZoKrates)\n* [OpenSea](https://opensea.io/): The largest marketplace for crypto collectibles\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsripwoud%2Fdecentralized_house_listing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsripwoud%2Fdecentralized_house_listing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsripwoud%2Fdecentralized_house_listing/lists"}