search

tendermint / rust-abci

A rust implementation of the ABCI protocol for tendermint core
Apache License 2.0
116 stars 34 forks source link
abci basecoin blockchain cosmos ethermint rust rust-lang tendermint

readme

🚨 DEPRECATED 🚨

This repo has been deprecated. Development work continues as the "abci" crate of informalsystems/tendermint-rs. Please reference that repository in the future.

Rust ABCI

Tendermint ABCI server, written in the Rust programming language.

Current Version CircleCI

This library implements the ABCI protocol and can be used to write ABCI applications for Tendermint.

Supported Version

Installation

Dependencies

Make sure that you have Rust and Cargo installed. The easiest way is to follow the instructions on rustup.

To test the examples, please clone this repository.

git clone https://github.com/tendermint/rust-abci.git

The empty_app example, found under the examples folder, is a good demonstration/bare minimum foundation for a Rust ABCI app.

To use this library to build your own ABCI apps in Rust you have to include the following in your Cargo.toml file.

[dependencies]
abci = "0.7.2"

Development

This crate already contains the compiled ABCI protobuf messages. If you want to update protobuf messages to a newer version of Tendermint. Run make update-proto

Running the examples

Tendermint

To run either of the example apps you have to have Tendermint installed and initialised (Remember to run tendermint init!). Please install it according to these instructions. After initializing and configuring the node, Tendermint can be run with:

tendermint node

After the node is online, you can run the empty_app example using cargo run --example empty_app.

To run the counter_app run cargo run --example counter_app and send transaction to Tendermint via:

curl localhost:26657/broadcast_tx_commit?tx=0x01
curl localhost:26657/broadcast_tx_commit?tx=0x02

For a real life example of an ABCI application you can checkout Cosmos SDK or Ethermint.

Tendermint Compatibility Table

Tendermint Rust-abci
0.33.6 0.7.2
0.33.5 0.7.1
0.33.1 0.7.0
0.32.9 0.6.5
0.31.7 0.5.4

Documentation

Coming soon!

Join the Community

Find us through a variety of channels here.

Code of Conduct

Please read, understand and adhere to our code of conduct.

Credits

Original rust-tsp made by Adrian Brink.