OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Layer 1

Codechain

CodeChain is an open-source, programmable blockchain implementation written in Rust for developing and customizing systems that manage multiple asset types.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Codechain — OpenViST project profile in Layer 1.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use CodeChain when your project requires a programmable blockchain implementation to customize for multi-asset management, and your team can work with its Rust build or Docker setup.

Who it is for

  • Developers building or adapting blockchain-based multi-asset management systems.
  • Teams exploring digital-securities or tokenization systems that need to work with a blockchain implementation.

Documented uses

  • Build the CodeChain node from source or prepare it using Docker.
  • Run CodeChain in solo mode and create a block by sending a transaction through JSON-RPC or the JavaScript SDK.
  • Use the documented JavaScript SDK package as a separate way to work with CodeChain.
Before you choose

Requirements & limits

The public repository identifies CodeChain as open source under AGPL-3.0.

  • The documented source build requires Rust 1.40.0 and platform-specific build tools.
  • The Docker setup requires deliberate volume mounting if local database and key data must persist across new containers.
  • The repository documents JSON-RPC and a JavaScript SDK as transaction pathways; SDK setup requires Node.js.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Build CodeChain from source

Produce the CodeChain release executable from its source repository.

Before you start

  • Rust 1.40.0; rustup is recommended.
  • On Linux, Ubuntu with CMake, GCC, G++ and Make; the README gives separate build dependencies for macOS.
  • Windows is not supported for this source-build workflow; the README directs Windows users to use WSL as Ubuntu.

Steps

  1. Clone the CodeChain repository and enter its directory.

  2. Run the command below.

    Documented command
    cargo build --release

Expected outcome

The README says the executable is produced in `./target/release`.

Guide limitations

  • The guide covers building, not running or configuring a node.
Documentation 1 ↗
Source-based practical guide

Prepare and start CodeChain with Docker

Build a Docker image from the repository and start a CodeChain container.

Before you start

  • Docker installed.
  • The CodeChain repository checked out locally.

Steps

  1. From the repository directory, build an image with the command below.

    Documented command
    docker build -f docker/ubuntu/Dockerfile --tag kodebox/codechain:branch_or_tag_name .

  2. Start it with the command below.

    Documented command
    docker run -it kodebox/codechain:branch_or_tag_name

  3. To retain the local database and keys across new containers, mount Docker volumes to /app/codechain/db and /app/codechain/keys when running the container.

Expected outcome

The README says the container command should result in CodeChain running; volume mounts provide persistent locations for database and key data.

Guide limitations

  • A container’s database and keys are not persistent across new containers without volume mounts.
  • The README notes possible Docker difficulties with WSL; it recommends Ubuntu or Docker for Windows, with Hyper-V enabled in BIOS for Docker for Windows.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
15 October 2026
Original website title
CodeChain-io/codechain · Official homepage title · retained in its source language
How we review sourcesSuggest a correction