Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Gitter

What is Ciri?

Ciri is an ongoing Ethereum implementation written in Ruby. Ciri aims to become a researcher-friendly Ethereum implementation and a blockchain toolbox for all developers to modify or build their own private/public chains more conveniently in Ruby.

The goals of Ciri:

  • Be a researcher-friendly Ethereum implementation, which means Ciri needs to be intelligible and easy to be modified.
  • Be a blockchain toolbox, provide components and low-level API for developers to build their own private or public chain.
  • In general, we want Ciri to build a bridge to bring rubyist into Ethereum world!

Where will this project go?

Ciri has already passed the Ethereum tests suite and the Ethereum 1.0 POW Chain is almost implemented. However, we still need to implement several components(DevP2P, KeyStore, CLI ...) to support running a fully functionally Ethereum node on the mainnet.

At the same time, we are keeping an eye on Ethereum 2.0 specs: the shasper(sharding + casper) implementation, and pursuing to implement the lastest updated shasper specs.

Ciri project wants more contributors and we highly welcome anyone to join in. If you are interested in Ciri project, please refer to How to learn Ethereum and contribute to Ciri and Issues.

Read projects and milestones for current development status.

See our Roadmap on Wiki.


Ciri is still under active development and the master branch is really recommended.

Add this line to your Gemfile:

gem 'ciri', github: 'ciri-ethereum/ciri'

See examples and spec to learn how to use.


Ciri depends on rocksdb, secp256k1 and snappy.

Manually Setup

clone repo and submodules

git clone --recursive

Install dependencies

On a mac you can install rocksdb and snappy with homebrew

brew install rocksdb snappy

Build and install secp256k1

cd ciri && rake install:secp256k1

For linux and windows users, remember to check Dockerfile instructions for hint.

then run:

bundle install

run tests:

# run all tests
RUBY_THREAD_VM_STACK_SIZE=52428800 bundle exec rake spec[full]

Why Ruby?

Because Ruby has built-in block support!


Ruby is a scripting language which makes it easy to write prototype or research code (like the official python Ethereum implementation intended).

According to the several performance research projects in Ruby community (JIT, JRuby, TruffleRuby), we are highly looking forward to seeing improvement of this language performance in the future.

Due to Ruby, we could expect to achieve both research-friendly and high-performance in our implementation.


See Contributors