From 3d348039b98441d0cefc4f11e7a18241249e41d3 Mon Sep 17 00:00:00 2001 From: Alexander Graebe Date: Mon, 14 Dec 2020 16:32:20 -0800 Subject: [PATCH] docs: redesign clarity onboarding --- public/images/pages/clarity/gitpod-new.png | Bin 0 -> 228483 bytes src/common/navigation.yaml | 4 +- src/pages/index.md | 4 +- src/pages/references/language-overview.md | 5 +- .../hello-world-tutorial.md | 239 +++++++----------- src/pages/write-smart-contracts/overview.md | 20 +- src/pages/write-smart-contracts/principals.md | 3 + src/pages/write-smart-contracts/values.md | 5 +- 8 files changed, 124 insertions(+), 156 deletions(-) create mode 100644 public/images/pages/clarity/gitpod-new.png diff --git a/public/images/pages/clarity/gitpod-new.png b/public/images/pages/clarity/gitpod-new.png new file mode 100644 index 0000000000000000000000000000000000000000..fcab2251cc4b710d254cd8422ead23034a913dee GIT binary patch literal 228483 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

pEf90$ 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 literal 0 HcmV?d00001 diff --git a/src/common/navigation.yaml b/src/common/navigation.yaml index 260fc0be..f83b185a 100644 --- a/src/common/navigation.yaml +++ b/src/common/navigation.yaml @@ -31,7 +31,6 @@ sections: - path: /atlas-how-it-works - path: /atlas-usage - path: /installing-memcached - - path: /build-apps # is an overview page - path: /write-smart-contracts pages: - path: /overview @@ -43,8 +42,9 @@ sections: - path: /hello-world-tutorial - path: /counter-tutorial - path: /testing-contracts - - path: /public-registry-tutorial - path: /signing-transactions + - path: /public-registry-tutorial + - path: /build-apps # is an overview page - path: /start-mining # is an overview page - title: Technology diff --git a/src/pages/index.md b/src/pages/index.md index 79083cd2..81cab013 100644 --- a/src/pages/index.md +++ b/src/pages/index.md @@ -11,12 +11,12 @@ description: All you need to build decentralized apps, write smart contracts, an ## Get started [@page-reference | grid] -| /build-apps, /write-smart-contracts/overview, /start-mining +| /write-smart-contracts/overview, /build-apps, /start-mining ## Try a tutorial [@page-reference | grid] -| /authentication/building-todo-app, /write-smart-contracts/counter-tutorial, /understand-stacks/running-testnet-node +| /write-smart-contracts/hello-world-tutorial, /authentication/building-todo-app, /understand-stacks/running-testnet-node ## Explore more diff --git a/src/pages/references/language-overview.md b/src/pages/references/language-overview.md index 1e1c3bf1..ec0fcae6 100644 --- a/src/pages/references/language-overview.md +++ b/src/pages/references/language-overview.md @@ -1,6 +1,9 @@ --- title: Overview -description: Overview of the Clarity language constructs. +description: Overview of the Clarity language constructs +images: + large: /images/pages/write-smart-contracts.svg + sm: /images/pages/write-smart-contracts-sm.svg --- export { convertClarityRefToMdx as getStaticProps } from '@common/data/clarity-ref' diff --git a/src/pages/write-smart-contracts/hello-world-tutorial.md b/src/pages/write-smart-contracts/hello-world-tutorial.md index 25910465..e819e9b4 100644 --- a/src/pages/write-smart-contracts/hello-world-tutorial.md +++ b/src/pages/write-smart-contracts/hello-world-tutorial.md @@ -6,7 +6,7 @@ experience: beginners tags: - tutorial images: - large: /images/pages/hello-world-app.svg + large: /images/pages/hello-world.svg sm: /images/pages/hello-world-sm.svg --- @@ -21,41 +21,31 @@ By the end of this tutorial, you will: - Have a working Clarity starter project and local dev environment - Understand basic Clarity language design principles - Deploy a contract to the Stacks 2.0 blockchain and call its public methods -- Understand how to use the Explorer Sandbox functionality +- Understand how to use the Stacks CLI ## Prerequisites -### Set up your Node environment - -You will need [NodeJS](https://nodejs.org/en/download/) `8.12.0` or higher to complete this tutorial. You can verify your installation by opening up your terminal and run the following command: - -```bash -node --version -``` - ### Check the Stacks 2.0 status The Stacks 2.0 blockchain is currently in development and could experience resets and downtimes. To make sure you're not running into any challenges related to the status of the network, please open up the [Status Checker](http://status.test-blockstack.com/) and confirm that all systems are operational. If some systems seem to have issues, it is best to wait until they are back up before you proceed with the next steps. -### Optional: Install Visual Studio Code with Clarity Extensions +## Step 1: Open the playground + +To avoid setting things up on your machine, we will run all instructions inside a virtual container inside your browser window, using a project called Gitpod. -[Visual Studio Code](https://code.visualstudio.com/) (aka VS Code) is a free development environment which has Clarity extensions, to make it easier to create smart contracts with Clarity. +**[Open this Gitpod in a new browser window](https://gitpod.io/#https://github.com/agraebe/clarity-onboarding-playground)** -[Install Visual Studio Code](https://code.visualstudio.com/download) and install the following extensions for the best coding experience: +You will be asked to login with a Github account. Follow the steps described on the screen. Once completed, the code editor window will be shown: -- [Clarity](https://marketplace.visualstudio.com/items?itemName=blockstack.clarity), the official language extension that defines the Clarity language for VS Code and provides auto-complete and syntax highlighting. -- [clarity-lsp](https://marketplace.visualstudio.com/items?itemName=lgalabru.clarity-lsp), which adds inline help functionality for Clarity to VS Code -- [Rainbow Brackets](https://marketplace.visualstudio.com/items?itemName=2gua.rainbow-brackets), which adds helpful colorization of matching pairs of parentheses while you code +![new gitpod](/images/pages/clarity/gitpod-new.png) --> If you need help installing extensions, review [Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) in the Visual Studio Code docs. +The Gitpod playground comes pre-installed with the [Stacks CLI](/references/stacks-cli). -## Step 1: Download a starter project +## Step 2: Set up a starter project -Using your terminal, run the following command to create a new folder and initialize a new project: +Using the terminal window on the bottom of the screen, run the following command to initialize a new project: ```bash -# create and go to new `hello-world` project folder -mkdir hello-world; cd hello-world npm init clarity-starter ``` @@ -67,9 +57,17 @@ After the starter project is loaded up, you have to select a project template (u Counter ``` -## Step 2: Review the contract +Next, you'll be asked to name the folder that will be created for the project. Hit ENTER to accept the default: + +```bash +? Project name: (clarity-hello-world) +``` + +Wait a few seconds until all project dependencies are installed. Once completed, you will see a new folder on the left side of the screen (`clarity-hello-world`). This is where your new Clarity project can be found. Open the project folder and get familiar with the structure. + +## Step 3: Review the contract -Select **File** > **Add Folder to Workspace** in VS Code, and add the `hello-world` folder you created in the previous step. Then, navigate to `contracts/hello-world.clar`. +Inside the project folder, open the `contracts/hello-world.clar` file. You will see that the program and each statement is enclosed in `()` (parentheses), and the smart contract consists of two functions. @@ -87,135 +85,47 @@ On the first line, a new public function `say-hi` is declared. Public functions The function doesn't take any parameters and simply returns "hello world" using the [`ok`](/references/language-functions#ok) response constructor. -The second function, `echo-number`, is a [read-only function](/references/language-functions#define-read-only). Read-only functions are also public, but as the name implies, they can not change and variables or datamaps. `echo-number` takes an input parameter of the type `int`. Along with integer, Clarity supports the following [types](/references/language-types): +The second function, `echo-number`, is a [read-only function](/references/language-functions#define-read-only). Read-only functions are also public, but as the name implies, they can not change and variables or datamaps. `echo-number` takes an input parameter of the type `int`. -- `uint`: 16-byte unsigned integer -- `principal`: spending entity, roughly equivalent to a Stacks address -- `boolean`: `true` or `false` -- `buff`: fixed-length byte buffers -- `string-ascii`: string containing ascii characters only -- `string-utf8`: string containing utf8 characters -- `tuple`: named fields in keys and values +-> Clarity supports a variety of other [types](/references/language-types) `echo-number` uses an [`ok`](/references/language-functions#ok) response to return the value passed to the function. -## Step 3: Access the Explorer Sandbox - --> This tutorial uses a developer preview release of the [Stacks 2.0 Explorer](https://testnet-explorer.blockstack.org/). Please feel free to report issues or request enhancements on the [blockstack/explorer](https://github.com/blockstack/explorer/issues/new) repository. For more details about this release, see the [Explore the Stacks 2.0 Testnet](https://forum.blockstack.org/t/explore-the-stacks-2-0-testnet-with-the-new-explorer-developer-preview/10889) post in the Blockstack forums. If you encounter trouble using the Explorer Sandbox, try falling back to [the CLI instructions at the end of this page](#get-familiar-with-cli-optional). - -Open up the [Stacks 2.0 Explorer Sandbox view](https://testnet-explorer.blockstack.org/sandbox). The Explorer Sandbox is a web-enabled view of the Stacks 2.0 blockchain, and has tools for validating contracts, testing out transactions, and generating tokens. - -Here, we will run the code from `hello-world` right in the browser and create blockchain transactions right in the browser. - -You will be asked to sign in with or sign up for a Stacks ID. Your new ID will include a new Stacks address, which is essentially a wallet that holds funds like STX tokens. STX tokens are consumed as fees to register digital assets on the network and to publish/execute smart contracts, among other functions on the network. - -All of the following operations will happen on the Testnet. A Testnet is an alternative Stacks 2.0 blockchain, to be used for testing. Testnet STX tokens are separate and distinct from actual STX tokens, and are never supposed to have any value. - -Follow the steps on the screen to complete the process. - -![The faucet tab of the Stacks 2.0 Testnet Explorer](/images/faucet.png) - -Once completed, you will see the Sandbox view and your newly generated Stacks address for testing purposes. - -## Step 4: Obtain STX tokens - -Uploading and calling smart contracts requires fees to be paid to the network to process the transactions. The Testnet Explorer features the capability to request STX tokens that can be used to pay the fees ("STX faucet"). - -On the [**STX faucet**](https://testnet-explorer.blockstack.org/sandbox?tab=faucet) screen, your new Stacks address will be prefilled. Click **Request STX** to receive 0.5 STX. - -On the right side of the screen ("Recent transactions"), you will notice that a new transaction was generated for you. A transaction usually takes up to a minute to complete, because it needs to be broadcast and confirmed by the network. - -Wait a few seconds until the transaction completes (the loading indicator will disappear and a green dot will show up on the icon). You don't need to refresh the page manually. However, if you wish to see the details of your faucet request, you can click on the transaction. - -![Screenshot of faucet request submission](/images/faucet-transfer.png) - -## Step 5: Deploy the contract - -A deployed contract on the Testnet is like a cloud function (comparable to serverless functions). It allows you to execute code remotely on the Stacks 2.0 network. - -On the Sandbox view, switch to the [**Contract deploy**](https://testnet-explorer.blockstack.org/sandbox?tab=contract-deploy) tab, and do the following: - -1. Enter a name for the contract under **Contract name** that uses lower-case letters, dashes, and numbers only. -2. Replace code in the text area under **Contract source code (editable)** with the contents of `contracts/hello-world.clar`. -3. Ignore the **Choose from sample** drop-down for now. After completing this tutorial you can come back to the Explorer Sandbox and use this drop-down to try other sample contracts. -4. Ignore the **Fee** field. It should be set to 2000 micro-STX (1 STX = 1000000 micro-STX) -5. Click **Deploy contract**. - --> In production, you would estimate the fees that are required to be paid using methods provided by the Stacks 2.0 network. The estimate would, for instance, be based on the size of the contract. For the purpose of this tutorial, we will keep it simple and accept the default fee. - -![deploy](/images/contract-deploy.png) - -On the right, inside the "Recent transactions" feed, you will notice that another transaction appearing. - -Wait a few seconds until the transaction completes. In the meantime, you can click on the transaction and review the details. You will notice that every deployed smart contracts' source code is publicly verifiable. - -## Step 6: Call the public method - -On the Sandbox view, switch to the [**Contract call**](https://testnet-explorer.blockstack.org/sandbox?tab=contract-call) tab, and enter the following details: - -- **Contract address**: Your generated Stacks address. Hover over the "identity view" on the top right side of the screen to copy your full address and paste it in here. -- **Contract name**: Whatever you entered as your contract name in the previous step. If you forgot, you can review your recent transactions by following the link on the upper-right, and look up your contract creation transaction. \* **Contract name**: Whatever you entered as your contract name in the previous step. If you forgot, you can review your recent transactions. - -![Screenshot of the Sandbox's contract call screen](/images/sandbox-call.png) - -After clicking **Search**, you will see the two public methods implemented in the smart contract. - -Locate the `(echo-number)` method, provide any integer for the `val` argument (for example 42) and click **Submit**. You will see the value you entered echoed back to you below the button: - -```clarity -Result: (ok 42) -``` +In the following steps, we will use this simple contract to deploy and run on the Stacks blockchain. -![sandbox-call](/images/sandbox-calltx.png) +## Step 4: Create a Stacks account -=> **Congratulations!** You just deployed your smart contract and called a public function on the Stacks 2.0 blockchain. - -With the completion of this tutorial, you now: - -- Have a working Clarity starter project and local dev environment -- Understand basic Clarity language design principles -- Have deployed a contract to the Stacks 2.0 blockchain and called its public methods -- Understand how to use the Explorer Sandbox functionality - -## Optional: Get familiar with CLI - -The steps above provide an easy way to get started with contract deployment and contract calls. If you want to stay in the terminal and get access to more advanced capabilities, you should use the Stacks CLI. - -The following set of commands will achieve the same goals as the above workflow. - -Install an early release of the new Stacks CLI for Stacks 2.0. +The container you are using comes pre-installed with Stacks CLI. Back inside the terminal, run the following command to create a new [Stacks 2.0 account](/understand-stacks/accounts): ```bash -npm install --global @stacks/cli +stx make_keychain -t | json_pp > cli_keychain.json ``` -Create a new Stacks address and save keychain details, using the `-t` flag to target Testnet. The new keychain details will be stored in the file `cli_keychain.json`: +This command creates a new address and saves the details in a JSON file. -```bash -stx make_keychain -t > cli_keychain.json -``` +-> The `-t` option generates an account for the [testnet](/understand-stacks/testnet). It cannot be used on the mainnet -Review your new Stacks address details. - -```bash -cat cli_keychain.json | json_pp -``` +Review your new Stacks account details by opening up the file `cli_keychain.json` from the left navigation bar. ```json { - "mnemonic": "aaa bbb ccc ddd ...", "keyInfo": { - "address": "STJRM2AMVF90ER6G3RW1QTF85E3HZH37006D5ER1", - "privateKey": "5a3f1f15245bb3fb...", + "address": "STNBNMTXV9ERHEDCQA3WE2S4PTF8ANSC24EBDKS2", + "btcAddress": "mjQtUz4kD7QsfAnxuPKKNM2EjFiomb9P8p", "index": 0, - "btcAddress": "biwSd6KTEvJcyX2R8oyfgj5REuLzczMYC1" - } + "privateKey": "416ce94972b13eee84943a0c42275c9f61f7..." + }, + "mnemonic": "cup core apple emotion chalk absorb ..." } ``` -> Check out the [Stacks CLI reference](/references/stacks-cli) for more details -Make an API call to the Testnet faucet to get STX tokens. +## Step 5: Obtain testing tokens + +Uploading and calling smart contracts requires fees to be paid to the network to process the transactions. Let's get some testnet tokens, so we can pay the fees in the next steps. + +The **STX faucet** is an API endpoint we can call to request testnet tokens for the new account. In the terminal, run the following command: ```bash # replace with `address` property from your keychain @@ -227,47 +137,88 @@ The response will include a `txId` property. This is the transaction that was in ```json { "success": true, - "txId": "0xabc123", - "txRaw": "8080000000040..." + "txId": "0xf2f0402f9f4c4d43b382690c4f7b97e24d5ff5dd5c619e3615daa64dca7ef4bc", + "txRaw": "8080000000040016..." } ``` -You need to wait up to a minute for the transaction to complete. After that, you can confirm that your balance increase by 0.5 STX. +-> You can also review the transaction status and details using the [Explorer](https://testnet-explorer.blockstack.org/) + +You need to wait up to a minute for the transaction to complete. Type the following in your terminal to check the balance: ```bash stx balance -t ``` +Once the transaction is successfully processed, you can see that your new balance is `500000`, which equals 0.5 Stacks (STX) tokens. + ```json { // in microstacks (1 STX = 1000000 microstacks) "balance": "500000", + "locked": "0", + "unlock_height": 0, "nonce": 0 } ``` -With sufficient funds on your account, you can deploy a contract file to Testnet. In this example, we are deploying the `hello-world.clar` contract with the name `hello-world`. +## Step 6: Deploy the contract + +A deployed contract on the Testnet is like a cloud function (comparable to serverless functions). It allows you to execute code remotely on the Stacks 2.0 network. + +Let's deploy the reviewed contract file (`hello-world.clar`). Inside the terminal, run the following command: ```bash # stx deploy_contract -t -# replace `nonce` with the value from the last balance check # replace `privateKey` with your private key from your keychain -# replace `fee` with 2000. Usually, an estimate should be used but 2000 will be good enough for this tutorial -stx deploy_contract -t ./hello-world.clar hello-world 2000 0 5a3f1f15245bb3fb +stx deploy_contract -t clarity-hello-world/contracts/hello-world.clar hello-world 2000 0 ``` --> To learn more about the Stacks CLI commands, you can run `stx help all`. +A new contract deploy transaction ID will be returned: -The command will return a new contract deploy transaction ID. You have to wait up to a minute for the contract to be broadcast to the network. Keep in mind that this operation will increase the `nonce` of your account. +```bash +09adc98490c9f900d3149e74322e07ff6d1bf49660a08d8104c4dc66430bc3c0 +``` + +The `deploy_contract` command takes the file contents and deploys a new contract with the name `hello-world`. With that name, the fully qualified contract identifier for the new account will be `STNBNMTXV9ERHEDCQA3WE2S4PTF8ANSC24EBDKS2.hello-world`. + +~> Your address will be different. The contract identifier is essentially a naming convention to address deployed contract. It is based on the dot notation: `

