From 931ce0a20153342a322a43ef5621cba6a2f925f5 Mon Sep 17 00:00:00 2001
From: Veronica Manuel <101472818+graceful-coder@users.noreply.github.com>
Date: Wed, 25 Oct 2023 09:38:54 -0400
Subject: [PATCH 1/8] Update README.md
---
discover/networks/README.md | 24 +++++++++++++++++++++++-
1 file changed, 23 insertions(+), 1 deletion(-)
diff --git a/discover/networks/README.md b/discover/networks/README.md
index 6ac2c295..97d34b8e 100644
--- a/discover/networks/README.md
+++ b/discover/networks/README.md
@@ -13,7 +13,7 @@ In each network, whether it's the Ethereum mainnet, a testnet, or the Polygon/Ma
The Ethereum mainnet is a production network, which means that it is a live and operational network that handles real transactions and has actual economic value. To connect to the Ethereum mainnet using a wallet such as MetaMask, you can click on the network name dropdown and select Ethereum mainnet from the list of available networks.
-
+
### Polygon Mainnet
@@ -25,6 +25,28 @@ Ocean Protocol is also deployed to Polygon Mainnet, which is another production
Check out the Polygon Bridge [guide](bridges.md) to learn how you can deposit, withdraw and send tokens.
+### Oasis Sapphire Mainnet
+
+Ocean Protocol is also deployed to Oasis Sapphire Mainnet, which is a production network that Ocean Protocol uses for [Predictoor](https://predictoor.ai). Ocean Protocol does do not currently support ocean.js, ocean.py, or Ocean Market on Oasis Sapphire. The native token of Oasis Sapphire is ROSE. If you cannot find Oasis Sapphire Mainnet as a predefined network in your wallet, you can manually connect to it by entering the following information during the import process: Network Name: `Oasis Sapphire`, RPC URL: `https://sapphire.oasis.io`, Chain ID: `23294`, Token: `ROSE`.
+
+
+
+**Bridge**
+
+Check out our Celer Bridge [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/get-ocean-on-sapphire.md#2-transfer-ocean-to-sapphire-mainnet-via-celer) to learn how you can bridge your OCEAN tokens from Ethereum Mainnet to Oasis Sapphire Mainnet.
+
+### Oasis Sapphire Testnet
+
+Ocean Protocol is also deployed to Oasis Sapphire Testnet, which is a test network that Ocean Protocol uses for [Predictoor](https://predictoor.ai). Ocean Protocol does do not currently support ocean.js, ocean.py, or Ocean Market on Oasis Sapphire. The native token of Oasis Sapphire is ROSE. If you cannot find Oasis Sapphire Testnet as a predefined network in your wallet, you can manually connect to it by entering the following information during the import process: Network Name: `Oasis Sapphire Testnet`, RPC URL: `https://testnet.sapphire.oasis.dev`, Chain ID: `23295`, Token: `ROSE`.
+
+
+
+**Get (fake) OCEAN on Sapphire Testnet**
+
+Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-ocean-on-sapphire-testnet) for how to get fake OCEAN tokens on Sapphire Testnet.
+
+Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-rose-on-sapphire-testnet) for how to get fake ROSE tokens on Oasis Sapphire Testnet.
+
### BNB Smart Chain
Ocean Protocol is also deployed to BNB Smart Chain, which is another production network. The native token of the BNB Smart Chain is BNB, which is the token of the Binance exchange. If BNB Smart Chain is not listed as a predefined network in your wallet, you can manually connect to it by following Binance's [guide](https://academy.binance.com/en/articles/connecting-metamask-to-binance-smart-chain), which provides detailed instructions on how to connect to BNB Smart Chain.
From a42304e9658c8997e44288c67ea6867b199a62a5 Mon Sep 17 00:00:00 2001
From: Veronica Manuel <101472818+graceful-coder@users.noreply.github.com>
Date: Wed, 25 Oct 2023 09:48:11 -0400
Subject: [PATCH 2/8] Update bridges.md
---
discover/networks/bridges.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/discover/networks/bridges.md b/discover/networks/bridges.md
index 072651d3..0afb6a47 100644
--- a/discover/networks/bridges.md
+++ b/discover/networks/bridges.md
@@ -9,6 +9,10 @@ A bridge is a mechanism that connects two or more separate blockchain networks,
We suggest using the following solutions to transfer OCEAN between Ethereum mainnet and Polygon or BSC.
+## Celer Bridge
+
+To transfer OCEAN to and from the Oasis Sapphire Mainnet, we recommend using the [Celer Bridge](https://cbridge.celer.network/1/23294/OCEAN). No bridge is needed for transfering OCEAN to the Oasis Sapphire Testnet because Ocean Protocol offers a [faucet](https://faucet.sapphire.oceanprotocol.com/) for OCEAN on Oasis Sapphire Testnet. Note that Ocean Protocol supports Oasis Sapphire networks for [Predictoor](https://predictoor.ai) development, and does not currently support Oasis Sapphire for ocean.js, ocean.py, or Ocean Market.
+
## BNB Smart Chain Bridge
To transfer OCEAN to and from the BNB Smart Chain, we recommend using the [Binance Bridge](https://www.bnbchain.org/en/bridge). BSC offers various options such as withdrawing crypto from [Binance](https://www.binance.com/en) and utilizing the [Binance Bridge](https://www.bnbchain.org/en/bridge). You can refer to the Binance Academy article "[How to Get Started with BSC](https://academy.binance.com/en/articles/how-to-get-started-with-binance-smart-chain-bsc)" for more information.
From afa0bc0a1a593991750de5d495bcb9d9ba78f777 Mon Sep 17 00:00:00 2001
From: Ana Loznianu
Date: Wed, 25 Oct 2023 21:02:05 +0300
Subject: [PATCH 3/8] Added FRE swap fee
---
developers/contracts/fees.md | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/developers/contracts/fees.md b/developers/contracts/fees.md
index 2830e781..f319d974 100644
--- a/developers/contracts/fees.md
+++ b/developers/contracts/fees.md
@@ -21,6 +21,18 @@ However, if you're building a custom marketplace, you have the flexibility to in
| --------------------- | ------------------------------ |
| 0% | Customizable in market config. |
+
+### Swap fee
+
+Swap fees are incurred as a transaction cost whenever someone exchanges one type of token for another within a [fixed rate exchange](./pricing-schemas.md#fixed-pricing). These exchanges can involve swapping a datatoken for a basetoken, like OCEAN or H2O, or vice versa, where basetoken is exchanged for datatoken. The specific value of the swap fee depends on the type of token being used in the exchange.
+
+The swap fee values are set at the smart contract level and can only be modified by the Ocean Protocol Foundation (OPF).
+
+| Value for OCCEAN or H2O | Value for other ERC20 tokens |
+| ----------------------- | ----------------------------- |
+| 0.1% | 0.2% |
+
+
### Consume(aka. Order) fee
When a user exchanges a [datatoken](datatokens.md) for the privilege of downloading an asset or initiating a compute job that utilizes the asset, consume fees come into play. These fees are associated with accessing an asset and include:
@@ -32,7 +44,7 @@ When a user exchanges a [datatoken](datatokens.md) for the privilege of download
* Eg: A market can set a fixed fee of 10 USDT per order, no matter what pricing schemas are used (fixedrate with ETH, BTC, dispenser, etc).
2. **Consume Market** Consumption Fee
* A market can specify what fee it wants on the order function.
-3. **Provider Consumption** Fees
+3. **Provider** Consumption Fees
* Defined by the [Provider](../provider/README.md) for any consumption.
* Expressed in: Address, Token, Amount (absolute), Timeout.
* You can retrieve them when calling the initialize endpoint.
From 366dde9ce341ab86fb014cf64c6d553b184aa3e7 Mon Sep 17 00:00:00 2001
From: Ana Loznianu
Date: Wed, 25 Oct 2023 21:09:14 +0300
Subject: [PATCH 4/8] added alignment for tables
---
developers/contracts/fees.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/developers/contracts/fees.md b/developers/contracts/fees.md
index f319d974..423abc0b 100644
--- a/developers/contracts/fees.md
+++ b/developers/contracts/fees.md
@@ -17,9 +17,9 @@ When you publish an asset on the Ocean marketplace, there are currently no charg
However, if you're building a custom marketplace, you have the flexibility to include a publishing fee by adding an extra transaction in the publish flow. Depending on your marketplace's unique use case, you, as the marketplace owner, can decide whether or not to implement this fee. We believe in giving you the freedom to tailor your marketplace to your specific needs and preferences.
-| Value in Ocean Market | Value in Other Markets |
-| --------------------- | ------------------------------ |
-| 0% | Customizable in market config. |
+| Value in Ocean Market | Value in Other Markets |
+| :---------------------: | :------------------------------: |
+| 0% | Customizable in market config. |
### Swap fee
@@ -28,9 +28,9 @@ Swap fees are incurred as a transaction cost whenever someone exchanges one type
The swap fee values are set at the smart contract level and can only be modified by the Ocean Protocol Foundation (OPF).
-| Value for OCCEAN or H2O | Value for other ERC20 tokens |
-| ----------------------- | ----------------------------- |
-| 0.1% | 0.2% |
+| Value for OCCEAN or H2O | Value for other ERC20 tokens |
+| :-----------------------: | :-----------------------------: |
+| 0.1% | 0.2% |
### Consume(aka. Order) fee
From c8405bd3c543d4a84883d32697541872ca377584 Mon Sep 17 00:00:00 2001
From: Ana Loznianu
Date: Fri, 27 Oct 2023 11:31:46 +0300
Subject: [PATCH 5/8] Added links to templates and showcases
---
.../assets/templates/TicketingMobileApp.png | Bin 0 -> 34592 bytes
.../assets/templates/TokengatedAIChatbot.png | Bin 0 -> 15063 bytes
.gitbook/assets/templates/marketplace.png | Bin 0 -> 407118 bytes
.gitbook/assets/templates/oceanArt.jpg | Bin 0 -> 61432 bytes
.gitbook/assets/templates/oceanLearn.jpg | Bin 0 -> 65503 bytes
.gitbook/assets/templates/oceanReads.jpg | Bin 0 -> 103389 bytes
.gitbook/assets/templates/ocean_waves.png | Bin 0 -> 52772 bytes
.gitbook/assets/templates/tokengate.png | Bin 0 -> 348840 bytes
.../assets/templates/tokengated_chatbot.png | Bin 0 -> 383613 bytes
.gitbook/assets/templates/webPallete.png | Bin 0 -> 19458 bytes
developers/ocean.js/README.md | 74 ++++++++++++++++++
11 files changed, 74 insertions(+)
create mode 100644 .gitbook/assets/templates/TicketingMobileApp.png
create mode 100644 .gitbook/assets/templates/TokengatedAIChatbot.png
create mode 100644 .gitbook/assets/templates/marketplace.png
create mode 100644 .gitbook/assets/templates/oceanArt.jpg
create mode 100644 .gitbook/assets/templates/oceanLearn.jpg
create mode 100644 .gitbook/assets/templates/oceanReads.jpg
create mode 100644 .gitbook/assets/templates/ocean_waves.png
create mode 100644 .gitbook/assets/templates/tokengate.png
create mode 100644 .gitbook/assets/templates/tokengated_chatbot.png
create mode 100644 .gitbook/assets/templates/webPallete.png
diff --git a/.gitbook/assets/templates/TicketingMobileApp.png b/.gitbook/assets/templates/TicketingMobileApp.png
new file mode 100644
index 0000000000000000000000000000000000000000..41a949c1e25649ecbdbe7613ece0ba9d276ebe61
GIT binary patch
literal 34592
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
go`l6UJ|tNWirRJY87kDnK6wmp0l
zMZ_PkvLuZ4C~+YU>W*u`cdG6~+UFe5Jm&Mi42VJtcac2vZZPN4Mc}`1
zKmB&)NCtbSw$mB6B7XR%So2M6lzQ83iJ}%9cX3F=v*DQ4rI==9YuV$nYeD`D(k~rR
zz2W=SCU>c?9GSuH+uEYM7F}NaTHP0Z*E4hBo}d2TpCzsv1bGX0
bf8+lD{g?#ud4oUPO<6td|HsetuU-EONx&;G
literal 0
HcmV?d00001
diff --git a/.gitbook/assets/templates/TokengatedAIChatbot.png b/.gitbook/assets/templates/TokengatedAIChatbot.png
new file mode 100644
index 0000000000000000000000000000000000000000..15076fa9c84168781524070a8e7fd0ceafe16aea
GIT binary patch
literal 15063
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