Skip to main content

🐳 Ocean protocol library.

Project description

banner

ocean.py

Python library to privately & securely publish, exchange, and consume data.

Maintainability Test Coverage

With ocean.py, you can:

  • Publish data services: downloadable files or compute-to-data. Create an ERC721 data NFT for each service, and ERC20 datatoken for access (1.0 datatokens to access).
  • Sell datatokens via for a fixed price. Sell data NFTs.
  • Transfer data NFTs & datatokens to another owner, and all other ERC721 & ERC20 actions using web3.py, Brownie, etc.

ocean.py is part of the Ocean Protocol toolset.

This is in beta state. If you run into problems, please open up a new issue.

🏗 Installation

#Install the ocean.py library. Allow pre-releases for the latest v4 version. Install wheel first to avoid errors.
pip install wheel
pip install --pre ocean-lib

⚠️ Mac users: if you encounter an "Unsupported Architecture" issue, then install including ARCHFLAGS: ARCHFLAGS="-arch x86_64" pip install ocean-lib. [Details.]

🏄 Quickstart

Here are flows to try out, from simple to specific detailed variants.

  • Simple flow - the essence of Ocean - creating a data NFT & datatoken.
  • Publish flow - a dataset is published.
  • Consume flow - a published dataset is consumed (downloaded).
  • Marketplace flow - a data asset is posted for sale at fixed rate, then purchased.
  • Dispenser flow - here, a datatoken dispenser is created and datatokens are dispensed for free.

Remote flows

More types of data assets

Data Bounties flows

Key-value flows

  • Key-value database - use data NFTs to store arbitrary key-value pairs on-chain.
  • Profile NFTs - enable "login with Web3" where Dapp can access private user profile data.

Learn more

🦑 Development

🏛 License

Copyright ((C)) 2022 Ocean Protocol Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ocean-lib-1.4.0.tar.gz (67.0 kB view hashes)

Uploaded source

Built Distribution

ocean_lib-1.4.0-py2.py3-none-any.whl (89.7 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page