Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 3.48 KB

barge.md

File metadata and controls

102 lines (70 loc) · 3.48 KB

Barge

Barge is a Docker container to run a local Ganache network having Predictoor contracts and (optionally) local bots. This README describes how to install Barge, and provides reference on running it with various agents.

Contents

Main:

Reference: how to run barge with...

Finally:

Install Barge

First, ensure pre-requisites: Docker, Docker Compose, allowing non-root users

Then, install barge. Open a new console and...

# Grab repo
git clone https://github.com/oceanprotocol/barge
cd barge

# Clean up previous Ocean-related dirs & containers (optional but recommended) 
rm -rf ~/.ocean
./cleanup.sh
docker system prune -a --volumes

Then, get Docker running. To run barge, you need the Docker engine running. Here's how:

  • If you're on Linux: you're good, there's nothing extra to do.
  • If you're on MacOS:
    • via console: open -a Docker
    • or, via app: open Finder app, find Docker, click to open app. (You don't need to press "play" or anything else. The app being open is enough.)
    • ⚠️ MacOS may give Docker issues. Here are workarounds.

Congrats! Barge is installed and ready to be run.

The sections below describe different ways to run barge. They're for reference only; DO NOT run them right now. Each README will describe what to do.

Barge Basic

Barge with basic Predictoor components is:

  • local chain (ganache)
  • predictoor-related smart contracts deployed to chain

To run this, go to the barge console and:

./start_ocean.sh --no-provider --no-dashboard --predictoor --with-thegraph

When barge runs, it will auto-publish DT3 tokens. Currently this is {BTC/USDT, Binance, 5min}, {ETH/USDT, Kraken, 5min} and {XRP/USDT, Binance, 5min}.

Barge One Agent

Barge can run with any subset of the agents.

For example, to run barge with just trueval agent:

./start_ocean.sh --no-provider --no-dashboard --predictoor --with-thegraph --with-pdr-trueval

Barge All Agents

To run with all agents:

./start_ocean.sh --no-provider --no-dashboard --predictoor --with-thegraph --with-pdr-trueval --with-pdr-trader --with-pdr-predictoor --with-pdr-publisher --with-pdr-dfbuyer

This will run all of the following at once:

  • local chain (ganache)
  • predictoor-related smart contracts deployed to chain
  • trueval agent
  • trader agent
  • predictoor agent
  • dfbuyer agent

Change Barge Itself

Some subcomponents of Barge are those from pdr-backend. If you change those components, then the new behavior becomes part of Barge upon the next Github Release of pdr-backend. See release-process.md Docker / Barge section for details.

For each other subcomponent of Barge, you need to change its respective repo similarly.

And for Barge core functionality, make changes to the barge repo itself.

Other READMEs