diff --git a/_browser/secureref.md b/_browser/secureref.md new file mode 100644 index 00000000..5ae30418 --- /dev/null +++ b/_browser/secureref.md @@ -0,0 +1,7 @@ +--- +layout: usenew +permalink: /:collection/:path.html +--- +# Phrase and Key Security + +{% include keyphrase.md %} diff --git a/_data/navigation_org.yml b/_data/navigation_org.yml index 3cf4d03a..dfbabcc7 100644 --- a/_data/navigation_org.yml +++ b/_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 diff --git a/_data/navigation_usenew.yml b/_data/navigation_usenew.yml index 963c2ad7..e9ad5817 100644 --- a/_data/navigation_usenew.yml +++ b/_data/navigation_usenew.yml @@ -10,4 +10,5 @@ - title: Reference - docs: + - browser/secureref - browser/faq_general diff --git a/_includes/keyphrase.md b/_includes/keyphrase.md new file mode 100644 index 00000000..9102aaf5 --- /dev/null +++ b/_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`). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Phrase/Key/ValueSecurityDescription
+

Secret Recovery Key

+

12 word seed phrase

+

24 word seed phrase

+

PROTECT

 +

A 12 or 24 sequence of words for example:

+

applied binge crisp pictorial fiery +

dancing agreeable frogs light finish ping apple

+
+

Identity

+

Blockstack identity

+

Blockstack ID

+

SHAREABLE

 +

A username, Both moxiegirl.id.blockstack or chad.id are examples of IDs.

+
Magic Recovery Code

PROTECT

An long encrypted string, for example:

+

36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++lH=0EI7c3mop2JuRBm5WXxSTazJsUjOA...

+

Do not share the QR code that accompanied your code either. This is a QR code:

+ +
Blockstack Owner Address

SHAREABLE

Looks like a bitcoin address but starts with ID for example:

+

ID-1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs

+
Bitcoin address + BTC Address +

SHAREABLE

A string of letters and numbers.

+

3E53XjqK4Cxt71BGeP2VhpcotM8LZ853C8

+

Sharing this address allows anyone to send Bitcoin to the address.

+

Stacks Address

+

Stacks Wallet Address

+

STX address

+

SHAREABLE

A string of letters and numbers starting with an SP or SM

+ SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT +

Sharing this allows anyone to send Stacks to the address, view the address balances, and view the address allocations.

+
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:

+

3048 0241 00C9 18FA CF8D EB2D EFD5 FD37 89B9 E069 EA97 FC20 …

+

The exact format of the public and private key depend on the software you use to create them.

+
private key

Private keys matches a corresponding public key. A public key also looks like a string of letters and numbers:

+ +

The exact format of the public and private key depend on the software you use to create them.

+
diff --git a/_org/images/private.png b/_org/images/private.png new file mode 100644 index 00000000..0ebbd2e4 Binary files /dev/null and b/_org/images/private.png differ diff --git a/_org/images/qr-code.png b/_org/images/qr-code.png new file mode 100644 index 00000000..4024d08e Binary files /dev/null and b/_org/images/qr-code.png differ diff --git a/_org/secureref.md b/_org/secureref.md new file mode 100644 index 00000000..89a8bd56 --- /dev/null +++ b/_org/secureref.md @@ -0,0 +1,7 @@ +--- +layout: org +permalink: /:collection/:path.html +--- +# Phrase and Key Security + +{% include keyphrase.md %} diff --git a/_org/wallet-install.md b/_org/wallet-install.md index 7b4382d1..caed6fef 100644 --- a/_org/wallet-install.md +++ b/_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 on this page. +## 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: + +* Trezor One +* Trezor Model T +* Ledger 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. diff --git a/_org/wallet-intro.md b/_org/wallet-intro.md index 7ddecc3d..bb833080 100644 --- a/_org/wallet-intro.md +++ b/_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. diff --git a/_org/wallet-use.md b/_org/wallet-use.md index 88d201c7..0a921a07 100644 --- a/_org/wallet-use.md +++ b/_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. Never send an entire coin to your Stacks Wallet. Amounts +such as .0002 BTC are plenty." %} -* 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 - (settings icon) in the upper right corner of the wallet. + 1. Click the + (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 (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. 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. +## 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 - (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 + (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 (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**.