1
0
mirror of https://github.com/oceanprotocol/ocean.js.git synced 2024-11-26 20:39:05 +01:00

Merge pull request #106 from oceanprotocol/fix/readme

fix/readme
This commit is contained in:
Ahmed Ali 2020-06-25 09:21:25 +02:00 committed by GitHub
commit 72c0b12fd4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 25 additions and 71 deletions

View File

@ -1,93 +1,47 @@
[![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)
<h1 align="center">Lib-js</h1>
<h1 align="center">Ocean-lib</h1>
> 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 +54,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.
```
```