[WIP] First draft of token bridge tutorial

content/tutorials/token-bridge.md

@@ -0,0 +1,60 @@
+---
+title: Transfer Ocean Tokens between Networks
+description: How to use the token bridge to transfer Ocean Tokens from the Ethereum Mainnet to the Ocean Production Network.
+---
+
+TODO: All images here are placeholders for now. Replace them with images showing the Ocean-specific token bridge UI.
+
+## Introduction
+
+There is a token bridge between the Ethereum Mainnet and the Ocean Production Network. It's based on [the TokenBridge by POA Network](https://medium.com/poa-network/introducing-the-erc20-to-erc20-tokenbridge-ce266cc1a2d0) (the company).
+This tutorial shows how you can use the token bridge to transfer Ocean Tokens (OCEAN) from the Ethereum Mainnet to the Ocean Production Network.
+
+## WARNING
+
+**Please Note: At the time of writing, if you transfer your Ocean Tokens to the Ocean Production Network, then you are putting your Ocean Tokens at risk.**
+
+## Using the Token Bridge
+
+If you want to transfer OCEAN out of the Ethereum Mainnet, then first you need an Ethereum account with some OCEAN in the Ethereum Mainnet. If you want to get some OCEAN in the Ethereum Mainnet, then see [the page about Ocean Tokens](/concepts/ocean-tokens/).
+
+Below is a screenshot of MetaMask showing an account (with address `0x8…`) which has 500 OCEAN in the Ethereum Mainnet. If you want MetaMask to show OCEAN, then see [the page about using your wallet to manage Ocean Tokens](/tutorials/wallets-and-ocean-tokens/).
+
+![MetaMask showing an account that has 500 Ocean Tokens in the Ethereum Mainnet](./images/tb01.png)
+
+To use the token bridge between the Ethereum Mainnet and the Ocean Production Network (a.k.a. Pacific), then go to [https://token-bridge.pacific.oceanprotocol.com](https://token-bridge.pacific.oceanprotocol.com). You should see something like this:
+
+TODO: or maybe the URL will be bridge.oceanprotocol.com ? Update accordingly.
+
+![The token bridge user interface](./images/tb02.png)
+
+The above screenshot shows that the account with address `0x8…` has 500.00 OCEAN in the Ethereum Mainnet and 0.00 OCEAN in Pacific.
+
+- Enter the amount of OCEAN you want to transfer (e.g. 1 OCEAN in the screenshot)
+- Click **Transfer**
+
+A confirmation dialog box like the following should appear.
+
+![](./images/tb03.png)
+
+- Click **Continue**
+
+You should see some status updates like the following.
+
+![](./images/tb04.png)
+
+![](./images/tb05.png)
+
+![](./images/tb06.png)
+
+If the transfer is a success, then you should see a dialog box like the following.
+
+![](./images/tb07.png)
+
+Notice how the transaction ID is shown.
+
+- Click **OK**
+
+If you go back to MetaMask and switch the network to Pacific, then the account's OCEAN balance in Pacific should be higher by the amount just transferred.
+
+![](./images/tb08.png)

data/sidebars/tutorials.yml

@@ -13,6 +13,8 @@
       link: /tutorials/wallets-and-ocean-tokens/
     - title: Get Ether and Ocean Tokens
       link: /tutorials/get-ether-and-ocean-tokens/
+    - title: Transfer Ocean Tokens between Networks
+      link: /tutorials/token-bridge/
 
 - group: Storage Setup
   items: