From a35740d1307af0f0a4e373c225de6439b9b51c02 Mon Sep 17 00:00:00 2001 From: Ahmed Ali Date: Thu, 25 Jun 2020 09:15:52 +0200 Subject: [PATCH 1/3] Update README.md --- README.md | 91 +++++++++++++++---------------------------------------- 1 file changed, 24 insertions(+), 67 deletions(-) diff --git a/README.md b/README.md index da9cef78..06bf73cf 100644 --- a/README.md +++ b/README.md @@ -7,87 +7,44 @@ > JavaScript client library for Ocean Protocol > [oceanprotocol.com](https://oceanprotocol.com) +`ocean-lib` is a Javascript library to privately & securely publish, exchange, +and consume data. With it, you can: +* **Publish** data services: downloadable files, streaming data, or compute-to-data. +Ocean creates a new [ERC20](https://github.com/ethereum/EIPs/blob/7f4f0377730f5fc266824084188cc17cf246932e/EIPS/eip-20.md) +data token for each data service or set of services. +* **Mint** data tokens for the service +* **Consume** data tokens, to access the service +* **Transfer** data tokens to another owner, and **all other ERC20 actions** +using [web3.js](https://web3js.readthedocs.io/en/v1.2.9/web3-eth-contract.html) etc. + +`ocean-lib` is part of the [Ocean Protocol](www.oceanprotocol.com) toolset. + This is in alpha state and you can expect running into problems. If you run into them, please open up a [new issue](/issues). -## Table of Contents +## Quick Install - - [Get Started](#get-started) - - [Local development](#local-development) - - [Testing](#testing) - - [Code Linting](#code-linting) - - [Packages](#packages) - - [Documentation](#documentation) - - [Contributing](#contributing) - - [Prior Art](#prior-art) - - [License](#license) +```npm i @oceanprotocol/lib``` -# Get Started +## Quickstart: Simple Flow -TBD +This stripped-down flow shows the essence of Ocean. Just downloading, no metadata. -### Local development +[Go to simple flow](README_simple_flow.md) -As a pre-requisite, you need: +## Quickstart: Marketplace Flow -- Node.js -- npm +This batteries-included flow includes metadata, multiple services for one datatoken, and compute-to-data. -Note: For MacOS, make sure to have `node@10` installed. +[Go to marketplace flow](README_marketplace_flow.md) -Clone the project and install all dependencies: +## For ocean-lib Developers -```bash -git clone git@github.com:oceanprotocol/ocean-js.git -cd ocean-js/ - -# install packages -npm i - -``` - -# Testing - -Run tests with - -```bash -# for unit tests -TBD - -# for test coverage -TBD -``` - -### Code Linting - -Linting is setup for `JavaScript` with [ESLint](https://eslint.org) - -```bash -# to check lint issues -npm run lint -``` -Code style is enforced through the CI test process, builds will fail if there're any linting errors. - -## Documentation - -* [Release process](doc/RELEASE_PROCESS.md) -* [Core Documentation](doc/contracts/README.md) -* [Packaging of libraries](doc/PACKAGING.md) - -## Contributing - -See the page titled "[Ways to Contribute](https://docs.oceanprotocol.com/concepts/contributing/)" in the Ocean Protocol documentation. - - - -## Prior Art - -This project builds on top of the work done in open source projects: -- [OpenZeppelin/openzeppelin-contracts](https://github.com/OpenZeppelin/openzeppelin-contracts) +[Go to ocean-lib-developers flow](README_ocean-lib-developers.md) ## License ``` -Copyright 2018 Ocean Protocol Foundation +Copyright ((C)) 2020 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. @@ -100,4 +57,4 @@ 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. -``` \ No newline at end of file +``` From bbd9067e3dd8a087787cc6e435060777eec31990 Mon Sep 17 00:00:00 2001 From: Ahmed Ali Date: Thu, 25 Jun 2020 09:17:34 +0200 Subject: [PATCH 2/3] minor fix --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 06bf73cf..50078aa3 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,8 @@ [![banner](https://raw.githubusercontent.com/oceanprotocol/art/master/github/repo-banner%402x.png)](https://oceanprotocol.com) -|[![Build Status](https://travis-ci.com/oceanprotocol/lib-js.svg?token=soMi2nNfCZq19zS1Rx4i&branch=develop)](https://travis-ci.com/oceanprotocol/lib-js) +|[![Build Status](https://travis-ci.com/oceanprotocol/ocean-lib-js.svg?token=soMi2nNfCZq19zS1Rx4i&branch=develop)](https://travis-ci.com/oceanprotocol/lib-js) -

Lib-js

- -> JavaScript client library for Ocean Protocol -> [oceanprotocol.com](https://oceanprotocol.com) +

Ocean-lib

`ocean-lib` is a Javascript library to privately & securely publish, exchange, and consume data. With it, you can: From 91c953485b7623b2fba5065409e99cfb21141878 Mon Sep 17 00:00:00 2001 From: Ahmed Ali Date: Thu, 25 Jun 2020 09:18:59 +0200 Subject: [PATCH 3/3] Rename README_simpleflow.md to README_simple_flow.md --- README_simpleflow.md => README_simple_flow.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README_simpleflow.md => README_simple_flow.md (100%) diff --git a/README_simpleflow.md b/README_simple_flow.md similarity index 100% rename from README_simpleflow.md rename to README_simple_flow.md