gaspersic/solana
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Clean up wallet URL paths (#9667)

Browse Source 
automerge
This commit is contained in:
Dan Albert
2020-04-22 17:48:21 -06:00
committed by GitHub
parent 71f7a7243b
commit 24354ccd6a
15 changed files with 41 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

61
docs/src/wallet-guide/README.md Normal file
View File

@@ -0,0 +1,61 @@
# Solana Wallet Guide
This document describes the different wallet options that are available to users
of Solana who want to be able to send, receive and interact with
SOL tokens on the Solana blockchain.
## What is a Wallet?
A crypto wallet is a device or application that stores a collection of keys and
can be used to send, receive,
and track ownership of cryptocurrencies. Wallets can take many forms.
A wallet might be a directory or file in your computer's file system,
a piece of paper, or a specialized device called a *hardware wallet*.
There are also various smartphone apps and computer programs
that provide a user-friendly way to create and manage wallets.
A *keypair* is a securely generated *private key* and its
cryptographically-derived *public key*. A private key and its corresponding
public key are together known as a *keypair*.
A wallet contains a collection of one or more keypairs and provides some means
to interact with them.
The *public key* (commonly shortened to *pubkey*) is known as the wallet's
*receiving address* or simply its *address*. The wallet address **may be shared
and displayed freely**. When another party is going to send some amount of
cryptocurrency to a wallet, they need to know the wallet's receiving address.
Depending on a blockchain's implementation, the address can also be used to view
certain information about a wallet, such as viewing the balance,
but has no ability to change anything about the wallet or withdraw any tokens.
The *private key* is required to digitally sign any transactions to send
cryptocurrencies to another address or to make any changes to the wallet.
The private key **must never be shared**. If someone gains access to the
private key to a wallet, they can withdraw all the tokens it contains.
If the private key for a wallet is lost, any tokens that have been sent
to that wallet's address are **permanently lost**.
Different wallet solutions offer different approaches to keypair security and
interacting with the keypair and sign transactions to use/spend the tokens.
Some are easier to use than others.
Some store and back up private keys more securely.
Solana supports multiple types of wallets so you can choose the right balance
of security and convenience.
**If you want to be able to receive SOL tokens on the Solana blockchain,
you first will need to create a wallet.**
## Supported Wallets
Solana supports supports several types of wallets in the Solana native
command-line app as well as wallets from third-parties.
For the majority of users, we recommend using one of the
[app wallets](apps.md), which will provide a more familiar user
experience rather than needing to learn command line tools.
{% page-ref page="apps.md" %}
For advanced users or developers, the [command-line wallets](cli.md)
may be more appropriate, as new features on the Solana blockchain will always be
supported on the command line first before being integrated into third-party
solutions.
{% page-ref page="cli.md" %}

26
docs/src/wallet-guide/apps.md Normal file
View File

@@ -0,0 +1,26 @@
# App Wallets
Solana supports multiple third-party apps which should provide a familiar
experience for most people who are new or experienced with using crypto wallets.
## Trust Wallet
[Trust Wallet](https://trustwallet.com/) is an app for iOS and Android. This is
currently the easiest and fastest way to get set up with a new wallet on Solana.
The app is free and getting your wallet set up only takes a few minutes.
{% page-ref page="trust-wallet.md" %}
## Ledger Live with Ledger Nano S
[Ledger Live](https://www.ledger.com/ledger-live) is available as free desktop
software and as a free app for iOS and Android. It is used to manage apps and
crypto accounts on a Ledger *hardware wallet*, which must be purchased
separately and connected to the device running Ledger Live.
[Ledger Nano S](https://shop.ledger.com/products/ledger-nano-s) is a
hardware wallet which stores the wallet's private keys on a secure device that
is physically separate from the computer, and connects via USB cable.
This provides an extra level of security but requires the user to purchase and
keep track of the hardware device.
Solana does not support the Ledger Nano **X** at this time.
{% page-ref page="ledger-live.md" %}

65
docs/src/wallet-guide/cli.md Normal file
View File

@@ -0,0 +1,65 @@
# Command Line Wallets
Solana supports several different types of wallets that can be used to interface
directly with the Solana command-line tools.
**If you are unfamiliar with using command line programs and just want to be able
to send and receive SOL tokens, we recommend setting up a third-party
[App Wallet](apps.md)**.
To use a Command Line Wallet, you must first [install the Solana CLI tools](../cli/install-solana-cli-tools.md)
## File System Wallet
A *file system wallet*, aka an FS wallet, is a directory in your computer's
file system. Each file in the directory holds a keypair.
### File System Wallet Security
A file system wallet is the most convenient and least secure form of wallet. It
is convenient because the keypair is stored in a simple file. You can generate as
many keys as you would like and trivially back them up by copying the files. It
is insecure because the keypair files are **unencrypted**. If you are the only
user of your computer and you are confident it is free of malware, an FS wallet
is a fine solution for small amounts of cryptocurrency. If, however, your
computer contains malware and is connected to the Internet, that malware may
upload your keys and use them to take your tokens. Likewise, because the
keypairs are stored on your computer as files, a skilled hacker with physical
access to your computer may be able to access it. Using an encrypted hard
drive, such as FileVault on MacOS, minimizes that risk.
{% page-ref page="../file-system-wallet/README.md" %}
## Paper Wallet
A *paper wallet* is a collection of *seed phrases* written on paper. A seed
phrase is some number of words (typically 12 or 24) that can be used to
regenerate a keypair on demand.
### Paper Wallet Security
In terms of convenience versus security, a paper wallet sits at the opposite
side of the spectrum from an FS wallet. It is terribly inconvenient to use, but
offers excellent security. That high security is further amplified when paper
wallets are used in conjunction with
[offline signing](../offline-signing/README.md). Custody services such as
[Coinbase Custody](https://custody.coinbase.com/) use this combination.
Paper wallets and custody services are an excellent way to secure a large number
of tokens for a long period of time.
{% page-ref page="../paper-wallet/README.md" %}
## Hardware Wallet
A hardware wallet is a small handheld device that stores keypairs and provides
some interface for signing transactions.
### Hardware Wallet Security
A hardware wallet, such as the
[Ledger hardware wallet](https://www.ledger.com/), offers a great blend of
security and convenience for cryptocurrencies. It effectively automates the
process of offline signing while retaining nearly all the convenience of an FS
wallet.
{% page-ref page="../hardware-wallet/README.md" %}

52
docs/src/wallet-guide/ledger-live.md Normal file
View File

@@ -0,0 +1,52 @@
# Ledger Live and Ledger Nano S
This document describes how to set up a
[Ledger Nano S hardware wallet](https://shop.ledger.com/products/ledger-nano-s)
with the [Ledger Live](https://www.ledger.com/ledger-live) software.
**NOTE: While Solana tools are fully integrated with the Ledger Nano S device,
and the Solana App can be installed on the Nano S using Ledger Live, adding and
managing wallet accounts currently requires use of our command-line tools.
Integration with Ledger Live to use Solana wallet accounts on Ledger Live
will be available in the future.**
Users may [use a Ledger Nano S with the Solana command
line tools](../hardware-wallets/ledger.md).
## Set up a Ledger Nano S
- Order a [Nano S from Ledger](https://shop.ledger.com/products/ledger-nano-s)
- Follow the instructions for device setup included in the package,
or [Ledger's Start page](https://www.ledger.com/start/)
- [Install the latest device firmware](https://support.ledgerwallet.com/hc/en-us/articles/360002731113-Update-Ledger-Nano-S-firmware)
## Install Ledger Live
- Install [Ledger Live desktop software](https://www.ledger.com/ledger-live/),
or
- Install the [Ledger Live app for iOS](https://apps.apple.com/app/id1361671700)
or [Ledger Live for Android](https://play.google.com/store/apps/details?id=com.ledger.live).
- Requires iOS 9.1 or later. Compatible with iPhone, iPad, and iPod touch.
- Requires Android 7.0 or later.
- Connect your Nano S to your device and follow the instructions
## Install the Solana App on your Nano S
- Open Ledger Live
- Currently Ledger Live needs to be in "Developer Mode"
(Settings > Experimental Features > Developer Mode) to see our app.
![Enabling Developer Mode](../.gitbook/assets/ledger-live-enable-developer-mode.png)
- Go to Manager in the app and find "Solana" in the App Catalog and
click Install
- Make sure your device is plugged in via USB and is unlocked with its PIN
- You may be prompted on the Nano S to confirm the install of Solana App
- "Solana" should now show as "Installed" in the Ledger Live Manager
![Installed Solana App in Manager](../.gitbook/assets/ledger-live-install-solana-app.png)
## Interact with Solana network
- To interact with your Ledger wallet on our live network, please see our
instructions on how to
[use a Ledger Nano S with the Solana command line tools](../hardware-wallets/ledger.md).
## Support
Check out our [Wallet Support Page](support.md) for ways to get help.

13
docs/src/wallet-guide/support.md Normal file
View File

@@ -0,0 +1,13 @@
# Support / Troubleshooting
If you have questions or are having trouble setting up or using your wallet
of choice, please make sure you've read through all the relevant pages in our
[Wallet Guide](README.md). The Solana team is working hard to support new
features on popular wallets, and we do our best to keep our documents up to date
with the latest available features.
If you have questions after reading the docs, feel free to reach out to us on
our [Telegram](https://t.me/solanaio).
For **technical support**, reach out to us on
[Discord](https://discordapp.com/invite/pquxPsq), using the #wallet-support
channel in our Community section.

107
docs/src/wallet-guide/trust-wallet.md Normal file
View File

@@ -0,0 +1,107 @@
# Trust Wallet
Trust Wallet is an app for your smartphone or tablet and is the fastest and
simplest way for most users to get started with a Solana wallet.
## Install Trust Wallet
#### iOS
- Open the App Store
- Download “Trust: Crypto & Bitcoin Wallet” from Six Days LLC
- Requires iOS 13.0 or higher
- Open Trust Wallet and follow the app prompts to get started
#### Android
- Open the Play Store
- Download “Trust Crypto Wallet” from Six Days LLC
- Requires Android 6.0 or higher
- Open Trust Wallet and follow the app prompts to get started
## Add Solana (SOL) tokens to your wallet
- From the main page, go to the “Tokens” tab at the top of the screen
- Tap the “+” icon at the top right corner
- Search for “Solana” in the search page, and when the “Solana SOL” token is
shown, slide the slider to enable this token.
- You can now tap the Solana icon to access your Solana wallet.
[Trust Wallet Official Docs: How to Add or Remove a Coin](https://community.trustwallet.com/t/how-to-add-or-remove-a-coin/896)
## Receiving SOL tokens
- To receive SOL tokens that you’ve purchased or earned, you need to send your
Receive Address to whoever is sending you tokens.
- Tap “Receive” to view a QR code and your text address, which is a long string
of letters and numbers.
- Tap “Copy” or “Share” to send the address.
- Be very careful when you copy and paste your receive address anywhere that
you do not miss any characters at the beginning or end of the string.
- If you send an incorrect Receive address to someone and they send tokens
to that address, **those tokens will be lost forever**.
[Trust Wallet Official Docs: How to Find my Receiving Address](https://community.trustwallet.com/t/how-to-find-my-receiving-address/2006)
## Sending SOL tokens
You can send SOL from your Trust Wallet to any other valid address on the Solana
network. Once you know the other party's receiving address,
go to the main page of the wallet from which you want to send some SOL tokens:
- Tap the "Solana" icon.
- Tap "Send"
- Under "Recipient Address":
- If you already have the receiving address you are going to send to,
tap "Paste"
- If you are transferring to another Trust Wallet user, you can use the app's
QR code reader by tapping the square icon to the right of the "Paste" button.
- Under "Amount", enter the amount of SOL you want to send, or tap "Max"
to send **all** of the SOL in your wallet to the new address
- Tap "Next" to view a summary/confirmation page to review before submitting
the transaction
- The real-time network transaction fee will be shown. This fee will be
paid by the sending account in addition to the full amount transferred.
- If you chose to send all your tokens to the new address by selecting
"Max" under amount, the amount sent to the recipient will be the account
balance *minus* the current network transaction fee.
- **Make sure you entered the "To" address correctly and that it matches your
desired wallet's receiving address!**
- Tap "Send" to submit the transaction. The transaction will show as "Pending"
for a few seconds, and then will show as "Sent".
[Trust Wallet Official Docs: Sending Cryptocurrencies](https://community.trustwallet.com/t/sending-cryptocurrencies/65)
## Using Multiple Wallet Addresses
Trust Wallet allows you to create multiple wallets, each of which is
secured by a different set of random seed words. If you want to use more than
one Solana address, follow these steps.
#### Create an additional wallet
- In the main page of the Trust Wallet App, tap "Settings" in the bottom-right
corner.
- Tap "Wallets"
- Tap "+" to create a new Wallet
- Follow the steps above to add SOL tokens to your new wallet
*Note: In the "Wallets" page under "Settings" you can re-name each of your wallets.
Consider giving each a descriptive name if you are planning to use your wallets
for different purposes, so you don't mistake one for the other.*
#### Transferring SOL between your wallets
Just like you can transfer SOL to another party, you can transfer SOL between
wallets that you own.
- Copy the receive address of your **newly created** wallet.
- Make sure your **new** wallet is selected by going to
"Settings" --> "Wallets", then tap on the name of your new wallet.
- Tap the "Solana" icon.
- Tap "Receive" then tap "Copy".
- Select your previous/original wallet which already has some SOL by going to
"Settings" --> "Wallets", then tap on the name of your **original** wallet.
- Now follow the same process for [sending SOL tokens](#sending-sol-tokens)
using your **new** wallet's receiving address as the address in the "To"
field when you make the transfer.
## Troubleshooting
If you are having trouble setting up your Trust Wallet app, check out their
[Community Help Center](https://community.trustwallet.com/c/helpcenter)
## Support
Check out our [Wallet Support Page](support.md) for ways to get help.