ethereumj-personal/README.md

36 lines
2.5 KiB
Markdown
Raw Normal View History

2014-12-29 19:08:49 +00:00
# Welcome to ethereumj
2014-10-13 14:58:26 +00:00
[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/ethereum/ethereumj?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/ethereum/ethereumj.svg?branch=master)](https://travis-ci.org/ethereum/ethereumj)
[![Coverage Status](https://coveralls.io/repos/ethereum/ethereumj/badge.png?branch=master)](https://coveralls.io/r/ethereum/ethereumj?branch=master)
[![Stories in Progress](https://badge.waffle.io/ethereum/ethereumj.png?title=In%20Progress&label=in_progress)](https://waffle.io/ethereum/ethereumj)
2014-07-27 20:12:53 +00:00
![Now hiring](http://i.imgur.com/lJw1Tui.jpg)
2014-07-27 20:12:53 +00:00
# About
ethereumj is a pure-Java implementation of the Ethereum protocol. For high-level information about Ethereum and its goals, visit [ethereum.org](https://ethereum.org). The [ethereum white paper](https://github.com/ethereum/wiki/wiki/%5BEnglish%5D-White-Paper) provides a complete conceptual overview, and the [yellow paper](http://gavwood.com/Paper.pdf) provides a formal definition of the protocol.
2014-06-21 15:21:44 +00:00
This repository consists of:
* [ethereum-core](ethereumj-core): a library suitable for inclusion in any JVM-based project.
* [ethereum-studio](ethereumj-studio): a simple GUI for exploring Ethereum functionality and usage of the ethereumj API.
2014-09-10 06:17:23 +00:00
To see ethereum-studio in action, watch this [video](https://youtu.be/D5ok7jh7AOg).
2014-09-10 06:17:23 +00:00
2014-09-19 10:37:38 +00:00
# Todo
The Ethereum protocol is under heavy development, thus so is this implementation. See the [todo list](TODO.md), GitHub [Issues](https://github.com/ethereum/ethereumj/issues) and [milestone schedule](https://github.com/ethereum/ethereumj/milestones). Issues are prioritized using [waffle](http://waffle.io/ethereum/ethereumj).
2014-09-10 06:15:40 +00:00
# Contact
Chat with us via [Gitter](https://gitter.im/ethereum/ethereumj) or [#ethereumj](webchat.freenode.net/?channels=ethereumj) on Freenode.
2014-06-21 15:21:44 +00:00
# Building from source
- Clone this repository and run `./gradlew build` (or at least `./gradlew antlr4` to generate sources).
- Import all sources into IntelliJ IDEA (14+) with `File->Import project` and point to the top-level `build.gradle` file.
- Make sure to set your language level in `File->Project Structure...` to JDK 8.
- Run `Build->Make Project`. When complete, there should be no errors.
2014-06-21 19:36:10 +00:00
# Usage
For complete details on downloading, building and using [etherumj-core](ethereumj-core) and [ethereumj-studio](ethereumj-studio), see their respective readme files.
2014-06-21 15:21:44 +00:00
2014-12-26 08:36:37 +00:00
# License
ethereumj is released under the [MIT license](LICENSE).