.` + +Ideally, you should estimate the minimal fees that are required to be paid. The estimate would, for instance, be based on the size of the contract. For this tutorial, we will keep it simple and accept the default fee of `2000` (equals 0.02 STX). + +You have to wait up to a minute for the contract to be broadcasted to the network. In the meantime, you can open the transaction with the Explorer. You will notice that every deployed smart contracts' source code is publicly verifiable. -As soon as the contract is deployed, you can call a contract method. In this example, we are calling the `echo-number` function of the previously named `hello-world` contract. The method is defined as `read-only` and will return the result without generating a new transactions. +-> Keep in mind that this operation increases the `nonce` of your account. [Read more about nonces](/understand-stacks/network#nonces) + +## Step 7: Call the public method + +As soon as the contract is deployed, you can call one of its methods. In this example, we are calling the `echo-number` function. + +-> The method is defined as `read-only` and will return the result [without generating a new transaction](/understand-stacks/network#read-only-function-calls) ```bash # stx call_read_only_contract_func -t # replace `stx_address` and `privateKey` with values from your keychain -# replace `nonce` with the value from the last balance check + 1 -# replace `fee` with 2000. Usually, an estimate should be used but 2000 will be good enough for this tutorial -stx call_read_only_contract_func -t hello-world echo-number 2000 1 5a3f1f15245bb3fb +stx call_read_only_contract_func -t hello-world echo-number 2000 1 ``` -=> **Congratulations!** You can now deploy your smart contract and call public functions on the Testnet using the CLI. +The command will look up the contract method definition on the network, identify that it requires an input parameter, and ask you for an integer to set `val`. Enter 42 an hit ENTER. + +```bash +42 +``` + +The method will now be executed on the network. Once completed, the command will respond with the value you just entered, `42`: + +```bash +(ok 42) +``` + +=> **Congratulations!** You can now deploy your smart contract and call public functions on the Testnet using the CLI. You just deployed your smart contract and called a public function on the testnet of the Stacks blockchain using the Stacks CLI. + +With the completion of this tutorial, you now: + +- Have a working Clarity starter project +- Understand basic Clarity language design principles +- Deployed a contract on the Stacks blockchain and called a public method +- Understand how to use the Stacks CLI diff --git a/src/pages/write-smart-contracts/overview.md b/src/pages/write-smart-contracts/overview.md index 58bacc88..a8a15e1c 100644 --- a/src/pages/write-smart-contracts/overview.md +++ b/src/pages/write-smart-contracts/overview.md @@ -11,6 +11,11 @@ images: Clarity is a programming language for writing smart contracts on the Stacks 2.0 blockchain. It supports programmatic control over digital assets. +Prefer to jump right in? Get started with the Hello World tutorial: + +[@page-reference | inline] +| /write-smart-contracts/hello-world-tutorial + ## Smart contracts Smart contracts encode and enforce rules for modifying a particular set of data that is shared among people and entities @@ -59,11 +64,14 @@ Note some of the key Clarity language rules and limitations. - There is support for lists, however, the only variable length lists in the language appear as function inputs; there is no support for list operations like append or join. - Variables are immutable. -## Learning Clarity +## Try a tutorial + +[@page-reference | grid] +| /write-smart-contracts/hello-world-tutorial, /write-smart-contracts/counter-tutorial, /write-smart-contracts/signing-transactions, /write-smart-contracts/public-registry-tutorial + +## Explore more -The tutorials are ordered from "beginner" to "advanced." Start with the [Hello World tutorial](/write-smart-contracts/hello-world-tutorial), -then learn how to construct [a counter](/write-smart-contracts/counter-tutorial), and finally, learn how to -[test your smart contracts](/write-smart-contracts/testing-contracts) using Mocha. +For language details, references and more, check out the following: -Once you've got the hang of the general workflow, environment, and language syntax, you should be ready to start writing -contracts, referring to the [Clarity language reference](/references/language-overview) as you go. +[@page-reference | grid] +| /write-smart-contracts/principals, /write-smart-contracts/values, /references/language-overview diff --git a/src/pages/write-smart-contracts/principals.md b/src/pages/write-smart-contracts/principals.md index 391ed83e..8e33fb7b 100644 --- a/src/pages/write-smart-contracts/principals.md +++ b/src/pages/write-smart-contracts/principals.md @@ -1,6 +1,9 @@ --- title: Principals description: 'Clarity: Understanding Principals' +images: + large: /images/pages/write-smart-contracts.svg + sm: /images/pages/write-smart-contracts-sm.svg --- ## Introduction diff --git a/src/pages/write-smart-contracts/values.md b/src/pages/write-smart-contracts/values.md index 4699e7b9..b86e45f6 100644 --- a/src/pages/write-smart-contracts/values.md +++ b/src/pages/write-smart-contracts/values.md @@ -1,6 +1,9 @@ --- title: Clarity Values -description: Learn how to deal with Clarity Values in JavaScript. +description: Learn how to deal with Clarity Values in JavaScript +images: + large: /images/pages/write-smart-contracts.svg + sm: /images/pages/write-smart-contracts-sm.svg --- ## Introduction