Set Up a Marketplace

Set up and run a data marketplace in an Ocean network.

In Ocean Protocol, marketplaces and publishers play different roles (outlined in the Terminology page), but both roles can be played by the same person or organization. Initially, we anticipate that will be the most common setup. As a result, this guide explains how to set up and run a combined marketplace/publisher (for now).

An Outline of the Steps

  1. Have assets to offer in your marketplace.
  2. Prepare those assets to work with Ocean Protocol.
  3. Develop a marketplace/publisher app.
  4. Run everything you need to run in production.

Prepare Assets

At the time of writing, the following kinds of assets were supported:

You can use all of the above. You aren’t restricted to using only one storage provider.

Support for other kinds of assets (e.g. computing in Azure) is coming.

Develop a Marketplace/Publisher App

At the time of writing, we recommend the following steps to develop a marketplace/publisher app:

  1. Do the React App Tutorial.
  2. Grow your app from there.

For more examples and inspiration, check out the source code for the Commons Marketplace and the source code for Pleuston. Both have an Apache v2 open source license. Both use React and squid-js. Both are “serverless” apps: they run entirely in the browser and have no server-side component.


⛲️ Commons Marketplace client & server to explore, download, and publish open data sets in the Ocean Protocol Network.

Other Options

A marketplace/publisher app could have both a back-end component and a front-end component. The main consideration is that you should probably use a programming language with an existing Squid library:

There are examples of how to use squid-py in the Tutorials. squid-py is to Ocean like boto3 is to AWS.

Of course, you could always write your own Squid library in the language of your choice.

Run Everything You Need to Run in Production

When developing your marketplace/publisher app, you will probably use Barge to run all the Ocean Protocol components on your local machine. When it comes time to go to production, you will have to run some of those components in production:

  • Your marketplace/publisher app
  • Aquarius
  • A database to go with Aquarius, e.g. Elasticsearch or MongoDB
  • Brizo
  • Recommended: a keeper node with the keeper contracts deployed to it, connected to an Ocean network
  • Optional: your own Secret Store nodes (for a more advanced setup)

Before running all of that in production, you will want to test it with an Ocean Protocol testnet.

Of course, there are many other things that must be handled in production:

  • Security of the infrastructure where the software is running
  • Monitoring
  • Log aggregation, storage and search
  • Handling crashes or other faults

Each of those is a big topic beyond the scope of these docs.