caseywoolley / fairground

Fairground - an open-source blockchain land protocol and auction platform for building citizen owned cities

Fairground

An open-source blockchain land protocol and auction platform featuring demand-based ground rent for building better, more sustainable, and more inclusive cities, designed from the bottom-up by the community.

• Whitepaper
• Newsletter
• Live Prototype

Protocol Features and Objectives:

• Demand-based ground rent collection and citizens dividend distribution
• On-chain land registry and title transfer governed by auction smart contracts
• Decentralized and market-driven zoning, planning, and infrastructure
• Protocol level changes by unanimous stakeholder consent through agreement, buyout, or amicable division

Protocol Inspiration and Reference:

• Progress and Poverty by Henry George
• Chapter 1 of Radical Markets by Glen Weyl
• Thoughts on Perpetual Property Rights by Daniel Larimer
• Should there be demand-based recurring fees on ENS domains? by Vitalik Buteren

"Cities have the capability of providing something for everybody, only because, and only when, they are created by everybody" — Jane Jacobs

Getting Started

It is recommended to use Yarn to avoid dependency collisions: Yarn

git clone https://github.com/caseywoolley/fairground.git
cd fairground

yarn install

# Start up the Hardhat Network
yarn chain

Here we just install the npm project's dependencies, and by running yarn chain we spin up an instance of Hardhat Network that you can connect to using MetaMask. In a different terminal in the same directory, run:

yarn localhost

This will deploy the contract to Hardhat Network. After this completes run:

cd frontend
yarn install

This will install the frontend packages. We also need to set up the local configuration file.

cp .env.local.example .env.local

This will create a file called .env.local. Open up that file and fill in the NEXT_PUBLIC_ALCHEMY_{NETWORK}_API_KEY= environment variables.

yarn dev

This will start up the Next.js development server. Your site will be available at http://localhost:3005/

To interact with the local contract, be sure to switch your MetaMask Network to Localhost 8545

• Hardhat
• Next.js
• RainbowKit
• wagmi
• Chakra UI

Thanks to Hunter Chang and BuidlGuidl for an excellent hardhat/Nextjs application template!