1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-07-01 06:02:10 +02:00
docs/predictoor/pdr-architecture.md

4.2 KiB
Raw Blame History

description
"We can only see a short distance ahead, but we can see plenty there that needs to be done." — Alan Turing

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.

Testnet Details

As of Sep 12, 2023, Predictoor / Ocean contracts are deployed to Oasis Sapphire testnet.

Users need fake OCEAN & ROSE tokens. You can find the Tutorial on How to Get tokens here.

Fake OCEAN. Staking & payment is in fake OCEAN. Users acquire it via a faucet.
Fake ROSE. Gas fees are in fake ROSE. Users acquire it via a faucet.

Mainnet Details

As of Oct 10, 2023, Predictoor / Ocean contracts are deployed to Oasis Sapphire mainnet.

Users need (real) OCEAN & ROSE tokens:

OCEAN. Staking & payment is in OCEAN. Users acquire OCEAN via exchanges. Users bridge OCEAN tokens from ETH mainnet to Oasis Sapphire mainnet via Celer.
ROSE. Gas fees are in ROSE. Users bridge tokens bridge from Oasis Emerald mainnet to Oasis Sapphire mainnet via Celer. Read the details here