diff --git a/content/tutorials/get-ether-and-ocean-tokens.md b/content/tutorials/get-ether-and-ocean-tokens.md index 423bd2f2..cea14b8b 100644 --- a/content/tutorials/get-ether-and-ocean-tokens.md +++ b/content/tutorials/get-ether-and-ocean-tokens.md @@ -9,7 +9,7 @@ At the time of writing, there were some public testnets you could use to test an ## Get a Compatible Wallet -You will need a wallet that can hold Ether (for any Ethereum network) and Ocean Tokens (for any Ethereum network). For now, we recommend using [MetaMask](https://metamask.io/). +You will need a [wallet that can hold Ether (for any Ethereum network) and Ocean Tokens (for any Ethereum network)](/tutorials/wallets/). For the purpose of this tutorial, you can use [MetaMask](https://metamask.io/). - Follow the MetaMask instructions to install it on your machine. - In MetaMask, switch from the **Main Ethereum Network** to the **Kovan Test Network** or the test network you're using. diff --git a/content/tutorials/wallets.md b/content/tutorials/wallets.md new file mode 100644 index 00000000..03284239 --- /dev/null +++ b/content/tutorials/wallets.md @@ -0,0 +1,33 @@ +--- +title: Wallets for Ocean Tokens +description: Learn about wallets that can hold Ocean Tokens. +--- + +If you want to use the Ocean Network, you need Ocean Tokens, and to get Ocean Tokens, you need to get a wallet that can hold Ocean Tokens. + +## Some Terminology + +There's a lot of terminology around wallets, so we'll start by going over some of it. + +A wallet might contain only one **account** (Ethereum account) or it might contain many accounts. + +Each account has a **balance** (e.g. 1.832 Ocean Tokens), an **address** (e.g. 0xa0A9d7e78bF29351997cA5589A0Af689eEC99211), a **public key** and a **private key**. + +An account is identified by its address, so if you want someone to send some Ocean Tokens to a specific account, you give them the account's address. + +The private key is used to spend the Ocean Tokens in the account. You must keep it secret, because anyone with that private key can spend those tokens. If you lose the secret key, and nobody else has it, then _nobody_ can spend those tokens, so don't lose it! + +> Note: The same account might have an Ocean Token balance, an [Ether](https://www.ethereum.org/ether) balance, and other balances. + +## Wallet Options + +Ocean Tokens are [ERC-20 tokens](https://en.wikipedia.org/wiki/ERC-20), so any wallet that supports arbitrary ERC-20 tokens should work to hold Ocean Tokens. + +There are many kinds of wallets (e.g. paper wallets, hardware wallets, software wallets, custodial wallets), each with its own advantages and disadvantages. There is a tradeoff between security and convenience. We encourage you to search around and read about wallets to understand the options. + +**We don't recommend or endorse any particular wallets at this time.** Some wallets which _might_ work with Ocean Tokens are: + +- Gnosis Safe +- MetaMask (in combination with other tools such as MyEtherWallet) +- Trust Wallet +- Tokenary diff --git a/data/sidebars/tutorials.yml b/data/sidebars/tutorials.yml index 0815ebaa..0334d513 100644 --- a/data/sidebars/tutorials.yml +++ b/data/sidebars/tutorials.yml @@ -2,6 +2,8 @@ items: - title: Introduction link: /tutorials/introduction/ + - title: Wallets for Ocean Tokens + link: /tutorials/wallets/ - title: Get Ether and Ocean Tokens for Testnets link: /tutorials/get-ether-and-ocean-tokens/ - title: Set Up Azure Storage