1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-26 19:49:26 +01:00
docs/predictoor/pdr-architecture.md
2023-10-06 10:06:55 -07:00

3.1 KiB
Raw Blame History

description
"It was never easy to look into the future, but it is possible and we should not miss our chance." — Andrei Linde

Predictoor Architecture

Privacy and Oasis Sapphire

Predictoor needs privacy for:

  • Submitted predictions
  • Compute aggregate predictions; and
  • Aggregated predictions — only subscribers can see

This could all be done on fully-centralized infrastructure. But doing so would fail on our other goals: being globally distributed, censorship resistant, and non-custodial.

Targeting these needs, we researched & prototyped many privacy technologies. Oasis Sapphire emerged as the best choice because, as the only privacy-preserving EVM chain in production, it could handle these needs cleanly end-to-end.

Software Implementation

Most of predictoor.ai dapp is implemented in the pdr-web repo, with help from pdr-websocket to fetch feed data and Ocean Aquarius for metadata caching.

The template Predictoor bots, trader bots, trueval bot, and prediction feed publishing are all in the pdr-backend repo. Contracts are in the Ocean contracts repo.

Events emitted by contracts are indexed as Ocean subgraphs, to be consumed by predictoor.ai and the bots. The backend subgraph README has more info.

Backend & Contract Details

The section "Predictoor Structure” presented much of the Predictoor architecture.

The image below adds detail around the backend (bottom 1/3 of diagram). Lets discuss.

Details of Predictoor Structure (Architecture)

Smart Contracts. Theres one Predictoor contract for each prediction feed, at each exchange/timescale: BTC/USDT at Binance/5m, ETH/USDT at Binance/5m, and so on. Each contract is an Ocean datatoken contract, with a new template for prediction feeds.

The implementation is in templates/ERC20Template3.sol at at Oceans contracts repo. It implements ERC20, Ocean, and Predictoor-specific behavior as follows.

- ERC20 behavior. It implements the ERC20 interface and therefore plays well with ERC20-friendly crypto wallets, DEXes, etc.

- Ocean behavior. Being part of Ocean, having 1.0 datatokens means you can access the underlying data asset for the duration of the subscription (once youve initiated the order). For Predictoor contracts this is 24h. Each datatoken contract has a parent Ocean data NFT with metadata, means to specify & collect fees, and more.

- Predictoor behavior. Each datatoken contract has additional methods specific to Predictoor: submitting predictions, submitting truevals, computing aggregated predictions, etc.