Browse Source

Adding in the new wallet Fixes #69, Fixes #68, Fixes #70 (#76)

Adding in the review commentary
Fixes #75 adding security reference
Removing Coinlist as a bTC holder

Signed-off-by: Mary Anthony <mary@blockstack.com>
feat/clarity-updates
Moxiegirl 6 years ago
committed by GitHub
parent
commit
37007fae7c
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 7
      _browser/secureref.md
  2. 3
      _data/navigation_org.yml
  3. 1
      _data/navigation_usenew.yml
  4. 86
      _includes/keyphrase.md
  5. BIN
      _org/images/private.png
  6. BIN
      _org/images/qr-code.png
  7. 7
      _org/secureref.md
  8. 30
      _org/wallet-install.md
  9. 14
      _org/wallet-intro.md
  10. 86
      _org/wallet-use.md

7
_browser/secureref.md

@ -0,0 +1,7 @@
---
layout: usenew
permalink: /:collection/:path.html
---
# Phrase and Key Security
{% include keyphrase.md %}

3
_data/navigation_org.yml

@ -6,6 +6,8 @@
- title: Manage Stacks - title: Manage Stacks
docs: docs:
- org/wallet-intro - org/wallet-intro
- org/wallet-install
- org/wallet-use
- org/tokenholders - org/tokenholders
- org/voucherholder - org/voucherholder
- title: Whitepapers - title: Whitepapers
@ -14,5 +16,6 @@
- org/whitepaper-token - org/whitepaper-token
- title: Reference - title: Reference
docs: docs:
- org/secureref
- org/faq - org/faq
- org/terms - org/terms

1
_data/navigation_usenew.yml

@ -10,4 +10,5 @@
- title: Reference - title: Reference
- docs: - docs:
- browser/secureref
- browser/faq_general - browser/faq_general

86
_includes/keyphrase.md

@ -0,0 +1,86 @@
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`).
<table class="uk-table-small uk-table-striped uk-text-small">
<tr valign="top">
<th class="uk-width-large">Phrase/Key/Value</th>
<th>Security</th>
<th class="uk-width-medium">Description</th>
</tr>
<tr valign="top">
<td>
<p>Secret Recovery Key</p>
<p>12 word seed phrase</p>
<p>24 word seed phrase</p>
</td>
<td><p>PROTECT</p></td>
<td>
<p>A 12 or 24 sequence of words for example:</p>
<p><code>applied binge crisp pictorial fiery</code>
</p><p><code> dancing agreeable frogs light finish ping apple</code></p>
</td>
</tr>
<tr valign="top">
<td>
<p>Identity</p>
<p>Blockstack identity</p>
<p>Blockstack ID</p>
</td>
<td><p>SHAREABLE</p></td>
<td>
<p>A username, Both <code>moxiegirl.id.blockstack</code> or <code>chad.id</code> are examples of IDs.</p>
</td>
</tr>
<tr valign="top">
<td>Magic Recovery Code</td>
<td><p>PROTECT</p></td>
<td><p>An long encrypted string, for example:</p>
<p> <code>36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++lH=0EI7c3mop2JuRBm5WXxSTazJsUjOA...</code></p>
<p>Do not share the QR code that accompanied your code either. This is a QR code:</p>
<img src="/org/images/qr-code.png"/>
</td>
</tr>
<tr valign="top">
<td>Blockstack Owner Address</td>
<td><p>SHAREABLE</p></td>
<td><p>Looks like a bitcoin address but starts with <code>ID</code> for example:</p>
<p><code>ID-1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs</code></p>
</td>
</tr>
<tr valign="top">
<td>Bitcoin address
BTC Address
</td>
<td><p>SHAREABLE</p></td>
<td><p>A string of letters and numbers.</p>
<p><code>3E53XjqK4Cxt71BGeP2VhpcotM8LZ853C8</code></p>
<p>Sharing this address allows anyone to send Bitcoin to the address.</p>
</td>
</tr>
<tr valign="top">
<td><p>Stacks Address</p>
<p>Stacks Wallet Address</p>
<p>STX address</p>
</td>
<td><p>SHAREABLE</p></td>
<td><p>A string of letters and numbers starting with an <code>SP</code> or <code>SM</code></p>
<code>SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT</code>
<p>Sharing this allows anyone to send Stacks to the address, view the address balances, and view the address allocations.</p>
</td>
</tr>
<tr valign="top">
<td>public key</td>
<td><p>SHAREABLE</p></td>
<td><p>Public and private key pair comprise of two uniquely related cryptographic keys. It looks like a long random string of letters and numbers:</p>
<p><code>3048 0241 00C9 18FA CF8D EB2D EFD5 FD37 89B9 E069 EA97 FC20 …</code></p>
<p>The exact format of the public and private key depend on the software you use to create them.</p>
</td>
</tr>
<tr valign="top">
<td>private key</td>
<td></td>
<td><p>Private keys matches a corresponding public key. A public key also looks like a string of letters and numbers:</p>
<img src="/org/images/private.png"/>
<p>The exact format of the public and private key depend on the software you use to create them.</p>
</td>
</tr>
</table>

BIN
_org/images/private.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

BIN
_org/images/qr-code.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

7
_org/secureref.md

@ -0,0 +1,7 @@
---
layout: org
permalink: /:collection/:path.html
---
# Phrase and Key Security
{% include keyphrase.md %}

30
_org/wallet-install.md

@ -87,11 +87,29 @@ by Blockstack PBC." %}
5. Verify that the resulting hash (a string of letters and numbers) is the same as the latest hash published on <a href="https://blockstack.org/wallet/" target="\_blank">on this page</a>. 5. Verify that the resulting hash (a string of letters and numbers) is the same as the latest hash published on <a href="https://blockstack.org/wallet/" target="\_blank">on this page</a>.
## Additional software requirements
## Before you start using the Stacks Wallet software If you wish to use the Stacks Wallet software to send and receive Stacks, you
need to ensure you also have a hardware wallet and a Bitcoin account.
You fuel your wallet transactions with Bitcoin via a Coinlist or other account. ### Hardware wallet
Before you begin, make sure that you have [an account with
CoinList](https://coinlist.co/register). You must create this account yourself. If you have a paper wallet or a custodial wallet, you should setup. You can use
You use this account to load very small fractions of Bitcoin to fuel your wallet any of these hardware wallets with the Stacks wallet:
transactions.
* <a href="https://trezor.io/" target="\_blank">Trezor</a> One
* Trezor Model T
* <a href="https://www.ledger.com/" target="\_blank">Ledger</a> Nano S
* Ledger Bluea hardware wallet.
For information on setting up a hardware wallet, refer to the vendor's
documentation. We cannot help you set up your hardware wallet.
### Bitcoin account for fuel
You fuel your Stacks wallet transactions with very small fractions of Bitcoin.
For example, .00025 Bitcoin can fuel several transactions. You can acquire this
Bitcoin and send it to the Stacks Wallet via a Coinbase or other Bitcoin
account. Before you begin, make sure that you have such an account. You must
create this account yourself.

14
_org/wallet-intro.md

@ -81,6 +81,18 @@ hardware offers another level of security that software wallets don’t have.
Blockstack suggests that you use a hardware wallet such as Blockstack suggests that you use a hardware wallet such as
[Trezor](https://trezor.io/) or [Ledger](https://www.ledger.com/). [Trezor](https://trezor.io/) or [Ledger](https://www.ledger.com/).
## Multiple wallets
Of course, you need not use a software or hardware wallet exclusively, you can Of course, you need not use a software or hardware wallet exclusively, you can
use multiple wallets choosing whichever works best for you at a specific time. use multiple wallets choosing whichever works best for you at a specific time.
You'll just need to transform tokens to whichever wallet you want to move.
For example, the Stacks Wallet is a software wallet. It operates with and
without a link to a hardware wallet. With a link to a hardware wallet, you can
use the Stacks wallet to send and receive Stacks. When used without a hardware
wallet link, the Stacks wallet is in _watch-only_ mode. This means the wallet
cannot send or receive Stacks. You can view only balances and transaction
history.
In some cases, you may need to transfer Stacks to or reference token address in whichever
wallet you want to move. Consult the documentation for your wallets for more
information.

86
_org/wallet-use.md

@ -154,42 +154,48 @@ 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 can see a receipt for the transaction in Software Wallet in watch-only mode or
connected to a hardware wallet. connected to a hardware wallet.
## Top up Bitcoin gas
## Reset the wallet You require very small fractiosn of Bitcoin (.00001) to send Stacks with the wallet.
Resetting a wallet clears all your data from the Stacks wallet and returns the {% include warning.html content="Very small amounts of Bitcoin are all you need
wallet to its original state. to fuel transactions. <b>Never send an entire coin to your Stacks Wallet. Amounts
such as .0002 BTC are plenty</b>." %}
* If you entered a Stacks address, resetting clears the address from the Stacks wallet. The Stacks Software wallet uses very small amounts of Bitcoin to pay fees for
* If you connected to a hardware wallet, resetting removes the connection to the hardware wallet. 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 Bitcoin.
Reseting the wallet does nothing to your addresses or their associated balances. If you attempt to send Stacks with your wallet and you do not have enough
They are maintained. Bitcoin to fuel the transaction, you see this dialog:
Once you reset the wallet, you have to start over from the *Terms of Use*. If ![](images/not-enough.png)
you do not restart the wallet, you can simple close it.
To increase your Bitcoin for transactions, do the following:
1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span> 1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span>
(settings icon) in the upper right corner of the wallet. (settings icon) in the upper right corner of the wallet.
The system opens the **Settings** dialog. The system opens the **Settings** dialog.
![](images/settings.png) ![](images/settings.png)
The **Top Up** button is only visible when you have connected the Stacks This dialog shows you how much BTC you currently have in your account.
Wallet to a hardware wallet.
2. Select **Reset Wallet**. 2. Select **Top up**.
System asks for confirmation. If, for some reason, you want to stop the reset The systems displays the **Top Up** dialog with a Bitcoin address.
you would press <span class="uk-margin-small-center" uk-icon="close"></span> (right corner) or **Close**.
3. Select **Are you sure?** to complete the reset. 3. Record the address.
The wallet displays the **Terms of Use**. You can accept to enter the wallet 4. Go to your Coinbase or similar account.
again or choose **Quit**. 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.
## Send stacks ## Send stacks
@ -243,43 +249,39 @@ transactions.
Select **Refresh** if you don't immediately see the transaction in your Select **Refresh** if you don't immediately see the transaction in your
history. history.
## Top up Bitcoin gas
{% include warning.html content="Very small amounts of Bitcoin are all you need
to fuel transactions. <b>Never send an entire coin to your Stacks Wallet. Amounts
such as .0002 BTC are plenty</b>." %}
The Stacks Software wallet uses very small amounts of Bitcoin to pay fees for ## Reset the wallet
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 Resetting a wallet clears all your data from the Stacks wallet and returns the
Bitcoin to fuel the transaction, you see this dialog: wallet to its original state.
![](images/not-enough.png) * 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.
To increase your Bitcoin for transactions, do the following: Reseting the wallet does nothing to your addresses or their associated balances.
They are maintained.
1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span> 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 <span class="uk-margin-small-center" uk-icon="cog"></span>
(settings icon) in the upper right corner of the wallet. (settings icon) in the upper right corner of the wallet.
The system opens the **Settings** dialog. The system opens the **Settings** dialog.
![](images/settings.png) ![](images/settings.png)
This dialog shows you how much BTC you currently have in your account. The **Top Up** button is only visible when you have connected the Stacks
Wallet to a hardware wallet.
2. Select **Top up**.
The systems displays the **Top Up** dialog with a Bitcoin address.
3. Record the address. 2. Select **Reset Wallet**.
4. Go to your Coinbase or similar account. System asks for confirmation. If, for some reason, you want to stop the reset
5. Send Bitcoin to the address presented by the Stacks Wallet. you would press <span class="uk-margin-small-center" uk-icon="close"></span> (right corner) or **Close**.
![](images/gas-up-cb.gif) 3. Select **Are you sure?** to complete the reset.
Review your Stacks Wallet settings to see the increase in your balance. Your The wallet displays the **Terms of Use**. You can accept to enter the wallet
transaction history also shows any Bitcoin sent to your wallet. again or choose **Quit**.

Loading…
Cancel
Save