diff --git a/_common/core_ref.md b/_common/core_ref.md new file mode 100644 index 00000000..a5a72c01 --- /dev/null +++ b/_common/core_ref.md @@ -0,0 +1,5 @@ +--- +layout: externalurl +redirect_url: https://core.blockstack.org/ +title: "Blockstack CORE API" +--- diff --git a/_site/core/glossary.md b/_common/glossary.md similarity index 96% rename from _site/core/glossary.md rename to _common/glossary.md index c710ca27..28414fb9 100644 --- a/_site/core/glossary.md +++ b/_common/glossary.md @@ -20,7 +20,7 @@ details. A human-readable name in Blockstack. It is comprised only of upper and lower-case ASCII characters, numbers, as well as `-`, `_`, and `.`. It must end with a `.`, followed by a namespace ID. It has at least 3 characters, and at most 37 (including the `.` and the namespace ID). -Anyone can register a Blockstack ID, such as through the [Blockstack Browser](https://github.com/blockstack/blockstack-browser) +Anyone can register a Blockstack ID, such as through the [Blockstack Browser](https://github.com/blockstack/blockstack-browser) ## Blockstack Core @@ -55,6 +55,10 @@ bound to a blockchain transaction. This includes all data stored in the Atlas network (such as your Blockstack ID's zone file), as well as any data whose hash is stored in the Atlas network. +## mnemonic + +A human-friendly representation of a seed. + ## Mutable Data This is the general term for data that is (1) signed by your Blockstack ID, and @@ -108,6 +112,10 @@ An online service that lets you sign up for and manage the profiles of Blockstac An online service that displays zonefile and profile data for a Blockstack ID. [The Blockstack Explorer](https://explorer.blockstack.org) is a resolver. +## Seed + +A 128 or 256 bits of random data used to generate a master public and privte key pair. + ## Social proof A post in an account on an existing Web service like Twitter, Facebook, or GitHub that points back to a Blockstack ID. Used to provide some evidence that the person who owns the Blockstack ID is also the person who owns the Web service account. diff --git a/_common/javascript_ref.md b/_common/javascript_ref.md new file mode 100644 index 00000000..d020f2bb --- /dev/null +++ b/_common/javascript_ref.md @@ -0,0 +1,5 @@ +--- +layout: externalurl +redirect_url: https://blockstack.github.io/blockstack.js/ +title: "Blockstack Javascript Reference" +--- diff --git a/_config.yml b/_config.yml index cd70fa23..62987357 100644 --- a/_config.yml +++ b/_config.yml @@ -108,6 +108,8 @@ exclude: - THEME_README.md - collections.json - get-content.sh + - _core/aglio_templates + - _core/attic sass: style: compressed @@ -131,9 +133,9 @@ collections: browser: output: true basepath: "blockstack/blockstack-browser/blob/master/docs" - newinternet: - output: true - basepath: "moxiegirl/docs-new/blob/master/docs" ios: output: true basepath: "blockstack/blockstack-ios/blob/master/docs" + common: + output: true + basepath: "moxiegirl/docs.blockstack" diff --git a/_data/navigation_auth.yml b/_data/navigation_auth.yml index 69b62baa..84170d0c 100644 --- a/_data/navigation_auth.yml +++ b/_data/navigation_auth.yml @@ -1,4 +1,4 @@ - docs: - - core/auth/overview - - core/auth/howitworks - - core/auth/howtouse + - core/atlas/overview + - core/atlas/howitworks + - core/atlas/howtouse diff --git a/_data/navigation_bns.yml b/_data/navigation_bns.yml index d573598e..4fb07774 100644 --- a/_data/navigation_bns.yml +++ b/_data/navigation_bns.yml @@ -3,11 +3,14 @@ - core/naming/introduction - core/naming/architecture - core/naming/namespaces + - core/naming/comparison -- title: Tutorials +- title: Tutorials & Cookbooks docs: - core/naming/tutorial_creation - core/naming/tutorial_subdomains + - core/naming/search + - core/naming/openbazaar - title: How to use BNS @@ -19,8 +22,19 @@ - core/naming/manage - core/naming/subdomains -- title: Other topics +- title: Forks and Dids docs: - core/naming/forks - core/naming/did - - core/naming/comparison + +- title: Atlas + docs: + - core/atlas/overview + - core/atlas/howitworks + - core/atlas/howtouse + +- title: Reference + docs: + - common/javascript_ref + - common/core_ref + - core/faq_technical diff --git a/_data/navigation_docs.yml b/_data/navigation_general.yml similarity index 100% rename from _data/navigation_docs.yml rename to _data/navigation_general.yml diff --git a/_data/navigation_home.yml b/_data/navigation_home.yml index c5f176e9..31b7f18d 100644 --- a/_data/navigation_home.yml +++ b/_data/navigation_home.yml @@ -8,7 +8,7 @@ - title: Use the New Internet desc: Learn about the New Internet and its applications. Create an identity and learn how to use it. icon: settings - doc: newinternet/browser-introduction + doc: browser/browser-introduction - title: Build Apps and Earn Money desc: Learn how to build an application that earns with Blockstack. @@ -23,7 +23,7 @@ - title: Implement Authentication desc: Managing your account, creating new users and exporting data icon: cog - doc: core/auth/overview + doc: core/atlas/overview - title: Implement Storage with GAIA desc: Backend storage drivers and interactions between developer APIs and the Gaia service. diff --git a/_data/navigation_learn.yml b/_data/navigation_learn.yml index 13b3a638..a7e79680 100644 --- a/_data/navigation_learn.yml +++ b/_data/navigation_learn.yml @@ -1,9 +1,14 @@ - title: Try a tutorial docs: - - newinternet/hello-blockstack - - newinternet/multi-player-storage + - browser/hello-blockstack + - browser/multi-player-storage - title: Work with an SDK docs: - android/tutorial - ios/tutorial + +- title: Reference + docs: + - core/faq_developer + - common/javascript_ref diff --git a/_data/navigation_newinternet.yml b/_data/navigation_newinternet.yml deleted file mode 100644 index 507a73a8..00000000 --- a/_data/navigation_newinternet.yml +++ /dev/null @@ -1,4 +0,0 @@ -- title: Get started - docs: - - newinternet/browser-introduction - - newinternet/ids-introduction diff --git a/_data/navigation_usenew.yml b/_data/navigation_usenew.yml new file mode 100644 index 00000000..bb2b924e --- /dev/null +++ b/_data/navigation_usenew.yml @@ -0,0 +1,4 @@ +- docs: + - browser/ids-introduction + - browser/browser-introduction + - browser/faq_general diff --git a/_includes/related-newinternet.html b/_includes/related-usenew.html similarity index 100% rename from _includes/related-newinternet.html rename to _includes/related-usenew.html diff --git a/_layouts/externalurl.html b/_layouts/externalurl.html new file mode 100644 index 00000000..a5acf476 --- /dev/null +++ b/_layouts/externalurl.html @@ -0,0 +1,2 @@ +{{page.title}} + diff --git a/_layouts/doc.html b/_layouts/general.html similarity index 97% rename from _layouts/doc.html rename to _layouts/general.html index 64428d9c..ad673b59 100644 --- a/_layouts/doc.html +++ b/_layouts/general.html @@ -8,7 +8,7 @@ layout: default
- {% for section in site.data.navigation_docs %} + {% for section in site.data.navigation_general %}
{{ section.title }}
  • -

    Replae the existing the onCreate function with the following:

    +

    Replace the existing the onCreate function with the following:

     override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
