Browse Source

- Updating with the newest UX language

- Modifying emphasis > <em>
- Style updates to em and code
- Adding wallet security page
- Adding new screen caps

Signed-off-by: Mary Anthony <mary@blockstack.com>
feat/clarity-updates
Mary Anthony 6 years ago
parent
commit
d8bcd7cd84
  1. 122
      _data/glossary.csv
  2. 10
      _data/theFAQs.json
  3. 2
      _develop/communityResources.md
  4. 51
      _includes/keyphrase.md
  5. BIN
      _org/images/pending.png
  6. BIN
      _org/images/receive-button.png
  7. BIN
      _org/images/settings.png
  8. BIN
      _org/images/top-up.png
  9. 22
      _org/secureref.md
  10. 2
      _org/token.md
  11. 18
      _org/tokenholders.md
  12. 38
      _org/wallet-install.md
  13. 50
      _org/wallet-intro.md
  14. 230
      _org/wallet-use.md
  15. 3
      _sass/theme/variables.scss
  16. 2
      _storage/amazon-s3-deploy.md
  17. 2
      _storage/digital-ocean-deploy.md
  18. 3
      assets/css/main.scss

122
_data/glossary.csv

@ -1,60 +1,66 @@
Term,Definition,Areas
App Review,An incentive mechanism for application developers in the early stage (first four years) of the ecosystem and helps with bootstrapping the two-sided market.,
App Mining,"​​A system where the Blockstack community funds decentralized app teams.",
association token,"A whitelisted key used in a Gaia Storage system.",Blockstack Tech
Atlas,A peer network provide a global index for discovery,Blockstack Tech
Term,Definition
App Mining,​​A system where the Blockstack community funds decentralized app teams.
App Review,An incentive mechanism for application developers in the early stage (first four years) of the ecosystem and helps with bootstrapping the two-sided market.
Atlas,A peer network provide a global index for discovery
Bitcoin (BTC) address,<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>
block,"A discrete group of records written to a blockchain that can effectively be identified and referenced by the
use of headers that contain a digital fingerprint of the records each block contains.",Filing
blockchain,A database created and shared by the members of a peer-to-peer computer network which each member of that network can independently trust due to the rules governing the database’s creation. A blockchain can therefore be used to replace centralized databases.,Filing
Blockchain Name System (BNS),Replacement for DNS.,Blockstack Tech
blockstack browser,An application for accessing identity and storage.,Blockstack Tech
Blockstack Core,"A complete version of our open-source software available on Github at https://github.com/blockstack/blockstack-core/ that governs the creation of the blockchain, the smart contracts that may be written to our blockchain, and other systems that make up the Blockstack network, when run on the systems and devices of our users and developers.",Filing
blockstack id,See id.blockstack,
Burning,Burning a token means that the token is transferred to an address that is a black hole—one that is not owned by any entity and for which guessing the applicable private key is effectively impossible based on known mathematical principles. This effectively destroys the token by making it unavailable for future use and decreases the total number of tokens available from that point forward.,Filing
consensus hash,"A consensus hash is a cryptographic hash that each node calculates at each block. It is derived from the accepted state transitions in the last-processed block, and a geometric series of prior-calculated consensus hashes.
",General Tech
Consensus rules,"The rules governing the creation of new valid records in a blockchain database, and the mining algorithms used for this purpose.",Filing
control plane ,The part of a network that carries signaling traffic and is responsible for routing. Control packets originate from or are destined for a router. Functions of the control plane include system configuration and management.,General Tech
core node,A server that runs Blockstack Core services.,Filing
crypto-asset,"A digital asset which utilises cryptography, peer-to-peer networking, and a public ledger to regulate the creation of new units, verify transactions, and secure the transactions without the intervention of any middleman.",Filing
cryptography,"The practise and study of encryption and decryption - encoding data so that it can only be decoded by specific individuals. A system for encrypting and decrypting data is a cryptosystem.",General Tech
decentralized application (DApp),"A DApp is a service that enables direct interaction between end users and providers (e.g. connecting buyers and sellers in some marketplace, owners and stores in file storage). A term coined by Ethereum. See their glossary: http://ethdocs.org/en/latest/glossary.html",Blockchain general
digital asset,"Also referred to as a crypto-asset. Any set of unique digital information—including, for example, programs, decentralized programs, isolated chunks of programming code, collections of data, e-mail or web addresses or cryptocurrency tokens—that is capable of being stored and uniquely tracked on a computer network such as the Blockstack network and over which a user can maintain control through that network.",Filing
digital fingerprint,"A digital fingerprint is a unique number of a fixed length that can be produced by running any set of digital information through something called a cryptographic hash function. Each set of digital information (including a digital asset, and the digital record of any network operation on that digital asset) should (as a practical matter) have a unique digital fingerprint, which allows that set of digital information to be identified. However, it is almost impossible to recreate a digital asset from its digital fingerprint. The Blockstack network uses industry-standard algorithms such as SHA-256 to create digital fingerprints.",Filing
digital signature,"A digital signature is a sequence of digital information combining a user’s private key and any digital information that the user wishes to sign. Any other party can use the user’s paired public key to verify that the digital signature is authentic, i.e. that the public key was generated from a particular piece of digital information and the user’s private key.",Filing
distributed hash tables (DHT),"A form of network used to store some content in the form of key/value pairs. ... This experimental project try to avoid keeping all the blockchain, but instead prefers to store it in a DHT.",General Tech
ephemeral key,A cryptographic key is called ephemeral if it is generated for each execution of a key establishment process.,
fork,"The term fork is used to refer both to any situation where there are two or more competing versions of a blockchain on a network (a situation that may arise and resolve itself in the ordinary course of network operations due to lags in communication between core nodes) and any software update that is proposed for adoption by the core nodes of a blockchain network that may result in a persistent fork on the network, with core nodes that adopt the update recognizing one version of the blockchain and those which do not recognizing another.",Filing
Gaia,Decentralized storage ,Blockstack Tech
genesis block,"The genesis block is the first block of the Stacks blockchain, which will create the initial 1.32 billion Stacks tokens.",Filing
id.blockstack,"An identifier in the Blockstack, for example moxiegirl.id.blockstack. This is your name & identity that is registered in the .id namespace on Blockstack. Your personal data and storage are built around this ID. Apps that want to access your data use your permission and identity to find it. An id is usually a shorthand for a longer, hash ID string, for example ID-1Fj9kkw15P51Fj9kkw15P5xJmyefWhLKrQMKNPREfaqsJ
",Blockstack Tech
identity management (IDM),"Identity management, also known as identity and access management is, in computer security, the security and business discipline that enables the right individuals to access the right resources at the right times and for the right reason",General Tech
know your customer (KYC),"Or KYC, is a popular term used in the banking or financial field. KYC is a process where financial institutions, insurers and other companies obtain information about the identity and address of the customers as part of risk management.",
KYC,See know your customer,
light clients,"Clients that can independently validate the existence of transactions by downloading only block headers and not the entire blockchain.",
mesh network,"A local network topology in which the infrastructure nodes (i.e. bridges, switches, and other infrastructure devices) connect directly, dynamically and non-hierarchically to as many other nodes as possible and cooperate with one another to efficiently route data from/to clients.",General Tech
mining,"Mining generally refers to the process of performing certain functions for a network such as adding new records to a blockchain in exchange for mining rewards; it may also refer to other mechanisms whereby rewards (usually in the form of cryptocurrency) are provided for performing other tasks helpful to the network.",Filing
mining power,"A miner’s (or group of miners’) mining power is equal to the probability it will be selected to write a new block to the blockchain. Depending on the mechanism for mining, this is usually related to the overall share of computing power or cryptoassets the miner or miners possess relative to all miners for that blockchain.",Filing
mining rewards,Mining rewards are newly issued tokens received by miners in exchange for adding new records to the blockchain or other activities beneficial to the network.,Filing
name,"An identifier or name. Names are a type of digital asset in the Blockstack network. If you have signed into the Blockstack Browser, you created a name. If an application developer registered an application within Blockstack, then they registered a name.",General
network operation,"A network operation is any change to the information about a digital asset (or smart contract) stored on a blockchain, including, for example, a change in the digital asset’s owner, or a change in the location at which it is stored on the network. How and when these network operations are performed for each digital asset is governed, on the Blockstack network, either by the Blockstack Core software or a smart contract.",Filing
Public Key Infrastructure (PKI),A system which returns a cryptographic public key associated with a name.,General Tech
private key,"A private key is a very large random sequence of digital information (effectively a very long password) that should be known only by a single user of the network and cannot be plausibly guessed by a third party in a reasonable amount of time. A user generates this large random sequence locally on a computer and should never share it with anyone. Each private key has a paired sequence of digital information, called a public key, which a user can share publicly.",Filing
proof-of-burn mining,"The consensus algorithm used in the Stacks blockchain where miners destroy a proof-of-work-based cryptocurrency (currently Bitcoin) to get tokens; this enables the functionality where nodes can select between conflicting blockchain forks, as the blockchain fork with the most amount of cryptocurrency burned is considered to be the correct fork.",
proof-of-work,"A proof-of-work system or proof-of-work mining is a mining mechanism where miners must expend computing power to solve complicated cryptographic puzzles, and prove that they have done so by writing the solution to the blockchain, in order to be allowed to add blocks to a blockchain. This is the mining system used, for example, by Bitcoin.",Filing
replicated state machines (RSMs),"This is a model for reasoning about distributed computer programs -- any program (plus it's input) can be represented as a state machine, and when trying to get a distributed set of servers to agree on the output of an algorithm, you can model that process as N different state machines",General Tech
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 hub provider or software. A Gaia hub stores data in separate, addressed location.",Blockstack Tech
storage provider,"A third-party company cloud 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
use of headers that contain a digital fingerprint of the records each block contains."
blockchain,A database created and shared by the members of a peer-to-peer computer network which each member of that network can independently trust due to the rules governing the database’s creation. A blockchain can therefore be used to replace centralized databases.
Blockchain Name System (BNS),Replacement for DNS.
blockstack browser,An application for accessing identity and storage.
Blockstack Core,"A complete version of our open-source software available on Github at https://github.com/blockstack/blockstack-core/ that governs the creation of the blockchain, the smart contracts that may be written to our blockchain, and other systems that make up the Blockstack network, when run on the systems and devices of our users and developers."
blockstack id,See id.blockstack
Blockstack Owner Address,<p>Looks like a bitcoin address but starts with <code>ID</code> for example:</p> <p><code>ID-1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs</code></p>
Burning,Burning a token means that the token is transferred to an address that is a black hole—one that is not owned by any entity and for which guessing the applicable private key is effectively impossible based on known mathematical principles. This effectively destroys the token by making it unavailable for future use and decreases the total number of tokens available from that point forward.
consensus hash,"A consensus hash is a cryptographic hash that each node calculates at each block. It is derived from the accepted state transitions in the last-processed block, and a geometric series of prior-calculated consensus hashes."
Consensus rules,"The rules governing the creation of new valid records in a blockchain database, and the mining algorithms used for this purpose."
control plane,The part of a network that carries signaling traffic and is responsible for routing. Control packets originate from or are destined for a router. Functions of the control plane include system configuration and management.
core node,A server that runs Blockstack Core services.
crypto-asset,"A digital asset which utilises cryptography, peer-to-peer networking, and a public ledger to regulate the creation of new units, verify transactions, and secure the transactions without the intervention of any middleman."
cryptography,The practise and study of encryption and decryption - encoding data so that it can only be decoded by specific individuals. A system for encrypting and decrypting data is a cryptosystem.
decentralized application (DApp),"A DApp is a service that enables direct interaction between end users and providers (e.g. connecting buyers and sellers in some marketplace, owners and stores in file storage). A term coined by Ethereum. See their glossary: http://ethdocs.org/en/latest/glossary.html"
digital asset,"Also referred to as a crypto-asset. Any set of unique digital information—including, for example, programs, decentralized programs, isolated chunks of programming code, collections of data, e-mail or web addresses or cryptocurrency tokens—that is capable of being stored and uniquely tracked on a computer network such as the Blockstack network and over which a user can maintain control through that network."
digital fingerprint,"A digital fingerprint is a unique number of a fixed length that can be produced by running any set of digital information through something called a cryptographic hash function. Each set of digital information (including a digital asset, and the digital record of any network operation on that digital asset) should (as a practical matter) have a unique digital fingerprint, which allows that set of digital information to be identified. However, it is almost impossible to recreate a digital asset from its digital fingerprint. The Blockstack network uses industry-standard algorithms such as SHA-256 to create digital fingerprints."
digital signature,"A digital signature is a sequence of digital information combining a user’s private key and any digital information that the user wishes to sign. Any other party can use the user’s paired public key to verify that the digital signature is authentic, i.e. that the public key was generated from a particular piece of digital information and the user’s private key."
distributed hash tables (DHT),"A form of network used to store some content in the form of key/value pairs. ... This experimental project try to avoid keeping all the blockchain, but instead prefers to store it in a DHT."
ephemeral key,A cryptographic key is called ephemeral if it is generated for each execution of a key establishment process.
fork,"The term fork is used to refer both to any situation where there are two or more competing versions of a blockchain on a network (a situation that may arise and resolve itself in the ordinary course of network operations due to lags in communication between core nodes) and any software update that is proposed for adoption by the core nodes of a blockchain network that may result in a persistent fork on the network, with core nodes that adopt the update recognizing one version of the blockchain and those which do not recognizing another."
Gaia,Decentralized storage
genesis block,"The genesis block is the first block of the Stacks blockchain, which will create the initial 1.32 billion Stacks Tokens."
id.blockstack,"An identifier in the Blockstack, for example moxiegirl.id.blockstack. This is your name & identity that is registered in the .id namespace on Blockstack. Your personal data and storage are built around this ID. Apps that want to access your data use your permission and identity to find it. An id is usually a shorthand for a longer, hash ID string, for example ID-1Fj9kkw15P51Fj9kkw15P5xJmyefWhLKrQMKNPREfaqsJ"
identity,"<p>A way to identify a person or an organization on the Blockstack network. An identity is unique, both <code>moxiegirl.id.blockstack</code> or <code>chad.id</code> are examples of IDs.</p>"
identity management (IDM),"Identity management, also known as identity and access management is, in computer security, the security and business discipline that enables the right individuals to access the right resources at the right times and for the right reason"
know your customer (KYC),"Or KYC, is a popular term used in the banking or financial field. KYC is a process where financial institutions, insurers and other companies obtain information about the identity and address of the customers as part of risk management."
KYC,See know your customer
light clients,Clients that can independently validate the existence of transactions by downloading only block headers and not the entire blockchain.
Magic Recovery Code,"<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""/>"
mesh network,"A local network topology in which the infrastructure nodes (i.e. bridges, switches, and other infrastructure devices) connect directly, dynamically and non-hierarchically to as many other nodes as possible and cooperate with one another to efficiently route data from/to clients."
mining,Mining generally refers to the process of performing certain functions for a network such as adding new records to a blockchain in exchange for mining rewards; it may also refer to other mechanisms whereby rewards (usually in the form of cryptocurrency) are provided for performing other tasks helpful to the network.
mining power,"A miner’s (or group of miners’) mining power is equal to the probability it will be selected to write a new block to the blockchain. Depending on the mechanism for mining, this is usually related to the overall share of computing power or cryptoassets the miner or miners possess relative to all miners for that blockchain."
mining rewards,Mining rewards are newly issued tokens received by miners in exchange for adding new records to the blockchain or other activities beneficial to the network.
name,"An identifier or name. Names are a type of digital asset in the Blockstack network. If you have signed into the Blockstack Browser, you created a name. If an application developer registered an application within Blockstack, then they registered a name."
network operation,"A network operation is any change to the information about a digital asset (or smart contract) stored on a blockchain, including, for example, a change in the digital asset’s owner, or a change in the location at which it is stored on the network. How and when these network operations are performed for each digital asset is governed, on the Blockstack network, either by the Blockstack Core software or a smart contract."
private key,"<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>"
proof-of-burn mining,"The consensus algorithm used in the Stacks blockchain where miners destroy a proof-of-work-based cryptocurrency (currently Bitcoin) to get tokens; this enables the functionality where nodes can select between conflicting blockchain forks, as the blockchain fork with the most amount of cryptocurrency burned is considered to be the correct fork."
proof-of-work,"A proof-of-work system or proof-of-work mining is a mining mechanism where miners must expend computing power to solve complicated cryptographic puzzles, and prove that they have done so by writing the solution to the blockchain, in order to be allowed to add blocks to a blockchain. This is the mining system used, for example, by Bitcoin."
public key,<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>
Public Key Infrastructure (PKI),A system which returns a cryptographic public key associated with a name.
replicated state machines (RSMs),"This is a model for reasoning about distributed computer programs -- any program (plus it's input) can be represented as a state machine, and when trying to get a distributed set of servers to agree on the output of an algorithm, you can model that process as N different state machines"
Secret Recovery Key,<p>Used to access an identity on the Blockstack blockchain. A 24-word 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> <p>The early Blockstack recovery keys were 12-word sequences.</p>
seed phrase,"<p>Used to access Stacks Wallet software. The seed phrase consists of 24 words in a sequence. Both the word <em>and its position the sequence</em> are important.</p><p>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,<code>1-frog, 2-horse, 3-building</code> and so on until you reach a final position <code>24-ocean</code>.</p>"
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."
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."
Stacks (STX) address,"<p> A STX address is a string of letters and numbers starting with an <code>SP</code> or <code>SM</code>, for example: <code>SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT</code> </p><p> If you created a software-only wallet with the Stacks Wallet software, the wallet has a single STX address which is also sometimes called the <em>wallet address</em>. You access a software wallet with a <em>seed phrase</em>. </p>"
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.
storage hub,"An Gaia instance run by a hub provider or software. A Gaia hub stores data in separate, addressed location."
storage provider,A third-party company cloud or software provider that hosts one or more Gaia storage hubs.
transaction,A transaction is a unit of work within a block.
transaction fee,Fees paid by participants in a transaction to miners.
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.
virtual blockchain,A layer that sits on top of a blockchain that introduces new functionality and operations without requiring changes to the underlying blockchain
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.
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 file that 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
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 file that describes a DNS zone. A DNS zone is a subset, often a single domain, of the hierarchical domain name structure of the DNS."
,
Can't render this file because it contains an unexpected character in line 15 and column 0.

