emerald-rs's Introduction

Emerald-rs

Ethereum classic web3 like connector written in Rust.

Distributed as a command line tool (CLI), as a Rust crate or you can use it in the form of plain C library.

As a reference dApp implementation take a look at our Ethereum Classic Emerald Wallet.

Developed by ETCDEV Team.

Features

General

❏ Accounts (In Progress)
❏ Address books
❏ Transactions signing (In Progress)
❏ C interface (ABI)

Transport

❏ IPC
✓ HTTP
❏ WebSockets

Roadmap

MVP (Mar'17, In Progress)

Basic version with minimal features for developers just to build and run on local machine.

Internal Beta (Apr'17)

Internal version with general features for testing and for early DApp adopters.

Public Beta (May'17)

First public release.

Prerequisites

Ensure you have these dependencies installed:

openssl gcc pkgconfig libudev

We recommend to use parity as ethereum classic node:

$ cargo install --git https://github.com/ethcore/parity.git --branch stable --force parity

How to run parity locally in development mode (v1.5+) on port '8545' (by default):

$ parity --chain dev --no-discovery --no-ui --no-ipc --no-dapps --rpccorsdomain "*" --jsonrpc-apis "web3,eth,net,personal,parity,parity_set,traces,rpc,parity_accounts"

Installation

Ensure you have these dependencies installed:

openssl gcc pkgconfig

$ git clone https://github.com/ethereumproject/emerald-rs

Usage

How to run emerald connector (on port '1920' by default) on top of ethereum classic node:

$ RUST_LOG=emerald,rpc cargo run

For more details look at usage.

Examples

TBD, just a first design prototype:

extern crate emerald;

use emerald::Client
use emerald::transport::Http;

fn main() {
  let etc = Client::new(Http::new("http://localhost:8545").unwrap());

  println!("Accounts: {:?}", etc.eth().accounts().unwrap());
}

For more see examples folder.