diff --git a/content/tutorials/images/tb01.png b/content/tutorials/images/tb01.png new file mode 100644 index 00000000..6615f6ec Binary files /dev/null and b/content/tutorials/images/tb01.png differ diff --git a/content/tutorials/images/tb02.png b/content/tutorials/images/tb02.png new file mode 100644 index 00000000..86b7f960 Binary files /dev/null and b/content/tutorials/images/tb02.png differ diff --git a/content/tutorials/images/tb03.png b/content/tutorials/images/tb03.png new file mode 100644 index 00000000..7726a136 Binary files /dev/null and b/content/tutorials/images/tb03.png differ diff --git a/content/tutorials/images/tb04.png b/content/tutorials/images/tb04.png new file mode 100644 index 00000000..67b75aca Binary files /dev/null and b/content/tutorials/images/tb04.png differ diff --git a/content/tutorials/images/tb05.png b/content/tutorials/images/tb05.png new file mode 100644 index 00000000..aac88d90 Binary files /dev/null and b/content/tutorials/images/tb05.png differ diff --git a/content/tutorials/images/tb06.png b/content/tutorials/images/tb06.png new file mode 100644 index 00000000..9243d5d2 Binary files /dev/null and b/content/tutorials/images/tb06.png differ diff --git a/content/tutorials/images/tb07.png b/content/tutorials/images/tb07.png new file mode 100644 index 00000000..0863e299 Binary files /dev/null and b/content/tutorials/images/tb07.png differ diff --git a/content/tutorials/images/tb08.png b/content/tutorials/images/tb08.png new file mode 100644 index 00000000..1b6964df Binary files /dev/null and b/content/tutorials/images/tb08.png differ diff --git a/content/tutorials/token-bridge.md b/content/tutorials/token-bridge.md new file mode 100644 index 00000000..cf87fe4d --- /dev/null +++ b/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) diff --git a/data/sidebars/tutorials.yml b/data/sidebars/tutorials.yml index f5db3ba6..bb750fd2 100644 --- a/data/sidebars/tutorials.yml +++ b/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: