Core Contracts

The Geo Web’s core smart contracts define the network’s digital land asset structure and market operations. They are the foundation on which all other aspects of the Geo Web are built.

Due to this central importance and the inherent nature of smart contracts, the Geo Web's design approach prioritizes security, scalability, and modularity.

Augmented reality and blockchain are nascent industries with many learnings and breakthroughs yet to come. The Geo Web must maintain extensibility without undermining its credible neutrality and the attributes that make smart contracts so powerful.

Broadly speaking, we want to make it easy for stakeholders to read, understand, and build upon the contracts. We want to leverage standards and designs that allow upgradability with constant time operations. We want to allow aspects of the contracts to be replaced while minimizing migration costs because every decision made now can become the wrong one in the future.

The Geo Web's contracts use and are inspired by several design patterns and protocols in pursuit of these goals:

• Diamonds, Multi-Facet Proxy (EIP-2535)
• Beacon Proxy
• Superfluid protocol

The resulting contracts are detailed in the following sections:

• RegistryDiamond
  • PCOERC721Facet
  • GeoWebParcelFacet
  • PCOLicenseClaimerFacet
  • PCOLicenseParamsFacet
• PCOLicenseDiamond
  • DiamondCut
• BeaconDiamond(s)
  • CFABasePCOFacet
  • CFAPenaltyBidFacet
  • CFAReclaimerFacet
• BeneficiarySuperApp

caution

When there are breaking storage changes made to facets, the previous facet(s) will remain in the Core Contract repository. The highest version number is currently active.

High-level architecture of the Geo Web core contracts

Actions in a parcel lifecycle