Fast, light, robust Ethereum implementation
Rust JavaScript CSS C++ Shell NSIS Other
Permalink
Failed to load latest commit information.
dapps jsonr rpc bump for IPC fix (#4200) Jan 18, 2017
db v1.6 in master (#4113) Jan 10, 2017
devtools v1.6 in master (#4113) Jan 10, 2017
docker added build-essential dep to dockerfiles (#3666) Nov 29, 2016
ethash v1.6 in master (#4113) Jan 10, 2017
ethcore ValidatorSet reporting (#4208) Jan 24, 2017
ethcrypto Get rid of unsafe code in ethkey, propagate incorrect Secret errors. (#… Jan 11, 2017
ethkey Secret - from hash function, also validate data (#4159) Jan 16, 2017
ethstore Get rid of unsafe code in ethkey, propagate incorrect Secret errors. (#… Jan 11, 2017
evmbin Port `try` macro to new `?` operator. (#3962) Dec 27, 2016
evmjit v1.6 in master (#4113) Jan 10, 2017
hash-fetch v1.6 in master (#4113) Jan 10, 2017
ipc-common-types Don't panic on uknown git commit hash (#4231) Jan 20, 2017
ipc v1.6 in master (#4113) Jan 10, 2017
js [ci skip] js-precompiled 20170124-105551 Jan 24, 2017
json ValidatorSet reporting (#4208) Jan 24, 2017
logger v1.6 in master (#4113) Jan 10, 2017
mac v1.6 in master (#4113) Jan 10, 2017
nsis v1.6 in master (#4113) Jan 10, 2017
parity Integration with zgp whitelist contract (#4215) Jan 22, 2017
rpc Integration with zgp whitelist contract (#4215) Jan 22, 2017
rpc_cli Port `try` macro to new `?` operator. (#3962) Dec 27, 2016
rpc_client jsonr rpc bump for IPC fix (#4200) Jan 18, 2017
scripts Update deb-build.sh to fix libssl dependency (#4260) Jan 22, 2017
signer jsonr rpc bump for IPC fix (#4200) Jan 18, 2017
stratum jsonr rpc bump for IPC fix (#4200) Jan 18, 2017
sync Integration with zgp whitelist contract (#4215) Jan 22, 2017
updater Updater fixes (#4196) Jan 17, 2017
util Memory-based pruning history size (#4114) Jan 20, 2017
windows/ptray Rename ethcore -> parity in license. Dec 11, 2016
.editorconfig Fixing travis.yml Jul 11, 2016
.gitignore Only ignore parity.* files in root Dec 12, 2016
.gitlab-ci.yml update gitlab-ci Jan 19, 2017
.gitmodules Removing submodule in favour of rust crate (#2756) Oct 22, 2016
.travis.yml Enable Panic=abort (#3423) Dec 8, 2016
Cargo.lock [ci skip] js-precompiled 20170124-105551 Jan 24, 2017
Cargo.toml jsonr rpc bump for IPC fix (#4200) Jan 18, 2017
LICENSE Change to library. Nov 24, 2015
README.md update version numbers in README Jan 19, 2017
appveyor.yml Rust 1.14 for windows builds (#4269) Jan 23, 2017
build.rs Rename ethcore -> parity in license. Dec 11, 2016
license_header Rename ethcore -> parity in license. Dec 11, 2016
rustfmt.toml Some tuning of rustfmt Apr 13, 2016
test.sh Enable Panic=abort (#3423) Dec 8, 2016

README.md

Parity

Fast, light, and robust Ethereum implementation

Build Status build status Coverage Status GPLv3

Join the chat!

Parity Join the chat at https://gitter.im/ethcore/parity and parity.js Join the chat at https://gitter.im/ethcore/parity.js

Internal Documentation

Be sure to check out our wiki for more information.

Parity requires Rust version 1.13.0 to build


About Parity

Parity's goal is to be the fastest, lightest, and most secure Ethereum client. We are developing Parity using the sophisticated and cutting-edge Rust programming language. Parity is licensed under the GPLv3, and can be used for all your Ethereum needs.

Parity comes with a built-in wallet. To access Parity Wallet this simply go to http://127.0.0.1:8080/. It includes various functionality allowing you to:

  • create and manage your Ethereum accounts;
  • manage your Ether and any Ethereum tokens;
  • create and register your own tokens;
  • and much more.

By default, Parity will also run a JSONRPC server on 127.0.0.1:8545. This is fully configurable and supports a number of RPC APIs.

If you run into an issue while using parity, feel free to file one in this repository or hop on our gitter chat room to ask a question. We are glad to help!

Parity's current release is 1.5. You can download it at https://ethcore.io/parity.html or follow the instructions below to build from source.


Build dependencies

Parity is fully compatible with Stable Rust.

We recommend installing Rust through rustup. If you don't already have rustup, you can install it like this:

  • Linux:

    $ curl https://sh.rustup.rs -sSf | sh

    Parity also requires gcc, g++, libssl-dev/openssl and pkg-config packages to be installed.

  • OSX:

    $ curl https://sh.rustup.rs -sSf | sh

    clang is required. It comes with Xcode command line tools or can be installed with homebrew.

  • Windows

    Make sure you have Visual Studio 2015 with C++ support installed. Next, download and run the rustup installer from https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe, start "VS2015 x64 Native Tools Command Prompt", and use the following command to install and set up the msvc toolchain:

    $ rustup default stable-x86_64-pc-windows-msvc
    

Once you have rustup, install parity or download and build from source


Quick install

cargo install --git https://github.com/ethcore/parity.git parity

Build from source

# download Parity code
$ git clone https://github.com/ethcore/parity
$ cd parity

# build in release mode
$ cargo build --release

This will produce an executable in the ./target/release subdirectory.


Simple one-line installer for Mac and Ubuntu

bash <(curl https://get.parity.io -Lk)

Start Parity

Manually

To start Parity manually, just run

$ ./target/release/parity

and Parity will begin syncing the Ethereum blockchain.

Using systemd service file

To start Parity as a regular user using systemd init:

  1. Copy parity/scripts/parity.service to your systemd user directory (usually ~/.config/systemd/user).
  2. To pass any argument to Parity, write a ~/.parity/parity.conf file this way: ARGS="ARG1 ARG2 ARG3".

    Example: ARGS="ui --geth --identity MyMachine".