contracts-v4
🦑 Smart contracts for Ocean Protocol v4. https://oceanprotocol.com Ocean v4 is part of the Ocean Protocol toolset.
This is in beta state and you can expect running into problems. If you run into them, please open up a new issue.
📚 Installation
For quick installation of the contract ABIs:
Javascript/Typescript
npm install @oceanprotocol/contracts
Python
pip3 install ocean-contracts
⚙️ Usage
By default, Python does not support importing json files directly, so it is recommended to use json-sempai package in order to automatically importing ABIs/json artifacts.
pip3 install json-sempai
# install the ocean-contracts package.
from jsonsempai import magic
from artifacts import address
Overview
🏄 Quickstart
Features
-
Base IP is now represented by an NFT, from which a datapublisher can create multiple ERC20s representing different type of access for the same dataset.
-
Help Ocean Community Monetize: there's a swap fee for the Ocean Community, if Ocean or allied tokens are the basetoken in a pool, Ocean Community will receive 0.1% swap fee, otherwhise it will be 0.2%.
Flexibility
-
Based on ERC721 and ERC20 templates to provide different features
-
Introduce an advanced Fee Structure both for Market and Provider runners.
-
Roles Administration: there are now multiple roles for a more flexible administation both at NFT and ERC20 levels
-
Key-value store in the NFT contract : NFT contract can be used to store custom key-value pairs (ERC725Y standard)
-
Multiple NFT template support: the Factory can deploy different types of NFT templates
-
Multiple datatoken template support: the Factory can deploy different types of Datatoken templates
Publisher Flow
Interaction flow from DataPublisher point of view.
Roles Diagram
How roles are handled in the v4.
Functions you will need
Selection of most common functions.
Bundle functions
Helper functions which can perform multiple steps in 1 call.
If you have any difficulties with the quickstarts, or if you have further questions about how to use the contracts please reach out to us on Discord.
If you notice any bugs or issues with this repo please open an issue on github. -->
The ocean.js and ocean.py libraries wrap contracts in JavaScript and Python respectively. They each have quickstart guides.
🦑 Development and Testing
Run hardhat in a new terminal:
export ALCHEMY_URL="https://eth-mainnet.alchemyapi.io/v2/XXXXXXXX"
npm install
npx hardhat node
Open a new terminal to run the tests:
export ALCHEMY_URL="https://eth-mainnet.alchemyapi.io/v2/XXXXXXXX"
npm run test:full
# same thing, but with coverage reporting
npm run test:full:cover
Unit Tests
You can execute just unit tests with:
npm run test:unit
Flow Tests
You can execute just flow tests with:
npm run test:flow
🏛 License
Copyright ((C)) 2023 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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ocean_contracts-2.9.0.tar.gz.
File metadata
- Download URL: ocean_contracts-2.9.0.tar.gz
- Upload date:
- Size: 403.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
38439fb114188dcc94fbea8194666147055df7cbafe53ce25b696ba80cc63cf8
|
|
| MD5 |
dc6e7c238fbe189a4a92b053b9e54c09
|
|
| BLAKE2b-256 |
51f4f9e9613dfe99a6e5546a5793f2ac24664442a898a5dd016d7cba76bc6a08
|
File details
Details for the file ocean_contracts-2.9.0-py3-none-any.whl.
File metadata
- Download URL: ocean_contracts-2.9.0-py3-none-any.whl
- Upload date:
- Size: 453.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
634a2380a6623c505215426eb1a55e60cc2fbf77d9ae181e522c5138aebd3192
|
|
| MD5 |
247662698780cc8a671890b4a3fbf48c
|
|
| BLAKE2b-256 |
beb6f05a19cb5626a4d11f17ca4a4a9d33de1b14715a17e025136aa7a918f3f4
|