@@ -1021,51 +1055,9 @@ know about your experience by tweeting to
                     
 
 
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
 
 
-                    
    
+                    
 
-
-                    
                 
 
                 
+{"description":"Use the Blockstack Browser","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/browser/browser-introduction.html","headline":"Use the Blockstack Browser","dateModified":"2018-09-10T15:18:11-07:00","datePublished":"2018-09-10T15:18:11-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/browser/browser-introduction.html"},"@context":"http://schema.org"}
 
 
   
@@ -102,19 +102,22 @@
                   
                     
                     
-                         
    Get started
    
-                    
                     
                     
@@ -126,7 +129,7 @@
 
                 
    
 
-                    
    Use the Blockstack Authenticator
    
+                    
    Use the Blockstack Browser
    
 
                     
 
@@ -142,28 +145,28 @@
     
 
 
-
    
 
                     
    
                         
-
    lockstack Authenticator gives users the ability to explore and use the
+
    The Blockstack Browser gives users the ability to explore and use the
 decentralized applications (dapps). The decentralized applications are a new way
 to interact with the internet. Dapps give users control of their data. Data
 about them personally, name, birthdate, phone number and data about what they do
 such as visiting a website or buying an item.
    
 
 
      
-  
    • Understand the Blockstack Authenticator
      • 
-  
    • Using the Authenticator on public computers
      • 
