#capsule #ckb #framework #nervos #smart-contracts #script #lua

bin+lib ckb-capsule

Capsule is a development framework for creating smart contract for Nervos' CKB

21 releases

new 0.10.5 May 17, 2024
0.10.4 Mar 15, 2024
0.10.3 Jan 4, 2024
0.10.2 Nov 3, 2023
0.4.4 Nov 24, 2020

#466 in Magic Beans

Download history 122/week @ 2024-01-29 14/week @ 2024-02-19 23/week @ 2024-02-26 2/week @ 2024-03-04 166/week @ 2024-03-11 21/week @ 2024-03-18 35/week @ 2024-04-01 6/week @ 2024-04-08 174/week @ 2024-05-13

174 downloads per month

MIT license

4.5K SLoC


Github Actions Rust crate

Capsule is an out-of-box development framework for creating smart contract on Nervos' CKB.

Capsule consists of:

  • Capsule CLI - Scaffolding tool.
  • CKB-testtool - CKB scripts testing framework.

CKB supports several programming languages for writing scripts, and the language supporting libraries are maintained in the following repositories:



Supported Environments

  • Linux
  • macOS
  • Windows (WSL2)


The following must be installed and available to use Capsule.

$ cargo install cross --git https://github.com/cross-rs/cross

Note: All commands must be accessible in the PATH in order for them to be used by Capsule.

Note: The current user must have permission to manage Docker instances. How to manage Docker as a non-root user.

Install binary

Download the latest release

Cargo install

Install the latest version

cargo install ckb-capsule

Install the develop branch

cargo install ckb-capsule --git https://github.com/nervosnetwork/capsule.git --branch develop


capsule help

Quick Start

# check environment
capsule check

# create project
capsule new my-demo
cd my-demo
capsule build
capsule test

Project Layout

  • capsule.toml - Capsule manifest file.
  • contracts - Contracts directory.
  • tests - Contracts tests.
  • build - Contracts binaries.


Capsule Wiki on GitHub

Upgrading to Capsule 0.10

Upgrade an existing project to capsule 0.10




~1M SLoC