mirror of https://github.com/lukechilds/docs.git
Browse Source
feat: remove wallet docs and redirect feat: fix next config formattingbuild/deps-updates
Alexander Graebe
4 years ago
committed by
Alexander Graebe
5 changed files with 48 additions and 544 deletions
@ -1,101 +0,0 @@ |
|||
--- |
|||
title: Install the Stacks wallet |
|||
description: Learn how to install the Stacks wallet |
|||
--- |
|||
|
|||
## Introduction |
|||
|
|||
You use the Stacks Wallet software client alone or with a hardware wallet to send and receive |
|||
Stacks (STX) tokens. On this page, you learn how to install the Stacks Wallet software. |
|||
|
|||
!> When you download the wallet software you are at risk of |
|||
a man-in-the-middle attack (as an example) from hackers interested in stealing |
|||
your tokens or your other information. To protect yourself from this type of |
|||
attack, verify your downloaded wallet software as detailed in the installation |
|||
instructions below. Verification confirms that you received the software signed |
|||
by Blockstack PBC. |
|||
|
|||
## Mac Installation |
|||
|
|||
1. [Go to the wallet download page](https://wallet.blockstack.org) in your browser. |
|||
2. Select the **macOS Download** button. |
|||
|
|||
This button downloads the software to your computer. |
|||
|
|||
3. To verify the authenticity of the downloaded package before installation, open a terminal window. |
|||
|
|||
To find the terminal software, enter `terminal` into the Spotlight search. |
|||
|
|||
![](/images/mac-terminal.png) |
|||
|
|||
4. In the terminal window, enter the command to change directory to the folder where you downloaded the wallet software. |
|||
|
|||
The default location is the **Downloads** folder, type the following into the terminal and press RETURN on your keyboard. |
|||
|
|||
```bash |
|||
cd ~/Downloads |
|||
``` |
|||
|
|||
5. In the terminal window, type the following command to verify the authenticity of the downloaded file `Stacks-Wallet-macOS-3.1.0-en-US.dmg` |
|||
|
|||
```bash |
|||
shasum -a 512 Stacks-Wallet-macOS-3.1.0-en-US.dmg |
|||
``` |
|||
|
|||
![](/images/mac-shasum.png) |
|||
|
|||
6. Verify that the resulting hash (a string of letters and numbers) is the same as the hash published [on the Stacks Wallet's Github repository](https://github.com/blockstack/stacks-wallet/releases). |
|||
|
|||
7. To proceed with installation, open the downloaded file and complete the setup. |
|||
|
|||
## Windows Installation |
|||
|
|||
1. Select the **Windows Download** button [on this page](https://wallet.blockstack.org/). |
|||
|
|||
This button downloads the software to your computer. |
|||
|
|||
2. To verify the authenticity of the downloaded package before installation, open a command prompt. |
|||
|
|||
To find the command prompt software, enter `command` into the Start menu. |
|||
|
|||
![](/images/windows-cmd.png) |
|||
|
|||
3. In the command prompt window, enter the command to change directory to the folder where you downloaded the wallet software. |
|||
|
|||
The default location is the **Downloads** folder, type the following at the command prompt and press RETURN on your keyboard. |
|||
|
|||
```bash |
|||
cd <You-User-Directory>/Downloads |
|||
``` |
|||
|
|||
4. In the command prompt window, type the following command to verify the authenticity of the downloaded file `Stacks-Wallet-win10-3.1.0-en-US.dmg` |
|||
|
|||
```bash |
|||
certUtil -hashfile Stacks-Wallet-win10-3.0.0.exe SHA512 |
|||
``` |
|||
|
|||
![](/images/windows-certutil.png) |
|||
|
|||
5. Verify that the resulting hash (a string of letters and numbers) is the same as the hash published [on the Stacks Wallet's Github repository](https://github.com/blockstack/stacks-wallet/releases). |
|||
|
|||
## Additional requirement and option |
|||
|
|||
Sending and receiving Stacks (STX) does require a Bitcoin as fuel. |
|||
You also have the option to use the wallet with or without a hardware wallet. |
|||
|
|||
### Bitcoin account for fuel (required) |
|||
|
|||
You need small amounts of Bitcoin to fuel your Stacks Wallet transactions. For example, 0.001 Bitcoin can fuel several transactions. You can acquire this Bitcoin fuel and send it to the Stacks Wallet's Bitcoin fuel address via a Coinbase or other Bitcoin account. You can view the Stacks Wallet's Bitcoin fuel address in the settings menu. |
|||
|
|||
### Hardware wallet (optional but recommended) |
|||
|
|||
If you have a paper wallet or a custodial wallet, you should set up a secondary hardware. You can then transfer small amounts to this hardware wallet for use with your Stacks Wallet. You can use any of these hardware wallets with the Stacks Wallet: |
|||
|
|||
- [Trezor One](https://trezor.io/) |
|||
- [Ledger Nano S](https://www.ledger.com/) |
|||
- Ledger Blue |
|||
|
|||
-> Blockstack only supports the hardware wallets listed above. Other wallets, for example, the Trezor Model T, **are not currently supported**. If you have questions about wallet support, please [contact Blockstack support](mailto:support@blockstack.org). |
|||
|
|||
For information on setting up a hardware wallet, refer to the vendor's |
|||
documentation. |
@ -1,88 +0,0 @@ |
|||
--- |
|||
title: Stacks wallet overview |
|||
description: Learn about cryptocurrency wallets, STX, and the Stacks wallet. |
|||
--- |
|||
|
|||
## Introduction |
|||
|
|||
The Stacks Wallet is the application used to manage your Stacks (STX) token holdings. You can |
|||
use it to view your token balance, send and receive tokens. This overview will introduce some |
|||
basic concepts and terminology. If you have a good understanding of cryptocurrencies, you can |
|||
skip to the [installation page](/stacks-wallet/install). |
|||
|
|||
## Wallets, addresses, and tokens |
|||
|
|||
Cryptocurrency wallets are software that enables the sending and receiving of cryptocurrency. |
|||
Unlike the wallets you carry physical money in, a cryptocurrency wallet doesn't contain your |
|||
tokens. |
|||
|
|||
Every wallet has one or more cryptocurrency addresses. An address is similar to an account number, |
|||
it is public and will be used by others to send tokens to you. Each address has a corresponding |
|||
private key, which is used to sign outgoing transactions from your account. The wallet software |
|||
securely manages this private key for you. When setting up a new wallet (and not using a hardware |
|||
wallet), you will be asked to write down a seed phrase. This seed phrase is the equivalent of your |
|||
private key. You should keep it safe and **never reveal it to anyone.** |
|||
|
|||
> ##### Security tip: What to share and what not to |
|||
> |
|||
> A Stacks address is a string of letters and numbers starting with an `SP` or `SM`, like |
|||
> `SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT`. You can and should share the address when you want |
|||
> someone to send STX tokens to you. |
|||
> |
|||
> Your seed phrase, 24 words in an ordered sequence, is the private key for your addresses and wallet. |
|||
> **never** share your seed phrase with anyone. |
|||
|
|||
When you send a transaction from the wallet, you are digitally signing a token transfer from your |
|||
account and broadcasting this to the Blockchain network. After the network has received and |
|||
validated your transaction, tokens will be moved from your account to the specified destination |
|||
account. The transaction will be permanently recorded on the Blockchain and is irreversible. |
|||
|
|||
## Large-scale or institutional token holders |
|||
|
|||
Just as you don’t keep all the money you have in your bank in a physical wallet, |
|||
you shouldn’t keep large numbers of tokens in your cryptocurrency wallet. |
|||
Instead, if you have a large number of crypto assets, you should store them with |
|||
a custodial service. Custodial services protect your token holdings using |
|||
high-security systems. |
|||
|
|||
Custodial services have different techniques for storing crypto assets. |
|||
The techniques vary according to factors such as the liquidity level you want to |
|||
maintain or the security you would like. If you own large numbers of token |
|||
assets as an investment, you should choose a custodial service as if you were |
|||
selecting any investment service. Consider your needs, the firm’s reputation, |
|||
fees, and so forth. |
|||
|
|||
!> The Stacks Wallet is not recommended for institutional holdings. |
|||
|
|||
Blockstack suggests a firm such as [Coinbase Custody](https://custody.coinbase.com/) for |
|||
institutional holders. Coinbase Custody charges its clients a management fee based on |
|||
assets. Of course, like any responsible asset holder, you should do your own research and |
|||
select a service that meets your needs. The Investopedia's article |
|||
[What Are Cryptocurrency Custody Solutions?](https://www.investopedia.com/news/what-are-cryptocurrency-custody-solutions/) |
|||
is one place to start. |
|||
|
|||
## Software and Hardware wallets |
|||
|
|||
You can choose among different types of cryptocurrency wallets. There are mainly |
|||
two types of wallets, software and hardware. |
|||
|
|||
Software wallets run as programs on a computer desktop/tablet, online (web), or |
|||
mobile phone. Desktop software wallets are downloaded to one computer. Because |
|||
they are on one system, they are vulnerable to theft either of the computer |
|||
itself or through computer hacking. Computer viruses can also impact desktop |
|||
wallets. |
|||
|
|||
Similarly, mobile, online wallets do not require a desktop, but they also tend to be smaller |
|||
and simpler. Online wallets run over the web and are accessible from any networked device, |
|||
computer or phone. However, online wallets are vulnerable to hacking as well and also rely on |
|||
third-party service providers who themselves may also be vulnerable. |
|||
|
|||
Hardware wallets store your seed and addresses on a separate and secure device. |
|||
To use these wallets, you connect them to a networked computer, enter a pin, and |
|||
communicate to send and receive tokens across the web. |
|||
|
|||
Unlike a pure software wallet, hardware wallets can be disconnected and placed |
|||
offline in a secure physical location like a bank deposit box. For this reason, |
|||
hardware offers another level of security that software wallets don’t have. |
|||
Blockstack suggests that you use a hardware wallet such as |
|||
[Trezor](https://trezor.io/) or [Ledger](https://www.ledger.com/). |
@ -1,49 +0,0 @@ |
|||
--- |
|||
title: Wallet security |
|||
description: Best practices for keeping your wallet(s) secure. |
|||
--- |
|||
|
|||
## Introduction |
|||
|
|||
It is important that you understand how to keep good security for your Stacks Wallet software and your Blockstack identity. |
|||
|
|||
## Backup your seed phrase and Secret Recovery Code |
|||
|
|||
Both your wallet seed phrase and your Secret Recovery Code are cryptographic keys. A seed phrase gives you access to your |
|||
Stacks Wallet software. A **Secret Recovery Code** gives you access to your Blockstack identity. You need to use the |
|||
strictest security available to you for both of these keys. |
|||
|
|||
The Cryptocurrency Security Standard publishes [guidelines for key storage](https://cryptoconsortium.github.io/CCSS/Details/#1.03). |
|||
These guidelines are presented from least (Level I) to most secure (Level III). We recommend you store your keys with at least |
|||
Level II security. This level states that you should: |
|||
|
|||
- Back up each of your cryptographic keys. |
|||
- Store the backup in a location separate location from where you use a key. For example, if you use the key at the office, |
|||
you can store the key are your office. |
|||
- Protect your backup from access by unauthorized parties. For example, a safe, safe deposit box, or lock box are good |
|||
examples of protecting access to a backup. |
|||
- Employ some form of tamper mechanism that allows your to determine when if you key was accessed by someone else. For |
|||
example, you could use a sealed paper envelopes with handwritten signatures over the seal as a tamper mechanism. |
|||
|
|||
You are responsible for recalling and protecting your keys. Blockstack does not store your seed phrase or |
|||
**Secret Recovery Code**. If you lose your seed phrase, you lose the key to your STX tokens, which can be a very |
|||
costly mistake. If you lose your **Secret Recovery Code**, you lose the key to your identity and cannot access |
|||
your applications or the data you created with them. |
|||
|
|||
## Security terminology |
|||
|
|||
Use the following table to answer questions about keys/phrases/values you can share with others (_SHAREABLE_) and ones |
|||
you should _never_ share but instead keep in a secure place (**PROTECT**). |
|||
|
|||
| Phrase/Key/Value | Security | Description | |
|||
| -------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
|||
| Secret Recovery Key | **PROTECT** | Used to access an identity on the Blockstack blockchain. A 24-word sequence of words for example: <br /> `applied binge crisp pictorial fiery dancing agreeable frogs light finish ping apple` <br /> | |
|||
| Identity <br /> Blockstack Identity <br /> Blockstack ID | _SHAREABLE_ | A way to identify a person or an organization on the Blockstack network. An identity is unique, both `meepers.id.blockstack` or `chad.id` are examples of IDs. | |
|||
| Magic Recovery Code | **PROTECT** | A long encrypted string, for example:<br />`36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++UjOA...` <br /> Do not share the QR code that accompanied your recovery code either. This is a QR code: <img src="/images/qr-code.png" alt="An example of a QR code." /> | |
|||
| Blockstack Owner Address | _SHAREABLE_ | Looks like a bitcoin address but starts with `ID`, for example: `ID-1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs...` | |
|||
| Bitcoin address <br /> BTC Address | _SHAREABLE_ | A string of letters and numbers: `3E53XjqK4Cxt71BGeP2VhpcotM8LZ853C8...` Sharing this address allows anyone to send Bitcoin to the address. | |
|||
| Stacks address / STX address | _SHAREABLE_ | A string of letters and numbers: `3E53XjqK4Cxt71BGeP2VhpcotM8LZ853C8...` Sharing this address allows anyone to send Stacks (STX) to the address. | |
|||
| Public Key | _SHAREABLE_ | Public and private key pair comprise of two uniquely related cryptographic keys. It looks like a long random string of letters and numbers: <br /> `3048 0241 00C9 18FA CF8D EB2D EFD5 FD37 89B9 E069 EA97 FC20 …` <br /> The exact format of the public and private key depend on the software you use to create them. | |
|||
| Private Key | **PROTECT** | Private keys matches a corresponding public key. A public key also looks like a string of letters and numbers: <br /> <img src="/images/private.png" alt="Example of a Private Key" /> | |
|||
| Seed Phrase | **PROTECT** | Used to access Stacks Wallet software. The seed phrase consists of 24 words in a sequence. Both the _word and its position_ in the sequence are important. <br /> Write down your seed phrase and store it in a secure location such as a safe deposit box. When you write the seed phrase down, include its position, for example: `1-frog, 2-horse, 3-building` and so on until you reach a final position: `24-ocean`. | |
|||
| Wallet Address | _SHAREABLE_ | If you created a software-only wallet with the Stacks Wallet software, the wallet has a single STX address which is also sometimes called a Stacks (STX) address. You access a software wallet with a seed phrase. | |
@ -1,301 +0,0 @@ |
|||
--- |
|||
title: Using the Stacks wallet |
|||
description: Learn how to use the Stacks wallet |
|||
--- |
|||
|
|||
## Introduction |
|||
|
|||
This page describes how to use the Stacks Wallet software to manager your Stacks (STX) tokens. |
|||
|
|||
The Stacks Wallet software is installed on your computer, it is not a web application. You should have already [downloaded, verified, and installed the wallet software](wallet-install). |
|||
|
|||
## Key concepts you should understand |
|||
|
|||
You use Stacks Wallet software to manage STX tokens. Using the wallet you can: |
|||
|
|||
- send STX from a specific STX address |
|||
- receive STX at a specific STX address |
|||
- view balances on an address |
|||
- review transaction history associated with an address |
|||
- withdraw Bitcoin sent to the wallet's fuel address |
|||
|
|||
To send STX, you need Bitcoin in your wallet. Bitcoin is the "gas" for transactions on the Stacks blockchain. A **_very small_** amount of Bitcoin is required to send STX. The gas price fluctuates like any market and is driven by the price of Bitcoin. Gas is not required to receive STX. |
|||
|
|||
You can use the Stacks Wallet software by itself or together with a hardware wallet. Using with a hardware wallet is recommended but not required. |
|||
|
|||
> ##### Investors and large token holdings: Hardware devices |
|||
> |
|||
> If you are an investor or current Stacks token holder, you should have your relevant STX addresses on a configured hardware device before using the Stacks Wallet software. If you have very large holdings, we recommend and anticipate these are held with a custodial service. In the case of a custodial service, you would work with your service to transfer a portion of your holdings to an appropriate hardware device before using the Stacks Wallet software. |
|||
|
|||
### A hardware device with the wallet |
|||
|
|||
You can use any of these hardware wallets with the Stacks Wallet: |
|||
|
|||
- Trezor One |
|||
- Ledger Nano S |
|||
- Ledger Blue |
|||
|
|||
-> Blockstack only supports the hardware wallets listed above. Other wallets, for example, the Trezor Model T, <strong>are not supported</strong>. If you have questions about wallet support, please <a href='emailto:support@blockstack.org' target='_blank'>contact Blockstack support</a>. |
|||
|
|||
The private key on your hardware wallet is used by the Stacks Wallet software to sign send transactions. Receive transactions don't require a signature. Please consult the device's manufacturer for support in setting up and configuring your hardware device. |
|||
|
|||
### Software only wallet and a seed phrase |
|||
|
|||
You can use the Stacks Wallet software without a hardware wallet device. Each wallet has its own address which corresponds to a STX address on the Stacks blockchain. You access this address with a unique, **seed phrase**. The software generates a seed phrase for you when create a software-only wallet. The seed phrase consists of 24 words in a sequence. Both the word _and its position the sequence_ are important. |
|||
|
|||
Write down your seed phrase and store it in a secure location such as a safe deposit box. |
|||
|
|||
!> Do not lose your seed phrase. If you lose your seed phrase, you lose any STX tokens in that associated wallet. **No person or organization, including Blockstack, can recover a lost seed phrase**. |
|||
|
|||
### About the reset function |
|||
|
|||
The **Reset** function is always available regardless of whether you are using a hardware wallet or a software-only. A **Reset** returns a wallet to its original state. It does not change your STX balance, your Stacks addresses, or any connected hardware wallet in any way. |
|||
|
|||
### Used an older version of the wallet? |
|||
|
|||
If you used the original, v1, version of the wallet, you should instead begin using the new Stacks Wallet v3. you should have a 24 word seed phrase from that wallet. You can use this same seed phrase to open this new version of the Stacks Wallet Software. |
|||
|
|||
The v2 version of the wallet required a hardware wallet to send and receive. You can connect this same hardware wallet to the v3 version of the Stacks Wallet software. If this is your situation, choose **Use existing wallet** when you first start the Stacks Wallet v3; you don't need to create a new wallet. |
|||
|
|||
## Create a new or open an existing wallet |
|||
|
|||
When you start the Stacks Wallet it prompts you to create a new or choose an existing wallet. You should create a new wallet if you have not previously connected a hardware device to the Stacks Wallet v3 software or if you do not have an existing 24 word seed phrase. |
|||
|
|||
### Use with a hardware wallet |
|||
|
|||
Initialize and configure your wallet according to the manufacturer's instructions before you use it with the Stacks Wallet software. Some hardware wallets require that you have additional software installed to support the hardware wallets interactions with the Stacks Wallet. |
|||
|
|||
| Hardware wallet | Prerequisite software | |
|||
| --------------- | ---------------------------------------------------------------------- | |
|||
| Trezor One | [Trezor Bridge](https://doc.satoshilabs.com/trezor-user/download.html) | |
|||
| Ledger Nano S | None. | |
|||
| Ledger Blue | None. | |
|||
|
|||
Make sure you have installed any prerequisite software. It is a good idea to connect your hardware wallet to your computer before starting the Stacks Wallet software, but it is not required. |
|||
|
|||
When your hardware device is ready, do the following: |
|||
|
|||
1. Connect your hardware wallet to your computer as you normally would. |
|||
2. Double-click on the wallet software to open it. |
|||
3. Select **Create new wallet** or **Use existing wallet**. |
|||
|
|||
If you connected your hardware device to an old version of the Stacks Wallet software, you choose **Create new wallet**. After you make this initial connection, the _next time_ you start the wallet, you can choose **Use existing wallet**. |
|||
|
|||
The system asks if you have a hardware wallet. |
|||
|
|||
4. Choose **Yes, I do**. |
|||
|
|||
The system prompts you to select a hardware wallet. |
|||
|
|||
5. Select the hardware wallet you want to use. |
|||
|
|||
This example uses a Trezor wallet. |
|||
|
|||
![](/images/choose-hardware.png) |
|||
|
|||
The system prompts you to connect your |
|||
device. |
|||
|
|||
6. Connect your wallet to your computer and choose **Continue**. |
|||
|
|||
The system prompts you to export a public key. |
|||
|
|||
![](/images/trezor-export.png) |
|||
|
|||
7. Select **Export**. |
|||
|
|||
The Stacks Wallet shows the current wallet balance. |
|||
|
|||
### Software only wallet |
|||
|
|||
If you have an existing 24 word seed phrase from this or a previous version of the Stacks Wallet software, you don't need to create a new wallet, you can **Use existing wallet**. This procedure assumes you are creating a wallet for the first time. |
|||
|
|||
1. Double-click on the wallet software to open it. |
|||
2. Select **Create new wallet**. |
|||
|
|||
The system asks if you have a hardware wallet. |
|||
|
|||
3. Choose **No, I don't**. |
|||
|
|||
The system prompts cautions you that a hardware wallet is recommended. |
|||
|
|||
4. Choose **Continue without a hardware wallet**. |
|||
|
|||
The system generates a seed phrase for you and prompts you to write it down. |
|||
Don't lose your seed phrase. If you lose your seed phrase, you lose your STX tokens and can never get them back. |
|||
|
|||
5. Write down each word in the displayed order. |
|||
6. Store your written seed phrase in a secure location such as a safe deposit box. |
|||
7. Click **I've written down my seed phrase**. |
|||
8. Select **Done**. |
|||
|
|||
The system displays the balance for the address that corresponds to your seed phrase. |
|||
|
|||
## View balance, allocation, or transaction history |
|||
|
|||
The default view for an open and loaded wallet is the **Wallet Balance** view. |
|||
|
|||
![](/images/hardware-balance.png) |
|||
|
|||
Notice this view includes **Send** and **Receive** buttons. |
|||
|
|||
Both balances show **Transaction History** if it exists for an address. A |
|||
transaction summary appears on the initial screen. To see details, |
|||
click on a transaction: |
|||
|
|||
![](/images/receive-details.png) |
|||
|
|||
Not all addresses have a balance. If you are a Stacks token holder, your |
|||
address shows with both a **Balance** and **Allocation**. The **Balance** is the |
|||
Stacks you have unlocked. The **Allocation** is the amount still locked up. |
|||
|
|||
![](/images/token-holder-balance.png) |
|||
|
|||
## Receive Stacks |
|||
|
|||
To receive Stacks: you give a STX address directly to a user via email or text, for |
|||
example. |
|||
|
|||
1. Click the **Receive** button to display the wallet address. where others can send STX to. |
|||
|
|||
![](/images/receive-button.png) |
|||
|
|||
2. Email or text the address to the person or organization sending to you. |
|||
|
|||
A Stacks address is a public addresses. Anyone with the address, can view the address balance or send money _**to**_ the address. |
|||
|
|||
3. Look for the receipt transaction in your transaction history. |
|||
|
|||
Once the person has sent you STX, you see a **PENDING** transaction which means the transaction is still being recorded by the blockchain. |
|||
|
|||
![](/images/pending.png) |
|||
|
|||
Blockchain transactions take time. It may be minutes or hours before the transaction is recorded in the blockchain. When the transaction is complete, you can see a receipt for the transaction in your Stacks Wallet. The **PENDING** marker goes away once the funds are recorded on the blockchain. |
|||
|
|||
## Add Bitcoin gas |
|||
|
|||
The Stacks Wallet uses very small amounts of Bitcoin to pay fees for sending transactions. You need very small amounts of Bitcoin (BTC) for gas. The cost of gas you need fluctuates with the market price of Bitcoin. |
|||
|
|||
!> Very small amounts of Bitcoin are all you need to fuel transactions. |
|||
|
|||
You need an account with Coinbase or similar exchange to buy Bitcoin and send it to the Stacks Wallet. |
|||
|
|||
If you attempt to send STX with your wallet and you do not have enough Bitcoin to fuel the transaction, you see this dialog: |
|||
|
|||
![](/images/not-enough.png) |
|||
|
|||
To increase your Bitcoin for transactions, do the following: |
|||
|
|||
1. Click the settings icon in the upper right corner of the wallet. |
|||
|
|||
The system opens the **Settings** dialog. |
|||
|
|||
![](/images/settings.png) |
|||
|
|||
This dialog shows you how much BTC you currently have in your account. |
|||
|
|||
2. Select **Add BTC**. |
|||
|
|||
The systems displays the **Top Up** dialog with a Bitcoin address. |
|||
|
|||
![](/images/top-up.png) |
|||
|
|||
3. Record the BTC address. |
|||
4. Go to your Coinbase or similar account. |
|||
5. Send Bitcoin to the address presented by the Stacks Wallet. |
|||
|
|||
![](/images/gas-up-cb.gif) |
|||
|
|||
Review your Stacks Wallet settings to see the increase in your balance. Your BTC balance only appears in this area. The Bitcoin fuel address is tied to your Stacks wallet private key. No one else including Blockstack can access the Bitcoin. |
|||
|
|||
To withdraw Bitcoin from the fuel address. Click on the `Withdraw BTC` button in the **Settings** dialog. Note that you can only withdraw the entire balance in one transaction. |
|||
|
|||
## Send stacks |
|||
|
|||
Sending stacks is a transaction you must authorize or sign. If you have connected your Stacks Wallet to a hardware wallet. The Stacks Wallet software uses the hardware wallet to sign your send transactions. A software-only wallet asks you for the 24-word key phase you used to create the wallet. |
|||
|
|||
1. Open the Stacks Wallet. |
|||
|
|||
If you are starting after a reset, choose **Use a Hardware Wallet**. |
|||
|
|||
2. Connect your hardware wallet to your computer. |
|||
3. Select **Send**. |
|||
|
|||
The system displays the **Send** dialog. |
|||
|
|||
4. Complete the dialog with the transaction information. |
|||
|
|||
| **Recipient** | A Stacks address. | |
|||
| **Amount to Send** | Enter a value. | |
|||
| **Note** | A memo for the transaction. | |
|||
|
|||
5. Select **Continue**. |
|||
|
|||
If you do not have enough Bitcoin to fuel the transaction, the system |
|||
notifies you. If you don't have enough Bitcoin, you must **Top Up**. |
|||
Otherwise, the system prompts you to connect to your hardware wallet. Your |
|||
hardware wallet will prompt you for additional information and actions. |
|||
|
|||
![](/images/device-check.png) |
|||
|
|||
6. Select **Continue**. |
|||
|
|||
The Stacks Wallet displays a confirmation dialog. |
|||
|
|||
![](/images/confirm-send.png) |
|||
|
|||
7. Select **Confirm** to complete your transaction. |
|||
|
|||
![](/images/sent.png) |
|||
|
|||
8. Select **Close**. |
|||
|
|||
The send transaction appears in your **Transaction History**. Blockchain |
|||
transactions can take minutes or hours to complete. |
|||
|
|||
Select **Refresh** if you don't immediately see the transaction in your |
|||
history. |
|||
|
|||
## Reset the wallet |
|||
|
|||
Resetting a wallet clears all your data from the Stacks Wallet and returns the |
|||
wallet to its original state. |
|||
|
|||
- If you entered a Stacks address, resetting clears the address from the Stacks Wallet. |
|||
- If you connected to a hardware wallet, resetting removes the connection to the hardware wallet. |
|||
|
|||
Resetting the wallet does nothing to your addresses or their associated balances. |
|||
They are maintained. |
|||
|
|||
Once you reset the wallet, you have to start over from the _Terms of Use_. If |
|||
you do not restart the wallet, you can simple close it. |
|||
|
|||
1. Click the settings icon in the upper right corner of the wallet. |
|||
|
|||
The system opens the **Settings** dialog. |
|||
|
|||
![](/images/settings.png) |
|||
|
|||
2. Select **Reset Wallet**. |
|||
|
|||
System asks for confirmation. If, for some reason, you want to stop the reset |
|||
you would press close icon in the right corner or **Close**. |
|||
|
|||
3. Select **Are you sure?** to complete the reset. |
|||
|
|||
The wallet displays the **Terms of Use**. You can accept to enter the wallet |
|||
again or choose **Quit**. |
|||
|
|||
## Trezor wallet support |
|||
|
|||
Due to technical compatibility issues, we are currently unable to fully support all Trezor wallets. |
|||
|
|||
-> The wallet only supports Trezor One, Ledger Nano S, and Ledger Blue. Other wallets, for example, the Trezor Model T, are not supported. If you have questions about wallet support, please [contact Blockstack support](emailto:support@blockstack.org). |
|||
|
|||
The current Stacks Wallet ([v3.1.0](https://github.com/blockstack/stacks-wallet/releases/tag/v3.1.0)) supports only the Trezor One device, and only up to firmware [version 1.8.3](https://wiki.trezor.io/Firmware_changelog). If you have a newer firmware, you will have to downgrade by [following instructions described on this page](https://wiki.trezor.io/Firmware_downgrade). |
|||
|
|||
!> Downgrading your wallet is dangerous and will erase your Trezor, so make sure you have your Trezor seed phrase backed up. |
|||
|
|||
Alternatively to downgrading the firmware, you can use Stacks (STX) tokens with a [Ledger hardware device](https://www.ledger.com/). You can enter your Trezor seed phrase into the Ledger device to access your account. View the [Ledger documentation on how to restore a seed phrase to a Ledger device](https://support.ledger.com/hc/en-us/articles/360005434914-Restore-from-recovery-phrase). You will need the original 24-word Trezor recovery phrase which you backed up when setting up your Trezor. |
|||
|
|||
-> Only Ledger Nano S is currently supported by the v3.1.0 Stacks Wallet. |
Loading…
Reference in new issue