+  
    • Understand the Blockstack Browser
      • 
+  
    • Using the Browser on public computers
      • 
   
    • Install the client edition    
        
       
      • On Mac
        • 
       
      • On Windows
        • 
@@ -178,11 +181,11 @@ such as visiting a website or buying an item.
        
   
 
      
 
-
      Understand the Blockstack Authenticator
      
+
      Understand the Blockstack Browser
      
 
-
      Through the Blockstack authemticator application you can create an identity. An identity
+
      Through the Blockstack browser application you can create an identity. An identity
 represents you as you interact with others through Dapps.  The Blockstack
-authenticator is itself, a smiple Dapp. It allows you to:
      
+Browser is itself, a simple Dapp. It allows you to:
      
 
 
        
   
      • create one or more identities
        • 
@@ -191,39 +194,39 @@ authenticator is itself, a smiple Dapp. It allows you to:
        
   
      • find and launch Dapps
        • 
 
      
 
-
      There are editorions of the Blockstack Authenticator, the web edition is an
+
      There are editorions of the Blockstack Browser, the web edition is an
 application you access through your web browser by simply visit the
 applications’ address in your computer’s
-browser.  You can also install the authenticator as a client application on your
+browser.  You can also install the browser as a client application on your
 computer.
      
 
 
      If all you want to do is create, manage, and fund an identity and then interact
 with Dapps, you can simply use the web edition. If you have concerns about net
 censorship, hightened security concerns, or develop a Dapp yourself, you may
-want to download and install the authenticator’s client edition.
      
+want to download and install the browser’s client edition.
      
 
-
      Using the Authenticator on public computers
      
+
      Using the Browser on public computers
      
 
 
      Before you use the web application, it is important to note that once you log
 into the application with the brower, your session does not expire until you
 choose Settings > RESET BROWSER.  For this reason, you should be careful
-when using the authenticator on public computers.
      
+when using the browser on public computers.
      
 
-
      If you are in a library, for example, and log into the authenticator, simply
+
      If you are in a library, for example, and log into the browser, simply
 closing the tab or even rebooting the computer does not log you out. Instead,
 you should be sure to choose Settings > RESET BROWSER before leaving the web
 application.
      
 
-
      For more informatin about your identity and the authenticator, see Get and use a Blockstack IDs.
      
+
      For more informatin about your identity and the browser, see Get and use a Blockstack IDs.
      
 
 
      Install the client edition
      
 
-
      Remember, for most users the Blockstack Authenticator web application should
+
      Remember, for most users the Blockstack Browser web application should
 suffice. You only need to install the client if you have additional, advanced
 concerns about Internet or identity. Though not required, some Dapp developrs
 may find it useful to install the client edition.
      
 
-
      The Blockstack Authenticator installer is a multiple-context installer. If you
+
      The Blockstack Browser installer is a multiple-context installer. If you
 run it as a user, the installation is avalable only for that user. If you
 install as administrator, the installation installs for all users. To find an
 installer for your operating system, visit the Blockstack install
@@ -251,7 +254,7 @@ page.
      
   
    • 
     
      Choose Open.
      
 
-    
      The system opens your default browser with the Blockstack Authenticator
+    
      The system opens your default browser with the Blockstack Browser
 application, running from your machine (localhost). You’ll also see the
 Blockstack icon in your machine’s
      
 
@@ -277,7 +280,7 @@ install:
      
     
      
   
      • 
   
    • 
-    
      Open the Wiindows Start menu and click on the recently added Blockstack Authenticator.
      
+    
      Open the Wiindows Start menu and click on the recently added Blockstack Browser.
      
 
     
      
 
@@ -288,7 +291,7 @@ install:
      
   
    • 
     
      Choose to Allow access.
      
 
-    
      The system opens in the Blockstack Authenticator application.
      
+    
      The system opens in the Blockstack Browser application.
      
 
     
      
   
      • 
