Skip to main content


Chialisp is a powerful and secure LISP-like language for encumbering and releasing funds with smart-contract capabilities. This website is a consolidated place to learn about Chialisp, CLVM and the conditions language.

Here's a sample:

(mod (password new_puzhash amount)  (defconstant CREATE_COIN 51)
  (if (= (sha256 password) (q . 0x2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824))    (list (list CREATE_COIN new_puzhash amount))    (x)  ))

Why Lisp?#

Many people come into our keybase channel and ask us why we chose a 60 year old language as our on chain programming language. We chose it due to a few unique features that make it remarkably well suited to the Chia blockchain:

  • Completely sandboxed. Chialisp resource utilization is completely controlled. The language needs to be run on half a million computers, so it is important that the program cannot reach out and affect everyone's machines in an unintended way. A lisp program is evaluated and therefore cannot spawn any new processes or interact with the system it is running on.

  • Composability. A lisp program is itself just a list. This feature allows for powerful techniques that allow you to modify source code during program evaluation. Doing so can allow a "smart coin" to enforce rules on a participating coin while still allowing it to utilize the full programmability that Chialisp has to offer. Using lisp programs like this allows you to have layers of smart coins in which the output of an "inner" puzzle can be used in the evaluation of the "outer" puzzle.

  • Interoperability. Every smart coin in the Chia ecosystem, no matter how complex, is fundamentally a coin that is locked up with a Chialisp puzzle. The input to any puzzle will always be a lisp data structure, and the output will always be a list of conditions that all puzzles share. This means that everything in Chia interoperates with everything else. Any smart coin should be able to interact or communicate with any other smart coin, regardless of whether either coin was specifically designed to do so.

Chia Asset Tokens (CATs)#

The first Chialisp smart transaction that we integrated into chia-blockchain were CATs (formerly known as coloured coins). CATs allow you to create tokens on the Chia blockchain that are entirely controlled by you. This allows you to issue assets on the Chia blockchain that cannot be created or destroyed by others without your permission. This can be used for stable coins, stock issuance, voting shares, or anything else you can think of. Read more about nomenclature of CATs.


Another fascinating application of Chialisp is the creation of singletons. Singletons are a type of coin that there is verifiably only one of. When you can verify that there is only one of a coin, you can enable some interesting functionality. The Chia Network pooling protocol uses this to verify that you have committed your plots to a pool and have not promised them to any other pool. You can also make NFTs, decentralized identities, and anything else that could make use of a unique coin.


Chialisp is also capable of any of the popularly available decentralized finance tools you find on other blockchains today. One feature that enables this is the fact that coins can communicate with each other when they are spent. You can have market makers announce prices and have other coins utilize those prices in their own logic when they are spent. The natural interoperability that Chialisp provides is also relevant because it will allow participants to layer and leverage many different DeFi tools all at once!

Introductory Material#

Developer Documentation#