ocean-contracts 0.3.3

🐳 Ocean Protocol L1 - v3

Ocean Protocol Contracts

This is in alpha state and you can expect running into problems. If you run into them, please open up a new issue.

Table of Contents

• Get Started
  • Installation
  • Usage
  • Local development
• Testing
  • Code Linting
• Networks
• Packages
• Documentation
• Contributing
• Prior Art
• License

Get Started

Installation

For quick installation of the contracts ABIs:

npm i @oceanprotocol/contracts

Usage

To import a contract ABI:

const dtFactoryABI = require('@oceanprotocol/contracts/artifacts/development/DTFactory.json')

const dtFactoryAddress = '0x123456789.....'

const dtFactory = new web3.eth.Contract(
                  dtFactoryABI, 
                  dtFactoryAddress,
                  {
                     from: accounts[0]
                  }
               )

// create new datatoken
const tx = await dtFactory.methods
               .createToken('https://123example.com')
               .send()
let tokenAddress = null
try {
   tokenAddress = tx.events.TokenCreated.returnValue[0]
} catch (e) {
   console.error(e)
}

Local development

For local development of the contracts setup the development environment on your machine as follows:

As a pre-requisite, you need:

• Node.js
• npm

Note: For MacOS, make sure to have node@10 installed.

Clone the project and install all dependencies:

git clone [e-mail]:oceanprotocol/contracts.git
cd contracts/

# install packages
npm i

# to compile contracts
npm run compile

Testing

Run tests with

# for unit tests
npm run test:unit

# for test coverage
npm run test:cover

Code Linting

Linting is setup for JavaScript with ESLint & Solidity with Ethlint.

# 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.

Networks

Testnets

For local development, start a local testnet using ganache-cli, then run:

npm run deploy

Checkout the supported deployment(s) on test networks.

Documentation

To use generate documentation via solidity-docgen please run:

npm run doc:generate

• Release Process
• Core Documentation

Contributing

See the page titled "Ways to Contribute" in the Ocean Protocol documentation.

Prior Art

This project builds on top of the work done in open source projects:

• OpenZeppelin/openzeppelin-contracts

License

Copyright 2018 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.