Merge pull request #1203 from oceanprotocol/fix-matic-bridge-instructions

Update matic bridge instructions

core-concepts/networks/bridges.md

@@ -1,76 +1,74 @@
 ---
 title: Bridges
+description: Transfer tokens between two blockchain networks.
 ---
 
-# Binance Smart Chain (BSC) Bridge
+# Bridges
 
-## Intro to BSC's Bridge
+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.
 
-BSC provides several bridge options, including:
+We suggest using the following solutions to transfer Ocean tokens between Ethereum mainnet and Polygon or BSC.
 
-* withdraw crypto from Binance.com, and
-* use Binance bridge.
+## Binance Smart Chain (BSC) 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.
+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.
 
-### Links
+{% 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.
 
-* [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](../../orientation/metamask-setup.md#set-up-custom-network)
+#### <img src="../../.gitbook/assets/binance-receive.png" alt="Binance deposit" data-size="original"> <a href="#binance-deposit" id="binance-deposit"></a>
+{% endhint %}
 
-# Polygon (ex Matic) Bridge
+## Polygon (ex Matic) Bridge
 
-### Links
+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.
 
-* [Matic Wallet](https://wallet.polygon.technology/)
-* [Matic Bridge](https://wallet.polygon.technology/bridge/)
-* [How to set up a custom network in MetaMask](../../orientation/metamask-setup.md#set-up-custom-network)
+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.
 
-### Intro to Polygon's Bridge
+<figure><img src="../../.gitbook/assets/polygon-login.png" alt="Polygon login options"><figcaption><p>Login options</p></figcaption></figure>
 
-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).
+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.&#x20;
 
-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.
+Check out our [blog post](https://blog.oceanprotocol.com/ocean-on-polygon-network-8abad19cbf47) for more details.
 
-![Login options](../../.gitbook/assets/login-options.png)
+#### Deposit Tokens
 
-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.
+When you access the wallet's main page, you'll be able to view all the tokens you possess on the Polygon 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 from Ethereum to Polygon" option.
 
-For details check the [blog post](https://blog.oceanprotocol.com/ocean-on-polygon-network-8abad19cbf47).
+![Main wallet page](../../.gitbook/assets/polygon-wallet-page.png)
 
-### Deposit Tokens
+In case you are unable to find the Ocean token in the list while depositing, simply click on "Manage token list" and enable the Polygon Tokens option, which contains a greater number of listed tokens. This will add Ocean to the tokens list.
 
-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”.
+![Ocean on Polygon](../../.gitbook/assets/polygon-ocean.png)
 
-![Main wallet page](../../.gitbook/assets/main-wallet-page.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.
 
-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/polygon-bridge.png)
 
-![Bridge interface](../../.gitbook/assets/matic-bridge.png)
+Select the number of tokens you want to transfer and hit the "Transfer" button. The bridge interface provided by Polygon 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 Polygon's bridge, while the second transaction is the actual deposit.
 
-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.
+#### Withdraw Tokens
 
-![Transferring process](../../.gitbook/assets/transferring-process.png)
+The process of withdrawing tokens also utilizes the bridge interface, but this time the withdrawal will happen from Polygon to the Ethereum Mainnet. The bridge interface will guide you through all the necessary steps for this process as well.
 
-### Withdraw Tokens
+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/).
 
-The withdrawing tokens process uses the same bridge interface. The only difference being that the withdraw happens from the Matic to the Ethereum Mainnet.
+#### Sending Tokens
 
-Again the bridge interface will guide you through the different steps.
+Unlike the first two cases where transactions are signed on the Ethereum Mainnet, transferring tokens between two Matic addresses occurs on the Polygon Mainnet. As a result, it's necessary to connect to the Polygon network in order to sign these transactions. Setting up the network on Metamask can be done in several ways.
 
-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).
+The easiest one is to go to the [polygon network explorer](https://polygonscan.com/) and tap the "Add polygon network" button.
 
-### Sending Tokens
+<figure><img src="../../.gitbook/assets/polygon-explorer.png" alt=""><figcaption></figcaption></figure>
 
-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:
+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/`        |
+| What               | Value                                                |
+| ------------------ | ---------------------------------------------------- |
+| Network Name       | Polygon                                              |
+| RPC                | `https://polygon-rpc.com/`                           |
+| Chain Id           | `137`                                                |
+| Currency Symbol    | `MATIC`                                              |
+| Block Explorer URL | [`https://polygonscan.com`](https://polygonscan.com) |
 
-Follow our guide to learn how to use those values to [set up a custom network in MetaMask](../orientation/metamask-setup.md#set-up-custom-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).