An IDE to develop CKB scripts for Nervos blockchain
CKB Studio is an IDE to develop CKB scripts on the Nervos blockchain. It includes
If you want to learn more about how to use CKB Studio, please go to the Tutorials section.
Installation packages are provided in releases. Please select the appropriate format according to your operating system (.dmg
or .zip
for Mac OS, .exe
for Windows, or .AppImage
for Linux).
CKBStudio-x.x.x.dmg
and drag CKB Studio into the Applications folder.CKBStudio-x.x.x.exe
to install CKB Studio. If you see a warning window for unrecognized app, click more info and then click the Run anyway button to start the installation.CKBStudio-x.x.x.AppImage
, select Properties => Permissions => Execute, and check the option Allow executing file as progrom. Close the property window and double-click the application to open it (different Linux systems may have slightly different installation procedures).When CKB Studio is started for the first time, it will display a welcome page to help you install the dependencies for CKB development - Docker, CKB Node and CKB Compiler.
nervos/ckb
) contains all the necessary softwares and dependencies to start a CKB node.nervos/ckb-indexer
) is an application that keeps track of live cells and transactions for specified address (lock script).obsidians/capsule
) is development framework for creating CKB smart contract scripts in Rust language.nervos/ckb-riscv-gnu-toolchain
) contains all the necessary softwares and dependencies to compile CKB scripts in C.For each of the required libraries, you can select from different versions to install in the dropdown menu. The latest version is always recommended.
The main interface will show a list of CKB projects. If you open CKB Studio for the first time, this list will be empty. You can click the New button to create a new CKB project. CKB Studio has provided a list of templates to help you get started:
After a project is created, CKB Studio will automatically navigate to the project editor.
Click the Build button (with the hammer icon) in the project toolbar (above the file tree) to compile the current CKB project. CKB Studio will choose the right compiler to use depending on the project language (JavaScript or C).
There is an extra step before building a JavaScript project. You will need to type the command npm install
or yarn
manually in the terminal to install the project dependecies.
The compiled files will be at different locations based on the project language:
build/*
for JavaScript project{script_name}.o
for C projectCKB Studio has integrated the CKB debugger. Click the Debug button (with the bug icon) in the project toolbar to debug the current CKB project.
The debugger will run the mocked transaction defined in mock/tx.json
(or the file defined in the project settings). It will help you run the CKB script and check the execution result very easily.
Click the green button (with the key icon) in the bottom left corner to open the keypair manager. In the keypair manager, you can create, import, and manage CKB keys. Make sure you created some keypairs before creating a CKB node. To initialize a CKB node, you will need a miner address to receive the mining rewards.
Please note that all keys in the keypair manager are for development purpose only. The private keys are saved unencrypted so DO NOT use them on the mainnet.
Click the Network tab in the header to open the CKB network manager, where you can manage instances for CKB nodes and start running a CKB network. If you open CKB Studio for the first time, the instance list will be empty.
To create a new CKB node instance, click the New Instance button. You need to select a block assembler as the miner so make sure you have created keypairs in the Keypair Manager.
Click the Start button to start a CKB node. Once the node is started, you can see the node log, indexer log, and miner log in the terminals below.
In the Network dropdown menu you can switch to other networks such as the Aggron testnet or the CKB mainnet. Switching the network will stop your curretnly running instance.
In the Explorer tab, you can look at basic account information and transaction history.
CKB has a special cell-based structure for its transactions. The TX Constructor is a dedicated client to facilitate the construction of CKB transactions.
Cells are the fundamental elements to form CKB transactions. The bottom half of the interface is a cell explorer where you can look through available cells (live cells) for each address. To learn more about CKB cells, please refer to the cell model.
In the cell explorer, you can
If you want to make a general transaction, you need to assemble the input, output, and dep cells manually using the transaction constructor. You probably need to use some empty cells, so remember to turn on the show empty cells toggler to display them in the cell explorer. Drag the cells you need to Inputs and Depts, and click the new button next to Outputs to create output cells.
Once the inputs, deps and outputs are set properly, click the Push Transaction button where you can see the raw transaction object. Select keys you want to use to sign the transaction and click the Sign Transaction button. CKB Studio will load required private keys to finish the signing, and update the transaction object with witnesses data. Then you can click the Push Transaction button to submit the transaction, and wait until it is confirmed by the CKB network.
For some specific types of transactions, CKB Studio can help you determine which cells to use and combine them into a transaction. The following types of transactions are supported now
For example, click the Transfer button next to search bar to open the Transfer window. You can type in the amount and the recipient address, and CKB Studio will look through all available empty cells and generate a transaction that satisfies your entered values. You can also use the same button to transfer a UDT token. Next, following the same procedures as described above to sign the transaction and push it to the running CKB network.