diff --git a/_browser/storage-provider.md b/_browser/storage-provider.md new file mode 100644 index 00000000..feaee9d8 --- /dev/null +++ b/_browser/storage-provider.md @@ -0,0 +1,51 @@ +--- +layout: usenew +permalink: /:collection/:path.html +--- +# How you control your data + +When you use a Blockstack decentralized application (DApp), the data that you +enter into that application, photos, documents, and more is something you own +and control. Traditional applications such as Instagram or PayPal store your +data _on their corporate servers_. + +Blockstack DApps do not allow applications to store your data on the +application's corporate servers. Instead, you store your data with a _storage +provider_ you choose. A storage provider gives you personal storage for your +application data. + +If you want to walk away from a particular DApp, there’s no need even to export +your data. You simply stop using the DApp and it no longer can read or modify +your data. And if you want to start using a different DApp with the same data, +you can. + +## Understand storage providers + +The Blockstack Ecosystem provides a technology for data storage called, Gaia. +Gaia is _storage hub_ technology for storing application data. A storage +provider is simply an organization that implemented Gaia and is providing +storage hubs for users. Any organization or person can create a Gaia storage hub +and become a storage provider. + +These providers host data in one or more existing storage systems of their +choice. These storage systems are typically cloud storage systems such as +Amazon, Dropbox, iCloud or Azure to name a few. + +Users that create an identity in the Blockstack Browser are given a choice of +which data storage provider to use. Blockstack itself runs a Gaia storage hub and acts +as a storage provider. The default choice is the Blockstack-run storage hub. + +Every provider will store your data at a particular address or URL. These +addresses look similar to any address you put in your web browser. When you log +into a DApp, you are giving that the application the ability to save +data to the URL on your behalf. + +## Current limitations of data storage + +The following are limitations of the current system. + +* You cannot move your storage from one provider to another. +* You cannot store your data on your own computer. + +Blockstack is always seeking to expand Gaia's capabilities. These limitations +will disappear as they are overcome by new Gaia features. diff --git a/_data/glossary.csv b/_data/glossary.csv index 4a1c8eac..60d2e3e3 100644 --- a/_data/glossary.csv +++ b/_data/glossary.csv @@ -46,11 +46,14 @@ replicated state machines (RSMs),"This is a model for reasoning about distribute smart contract,"A smart contract is a computer program written to a blockchain such as the Blockstack blockchain by developers. This computer program defines the various network operations that can be performed on the digital assets on the blockchain, the computations that can be performed using the smart contract, along with defining various important properties of the respective digital assets like ownership rights and the cost in fuel required to register the digital assets.",Filing soft fork,"A soft fork is a proposed update to the software governing the network that results in a post-update network that is compatible with the network as it existed prior to the update, because it restricts the network operations that can be performed after the update.",Filing Stacks blockchain,The Stacks blockchain is the custom blockchain being developed for use by the Blockstack network that will use the Stacks token as its native currency and which will include the genesis block and subsequent blocks created by the mining activities described in The Blockstack Network—Development of the Blockstack network.,Filing +storage hub,"An Gaia instance run by a storage provider or software. A storage hub stores data in separate, addressed locations within the hub.",Blockstack Tech +storage provider,"A third-party company or software provider that hosts one or more Gaia storage hubs.",Blockstack Tech transaction,"A transaction is a unit of work within a block.",General Tech transaction fee,"Fees paid by participants in a transaction to miners.",Blockstack Tech two-sided market problem,Economic platforms having two distinct user groups that provide each other with network benefits. The Blockstack platform is a classic two-sided market., username,A shorthand name for your your id.blockstack.,Blockstack Tech virtual blockchain,A layer that sits on top of a blockchain that introduces new functionality and operations without requiring changes to the underlying blockchain,Blockstack Tech wallet address,A wallet address is the form in which a public key can be presented and recorded on a blockchain. Wallet addresses are therefore used to assign the ownership of digital assets on the Blockstack network.,Filing +watch-only wallet,A wallet without send and receive ability. You can view only balances and transaction history. Web of trust mining,"Web-of-trust mining provides incentive mechanisms for users where an initial trusted-set of unique users is curated in the genesis block and, in the future, the initial set of users can expand the web-of-trust after the network goes live. ", Zone file,"A Domain Name System (DNS) zone file is a text filethat describes a DNS zone. A DNS zone is a subset, often a single domain, of the hierarchical domain name structure of the DNS.",General Tech diff --git a/_data/navigation_usenew.yml b/_data/navigation_usenew.yml index 5fdf793f..963c2ad7 100644 --- a/_data/navigation_usenew.yml +++ b/_data/navigation_usenew.yml @@ -3,9 +3,10 @@ - browser/browser-introduction - browser/local_browser -- title: Identity +- title: Identity and storage - docs: - browser/ids-introduction + - browser/storage-provider - title: Reference - docs: diff --git a/_org/images/choose-hardware.png b/_org/images/choose-hardware.png new file mode 100644 index 00000000..f2b76ba3 Binary files /dev/null and b/_org/images/choose-hardware.png differ diff --git a/_org/images/confirm-send.png b/_org/images/confirm-send.png new file mode 100644 index 00000000..15a2da0a Binary files /dev/null and b/_org/images/confirm-send.png differ diff --git a/_org/images/device-check.png b/_org/images/device-check.png new file mode 100644 index 00000000..f607d8b6 Binary files /dev/null and b/_org/images/device-check.png differ diff --git a/_org/images/enter-address.png b/_org/images/enter-address.png new file mode 100644 index 00000000..29b5e1ce Binary files /dev/null and b/_org/images/enter-address.png differ diff --git a/_org/images/gas-up-cb.gif b/_org/images/gas-up-cb.gif new file mode 100644 index 00000000..9d2d2b1e Binary files /dev/null and b/_org/images/gas-up-cb.gif differ diff --git a/_org/images/hardware-balance.png b/_org/images/hardware-balance.png new file mode 100644 index 00000000..7f9bc2a2 Binary files /dev/null and b/_org/images/hardware-balance.png differ diff --git a/_org/images/mac-shasum.png b/_org/images/mac-shasum.png new file mode 100644 index 00000000..8e4acff5 Binary files /dev/null and b/_org/images/mac-shasum.png differ diff --git a/_org/images/mac-terminal.png b/_org/images/mac-terminal.png new file mode 100644 index 00000000..149729d3 Binary files /dev/null and b/_org/images/mac-terminal.png differ diff --git a/_org/images/not-enough.png b/_org/images/not-enough.png new file mode 100644 index 00000000..6a9d7abd Binary files /dev/null and b/_org/images/not-enough.png differ diff --git a/_org/images/pending.png b/_org/images/pending.png new file mode 100644 index 00000000..4fd8e87c Binary files /dev/null and b/_org/images/pending.png differ diff --git a/_org/images/receive-button.png b/_org/images/receive-button.png new file mode 100644 index 00000000..1615b441 Binary files /dev/null and b/_org/images/receive-button.png differ diff --git a/_org/images/receive-details.png b/_org/images/receive-details.png new file mode 100644 index 00000000..d6dd3ee2 Binary files /dev/null and b/_org/images/receive-details.png differ diff --git a/_org/images/sent.png b/_org/images/sent.png new file mode 100644 index 00000000..5d8b4999 Binary files /dev/null and b/_org/images/sent.png differ diff --git a/_org/images/settings.png b/_org/images/settings.png new file mode 100644 index 00000000..4e91791d Binary files /dev/null and b/_org/images/settings.png differ diff --git a/_org/images/software-balance.png b/_org/images/software-balance.png new file mode 100644 index 00000000..9be9955e Binary files /dev/null and b/_org/images/software-balance.png differ diff --git a/_org/images/sw-allocation.png b/_org/images/sw-allocation.png new file mode 100644 index 00000000..3057792a Binary files /dev/null and b/_org/images/sw-allocation.png differ diff --git a/_org/images/token-holder-balance.png b/_org/images/token-holder-balance.png new file mode 100644 index 00000000..ed085a79 Binary files /dev/null and b/_org/images/token-holder-balance.png differ diff --git a/_org/images/top-up.png b/_org/images/top-up.png new file mode 100644 index 00000000..c0dea1b5 Binary files /dev/null and b/_org/images/top-up.png differ diff --git a/_org/images/trezor-export.png b/_org/images/trezor-export.png new file mode 100644 index 00000000..26cafe3f Binary files /dev/null and b/_org/images/trezor-export.png differ diff --git a/_org/images/windows-certutil.png b/_org/images/windows-certutil.png new file mode 100644 index 00000000..227dcbd3 Binary files /dev/null and b/_org/images/windows-certutil.png differ diff --git a/_org/images/windows-cmd.png b/_org/images/windows-cmd.png new file mode 100644 index 00000000..37066a54 Binary files /dev/null and b/_org/images/windows-cmd.png differ diff --git a/_org/install.md b/_org/install.md deleted file mode 100644 index 9d6d8b80..00000000 --- a/_org/install.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -layout: org -permalink: /:collection/:path.html ---- -# Setup Stacks wallet - -You use the Stacks Wallet software to generate a unique address for storing your -Stacks tokens. This section teaches you how to install and verify your Stacks -token wallet and contains the following sections: - -Use this procedure if you are a Blockstack investor in the Blockstack Genesis -block. - -During you wallet download, 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, you should verify -your downloaded wallet software before you install it. Verification confirms -that you received the software signed by Blockstack PBC. - -## Do not lose your Stacks tokens - -When you create a wallet you receive a _seed phrase_. With one very important -exception, a seed phrase is similar to a banking pin in that it gives you -access to your wallet and the tokens it contains. The exception is, that if you -lose your seed phrase you can never access your wallet or the tokens it contains -ever again. - -{% include warning.html content="Losing a seed phrase is final and destructive. -Blockstack does not keep a copy of your seed. Blockstack cannot give you a new -seed, get your access to your wallet, or return your tokens if you lose your -seed phrase." %} - -Keep your seed phrase secret. Just as with a banking pin, anyone that knows or -steals your seed phrase can access your tokens. - -For this reason, you should keep your seed phrase safe. You should write your -seed phrase down and store it in at least two locations. A safe or lock box is a -good location. You can also store it online in a password manager. - -## Before you start - -You link your wallet with a Coinleist account. Before you begin, make sure that -you have [an account with CoinList](https://coinlist.co/register). You must -create this account yourself. - -## Mac OSX: Download, verify, and install on Mac OSX - -You use the command line terminal to confirm your download in Mac OSX. Perform this procedure after you dowanlod - - -1. Log into your Coinlist Account - -2. [Download the stacks ](https://blockstack.org/wallet/macos-stacks-wallet.dmg) - -3. From your Mac desktop, click on the magnifying glass in the top, right corner of your screen. - - ![Spotlight search launch](images/search-start.png) - - The Spotlight search bar appears. - -2. Enter terminal in the search field. - - ![Terminal](images/search-terminal.png) - -3. Select the **Terminal.app** to launch it. - -4. tbd. - -## Windows: Download, verify, and install - -TBD diff --git a/_org/tokenholders.md b/_org/tokenholders.md index 6967352b..b0267213 100644 --- a/_org/tokenholders.md +++ b/_org/tokenholders.md @@ -11,7 +11,7 @@ The information on this page is intended for **current Stacks token holders** du During your the initial grant process, you should have submitted a _public Stacks wallet address_ to Blockstack. The wallet address is a string of letters and numbers -starting with an 'SP' or SM', for example: `SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT` +starting with an `SP` or `SM`, for example: `SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT` If you purchased Stacks tokens through CoinList, you can find your address at [CoinList](https://coinlist.co/distributions). If you submitted your Stacks diff --git a/_org/wallet-hardware.md b/_org/wallet-hardware.md deleted file mode 100644 index bb238a8d..00000000 --- a/_org/wallet-hardware.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -layout: org -permalink: /:collection/:path.html ---- -# Setup Hardware wallet - -How you setup a hardware wallet depends on the hardware you use. - -* TOC -{:toc} - - -## Suggested wallet vendors - -Suspendisse cursus venenatis ligula a porta. Vestibulum -ultricies elit eget leo dapibus, nec pulvinar risus porttitor. Integer vitae -lectus at tellus consectetur sollicitudin. Ut cursus finibus feugiat. Sed purus -ipsum, viverra congue velit vel, finibus vestibulum orci. Aliquam vitae vehicula -nisl. Phasellus semper aliquet imperdiet. Vivamus feugiat leo quis metus -facilisis congue. Nullam vel lectus sit amet enim aliquet sagittis vitae euismod -risus. - -## Do not lose your Stacks tokens - -When you create a wallet you receive a _seed phrase_. With one very important -exception, a seed phrase is similar to a banking pin in that it gives you -access to your wallet and the tokens it contains. The exception is, that if you -lose your seed phrase you can never access your wallet or the tokens it contains -ever again. - -{% include warning.html content="Losing a seed phrase is final and destructive. -Blockstack does not keep a copy of your seed. Blockstack cannot give you a new -seed, get your access to your wallet, or return your tokens if you lose your -seed phrase." %} - -Keep your seed phrase secret. Just as with a banking pin, anyone that knows or -steals your seed phrase can access your tokens. - -For this reason, you should keep your seed phrase safe. You should write your -seed phrase down and store it in at least two locations. A safe or lock box is a -good location. You can also store it online in a password manager. - -## If you already have a Stacks wallet - -Suspendisse cursus venenatis ligula a porta. Vestibulum -ultricies elit eget leo dapibus, nec pulvinar risus porttitor. Integer vitae -lectus at tellus consectetur sollicitudin. Ut cursus finibus feugiat. Sed purus -ipsum, viverra congue velit vel, finibus vestibulum orci. Aliquam vitae vehicula -nisl. Phasellus semper aliquet imperdiet. Vivamus feugiat leo quis metus -facilisis congue. Nullam vel lectus sit amet enim aliquet sagittis vitae euismod -risus. diff --git a/_org/wallet-install.md b/_org/wallet-install.md index e50ae372..7b4382d1 100644 --- a/_org/wallet-install.md +++ b/_org/wallet-install.md @@ -3,101 +3,95 @@ layout: org permalink: /:collection/:path.html --- # Install the Stacks Wallet software -{:.no_toc} + You use the Stacks Wallet software client alone or with a hardware wallet to -manage your Stacks tokens. On this page, you learn how to install the Stacks -Software wallet. This page contains the following: +generate and manage the addresses for storing your Stacks token. On this page, +you learn how to install the Stacks Software wallet. This page contains the +following: * TOC {:toc} If you have already installed the latest Stacks wallet, see [Use the Stacks -Wallet software](wallet-use.html) in this documentation instead. - - -## Before you start +Wallet software](wallet-use.html) instead. -If Trezor, install Trezor bridge https://wallet.trezor.io/data/bridge/latest/index.html - -## Windows Installation +{% include warning.html content="During you wallet download, 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." %} -## Download and check the download +## Mac Installation -1. Select the download button this page. -2. Download the software which is packaged in a Zip file. +1. Select the **MacOS Download** button on this page. -## Verify the download was secure + This button downloads the software to your computer. -During you wallet download, 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, you should verify -your downloaded wallet software before you install it. Verification confirms -that you received the software signed by Blockstack PBC. +2. Open a terminal window. -1. Open command prompt. + To find the terminal software, enter `terminal` into the Spotlight search. - You can find it by typing command into the Start menu + ![](images/mac-terminal.png) -2. Change to the directory your wallet downloaded to by running cd +3. In the terminal window, enter the command to change directory to the folder where you downloaded the wallet software. - By default that’s /Downloads , so you can run cd Downloads + The default location is the **Downloads** folder, type the following into the terminal and press RETURN on your keyboard. -3. Run the Windows checksum utility by running: + ``` + cd ~/Downloads + ``` - certUtil -hashfile windows-stacks-wallet.exe SHA512 +4. In the terminal window, type the following Command -4. Verify that the resulting hash is the same as the latest hash published on on https://blockstack.org/wallet + ``` + shasum -a 512 macos-stacks-wallet.dmg + ``` + ![](images/mac-shasum.png) +5. Verify that the resulting hash (a string of letters and numbers) is the same as the latest hash published on on this page. -## Mac OSX Installation -## Download and check the download - -1. Select the download button this page. -2. Download the software which is packaged in a Zip file. -3. Unzip the zip file. ?Is it a zip - -## Verify and then start the wallet - -During you wallet download, 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, you should verify -your downloaded wallet software before you install it. Verification confirms -that you received the software signed by Blockstack PBC. +## Windows Installation -1. From your Mac desktop, click on the magnifying glass in the top, right corner of your screen. +1. Select the **Windows Download** button on this page. - ![Spotlight search launch](images/search-start.png) + This button downloads the software to your computer. - The Spotlight search bar appears. +2. Open a command prompt. -2. Enter terminal in the search field. + To find the command prompt software, enter `command` into the Start menu. - ![Terminal](images/search-terminal.png) + ![](images/windows-cmd.png) -3. Select the **Terminal.app** to launch it. -4. Change to the directory in Terminal to the directory your wallet downloaded to +3. In the command prompt window, enter the command to change directory to the folder where you downloaded the wallet software. - The default directory is usually `/Downloads` so type cd ~/Downloads and press return + The default location is the **Downloads** folder, type the following at the command prompt and press RETURN on your keyboard. -5. Run the checksum utility shasum by typing the following command and pressing return: + ``` + cd /Downloads + ``` - `shasum -a 512 macos-stacks-wallet.dmg` +4. In the command prompt window, type the following at the command prompt. -6. Verify that the resulting hash is the same as the latest hash published on on https://blockstack.org/wallet + ``` + certUtil -hashfile windows-stacks-wallet.exe SHA512 + ``` -7. Run the dmg + ![](images/windows-certutil.png) +5. Verify that the resulting hash (a string of letters and numbers) is the same as the latest hash published on on this page. -## Before you start +## Before you start using the Stacks Wallet software -You link your wallet with a Coinlist or other account with access to Bitcoin. Before you begin, make sure that -you have [an account with CoinList](https://coinlist.co/register). You must -create this account yourself. You use this account to load very small fractions -of Bitcoin to fuel your wallet transactions. +You fuel your wallet transactions with Bitcoin via a Coinlist or other account. +Before you begin, make sure that you have [an account with +CoinList](https://coinlist.co/register). You must create this account yourself. +You use this account to load very small fractions of Bitcoin to fuel your wallet +transactions. diff --git a/_org/wallet-use.md b/_org/wallet-use.md index ad2daaf4..88d201c7 100644 --- a/_org/wallet-use.md +++ b/_org/wallet-use.md @@ -2,40 +2,284 @@ layout: org permalink: /:collection/:path.html --- -# Use the Stacks wallet +# Use the Stacks Wallet software +{:.no_toc} -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas faucibus -cursus purus, fermentum consequat nisl consequat vel. +This page describes how to manage your Stacks using the Stacks Wallet software. +The Stacks Wallet software is installed on your computer. This page contains +the following topics: * TOC {:toc} +This page assumes you have already [downloaded, verified, and installed the +wallet software](wallet-install.html). -In non posuere velit. -Pellentesque rutrum molestie arcu ac rhoncus. Ut id pretium ligula. Mauris vel -quam ac nisl fringilla tincidunt. +## Use the Stacks Wallet with or without a hardware wallet -## View your stacks +You can use the Stacks Wallet software by itself or together with a hardware +wallet. When used by itself, the Stacks Wallet software acts as a _watch-only +wallet_. You can view STX balances and transaction history. -Suspendisse cursus venenatis ligula a porta. Vestibulum -ultricies elit eget leo dapibus, nec pulvinar risus porttitor. Integer vitae -lectus at tellus consectetur sollicitudin. Ut cursus finibus feugiat. Sed purus -ipsum, viverra congue velit vel, finibus vestibulum orci. Aliquam vitae vehicula -nisl. Phasellus semper aliquet imperdiet. Vivamus feugiat leo quis metus -facilisis congue. Nullam vel lectus sit amet enim aliquet sagittis vitae euismod -risus. +When you use the Stacks Wallet together with a hardware wallet, you can also +send and receive Stacks. To do this, you must first top up the wallet's "gas" which is +Bitcoin. A **_very small_** amount of Bitcoin is required to send Stacks. No +gas is required to receive Stacks. You can use any of these hardware wallets with the Stacks wallet: -## Receive stacks +* Trezor One +* Trezor Model T +* Ledger Nano S +* Ledger Blue -Suspendisse ipsum turpis, malesuada sit amet varius eget, auctor vitae lectus. -Maecenas sit amet tellus metus. Sed in condimentum mi. Nulla ac tincidunt leo. -Suspendisse lectus elit, facilisis non mollis eu, rhoncus vel augue. Ut tempus -vel felis sit amet viverra. Aenean eu congue orci. Morbi massa mauris, +Once connected, the Stacks Wallet only uses the hardware wallet when signing +send transactions. This means, you can connect to the hardware wallet when you +start the Stacks Wallet software. After starting, you can disconnect the +hardware wallet and put it away until you want to send Stacks. + +The **Reset** function is always available regardless of whether you are using a +hardware wallet as well. A reset returns the Wallet Software to its original +state. It does not change your Stacks balance or your hardware wallet in any +way. + + +## Open the wallet + +You can use the Stacks Wallet software with or without a hardware wallet. To +send Stacks, a hardware wallet is required. + +### Stacks Wallet software only + +You need at least on Stacks Address to create a wallet. A Stacks address is a +unique string of letters and numbers, for example: +`SM7KJBA4UZ7Z20KD2HBXNSXVPCR1D7CRAV605MKT`. + +1. Double-click on the wallet software to open it. +2. Select **Use a Stacks Address**. + + The system asks you to enter an adddres. If you are a token holder, you + should have generated several Stacks address during your the initial grant + process. You can provide one of these addresses to the Stacks wallet when you + start it. + + ![](images/enter-address.png) + +3. Select **Continue**. + + The system displays the balance for that address. + + +### Hardware wallet + +It is a good idea to connect your hardware wallet to your computer before +starting the Stacks wallet software, but it is not required. 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 | +| Trezor Model T | Trezor Bridge | +| Ledger Nano S | None. | +| Ledger Blue | None. | + +Make sure you have installed any prerequisite software. Then, do the following to start the Stacks Wallet with a Hardware wallet: + +1. Connect your hardware wallet to your computer as you normally would. +2. Double-click on the wallet software to open it. +3. Select **Use a Hardware Wallet**. +4. 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. + +5. Connect your wallet to your computer and choose **Continue**. + + The system prompts you to export a public key. + + ![](images/trezor-export.png) + +6. Select **Export**. + + The Stacks Wallet shows the current wallet balance. + + + +## View Balance, Allocation, and transaction history + +The default view for an open and loaded wallet is the **Wallet Balance** view. + +![](images/hardware-balance.png) + +If you have started with a hardware wallet, your view includes **Send** and +**Receive** buttons. If you open the same address in a watch-only wallet, you do +not see these buttons: + +![](images/software-balance.png) + +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 will have a balance. If you are a Stacks token holder, your +address shows with both a **Balance** and **Allocation**. The **Balance** is the +Stackes you have unlocked. The **Allocation** is the amount still locked up. + +![](images/token-holder-balance.png) + + +## Receive Stacks + +To receive Stack you pass a STX address directly to a user via email, for +example. If your Stackes Wallet is connected to a hardware wallet, click the **Receive** button to +display an address where others can send Stacks to. + +![](images/receive-button.png) + +A stack address is a public addresses. Anyone with the address, can view the +address balance or send money _**to**_ the address. + +{% include note.html content="Sending money from a +Stacks address requires the private key. It is this private key together with +your seed phrase that you should keep private and maintain with high security." +%} + +Blockchain transactions take take time. There may be minutes or hours while the +transaction is recorded in the blockchain. When the transaction is complete, you +can see a receipt for the transaction in Software Wallet in watch-only mode or +connected to a hardware wallet. + + +## 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. + +Reseting 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) + + The **Top Up** button is only visible when you have connected the Stacks + Wallet to a hardware wallet. + +2. Select **Reset Wallet**. + + System asks for confirmation. If, for some reason, you want to stop the reset + you would press (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**. ## Send stacks -ullamcorper ac odio nec, mattis auctor turpis. Sed rhoncus viverra elit. In hac -habitasse platea dictumst. Vivamus eget mauris nec odio fringilla facilisis. -Cras id ligula at eros cursus varius. Quisque semper nulla ut lobortis -consequat. Aliquam hendrerit a neque id tempor. Sed porta id ligula in iaculis. +You can only send Stacks if you have connected your Stacks wallet to a hardware +wallet. The Stacks Wallet software uses the hardware wallet to sign your send +transactions. + +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. + +3. Complete the dialog with the transaction information. + + + | **Recipient** | A Stacks address. | + | **Amount to Send** | Enter a value. | + | **Note** | A memo for the transaction. | + +4. 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) + +4. Select **Continue**. + + The Stacks Wallet displays a confirmation dialog. + + ![](images/confirm-send.png) + +5. Select **Confirm** to complete your transaction. + + ![](images/sent.png) + +6. Select **Close**. + + The send transaction appears in your **Transaction History**. Blockchain + transactions can take minutes or hours to complete. Transactions that have + not cleared yet show as **PENDING**. + + ![](images/pending.png) + + Select **Refresh** if you don't immediately see the transaction in your + history. + +## Top up Bitcoin gas + +{% include warning.html content="Very small amounts of Bitcoin are all you need +to fuel transactions. Never send an entire coin to your Stacks Wallet. Amounts +such as .0002 BTC are plenty." %} + +The Stacks Software wallet uses very small amounts of Bitcoin to pay fees for +transactions. You can only receive Bitcoin with the wallet, you cannot send it +from the Stacks Wallet. You need an account with Coinbase or similar exchange to +buy Bitcoin or send it. + +If you attempt to send Stacks 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 **Top up**. + + The systems displays the **Top Up** dialog with a Bitcoin address. + +3. Record the 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 +transaction history also shows any Bitcoin sent to your wallet.