Our primary inspiration comes directly from the Sustainable Groundwater Management Act of California (2014). SGMA laid the framework for achieving sustainability via local control of groundwater resources. By providing a wide variety of methods with which to achieve sustainability, this landmark piece of legislation indirectly encourages projects like this to deliver novel solutions to the issues of groundwater sustainability a particularly interesting version of the classic resource allocation problem.

Speaking of resource allocation, another piece of inspiration is the classic text based video game Hamurabi. We think blockchain is particularly well suited for a situation in which there is more than just one king of Sumeria, as is often the case.


California groundwater management is complex. Complexity in groundwater management leads to confusion among stakeholders (litigation), causes uncertainty about future management decisions (pumping restrictions), and creates perverse incentives (race to the bottom pumping). Basin Logix believes that the implementation of a stakeholder owned management network system is necessary to subdue the inherent complexities of California groundwater so locally sourced management can steer basins towards groundwater sustainability. Using blockchains, Basin Logix introduces a network design which brings the value of groundwater to the forefront while ensuring compliance with existing water rights in the background. By taking the existing complex state of water rights in a basin and transitioning to explicitly defined digital rights, a basin-scale network is able to make guarantees about groundwater management which previously would have previously never been possible.


The hackathon team came together as a direct result of hackusama being launched and utilization of team building resources supplied by devpost/web3/parity. Being able to connect with other people in the space has been a tremendous help for the project as a whole. Please see for information about the team.


We have set out to build a network which can ingest real world data, extract and store essential information from the real world data on-chain, and allow users to claim NFTs which are on-chain representations of groundwater rights (ApnTokens) using this essential information.

We have mocked up the pieces of our network, these include:

  • Data_Logix Pipeline A data collection and amalgamation pipeline.
  • BLX_chain A substrate based chain which uses off-chain worker to fetch and submit data to on-chain source from the Data_Logix Pipeline.
  • BLX_frontend A React front end based off of the substrate-frontend-template which interacts with BLX_chain. This frontend acts as access for users to claim ApnTokens as well as view further information about their ApnTokens.
  • A live website with information about the project. Will become home to the BLX_frontend in the future.

We are in the process of connecting the above pieces into a docker container, in the case that this is not accomplished by the deadline both the BLX_chain and BLX_frontend repositories have detailed instructions on how to install/build/run our network on a standard ubuntu linux installation.

Build Discussion

The 4 network pieces outlined in Build section should theoretically work in concert. In reality because this is a local mockup there are many hardcoded values, particularly in the BLX_frontend. The hardcoded values will be replaced by a separate database and backend which are being built.

The team experienced significant difficulty understanding and implementing off-chain worker, but eventually succeeded in hacking an implementation. Many fundamental network mechanisms associated with governance of the ApnTokens (see Network diagram photo) were not built within the hackusama deadline because of the priority to get real world data on chain at the cost of halting progression on other aspects of chain development.

BLX_chain's role in the larger kusama/polkadot network has been roughly diagrammed (see Kusama network example photo). One potential use case would be connecting to the Kusama network via parathread slot in order to migrate assets from BLX_chain to Centrifuge's Tinlake protocol for purposes of utilizing these onchain assets in the larger ecosystem.


This project is a multidisciplinary endeavor, it was started before hackusama and will continue beyond hackusama. The project will continue to add functionality while maintaining a focus on moving towards implementation of a pilot program. Basin Logix is actively looking to partner with stakeholders who may be interested in a self-governed groundwater sustainability network.

Built With

Share this project: