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. 94
      _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
docs:
- org/wallet-intro
- org/wallet-install
- org/wallet-use
- org/tokenholders
- org/voucherholder
- title: Whitepapers
@ -14,5 +16,6 @@
- org/whitepaper-token
- title: Reference
docs:
- org/secureref
- org/faq
- org/terms

1
_data/navigation_usenew.yml

@ -10,4 +10,5 @@
- title: Reference
- docs:
- browser/secureref
- 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>.
## 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.
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.
### Hardware wallet
If you have a paper wallet or a custodial wallet, you should setup. You can use
any of these hardware wallets with the Stacks wallet:
* <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
[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
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.

94
_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
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
wallet to its original state.
{% 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>." %}
* 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.
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 Bitcoin.
Reseting the wallet does nothing to your addresses or their associated balances.
They are maintained.
If you attempt to send Stacks with your wallet and you do not have enough
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
you do not restart the wallet, you can simple close it.
![](images/not-enough.png)
To increase your Bitcoin for transactions, do the following:
1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span>
(settings icon) in the upper right corner of the wallet.
1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span>
(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
Wallet to a hardware wallet.
This dialog shows you how much BTC you currently have in your account.
2. Select **Reset Wallet**.
2. Select **Top up**.
System asks for confirmation. If, for some reason, you want to stop the reset
you would press <span class="uk-margin-small-center" uk-icon="close"></span> (right corner) or **Close**.
The systems displays the **Top Up** dialog with a Bitcoin address.
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
again or choose **Quit**.
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.
## Send stacks
@ -243,43 +249,39 @@ transactions.
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. <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
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.
## Reset the wallet
If you attempt to send Stacks with your wallet and you do not have enough
Bitcoin to fuel the transaction, you see this dialog:
Resetting a wallet clears all your data from the Stacks wallet and returns the
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>
(settings icon) in the upper right corner of the wallet.
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.
The system opens the **Settings** dialog.
![](images/settings.png)
1. Click the <span class="uk-margin-small-center" uk-icon="cog"></span>
(settings icon) in the upper right corner of the wallet.
This dialog shows you how much BTC you currently have in your account.
The system opens the **Settings** dialog.
2. Select **Top up**.
![](images/settings.png)
The systems displays the **Top Up** dialog with a Bitcoin address.
The **Top Up** button is only visible when you have connected the Stacks
Wallet to a hardware wallet.
3. Record the address.
2. Select **Reset Wallet**.
4. Go to your Coinbase or similar account.
5. Send Bitcoin to the address presented by the Stacks Wallet.
System asks for confirmation. If, for some reason, you want to stop the reset
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
transaction history also shows any Bitcoin sent to your wallet.
The wallet displays the **Terms of Use**. You can accept to enter the wallet
again or choose **Quit**.

Loading…
Cancel
Save