Clarity Notebook

Interactive tour

Chapter 1 - Basics

In this chapter, we will dissect some hello world programs and learn the basics of Clarity and its functional programming syntax. We will learn how to define a function and the fundamental control flow functions.

Chapter 2 - Data types

In this chapter, we will gradually learn about the data types powering Clarity, from the most basic ones, to the most sophisticated. This chapter will gives us the fundamental keys to approach the next chapters.

Chapter 3 - Data storage

In this chapter, we will be introducing two primitives for storing, updating and retrieving stateful data in Clarity programs, along with their associated functions.

Chapter 4 - Arithmetic and Logic functions

In this chapter, we will learn about all the arithmetic and logic functions available natively in Clarity.

Chapter 5 - Sequence functions

In this chapter, we will have a closer look at a family of types, the sequences (list, buffer and strings), and see how the functions map / reduce can be combined and leveraged for solving problems.

Chapter 6 - Token Oriented Programming

In this chapter, we will introduce another type of data storage primitive, designed to simplify the structure and reduce the amount of code of programs manipulating Fungible and Non Fungible Tokens.

Chapter 7 - Cryptographic and Blockchain functions

In this chapter, we will learn about the handful of native cryptographic functions available natively with Clarity, along with some of the very unique functions that can be used for exploring the state of the chain, past and present.

Chapter 8 - Inter-Contract Communication functions

In this chapter, we will learn how contracts can safely dispatch inter contract calls and exchange data with other programs, statically and dynamically through the use of traits.

Chapter 9 - Best practices and recommandations

In this chapter, we will learn about smart contracts best practices. We will be suggesting design patterns and recommandations aiming at maximizing security.

Misc

Generating some randomness

In this notebook, we will generate some randomness, using the VRF of the current block

Run the notebooks locally

The first step is to ensure that you have Rust and the support software installed.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then you need to install Jupyter, using your favourite package manager:

brew install jupyter

And install Clarity for Jupyter:

cargo install clarity-jupyter-kernel
clarity-jupyter-kernel --install

From there, you can clone this repository:

git clone https://github.com/lgalabru/clarity-notebook.git

cd clarity-notebook

Then start Jupyter:

jupyter-notebook

Happy hacking / learning!

agraebe/clarity-notebook