GITBOOK-15: Updated the bridges page

SUMMARY.md

@@ -2,11 +2,11 @@
 
 * [👋 Welcome](README.md)
 * [🌊 Discover](discover/discover.md)
-  * [Networks](discover/networks.md)
+  * [Networks](discover/networks/README.md)
+    * [Bridges](discover/networks/bridges.md)
   * [Wallets](discover/wallets.md)
   * [Set Up MetaMask Wallet](discover/metamask-setup.md)
   * [Manage Your OCEAN Tokens](discover/wallets-and-ocean-tokens.md)
-  * [Bridges](discover/bridges.md)
   * [FAQ](discover/faq.md)
 * [📚 Tutorials](tutorials/README.md)
   * [Using Ocean Market](tutorials/using-ocean-market/README.md)
@@ -36,7 +36,7 @@
   * [Data Farming Background](rewards/df-background.md)
   * [Emissions & APYs](rewards/emissions-apys.md)
   * [Rewards Tutorial](rewards/veOcean-Data-Farming-Tutorial.md)
-* [👨💻 Developers](developers/README.md)
+* [👨💻 👨💻 Developers](developers/README.md)
   * [Core concepts](developers/core-concepts/README.md)
     * [Architecture Overview](developers/core-concepts/architecture.md)
     * [Data NFTs and Datatokens](developers/core-concepts/datanft-and-datatoken.md)

discover/bridges.md