@@ -368,7 +371,7 @@ the version of Docker appropriate for your operating system</a>.
    -

    The system launches the Blockstack Authenticator application for you.

    +

    The system launches the Blockstack Browser application for you.

    • @@ -382,7 +385,7 @@ the docker container ls command.

    -

    Use ./Blockstack-for-Linux-vO.30.0.sh stop to stop the Blockstack Authenticator and its containers.

    +

    Use ./Blockstack-for-Linux-vO.30.0.sh stop to stop the Blockstack Browser and its containers.

    Uninstall the browser

    @@ -428,7 +431,7 @@ your operating system.

  • -

    Locate the Blockstack Authenticator and choose Uninstall.

    +

    Locate the Blockstack Browser and choose Uninstall.

    • @@ -490,8 +493,8 @@ but that is not explained here.

    - - + +
    @@ -501,48 +504,6 @@ but that is not explained here.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +Users Frequently Asked Questions (FAQ) | Blockstack + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +
    + + + + +
    +
    +
    + +
    +
    + + + + + + +
    +
    + +
    + +
    + +

    Users Frequently Asked Questions (FAQ)

    + + + + +
    + + + + + + + + + + + + +
    + +
    + +

    This is a general FAQ intended for users of decentralized applications. If you are a developer, refer to the [technical FAQ].

    + + + +

    What is the decentralized internet?

    + +

    The Blockstack ecosystem enables the new decentralized internet. Decentralization means authority moving from central authority to local authority. Simply put, in a decentralized interent, you your data, not the applications or services you use.

    + +

    Blockstack envisions a world where users control their own data, and power flows back to the users. For example, when you buy something from an online company, that company collects and stores data about you:

    + +
      +
    • your name
      • +
    • the information about the product you bought
      • +
    • the number on your credit card
      • +
    + +

    In the decentralied internet, that information stays with you and it isn’t +collected or stored by anyone. Applications that operate in the decentralized +internet are called decentralized applications or Dapps for short.

    + +

    What is Blockstack?

    + +

    Blockstack is an ecosystem to support both Dapp users and Dapp developers. For +users, Blockstack makes software to create Blockstack identities and find Dapps. +For developers, Blockstack develops an ecosystem of software and services that developrs can use to build Dapps.

    + +

    Blockstack through its

    + +

    How do Dapps differ applications I typically use?

    + +

    Dapps differ from Web applications in two ways:

    + +
      +
    • Users have identities not accounts. The user brings their identity to the +applications; applications do not require the user to create accounts and +passwords.
      • +
    • Users own their data. Users control access to their data. Users decide where to store their data and which applications can read or write to your. Companies and their applications in the new Internet don’t keep or save your data.
      • +
    + +

    Where is my identity kept?

    + +

    Your identity is a unique string you and other people can read such as moxiegirl.id. A private key is a string of letters only you know. When you create an identity, a hash is made of your id and your private key registered with Blockstack.

    + +

    Your personal data storage is built around this ID. Apps that want to access your data use your permission and identity to find it.

    + +

    You have to remember and keep your private key in a safe place like a password manager. If you lose a private key, no one else, no person, no software, can help you get your identity back.

    + +

    Can Blockstack control my data or ID when I use it?

    + +

    No. When you’re using a Blockstack client you control your data and ID with a +private key. As long as no one gets access to your private key, no one can +control your data or ID. When you use Blockstack, by design, your private keys +are never sent to any remote servers.

    + +

    Do Dapps uwork with a regular browser?

    + +

    Yes! Dapps run in the web browsers (Chrome, Safari, Internet Explorer, etc.) you know and love.

    + +

    What is the Blockstack Browser?

    + +

    The Blockstack Browser is the Dapp users use to create and manage their identities and configure their data storage. The browser is also where users can go to discover and use apps using Blockstack.

    + +

    The Blockstack Browser also handles login requests from Dapps that allow their users to log in with Blockstack. When a user clicks a Log In with Blockstack button, they are redirected to the Blockstack Browser to approve the request before being logged into the app.

    + +

    Are Blockstack applications usable today?

    + +

    Yes! Blockstack applications are as easy to use as normal Web applications, if +not easier. Moreover, they are just as performant if not more so.

    + +

    If you install the Blockstack +Browser, or use our +Web-hosted Blockstack Browser, you can get +started with them right away.

    + + + +
    + +
    + + + + + + + + +
    + + + +
    + +
    +
    + + +
    +
    + + + + + +
    +
    + +
    + +
    + + +
    + +
    + + + + +
    + +
    + + + + + +
    + +
    + + + + + + +
    +
    + +
    +
    + + + + + + + + + + + + + + + diff --git a/_site/newinternet/hello-blockstack.html b/_site/browser/hello-blockstack.html similarity index 89% rename from _site/newinternet/hello-blockstack.html rename to _site/browser/hello-blockstack.html index dcd6837e..532c492d 100644 --- a/_site/newinternet/hello-blockstack.html +++ b/_site/browser/hello-blockstack.html @@ -13,13 +13,13 @@ - - + + - + +{"description":"Hello, Blockstack Tutorial","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/browser/hello-blockstack.html","headline":"Hello, Blockstack Tutorial","dateModified":"2018-09-10T15:18:11-07:00","datePublished":"2018-09-10T15:18:11-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/browser/hello-blockstack.html"},"@context":"http://schema.org"} @@ -99,37 +99,60 @@
    + -
    Try a tutorial
    - -
    Work with an SDK
    - +
    Try a tutorial
    + + + + +
    Work with an SDK
    + + + +
    Reference
    + + + +
    @@ -141,6 +164,7 @@ +
    @@ -152,13 +176,13 @@ -
    @@ -433,7 +457,7 @@ and open your browser ‘http://localhost:5000’. From the root of your new ap

    The application detects whether the user has the Blockstack client edition installed or not. This is done automatically by the Blockstack API, more about this later. - What the authenticator displays depends on the users’ current state.

    + What the browser displays depends on the users’ current state.

    @@ -450,12 +474,12 @@ and open your browser ‘http://localhost:5000’. From the root of your new ap
    -

    If the user logged into the Blockstack authenticator but not reset it, the user can +

    If the user logged into the Blockstack Browser but not reset it, the user can simply use the exiting identity.

    -

    If the user chooses Deny, the Blockstack authenticator displays its +

    If the user chooses Deny, the Blockstack Browser displays its Home page but the user is not logged into the sample application.

  • @@ -601,8 +625,8 @@ user home screens. The contents are very simple:

    You’re well on your way to becoming a Blockstack app legend.

    • @@ -612,51 +636,9 @@ You’re well on your way to becoming a Blockstack app legend.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    + - - +{"description":"Get and use a Blockstack ID","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/browser/ids-introduction.html","headline":"Get and use a Blockstack ID","dateModified":"2018-09-10T15:18:11-07:00","datePublished":"2018-09-10T15:18:11-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/browser/ids-introduction.html"},"@context":"http://schema.org"} @@ -102,19 +102,22 @@ -
    Get started
    - @@ -142,13 +145,13 @@ -
    @@ -233,7 +236,7 @@ registrars. Coin is required to purchase identities on other domains.

    1. -

      Open the Blockstack web applicatin in your browser.

      +

      Open the Blockstack web application in your browser.

      The application prompts you for an email address.

      @@ -396,8 +399,8 @@ recovery key rather than your code to restore your identity.

      At this point, you can go work with Dapps or you can review your recovery key.

      @@ -407,48 +410,6 @@ recovery key rather than your code to restore your identity.

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -99,37 +99,60 @@
      + -
      Try a tutorial
      - -
      Work with an SDK
      - +
      Try a tutorial
      + + + + +
      Work with an SDK
      + + + +
      Reference
      + + + +
      @@ -141,6 +164,7 @@ +
      @@ -152,13 +176,13 @@ -
      @@ -397,7 +421,7 @@ stored on Gaia are made visible to others via the Understand Gaia storage methods

      Once you authenticate a user with store_write and publish_data, you can -begin to manage data for your users. BlockStack JS provides two methods +begin to manage data for your users. Blockstack JS provides two methods getFile() and putFile() for interacting with Gaia storage. The storage methods support all file types. This means you can store SQL, Markdown, JSON, or even a custom format.

      @@ -479,7 +503,7 @@ or remove a grocery list; updating a list has no impact.

    2. Replace the constructor() initial state so that it holds the key properties required by the app.

      -

      This code constructs a BlockStack Person object to hold the profile. Your constructor should look like this:

      +

      This code constructs a Blockstack Person object to hold the profile. Your constructor should look like this:

       constructor(props) {
    super(props);
@@ -1051,8 +1075,8 @@ about Blockstack. To use a working version of the app go
 here.
      @@ -1062,51 +1086,9 @@ about Blockstack. To use a working version of the app go - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      + - - +{"description":"How Atlas Works","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/core/atlas/howitworks.html","headline":"How Atlas Works","dateModified":"2018-09-10T15:18:11-07:00","datePublished":"2018-09-10T15:18:11-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/core/atlas/howitworks.html"},"@context":"http://schema.org"} @@ -107,17 +107,17 @@ -
    3. Overview of the Atlas network
      4. +
    4. Overview of the Atlas network
      5. -
    5. How Atlas Works
      6. +
    6. How Atlas Works
      7. -
    7. How to Use the Atlas Network
      8. +
    8. How to Use the Atlas Network
      9. @@ -145,13 +145,13 @@ -