@oceanprotocol/keeper-contracts

keeper-contracts

💧 Integration of TCRs, CPM and Ocean Tokens in Solidity oceanprotocol.com

Ocean Keeper implementation where we put the following modules together:

• TCRs: users create challenges and resolve them through voting to maintain registries;
• Ocean Tokens: the intrinsic tokens circulated inside Ocean network, which is used in the voting of TCRs;
• Curated Proofs Market: the core marketplace where people can transact with each other and curate assets through staking with Ocean tokens.

Table of Contents

• Get Started
  • Docker
  • Local development
• Testing
• Documentation
• Contributing
• License

---

Get Started

For local developmenty you can either use Docker, or setup the development environment on your machine.

Docker

The most simple way to get started is with Docker:

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

docker build -t keeper-contracts:0.1 .
docker run -d -p 8545:8545 keeper-contracts:0.1

Which will expose the Ethereum RPC client with all contracts loaded under localhost:8545, which you can add to your truffle.js:

module.exports = {
    networks: {
        development: {
            host: 'localhost',
            port: 8545,
            network_id: '*',
            gas: 6000000
        },
    }
}

Local development

As a pre-requisite, you need Node.js >= v6.11.5.

Clone the project and install all dependencies:

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

# install dependencies
npm i

# install RPC client globally
npm install -g ganache-cli

Compile the solidity contracts:

truffle compile

In a new terminal, launch an Ethereum RPC client, e.g. ganache-cli:

ganache-cli

Switch back to your other terminal and deploy the contracts:

truffle migrate

# for redeployment run this instead
truffle migrate --reset

Note:

• we enable the solc optimizer to reduce the gas cost of deployment. It can now be deployed with less gas limit such as gas = 5000000
• no need to update the from : 0x3424ft... in truffle.js and it will use the first account in testRPC or ganache-cli by default.

Testing

Run tests with truffle test, e.g.:

truffle test test/registry.js

Documentation

• Main Documentation: TCR and CPM and Ocean Tokens
• Architecture (pdf)
• Packaging of libraries

Contributing

We use GitHub as a means for maintaining and tracking issues and source code development.

If you would like to contribute, please fork this repository, do work in a feature branch, and finally open a pull request for maintainers to review your changes.

Ocean Protocol uses C4 Standard process to manage changes in the source code. Find here more details about Ocean C4 OEP.

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.