"answer":"<p>The Blockstack Browser is a deprecated app used to create and manage Blockstack identities. To a user, it looks just like another tab in a standard browser. From the Blockstack Browser tab, you can find apps to try, update settings related to your identity and storage – and much more. </p> <p>Developers used the Blockstack Browser to handle login requests from apps. From a Blockstack app, a user chooses the Log In with Blockstack button. Clicking this button sends users to a Blockstack Browser dialog. This dialog asks users to allow the app to access their data. </p><p>Developers are encouraged to integrate <a href=\"https://docs.blockstack.org/develop/connect/overview.html\">Blockstack Connect</a> into their apps instead of the Blockstack Browser, which is no longer actively developed by Blockstack PBC.</p> "
"answer":"<p>The Blockstack Browser is a deprecated app used to create and manage Blockstack identities. To a user, it looks just like another tab in a standard browser. From the Blockstack Browser tab, you can find apps to try, update settings related to your identity and storage – and much more. </p> <p>Developers used the Blockstack Browser to handle login requests from apps. From a Blockstack app, a user chooses the Log In with Blockstack button. Clicking this button sends users to a Blockstack Browser dialog. This dialog asks users to allow the app to access their data. </p><p>Developers are encouraged to integrate <a href=\"/authentication/connect\">Blockstack Connect</a> into their apps instead of the Blockstack Browser, which is no longer actively developed by Blockstack PBC.</p> "
},
},
{
{
"category":"appusers",
"category":"appusers",
@ -203,7 +203,7 @@
{
{
"category":"appdevs",
"category":"appdevs",
"question":"How do I register Blockstack usernames?",
"question":"How do I register Blockstack usernames?",
"answer":"<p>You should use integrate authentication into your app with <a href='https://docs.blockstack.org/develop/connect/overview.html'>Blockstack Connect</a>.</p>"
"answer":"<p>You should use integrate authentication into your app with <a href='/authentication/connect'>Blockstack Connect</a>.</p>"
},
},
{
{
"category":"appdevs",
"category":"appdevs",
@ -273,7 +273,7 @@
{
{
"category":"coredevs",
"category":"coredevs",
"question":"What is a Blockstack Subdomain?",
"question":"What is a Blockstack Subdomain?",
"answer":"<p>A Blockstack subdomain can be used for all the things a Blockstack ID can be used for. The only difference is that they have the format <code>~~foo.bar.baz~~</code> instead of <code>~~bar.baz~~</code>. For example, <a href='https://core.blockstack.org/v1/users/jude.personal.id'>jude.personal.id</a> is a Blockstack ID, and is a subdomain of <code>~~personal.id~~</code>. Hundreds of subdomains can be registered with a single transaction. The <a href='https://docs.blockstack.org/core/naming/introduction.html'>BNS documentation</a> describes them in detail.</p>"
"answer":"<p>A Blockstack subdomain can be used for all the things a Blockstack ID can be used for. The only difference is that they have the format <code>~~foo.bar.baz~~</code> instead of <code>~~bar.baz~~</code>. For example, <a href='https://core.blockstack.org/v1/users/jude.personal.id'>jude.personal.id</a> is a Blockstack ID, and is a subdomain of <code>~~personal.id~~</code>. Hundreds of subdomains can be registered with a single transaction. The <a href='/naming-services/overview'>BNS documentation</a> describes them in detail.</p>"
},
},
{
{
"category":"coredevs",
"category":"coredevs",
@ -423,7 +423,7 @@
{
{
"category":"wallet",
"category":"wallet",
"question":"Can I send Bitcoin to my Stacks Wallet?",
"question":"Can I send Bitcoin to my Stacks Wallet?",
"answer":"<p>No, you cannot send Bitcoin to a Stacks address. You can only add Bitcoin as fuel to the wallet. Please <a href='https://docs.blockstack.org/org/wallet-use.html' target='_blank'>follow the instructions for adding "gas"</a>.</p>"
"answer":"<p>No, you cannot send Bitcoin to a Stacks address. You can only add Bitcoin as fuel to the wallet. Please <a href='/stacks-wallet/usage' target='_blank'>follow the instructions for adding "gas"</a>.</p>"
},
},
{
{
"category":"wallet",
"category":"wallet",
@ -433,12 +433,12 @@
{
{
"category":"tokens",
"category":"tokens",
"question":"How do I check the status of my previously purchased Stacks tokens?",
"question":"How do I check the status of my previously purchased Stacks tokens?",
"answer":"<p>You may check the status of previously purchased Stacks tokens at the <a href='https://explorer.blockstack.org'>Blockstack Explorer</a>. Additional wallet-related information is available <a href='https://docs.blockstack.org/org/wallet-intro.html'>here</a>.</p>"
"answer":"<p>You may check the status of previously purchased Stacks tokens at the <a href='https://explorer.blockstack.org'>Blockstack Explorer</a>. Additional wallet-related information is available <a href='/stacks-wallet/overview'>here</a>.</p>"
},
},
{
{
"category":"tokens",
"category":"tokens",
"question":"How do I check my STX balance?",
"question":"How do I check my STX balance?",
"answer":"<p>Blockchain transactions take time. Once Stacks are sent to you, you see a PENDING transaction, which means the transaction is still being recorded by the blockchain. Your balance will not change until the transaction is recorded. It may be minutes or hours before the transaction is recorded in the blockchain.</p><p>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. Then, at this point, the <a href='https://docs.blockstack.org/org/wallet-use.html#view-balance-allocation-or-transaction-history'>balance in your Stacks Wallet software</a> should reflect the completed transaction.</p>"
"answer":"<p>Blockchain transactions take time. Once Stacks are sent to you, you see a PENDING transaction, which means the transaction is still being recorded by the blockchain. Your balance will not change until the transaction is recorded. It may be minutes or hours before the transaction is recorded in the blockchain.</p><p>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. Then, at this point, the <a href='/stacks-wallet/usage#view-balance-allocation-or-transaction-history'>balance in your Stacks Wallet software</a> should reflect the completed transaction.</p>"
},
},
{
{
@ -512,4 +512,4 @@
"answer":"<p>Accredited Investors and funds in the 2017 Reg D token offering purchased tokens at a $0.12 price. Blockstack PBC raised $47.5M in this offering.</p> <p>Holders of Blockstack’s Series A convertible preferred stock—who had invested a total of $5.1 million as of late 2016 and funded Blockstack’s early growth and development before the decision to create a token, or the drafting or publication of any white papers—were also provided an opportunity to purchase tokens at a nominal price per token before the 2017 Reg D offering. This opportunity to participate at a nominal price was given in return for their early support and in proportion to their equity ownership, and it was based on their reasonable expectation as early investors that they would receive tokens if Blockstack ever decided to create a digital token.</p> <p>These tokens are subject to a three-year time lock, commencing upon the introduction of the genesis block to the Blockstack network in November 2018. The tokens for founders and employees are also subject to a three-year time lock starting November 2018.</p> <p>Further, affiliates of Blockstack PB,C including Union Square Ventures, Muneeb Ali, and Ryan Shea — three of the largest holders of Stacks tokens — have additional restrictions on selling tokens on the open markets.</p>"
"answer":"<p>Accredited Investors and funds in the 2017 Reg D token offering purchased tokens at a $0.12 price. Blockstack PBC raised $47.5M in this offering.</p> <p>Holders of Blockstack’s Series A convertible preferred stock—who had invested a total of $5.1 million as of late 2016 and funded Blockstack’s early growth and development before the decision to create a token, or the drafting or publication of any white papers—were also provided an opportunity to purchase tokens at a nominal price per token before the 2017 Reg D offering. This opportunity to participate at a nominal price was given in return for their early support and in proportion to their equity ownership, and it was based on their reasonable expectation as early investors that they would receive tokens if Blockstack ever decided to create a digital token.</p> <p>These tokens are subject to a three-year time lock, commencing upon the introduction of the genesis block to the Blockstack network in November 2018. The tokens for founders and employees are also subject to a three-year time lock starting November 2018.</p> <p>Further, affiliates of Blockstack PB,C including Union Square Ventures, Muneeb Ali, and Ryan Shea — three of the largest holders of Stacks tokens — have additional restrictions on selling tokens on the open markets.</p>"
@ -9,7 +9,7 @@ With the launch of Stacks 2.0, a new version of the Blockstack blockchain was re
## Stacks Core API
## Stacks Core API
The Stacks 2.0 blockchain's Rust implementation exposes RPC endpoints (in JSON format), which can be used to interface with the Stacks blockchain. [You can find the RPC API references here](https://docs.blockstack.org/core/smart/rpc-api.html).
The Stacks 2.0 blockchain's Rust implementation exposes RPC endpoints (in JSON format), which can be used to interface with the Stacks blockchain. [You can find the RPC API references here](/references/stacks-rpc-api).
@ -76,9 +76,9 @@ On the first line, a new public function `say-hi` is declared. Public functions
-> To create private functions, you would use the `define-private` keyword. Private functions can only be executed by the current smart contract. Only public functions can be called from other contracts.
-> To create private functions, you would use the `define-private` keyword. Private functions can only be executed by the current smart contract. Only public functions can be called from other contracts.
The function doesn't take any parameters and simply returns "hello world" using the [`ok`](clarityRef.html#ok) response constructor.
The function doesn't take any parameters and simply returns "hello world" using the [`ok`](/references/clarity-language#ok) response constructor.
The second function, `echo-number`, is a [read-only function](clarityRef.html#define-read-only). Read-only functions are also public, but as the name implies, they can not perform any datamap modifications. `echo-number` takes an input parameter of the type `int`. Along with integer, Clarity supports the following [types](clarityRef.html#clarity-type-system):
The second function, `echo-number`, is a [read-only function](/references/clarity-language#define-read-only). Read-only functions are also public, but as the name implies, they can not perform any datamap modifications. `echo-number` takes an input parameter of the type `int`. Along with integer, Clarity supports the following [types](/references/clarity-language#clarity-type-system):
- `uint`: 16-byte unsigned integer
- `uint`: 16-byte unsigned integer
- `principal`: spending entity, roughly equivalent to a Stacks address
- `principal`: spending entity, roughly equivalent to a Stacks address
@ -86,7 +86,7 @@ The second function, `echo-number`, is a [read-only function](clarityRef.html#de
- `buffer`: fixed-length byte buffers
- `buffer`: fixed-length byte buffers
- `tuple`: named fields in keys and values
- `tuple`: named fields in keys and values
`echo-number` uses an [`ok`](clarityRef.html#ok) response to return the value passed to the function.
`echo-number` uses an [`ok`](/references/clarity-language#ok) response to return the value passed to the function.
| contractAddress | string | false | The Stacks address that published this contract |
| contractAddress | string | false | The Stacks address that published this contract |
| contractName | string | false | The name that was used when publishing this contract |
| contractName | string | false | The name that was used when publishing this contract |
| functionName | string | false | The name of the function you're calling. This needs to be a [public function](/core/smart/clarityRef.html#define-public). |
| functionName | string | false | The name of the function you're calling. This needs to be a [public function](/references/clarity-language#define-public). |
| functionArgs | array | false | The arguments you're calling the function with. You'll need to provide the Clarity type with each argument. See the below section for details. Defaults to `[]`. |
| functionArgs | array | false | The arguments you're calling the function with. You'll need to provide the Clarity type with each argument. See the below section for details. Defaults to `[]`. |
| appDetails | object | false | A dictionary that includes `name` and `icon` |
| appDetails | object | false | A dictionary that includes `name` and `icon` |
| finished | function | false | A callback that is fired when the transaction is signed and broadcasted. Your callback will receive an object back with a `txId` and a `txRaw`, both of which are strings. |
| finished | function | false | A callback that is fired when the transaction is signed and broadcasted. Your callback will receive an object back with a `txId` and a `txRaw`, both of which are strings. |
@ -14,7 +14,7 @@ DigitalOcean provides you with a compute machines known as a **Droplets** and st
<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>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 <em>open-membership hub</em> or an <em>application-specific hub</em>, you'll should see <ahref="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 <ahref="/storage-hubs/overview">the section on Hub Operation</a></p>.
johndmulhausen
4 years ago
Thomas Osmonson