Skip to content
Switch branches/tags


Failed to load latest commit information.

Reality.eth monorepo

This repo replaces the old separate repos that were previously at

It comprises the following packages, under packages/:

  • contracts: Reality.eth contracts source code, also details of supported networks and tokens and the relevant contract addresses.
  • reality-eth-lib: Useful functions for creating and interpreting questions and templates used by the reality.eth system.
  • dapp: The UI front-end as deployed at reality.eth/dapp
  • docs: The system documentation as deployed at reality.eth/docs
  • website: The project website as seen at reality.eth/
  • cli-tools: Javascript tools, mainly used for arbitration
  • python-services: Python code used for back-end services, specifically the twitter bot @RealityEthBot
  • graph: Subgraph definitions for
  • template-generator: A GUI tool to create custom question templates.

See the README of each respective package for details.

The following scripts are used for deployment, under tools/:

  • Deploy web-accessible parts of the project to a web-accessible URL, and pin it to IPFS on the local server. You should then manually add it to pinata and register it with ENS to update
  • As with but deploying the dapp only, to repo at This is usually updated more frequently than the IPFS build.

NPM packages

The following are published to npm. They are versioned individually, and updated by running lerna publish.

  • @reality.eth/contracts
  • @reality.eth/reality-eth-lib
  • @reality.eth/dapp
  • @reality.eth/cli-tools

Some packages reference each other, for example dapp needs contracts and reality-eth-lib. When developing it can be useful to make your local environment refer directly to the working versions of the other packages in the repo. To do this, instead of running the normal npm install for each JavaScript package, run lerna bootstrap from the uppermost directory. This will install external dependencies normally, but set up dependencies within this repo as symlinks.