> For the complete documentation index, see [llms.txt](https://gemkeeper-finance.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gemkeeper-finance.gitbook.io/docs/welcome/getting-started/set-up-oasis-wallet.md). # Set up Oasis Wallet ## **How to use the Oasis Wallet - Browser Extension** {% hint style="info" %} Currently, [Oasis Wallet - Browser Extension](https://github.com/oasisprotocol/oasis-wallet-ext) **only supports** [**Chrome**](https://www.google.com/chrome/) or other [Chromium](https://www.chromium.org/Home)-based browsers. {% endhint %} ### Install the Oasis Wallet via Chrome Web Store You can install the [Oasis Wallet - Browser Extension](https://github.com/oasisprotocol/oasis-wallet-ext) by heading to the [Chrome Web Store](https://chrome.google.com/webstore/detail/oasis-wallet/ppdadbejkmjnefldpcdjhnkpbjkikoip). ### Create a new wallet {% hint style="warning" %} Your mnemonic phrase is required to access your wallet. Be sure to store it in a secure location. If you lose or forget your mnemonic phrase, you will lose access to your wallet and any token funds contained in it. {% endhint %} {% hint style="warning" %} Never share your keyphrase. Anyone with your keyphrase can access your wallet and your tokens. {% endhint %} ### **Access an existing wallet** You can access and existing wallet by clicking on the Restore Wallet button when opening the Oasis Wallet Browser extension. You will asked to choose a password. This password will be necessary for accessing your wallet in the future so be sure not to lose it. After choosing a password you will be asked to enter recovery phrase. Please enter your 12 or 24 word recovery phrase from the wallet you are restoring. At this point you should have successfully recovered your wallet ### Send tokens 1. Click the avatar on the top right corner 2. Pick an account you want to transfer tokens out of 3. Click ‘Send’ 4. Type in the token amount under ‘Amount’ 5. Type in the Receiver’s wallet address 6. Click ‘Next’ 7. Check the ‘Send Details’; if everything looks good to you, click ‘Confirm’ 8. Wait for a couple of seconds, and you’ll get a status update of your transaction 9. Go back to the Account page, and you’ll see the transfer has gone through ### **Receive tokens** Click ‘Receive’ on the Account page, and you’ll get the QR code as well as the wallet address in text format ## How to use the Oasis Wallet - Web ### **Access the Oasis Wallet via your web browser** You can access the [Oasis Wallet - Web](https://github.com/oasisprotocol/oasis-wallet-web/) by heading to . For the best performance, we recommend using [Chrome](https://www.google.com/chrome/) or any other [Chromium](https://www.chromium.org/Home)-based browser. ### **Create a New Wallet** If you do not currently have an existing Oasis wallet address, you can create a new wallet address directly from the Oasis Wallet's home screen. Click on the “Create wallet” button. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2FMqTrskSHixOpT17Np9eB%2Fimage.png?alt=media\&token=f64cbb43-220f-43be-a1b6-b12bfd46e6ee) The next page contains information about your mnemonic (an ordered list of words representing your keyphrase), which you will need in order to retrieve your wallet later. Review the information on this page very carefully. Save your mnemonic in the right order in a secure location. {% hint style="warning" %} Your mnemonic (i.e. keyphrase) is required to access your wallet. Be sure to store it in a secure location. If you lose or forget your mnemonic, you will lose access to your wallet and any token funds contained in it. {% endhint %} {% hint style="warning" %} Never share your mnemonic (i.e. keyphrase). Anyone with your mnemonic can access your wallet and your tokens. {% endhint %} After you’ve saved your mnemonic, click the “I saved my keyphrase” checkbox and then click on the “Open my wallet” button. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2FD9fue1yCiXwdckCDFPBe%2Fimage.png?alt=media\&token=75163cc6-655c-426f-9bea-0a7d50e60b6f) Next, you will need to confirm your mnemonic by filling in some missing words. You can enter the missing word for each respective box, by clicking on the appropriate word from the list of words presented below. Be sure to enter all of the missing words in the right order. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2FSSscc8L4HBY1JJUIRmuT%2Fimage.png?alt=media\&token=2d00dcab-f722-454f-a7b1-2f5c440d5690) After you correctly enter all of the missing words, you will be taken to your Oasis Wallet home screen, containing information about your account balance and more. ### **Access an Existing Wallet** If you already have an existing Oasis wallet address, you can open it in the web wallet by clicking the “Open wallet” button on the home screen. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2F989Ye5KQJ0vIZlzGxgo3%2Fimage.png?alt=media\&token=9de99920-aa87-45ee-a9fe-b47bb512262b) Next, you should select whether you want to open your wallet via a mnemonic, a private key, or a Ledger hardware wallet. Select the respective button corresponding to the retrieval method you want to use. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2Fq9M1dkILwiGD9vLWVCcW%2Fimage.png?alt=media\&token=ba36f655-64f7-4b1f-b80c-87317d7012f6) #### Open Wallet via Mnemonic In the *Enter your keyphrase* field, enter each word of your mnemonic separated by a space. Afterwards, hit the "Open my wallet" button. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2FhDXRbLFA273QPcDlDp1m%2Fimage.png?alt=media\&token=7f93faaf-ed9e-4a70-86ff-32adacaf2d71) {% hint style="info" %} Oasis Wallet - Web uses English mnemonic phrase words as defined in [BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki). You can find a complete list of all valid phrase words [here](https://github.com/bitcoin/bips/blob/master/bip-0039/english.txt). If you misspelled a word, the wallet will warn you. {% endhint %} {% hint style="warning" %} Oasis Wallet mnemonics are incompatible with BitPie mnemonics. Check our [FAQ](broken://pages/-Mj6jYnxX8ZDlADV9OPq#frequently-asked-questions) for more information. {% endhint %} #### Open Wallet via Private Key Paste your Base64-encoded Ed25519 private key in the *Enter your private key* field and then click on the "Open my wallet" button. ![](https://3455652524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9uUFQ8EPsIgvjxduytLC%2Fuploads%2FgGI3qd9gQ6JdCjzURHFM%2Fimage.png?alt=media\&token=2d15c3bb-19b0-439d-b25e-32ceb60488ea) {% hint style="info" %} The Ed25519 private key format that is used is 64 bytes long and consists of two 32-byte parts: 1. First 32 bytes are the **private key seed** which is used to derive the private key that is then used for signing the transactions (i.e. sending tokens from your wallet). 2. Last 32 bytes are the **public key** which is used to compute your account's address of the form `oasis1...`. {% endhint %} {% hint style="danger" %} If you typed in the private key manually, make sure you do not mix similar characters like the big O and 0 or big I and 1! Currently, there is no error detection on the inputted private key, so the wallet cannot warn you of a mistyped character. **It is imperative that you correctly input the private key, otherwise you will not be able to access your funds!** We suggest that you perform a test transaction the first time you import your wallet from the private key so you can rest assured the key is valid. {% endhint %} #### Open wallet with Ledger To open your wallet via a Ledger hardware wallet, make sure you have your Ledger device readily available and have familiarized yourself with the [Oasis-specific Ledger usage instructions](broken://pages/-MK4on9nTu6ilq8k-BGh). Follow the instructions on the screens that follow to open your existing wallet address. {% hint style="warning" %} To date, only Chromium-based browsers support WebUSB component which is required to access your Ledger device. {% endhint %} After you complete the instructions, you will be taken to your Oasis Wallet home screen, containing information about your account balance and more.