@@ -1,78 +0,0 @@
----
-title: Bridges
----
-
-# Bridges
-
-## Binance Smart Chain (BSC) Bridge
-
-### Intro to BSC's Bridge
-
-BSC provides several bridge options, including:
-
-* withdraw crypto from Binance.com, and
-* use Binance bridge.
-
-The article [How to Get Started with BSC](https://academy.binance.com/en/articles/how-to-get-started-with-binance-smart-chain-bsc) by Binance Academy provides further details.
-
-#### Links
-
-* [BSC Wallet Support](https://docs.binance.org/wallets/bsc-wallets.html). Includes MetaMask and Trust Wallet.
-* [BSC Bridge](https://www.bnbchain.org/en/bridge)
-* [How to set up a custom network in MetaMask](metamask-setup.md#set-up-custom-network)
-
-## Polygon (ex Matic) Bridge
-
-#### Links
-
-* [Matic Wallet](https://wallet.polygon.technology/)
-* [Matic Bridge](https://wallet.polygon.technology/bridge/)
-* [How to set up a custom network in MetaMask](metamask-setup.md#set-up-custom-network)
-
-#### Intro to Polygon's Bridge
-
-The Polygon Network (ex Matic) provide us with a bridge (connecting Ethereum & Polygon blockchains), and a dedicated [wallet](https://wallet.polygon.technology/) that simplify the steps of transferring digital assets between the two networks. The wallet connects to your account via Metamask (or any of the other supported wallets).
-
-When you open the wallet link, the wallet will ask to log in. Select your preferred way of connecting and confirm the action. In our guide we'll use Metamask.
-
-![Login options](../.gitbook/assets/wallet/login-options.png)
-
-In some places, the Polygon Network is still using its old brand Matic. Either you run into Matic or Polygon - it's the exact same thing. For the purpose of this guide, we'll use Matic in the next few paragraphs since the interfaces you're going to use still use the old brand.
-
-For details check the [blog post](https://blog.oceanprotocol.com/ocean-on-polygon-network-8abad19cbf47).
-
-#### Deposit Tokens
-
-On the main page of the wallet, you can see all tokens you own on the Matic Mainnet. To deposit tokens (transfer them from the Ethereum Mainnet) you can either use the “deposit” button for a selected token or use “Move funds to Matic Mainnet”.
-
-![Main wallet page](<../.gitbook/assets/wallet/wallet-page (1).png>)
-
-Both options will redirect you to the bridge interface. In case you chose the second one, use the dropdown and select the token you want to transfer from the Ethereum Mainnet.
-
-![Bridge interface](../.gitbook/assets/wallet/matic-bridge.png)
-
-Choose the amount to transfer and click the “Transfer” button. Matic’s bridge interface will guide you through the whole process and the different steps that will occur. You’ll need to sign two transactions on the Ethereum Mainnet. The first being the approval for your token to be traded on the Matic’s bridge and the second one being the deposit.
-
-![Transferring process](<../.gitbook/assets/wallet/transferring (1).png>)
-
-#### Withdraw Tokens
-
-The withdrawing tokens process uses the same bridge interface. The only difference being that the withdraw happens from the Matic to the Ethereum Mainnet.
-
-Again the bridge interface will guide you through the different steps.
-
-For more in dept explanation of the deposit and withdraw actions check [the official Polygon (ex Matic) docs](https://docs.matic.network/docs/develop/ethereum-matic/pos/getting-started).
-
-#### Sending Tokens
-
-While in the first two cases, the transactions are signed on the Ethereum Mainnet, transferring tokens between two Matic addresses happens on the Matic Mainnet. Thus it’s required for you to connect to the Matic network to sign the transactions. You can use the following parameters to set the network in Metamask:
-
-| What               | Value                             |
-| ------------------ | --------------------------------- |
-| Network Name       | `Matic Mainnet`                   |
-| RPC                | `https://polygon-rpc.com/`        |
-| Chain Id           | `137`                             |
-| Currency Symbol    | `MATIC`                           |
-| Block Explorer URL | `https://explorer.matic.network/` |
-
-Follow our guide to learn how to use those values to [set up a custom network in MetaMask](metamask-setup.md#set-up-custom-network).

discover/discover.md

@@ -41,9 +41,9 @@ As a data scientist or AI practitioner, you can benefit from access to more data
 
 The following guides will help you get started with buying and selling data:
 
-- [Publish a data asset](../tutorials/using-ocean-market/marketplace-publish-data-asset.md)
-- [Download a data asset](../tutorials/using-ocean-market/marketplace-download-data-asset.md)
-- [Publishing with hosting services](../tutorials/using-ocean-market/asset-hosting.md)
+* [Publish a data asset](../tutorials/using-ocean-market/marketplace-publish-data-asset.md)
+* [Download a data asset](../tutorials/using-ocean-market/marketplace-download-data-asset.md)
+* [Publishing with hosting services](../tutorials/using-ocean-market/asset-hosting.md)
 
 ### Build Your Own Data Market
 
@@ -53,9 +53,9 @@ Use Ocean Protocol software tools to build your own data marketplace, by either
 
 If you're interested in starting your own marketplace checkout the following guides:
 
-- [Forking Ocean Market](../tutorials/build-a-marketplace/forking-ocean-market.md)
-- [Customising your market](../tutorials/build-a-marketplace/customising-your-market.md)
-- [Deploying your market](../tutorials/build-a-marketplace/deploying-market.md)
+* [Forking Ocean Market](../tutorials/build-a-marketplace/forking-ocean-market.md)
+* [Customising your market](../tutorials/build-a-marketplace/customising-your-market.md)
+* [Deploying your market](../tutorials/build-a-marketplace/deploying-market.md)
 
 ### Manage datatokens and data NFTs for use in DeFi
 
@@ -73,9 +73,9 @@ To access the dataset, you send 1.0 datatokens to the data provider (running Oce
 
 Since datatokens are ERC20, and live on Ethereum mainnet, there's a whole ecosystem to leverage.
 
-- _Publish and access data services:_ downloadable files or compute-to-data. Use Ocean to deploy a new [ERC721](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md) and [ERC20](https://github.com/ethereum/EIPs/blob/7f4f0377730f5fc266824084188cc17cf246932e/EIPS/eip-20.md) datatoken contract for each data service, then mint datatokens.
-- _Transfer datatokens_ to another owner (or approve & transferFrom).
-- _And more._ Use ERC20 support in [web3.js](https://web3js.readthedocs.io/), [web3.py](https://web3py.readthedocs.io/en/stable/examples.html#working-with-an-erc20-token-contract) and Solidity to connect datatokens with crypto wallets and other DeFi services.
+* _Publish and access data services:_ downloadable files or compute-to-data. Use Ocean to deploy a new [ERC721](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md) and [ERC20](https://github.com/ethereum/EIPs/blob/7f4f0377730f5fc266824084188cc17cf246932e/EIPS/eip-20.md) datatoken contract for each data service, then mint datatokens.
+* _Transfer datatokens_ to another owner (or approve & transferFrom).
+* _And more._ Use ERC20 support in [web3.js](https://web3js.readthedocs.io/), [web3.py](https://web3py.readthedocs.io/en/stable/examples.html#working-with-an-erc20-token-contract) and Solidity to connect datatokens with crypto wallets and other DeFi services.
 
 ### Compute-to-Data
 
@@ -93,11 +93,11 @@ Private data can help research, leading to life-altering innovations in science
 
 Checkout these guides if you are aiming to get a deeper understanding on how compute-to-data works:
 
-- [Architecture](../developers/core-concepts/compute-to-data-architecture.md)
-- [Datasets & Algorithms](../developers/core-concepts/compute-to-data-datasets-algorithms.md)
-- [Minikube Environment](../infrastructure/compute-to-data-minikube.md)
-- [Writing Algorithms](../developers/core-concepts/compute-to-data-algorithms.md)
-- [Private docker registry](../infrastructure/compute-to-data-docker-registry.md)
+* [Architecture](../developers/core-concepts/compute-to-data-architecture.md)
+* [Datasets & Algorithms](../developers/core-concepts/compute-to-data-datasets-algorithms.md)
+* [Minikube Environment](../infrastructure/compute-to-data-minikube.md)
+* [Writing Algorithms](../developers/core-concepts/compute-to-data-algorithms.md)
+* [Private docker registry](../infrastructure/compute-to-data-docker-registry.md)
 
 ## How does it work?
 
@@ -107,23 +107,23 @@ Ocean Protocol provides tools for developers to _build data markets_, and to _ma
 
 If you are new to web3 and blockchain technologies then we suggest you first read these introductory guides:
 
-- [Wallet Basics](wallets.md)
-- [Set Up MetaMask Wallet](metamask-setup.md)
-- [Manage Your OCEAN Tokens](wallets-and-ocean-tokens.md)
+* [Wallet Basics](wallets.md)
+* [Set Up MetaMask Wallet](metamask-setup.md)
+* [Manage Your OCEAN Tokens](wallets-and-ocean-tokens.md)
 
 If ou are looking to get to grips with the inner workings of Ocean, then you'll be interested in the following guides:
 
-- [Architecture Overview](../developers/core-concepts/architecture.md)
-- [Data NFTs and Datatokens](../developers/core-concepts/datanft-and-datatoken.md)
-- [Networks](networks.md)
-- [Fees](../developers/core-concepts/fees.md)
-- [Asset pricing](../developers/core-concepts/asset-pricing.md)
-- [DID & DDO](../developers/core-concepts/did-ddo.md)
-- [Roles](../developers/core-concepts/roles.md)
-- [Set Up a Marketplace](../tutorials/build-a-marketplace/marketplace.md)
-- [Compute-to-Data](../developers/core-concepts/compute-to-data)
-- [Deploying components](../infrastructure/README.md)
-- [Contributing](../contribute/contributing.md)
+* [Architecture Overview](../developers/core-concepts/architecture.md)
+* [Data NFTs and Datatokens](../developers/core-concepts/datanft-and-datatoken.md)
+* [Networks](networks/)
+* [Fees](../developers/core-concepts/fees.md)
+* [Asset pricing](../developers/core-concepts/asset-pricing.md)
+* [DID & DDO](../developers/core-concepts/did-ddo.md)
+* [Roles](../developers/core-concepts/roles.md)
+* [Set Up a Marketplace](../tutorials/build-a-marketplace/marketplace.md)
+* [Compute-to-Data](../developers/core-concepts/compute-to-data/)
+* [Deploying components](../infrastructure/)
+* [Contributing](../contribute/contributing.md)
 
 ## Supporters
 

discover/metamask-setup.md

@@ -4,6 +4,8 @@ description: Tutorial about how to set up MetaMask for Chrome.
 
 # Set Up MetaMask Wallet
 
+
+
 > MetaMask can also be used with a TREZOR or Ledger hardware wallet but we don't cover those options below; see [the MetaMask documentation](https://metamask.zendesk.com/hc/en-us/articles/360020394612-How-to-connect-a-Trezor-or-Ledger-Hardware-Wallet).
 
 ### MetaMask Set Up Steps
@@ -12,27 +14,27 @@ description: Tutorial about how to set up MetaMask for Chrome.
 
 ![metamask-chrome-store](../.gitbook/assets/wallet/metamask-chrome-extension.png)
 
-- Install MetaMask. The wallet provides a friendly user interface that will help you through each step. MetaMask gives you two options: importing an existing wallet or creating a new one. Choose to `Create a Wallet`:
+* Install MetaMask. The wallet provides a friendly user interface that will help you through each step. MetaMask gives you two options: importing an existing wallet or creating a new one. Choose to `Create a Wallet`:
 
 ![Create a wallet](../.gitbook/assets/wallet/create-new-metamask-wallet.png)
 
-- In the next step create a new password for your wallet. Read through and accept the terms and conditions. After that, MetaMask will generate Secret Backup Phrase for you. Write it down and store it in a safe place.
+* In the next step create a new password for your wallet. Read through and accept the terms and conditions. After that, MetaMask will generate Secret Backup Phrase for you. Write it down and store it in a safe place.
 
 ![Secret Backup Phrase](../.gitbook/assets/wallet/secret-backup-phrase.png)
 
-- Continue forward. On the next page, MetaMask will ask you to confirm the backup phrase. Select the words in the correct sequence:
+* Continue forward. On the next page, MetaMask will ask you to confirm the backup phrase. Select the words in the correct sequence:
 
 ![Confirm secret backup phrase](../.gitbook/assets/wallet/confirm-backup-phrase.png)
 
-- Voila! Your account is now created. You can access MetaMask via the browser extension in the top right corner of your browser.
+* Voila! Your account is now created. You can access MetaMask via the browser extension in the top right corner of your browser.
 
 ![MetaMask browser extension](../.gitbook/assets/wallet/metamask-browser-extension.png)
 
-- You can now manage Ether and Ocean Tokens with your wallet. You can copy your account address to the clipboard from the options. When you want someone to send Ether or Ocean Tokens to you, you will have to give them that address. It's not a secret.
+* You can now manage Ether and Ocean Tokens with your wallet. You can copy your account address to the clipboard from the options. When you want someone to send Ether or Ocean Tokens to you, you will have to give them that address. It's not a secret.
 
 ![Manage tokens](../.gitbook/assets/wallet/manage-tokens.png)
 
-You can also watch our [tutorial video snippets](https://www.youtube.com/playlist?list=PL_dn0wVs9kWolBCbtHaFxsi408cumOeth) if you want more help setting up MetaMask.
+You can also watch our [tutorial video snippets](https://www.youtube.com/playlist?list=PL\_dn0wVs9kWolBCbtHaFxsi408cumOeth) if you want more help setting up MetaMask.
 
 ### Set Up Custom Network
 
@@ -42,12 +44,12 @@ Open the Settings menu and find the `Networks` option. When you open it, you'll
 
 ![Add custom/external network](../.gitbook/assets/wallet/metamask-add-network.png)
 
-There are a few empty inputs we need to fill:
+There are a few empty inputs we need to fill in:
 
-- **Network Name:** this is the name that MetaMask is going to use to differentiate your network from the rest.
-- **New RPC URL:** to operate with a network we need an endpoint (RPC). This can be a public or private URL.
-- **Chain Id:** each chain has an Id
-- **Currency Symbol:** it's the currency symbol MetaMask uses for your network
-- **Block Explorer URL:** MetaMask uses this to provide a direct link to the network block explorer when a new transaction happens
+* **Network Name:** this is the name that MetaMask is going to use to differentiate your network from the rest.
+* **New RPC URL:** to operate with a network we need an endpoint (RPC). This can be a public or private URL.
+* **Chain Id:** each chain has an Id
+* **Currency Symbol:** it's the currency symbol MetaMask uses for your network
+* **Block Explorer URL:** MetaMask uses this to provide a direct link to the network block explorer when a new transaction happens
 
 When all the inputs are filled just click `Save`. MetaMask will automatically switch to the new network.

discover/networks/README.md

@@ -1,7 +1,7 @@
 ---
 title: Supported Networks
 description: All the public networks the Ocean Protocol contracts are deployed to.
-cover: ../.gitbook/assets/landing/rewards.png
+cover: ../../.gitbook/assets/landing/rewards.png
 coverY: 0
 ---
 
@@ -44,7 +44,7 @@ Ocean Protocol is also deployed to Binance Smart Chain (BSC), which is another p
 
 **Bridge**
 
-Check our BSC Bridge [guide](../core-concepts/networks/bridges.md#binance-smart-chain-bsc-bridge) to learn how you can deposit, withdraw and send tokens.
+Check our BSC Bridge [guide](../../core-concepts/networks/bridges.md#binance-smart-chain-bsc-bridge) to learn how you can deposit, withdraw and send tokens.
 
 ### Energy Web Chain
 

discover/networks/bridges.md

@@ -0,0 +1,76 @@
+---
+title: Bridges
+description: Transfer tokens between two blockchain networks.
+---
+
+# Bridges
+
+A bridge is a mechanism that connects two or more separate blockchain networks, enabling communication and interoperability between them. Bridges can be designed to facilitate the transfer of assets, data, or messages between different blockchain networks that may operate on different protocols, and consensus mechanisms, or have different native currencies.
+
+We suggest using the following solutions to transfer Ocean tokens between Ethereum mainnet and Polygon or BSC.
+
+## Binance Smart Chain (BSC) Bridge
+
+To transfer Ocean tokens to and from the Binance 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.
+
+
+
+{% hint style="warning" %}
+In case you opt for an alternative bridge option and intend to transfer tokens to Binance, it is crucial to ensure that the contract address you are sending the tokens to is correct. 
+
+## &#x20;                            <img src="../../.gitbook/assets/binance-receive.png" alt="" data-size="original">
+{% endhint %}
+
+
+
+## Polygon (ex Matic) Bridge
+
+The Polygon Network (previously known as Matic) offers a [bridge](https://wallet.polygon.technology/bridge/), which lets you easily transfer digital assets between Ethereum and Polygon blockchains and a dedicated [wallet](https://wallet.polygon.technology/) designed for this purpose, which can be linked to your account through Metamask or other compatible wallets.&#x20;
+
+All you need to do is click on the [wallet](https://wallet.polygon.technology/) link, select your preferred method of connection, and log in to get started. In this guide, we'll be using Metamask to connect the wallet.
+
+![Login options](../../.gitbook/assets/wallet/login-options.png)
+
+You might come across the name "Matic" in some places instead of "Polygon" because the network is still using its old brand name in certain instances. Don't worry though, it's the same network whether you see Matic or Polygon. For the sake of this guide, we'll be using the name Matic in the following paragraphs because the interfaces we'll be using still use the old brand name.&#x20;
+
+Check out our [blog post](https://blog.oceanprotocol.com/ocean-on-polygon-network-8abad19cbf47) for more details.
+
+#### Deposit Tokens
+
+When you access the wallet's main page, you'll be able to view all the tokens you possess on the Matic Mainnet. If you want to deposit tokens (i.e., transfer them from the Ethereum Mainnet), there are two ways to do it: you can either click the "deposit" button for a specific token or use the "Move funds to Matic Mainnet" option.
+
+![Main wallet page](<../../.gitbook/assets/wallet/wallet-page (1).png>)
+
+Both of these options will redirect you to the bridge interface. If you select the second option, you'll need to use the dropdown menu to choose the token that you wish to transfer from the Ethereum Mainnet.
+
+![Bridge interface](<../../.gitbook/assets/wallet/matic-bridge (1).png>)
+
+Select the amount of tokens you want to transfer and hit the "Transfer" button. The bridge interface provided by Matic will guide you through all the necessary steps, including signing two transactions on the Ethereum Mainnet. The first transaction involves giving permission for the tokens to be traded on Matic's bridge, while the second transaction is the actual deposit.
+
+![Transferring process](<../../.gitbook/assets/wallet/transferring (1).png>)
+
+#### Withdraw Tokens
+
+The process of withdrawing tokens also utilizes the bridge interface, but this time the withdrawal will happen from Matic to the Ethereum Mainnet. The bridge interface will guide you through all the necessary steps for this process as well.&#x20;
+
+For more detailed information about depositing and withdrawing actions, you can refer to the official Polygon [documentation](https://wiki.polygon.technology/docs/develop/ethereum-polygon/plasma/eth/).
+
+#### Sending Tokens
+
+Unlike the first two cases where transactions are signed on the Ethereum Mainnet, transferring tokens between two Matic addresses takes place on the Matic Mainnet. As a result, it's necessary to connect to the Matic network in order to sign these transactions. Setting up the network on Metamask can be done in several ways.
+
+The easiest one is to go to the [polygon network explorer](https://polygonscan.com/) and tap on the "Add polygon network" button.
+
+<figure><img src="../../.gitbook/assets/polygon-explorer.png" alt=""><figcaption></figcaption></figure>
+
+Alternatively, you can manually configure the network on Metamask by using the following parameters. To learn how to set up a custom network in Metamask using these values, you can refer to our guide.
+
+| What               | Value                             |
+| ------------------ | --------------------------------- |
+| Network Name       | `Matic Mainnet`                   |
+| RPC                | `https://polygon-rpc.com/`        |
+| Chain Id           | `137`                             |
+| Currency Symbol    | `MATIC`                           |
+| Block Explorer URL | `https://explorer.matic.network/` |
+
+Follow our guide to learn how to use those values to [set up a custom network in MetaMask](../metamask-setup.md#set-up-custom-network).

infrastructure/setup-server.md

@@ -28,7 +28,7 @@ Select Ubuntu OS and choose a plan. The required CPU, Memory depends on the numb
 
 Also, select the region where you want Aquarius to be hosted and a root password.
 
-![Select region](../.gitbook/assets/server-setup/server-setup3.png)
+![Select region](<../.gitbook/assets/server-setup/server-setup3 (1).png>)
 
 ![Click create Droplet](../.gitbook/assets/server-setup/server-setup4.png)