10
_data/theFAQs.json

@ -69,7 +69,7 @@
{
"category":"appusers",
"question":"How do I get an identity? Is it free?",
"answer":"<p>Normally, registering an identity as a digital asset on the Stacks blockchain requires <a href='https://blog.blockstack.org/video-reusing-bitcoins-hashpower-to-launch-the-stacks-blockchain/'>burning of Stacks tokens as <emphasis>fuel</emphasis></a>. However, Blockstack PBC is currently running a free service to pay for identities on behalf of the users. Through this service, you can get a free identity from Blockstack in the <strong>id.blockstack</strong> namespace. A namespace is similar to a domain (<strong>checklist.com</strong>, for example) on the old internet. So, a free identity has blockstack suffix in its name; for example, <strong>moxiegirl.id.blockstack</strong> is a free Blockstack identity.</p>"
"answer":"<p>Normally, registering an identity as a digital asset on the Stacks blockchain requires <a href='https://blog.blockstack.org/video-reusing-bitcoins-hashpower-to-launch-the-stacks-blockchain/'>burning of Stacks tokens as <em>fuel</em></a>. However, Blockstack PBC is currently running a free service to pay for identities on behalf of the users. Through this service, you can get a free identity from Blockstack in the <strong>id.blockstack</strong> namespace. A namespace is similar to a domain (<strong>checklist.com</strong>, for example) on the old internet. So, a free identity has blockstack suffix in its name; for example, <strong>moxiegirl.id.blockstack</strong> is a free Blockstack identity.</p>"
},
{
"category":"appusers",
@ -503,13 +503,13 @@
},
{
"category":"wallet",
"question":"When will the new Stacks wallet be available?",
"answer":"<p>The Stacks wallet is available for <a href='https://wallet.blockstack.org/'>download at wallet.blockstack.org.</a></p>"
"question":"When will the new Stacks Wallet be available?",
"answer":"<p>The Stacks Wallet is available for <a href='https://wallet.blockstack.org/'>download at wallet.blockstack.org.</a></p>"
},
{
"category":"wallet",
"question":"What is a public Stacks wallet address?",
"answer":"<p>During the initial grant process, investors submitted a <em>public Stacks wallet address</em> to Blockstack. This is a string of letters and numbers starting with an ‘SP’ or SM’, for example <code>SP017AUV5YRM7HT3TSQXJF7FCCYXETAB276BQ6XY</code> is a wallet address.</p> <p>If you purchased Stacks tokens through CoinList, you can find your address at <a href='https://coinlist.co/distributions'>CoinList</a>. If you submitted your Stacks address directly to Blockstack, you can either use the “Restore from Seed Phrase” feature on the Stacks wallet or contact us at <a href='mailto:hello@stackstoken.com'>hello@stackstoken.com</a> for help.</p>"
"question":"What is a public Stacks Wallet address?",
"answer":"<p>During the initial grant process, investors submitted a <em>public Stacks Wallet address</em> to Blockstack. This is a string of letters and numbers starting with an ‘SP’ or SM’, for example <code>SP017AUV5YRM7HT3TSQXJF7FCCYXETAB276BQ6XY</code> is a wallet address.</p> <p>If you purchased Stacks tokens through CoinList, you can find your address at <a href='https://coinlist.co/distributions'>CoinList</a>. If you submitted your Stacks address directly to Blockstack, you can either use the “Restore from Seed Phrase” feature on the Stacks Wallet or contact us at <a href='mailto:hello@stackstoken.com'>hello@stackstoken.com</a> for help.</p>"
},
{
"category":"wallet",

2
_develop/communityResources.md

@ -17,7 +17,7 @@ other resources.
</thead>
{% for resource in site.data.community.resources %}
<tr>
<td><p><a href="{{ resource.url }}" target="\_blank">{{ resource.title }}</a> {{resource.description}} (<emphasis>{{resource.type}}</emphasis>)</p></td>
<td><p><a href="{{ resource.url }}" target="\_blank">{{ resource.title }}</a> {{resource.description}} (<em>{{resource.type}}</em>)</p></td>
<td>{{resource.date}}</td>
</tr>
{% endfor %}

51
_includes/keyphrase.md

@ -9,42 +9,38 @@ Use the following table to answer questions about keys/phrases/values you can sh
<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>Used to access an identity on the Blockstack blockchain. A 24-word 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>
<p>The early Blockstack recovery keys were 12-word sequences.</p>
</td>
</tr>
<tr valign="top">
<td>
<p>Identity</p>
<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>
<p>A way to identify a person or an organization on the Blockstack network. An identity is unique, 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><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>
<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
@ -57,14 +53,11 @@ Use the following table to answer questions about keys/phrases/values you can sh
</td>
</tr>
<tr valign="top">
<td><p>Stacks Address</p>
<p>Stacks Wallet Address</p>
<p>STX address</p>
<td><p>Stacks address or 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>
<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">
@ -77,10 +70,30 @@ Use the following table to answer questions about keys/phrases/values you can sh
</tr>
<tr valign="top">
<td>private key</td>
<td></td>
<td>PROTECT</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>
<tr valign="top">
<td>
<p>seed phrase</p>
</td>
<td><p>PROTECT</p></td>
<td>
<p>Used to access Stacks Wallet software. The seed phrase consists of 24 words in a sequence. Both the word <em>and its position the sequence</em> are important.</p><p>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,<code>1-frog, 2-horse, 3-building</code> and so on until you reach a final position <code>24-ocean</code>.</p>
</td>
</tr>
<tr valign="top">
<td>
<p>wallet address</p>
</td>
<td><p>SHAREABLE</p></td>
<td>
<p>
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 <em>Stacks (STX) address</em>. You access a software wallet with a <em>seed phrase</em>.
</p>
</td>
</tr>
</table>

BIN
_org/images/pending.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 58 KiB

After

Width:  |  Height:  |  Size: 49 KiB

BIN
_org/images/receive-button.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 46 KiB

BIN
_org/images/settings.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 46 KiB

BIN
_org/images/top-up.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 28 KiB

22
_org/secureref.md

@ -2,6 +2,26 @@
layout: org
permalink: /:collection/:path.html
---
# Phrase and Key Security
# Wallet and identity security
It is important that you understand how to keep good security for your Stacks Wallet software and your Blockstack identity.
* TOC
{:toc}
## 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 CrtypoCurrency Security Standard publishes <a href="https://cryptoconsortium.github.io/CCSS/Details/#1.03" target="_blank">guidelines for key storage</a>. 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
{% include keyphrase.md %}

2
_org/token.md

@ -20,7 +20,7 @@ the first block of a blockchain.
During the draft genesis block period token holders setup a seed phrase
(sometimes referred to as a _recovery phrase_ or a _recovery seed_ using the
Stacks wallet software or their own hardware wallet.
Stacks Wallet software or their own hardware wallet.
It was each token holder’s responsibility to store their own seed phrase in a
private and secure location. Holders could use their wallet to verify their

18
_org/tokenholders.md

@ -4,19 +4,17 @@ permalink: /:collection/:path.html
---
# Information for current token holders
The information on this page is intended for **current Stacks token holders** during Blockstack’s token sale through early 2018.
The information on this page is intended for **current Stacks (STX) token holders** during Blockstack’s token sale through early 2018.
## Find your token balance and unlock date
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`
During your the initial grant process, you should have submitted a public *Stacks (STX) address* (also known as a *wallet address*) to Blockstack. A STX address is a string of letters and numbers starting with an `SP` or `SM`, for example: `SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT`
If you purchased Stacks tokens through CoinList, you can find your address at
If you purchased STX tokens through CoinList, you can find your address at
[CoinList](https://coinlist.co/distributions). If you submitted your Stacks
address directly to Blockstack, you can either use the Restore from Seed
Phrase” feature on the Stacks wallet or contact us at <hello@stackstoken.com> for
address directly to Blockstack, you can either use the **Restore from Seed
Phrase** feature on the Stacks Wallet or contact us at <hello@stackstoken.com> for
help.
@ -33,7 +31,7 @@ return false;
<form class="uk-form-horizontal" onSubmit="return process();" autocomplete="off">
<div>
<input style="background: #fff !important;" class="uk-input" type="text" name="url" id="url" placeholder="Enter public Stacks wallet address">
<input style="background: #fff !important;" class="uk-input" type="text" name="url" id="url" placeholder="Enter public Stacks Wallet address">
<input class="uk-button uk-button-default uk-form-width-medium uk-align-center" type="submit" value="Check allocation">
</div>
</form>
@ -48,8 +46,8 @@ If you have questions or concerns about your report, please contact <hello@Stack
## Understanding the timeline for unlocking your tokens
In October 2018, the Stacks blockchain launched under the Stacks token. With the
launch, Stacks tokens unlock for accredited token holders under a predetermined
In October 2018, the Stacks blockchain launched under the STX token. With the
launch, STX tokens unlock for accredited token holders under a predetermined
unlocking schedule. The events on the unlocking schedule are the same for each
token holder, the dates of these events depend on the holders’s purchase date.

38
_org/wallet-install.md

@ -4,20 +4,12 @@ permalink: /:collection/:path.html
---
# Install the Stacks Wallet software
You use the Stacks Wallet software client alone or with a hardware wallet to
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:
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. 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) instead.
{% include warning.html content="During you wallet download, you are at risk of
{% include warning.html content="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
@ -27,7 +19,7 @@ by Blockstack PBC." %}
## Mac Installation
1. Select the **MacOS Download** button <a href="https://blockstack.org/wallet/" target="\_blank">on this page</a>.
1. Select the **MacOS Download** button <a href="https://wallet.blockstack.org" target="\_blank">on this page</a>.
This button downloads the software to your computer.
@ -59,7 +51,7 @@ by Blockstack PBC." %}
## Windows Installation
1. Select the **Windows Download** button <a href="https://blockstack.org/wallet/" target="\_blank">on this page</a>.
1. Select the **Windows Download** button <a href="https://wallet.blockstack.org/" target="\_blank">on this page</a>.
This button downloads the software to your computer.
@ -87,29 +79,25 @@ by Blockstack PBC." %}
5. Verify that the resulting hash (a string of letters and numbers) is the same as the latest hash published <a href="https://github.com/blockstack/stacks-wallet/releases" target="\_blank">on this page</a>.
## Additional software requirements
## Additional requirement and option
Sending and receiving Stacks (STX) does require a Bitcoin account. You also have the option to use the wallet with or without a hardware wallet.
### Bitcoin account for fuel (required)
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 need very small fractions of Bitcoin to fuel your Stacks Wallet transactions. For example, .00025 Bitcoin can fuel several transactions. You can acquire this Bitcoin fuel and send it to the Stacks Wallet via a Coinbase or other Bitcoin account. Before you begin using the wallet transactions, make sure that you have such an account. You must create this account yourself.
### Hardware wallet
### Hardware wallet (optional but recommended)
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:
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:
* <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.
* Ledger Blue 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 use this account to load very small fractions of Bitcoin to fuel your wallet
transactions. 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 using the wallet transactions, make sure that
you have such an account. You must create this account yourself.

50
_org/wallet-intro.md

@ -5,29 +5,36 @@ permalink: /:collection/:path.html
# Understand cryptocurrency wallets
If you are, or plan to be a Stacks token holder, you need to think about how you
can manage your tokens. How can you review your token balance or send and
receive your tokens? You manage your tokens through a **cryptocurrency wallet**.
can manage your Stacks (STX) tokens. How can you review your token balance? How can send or
receive your tokens? STX tokens are a cryptocurrency and you manage your tokens through a **cryptocurrency wallet**. This overview introduces basic wallet terminology and concepts.
Unlike the wallets you carry physical money in, a cryptocurrency wallet doesn’t
hold your tokens. Your tokens are recorded by transactions which are themselves
encrypted on the Stacks blockchain. The cryptocurrency wallet holds software
keys. You use these keys and some software to interact with the blockchain and
gain use of your tokens.
* TOC
{:toc}
## Token flow and wallets
## Wallets, addresses, and tokens
Tokens move from one wallet to a another via the blockchain. For example, say
Lena decides to buy a book from Bitbooks, a company that accepts tokens. A
complete purchase, has the following general steps:
Cryptocurrency wallets are software that make sending and receiving cryptocurrency easier. Unlike the wallets you carry physical money in, a cryptocurrency wallet doesn’t
contain your tokens. A wallet has one or more cryptocurrency addresses, in the case of Stacks these are *Stacks token address*.
![](images/key.png)
An address is public and can be viewed by other people much like your house is visible to any passerby. To open a particular address, you must know the address value and you must have the private key for that address. Wallets can read existing addresses to send from or create new addresses to send to. A wallet can show you the history of transactions for an address on the blockchain.
Exchanging cryptocurrency requires moving currency from one address to another. Say a company, Bitbook, is selling books and receive crypto currency in payment. Lena sees a book she wants to buy on Bitbook, she selects a **Buy** button and Bitbook gives her an address to send currency to. Lena uses her private key to open one of her cryptocurrency addresses. She then sends from this address to BitBook's address.
![](images/key.png)
Token exchanges are recorded by *transactions* on a blockchain. In the case of STX, these exchanges appear on the Stacks blockchain. The movement of tokens from Lena to Bitbook is recorded on the blockchain. The private key Lena uses is not recorded.
<div class="uk-card uk-card-default uk-card-body">
<h5>Security tip: What to share and what not to</h5>
<p>A Stacks address is a string of letters and numbers starting with an <code>SP</code> or <code>SM</code>, like <code>SM3KJBA4RZ7Z20KD2HBXNSXVPCR1D3CRAV6Q05MKT</code>. You can and should share the address when you want someone to send STX tokens to you.</p>
<p>Your seed phrase, 24 words in an ordered sequence, is the private key for your addresses and wallet. <strong>never</strong> share your seed phrase with anyone.</p>
</div>
## 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 amounts of tokens in your cryptocurrency 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.
@ -39,10 +46,7 @@ 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.
{% include warning.html content="None of our ecosystem entities, Blockstack PBC,
Blockstack Signature Fund, and Blockstack Token LLC, are custodial services.
Neither the pre-genesis software wallet or the upcoming wallet are recommended for
institutional holdings." %}
{% include warning.html content="None of our ecosystem entities, Blockstack PBC, Blockstack Signature Fund, and Blockstack Token LLC, are custodial services. Or 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
@ -65,11 +69,7 @@ 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 wallets are, 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.
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 device like a USB. To use
these wallets, you connect them to a networked computer, enter a pin, and
@ -88,11 +88,11 @@ use multiple wallets choosing whichever works best for you at a specific time.
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
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
In some cases, you may need to transfer Stacks to a reference token address in whichever
wallet you want to move. Consult the documentation for your wallets for more
information.

230
_org/wallet-use.md

@ -5,89 +5,109 @@ permalink: /:collection/:path.html
# Use the Stacks Wallet software
{:.no_toc}
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:
This page describes how to use the Stacks Wallet software to manager your Stacks (STX) tokens. This page contains the following topics:
* TOC
{:toc}
This page assumes you have already [downloaded, verified, and installed the
wallet software](wallet-install.html).
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.html).
## Use the Stacks Wallet with or without a hardware wallet
## Key concepts you should understand
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.
You use Stacks Wallet software to manage STX tokens. Using the wallet you can:
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:
* 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
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.
<div class="uk-card uk-card-default uk-card-body">
<h5>Investers and large token holdings: Hardware devices </h5>
<p>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.</p>
</div>
### A hardware device with the wallet
You can use any of these hardware wallets with the Stacks Wallet:
* Trezor One
* Trezor Model T
* Ledger Nano S
* Ledger Blue
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 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.
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.
### Software only wallet and a seed phrase
You can use the Stacks Wallet software without a hardware device to create one or more software wallets. 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.
## Open the wallet
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`.
You can use the Stacks Wallet software with or without a hardware wallet. To
send Stacks, a hardware wallet is required.
{% include warning.html content="Do not lose your seed phrase. If you lose your seed phrase, you lose any STX tokens in that associated wallet. <strong>No person or organization, including Blockstack, can recover a lost seed phrase</strong>." %}
### Stacks Wallet software only
### About the reset function
You need at least one Stacks Address to create a wallet. A Stacks address is a
unique string of letters and numbers, for example:
`SM7KJBA4UZ7Z20KD2HBXNSXVPCR1D7CRAV605MKT`.
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.
1. Double-click on the wallet software to open it.
2. Select **Use a Stacks Address**.
### 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 system asks you to enter an address. 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.
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.
![](images/enter-address.png)
3. Select **Continue**.
## Create a new or open an existing wallet
The system displays the balance for that address.
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
### 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.
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.
<table class="uk-table uk-table-small uk-table-divider">
<tr>
<th>Hardware wallet</th>
<th>Prerequisite software</th>
</tr>
<tr>
<td>Trezor One</td>
<td><a href="https://doc.satoshilabs.com/trezor-user/download.html" target="\_blank">Trezor Bridge</a></td>
</tr>
<tr>
<td>Trezor Model T</td>
<td><a href="https://doc.satoshilabs.com/trezor-user/download.html" target="\_blank">Trezor Bridge </a></td>
</tr>
<tr>
<td>Ledger Nano S</td>
<td>None.</td>
</tr>
<tr>
<td>Ledger Blue</td>
<td>None.</td>
</tr>
</table>
| Hardware wallet | Prerequisite software |
|----------------- |------------------------ |
| Trezor One | <a href="https://doc.satoshilabs.com/trezor-user/download.html" target="\_blank">Trezor Bridge</a> |
| Trezor Model T | <a href="https://doc.satoshilabs.com/trezor-user/download.html" target="\_blank">Trezor Bridge </a> |
| 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.
Make sure you have installed any prerequisite software. Then, do the following to start the Stacks Wallet with a Hardware wallet:
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 **Use a Hardware Wallet**.
4. Select the hardware wallet you want to use.
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.
@ -96,29 +116,52 @@ Make sure you have installed any prerequisite software. Then, do the following t
The system prompts you to connect your
device.
5. Connect your wallet to your computer and choose **Continue**.
6. 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**.
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.
## View Balance, Allocation, and transaction history
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 and its position, for example,` 1 - frog`.
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**.
The system prompts you to re-enter your seed phrase. The sequence numbers are out of order. For example, `5` may appear in the `1` position. Enter the corresponding `5` and `1` word as appropriate.
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)
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)
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,
@ -126,49 +169,47 @@ click on a transaction:
![](images/receive-details.png)
Not all addresses will have a balance. If you are a Stacks token holder, your
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
Stackes you have unlocked. The **Allocation** is the amount still locked up.
Stacks 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.
To receive Stacks: you give a STX address directly to a user via email or text, for
example.
![](images/receive-button.png)
1. Click the **Receive** button to display the wallet address. where others can send STX to.
A stack address is a public addresses. Anyone with the address, can view the
address balance or send money _**to**_ the address.
![](images/receive-button.png)
{% include note.html content="Sending money <emphasis><u>from</u></emphasis> 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."
%}
2. Email or text the address to the person or organization sending to you.
Blockchain transactions 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.
A Stacks address is a public addresses. Anyone with the address, can view the address balance or send money _**to**_ the address.
## Top up Bitcoin gas
3. Look for the receipt transaction in your transaction history.
You require very small fractions of Bitcoin (.00001) to send Stacks with the wallet.
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 fractions of Bitcoin (BTC) for gas. The cost of gas you need fluctuates with the market price of Bitcoin.
{% 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 Bitcoin.
You can only receive Bitcoin with Stacks Wallet; you cannot send Bitcoin. You need an account with Coinbase or similar exchange to buy Bitcoin and send it to the Stacks 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:
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)
@ -183,12 +224,13 @@ Bitcoin to fuel the transaction, you see this dialog:
This dialog shows you how much BTC you currently have in your account.
2. Select **Top up**.
2. Select **Add BTC**.
The systems displays the **Top Up** dialog with a Bitcoin address.
3. Record the 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.
@ -199,11 +241,9 @@ transaction history also shows any Bitcoin sent to your wallet.
## Send stacks
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.
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.
1. Open the Stacks Wallet.
If you are starting after a reset, choose **Use a Hardware Wallet**.
@ -241,10 +281,7 @@ transactions.
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)
transactions can take minutes or hours to complete.
Select **Refresh** if you don't immediately see the transaction in your
history.
@ -253,10 +290,10 @@ transactions.
## Reset the wallet
Resetting a wallet clears all your data from the Stacks wallet and returns the
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 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.
@ -273,9 +310,6 @@ you do not restart the wallet, you can simple close it.
![](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

3
_sass/theme/variables.scss

@ -1,4 +1,7 @@
// Color scheme variables
$base-em-color:#5d3671;
$base-code-color: #36074d;
// Main content
$color-main: #201F6D;

2
_storage/amazon-s3-deploy.md

@ -15,7 +15,7 @@ This teaches you how to run a Gaia hub on Amazon EC2. Amazon EC2 is an affordabl
<p>This documentation is appropriate for advanced power users who are familiar with command line tools, <code>ssh</code>, and basic editing configuration files.</p>
<p>If you are planning on running an <emphasis>open-membership hub</emphasis> or an <emphasis>application-specific hub</emphasis>, see <a href="hub-operation.html">the section on Hub Operation</a>.</p>
<p>If you are planning on running an <em>open-membership hub</em> or an <em>application-specific hub</em>, see <a href="hub-operation.html">the section on Hub Operation</a>.</p>
</div>

2
_storage/digital-ocean-deploy.md

@ -17,7 +17,7 @@ DigitalOcean provides you with a compute machines known as a **Droplets** and s
<p>This documentation is appropriate for advanced power users who are familiar with command line tools, editing configuration files, and basic configuration of services of DNS or Nginx. </p>
<p>If you are planning on running an <emphasis>open-membership hub</emphasis> or an <emphasis>application-specific hub</emphasis>, you'll should see <a href="hub-operation.html">the section on Hub Operation</a></p>.
<p>If you are planning on running an <em>open-membership hub</em> or an <em>application-specific hub</em>, you'll should see <a href="hub-operation.html">the section on Hub Operation</a></p>.
</div>

3
assets/css/main.scss

@ -49,3 +49,6 @@ body > div.uk-lightbox.uk-overflow-hidden.uk-lightbox-panel.uk-open > div.uk-lig
}
.uk-table th {
vertical-align: top !important;
}
Loading…
Cancel
Save