ConsenSys/ethereumj

Name: ethereumj

Owner: ConsenSys

Description: Java implementation of the Ethereum yellowpaper

Forked from: ethereum/ethereumj

Created: 2018-02-19 21:25:37.0

Updated: 2018-02-19 21:25:42.0

Pushed: 2018-02-17 07:12:08.0

Homepage:

Size: 45450

Language: Java

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Welcome to ethereumj

About

ethereumj is a pure-Java implementation of the Ethereum protocol. For high-level information about Ethereum and its goals, visit ethereum.org. The ethereum white paper provides a complete conceptual overview, and the yellow paper provides a formal definition of the protocol.

Running EthereumJ

Adding as a dependency to your Maven project:

dependency>
 <groupId>org.ethereum</groupId>
 <artifactId>ethereumj-core</artifactId>
 <version>1.5.0-RELEASE</version>
/dependency>

or your Gradle project:

epositories {
   mavenCentral()

ompile "org.ethereum:ethereumj-core:1.5.+"

As a starting point for your own project take a look at https://github.com/ether-camp/ethereumj.starter

Building an executable JAR

clone https://github.com/ethereum/ethereumj
thereumj
thereumj-core/src/main/resources/ethereumj.conf ethereumj-core/src/main/resources/user.conf
ethereumj-core/src/main/resources/user.conf # adjust user.conf to your needs
adlew clean shadowJar
 -jar ethereumj-core/build/libs/ethereumj-core-*-all.jar

Running from command line:

t clone https://github.com/ethereum/ethereumj
 ethereumj
gradlew run [-PmainClass=<sample class>]

Optional samples to try:

adlew run -PmainClass=org.ethereum.samples.BasicSample
adlew run -PmainClass=org.ethereum.samples.FollowAccount
adlew run -PmainClass=org.ethereum.samples.PendingStateSample
adlew run -PmainClass=org.ethereum.samples.PriceFeedSample
adlew run -PmainClass=org.ethereum.samples.PrivateMinerSample
adlew run -PmainClass=org.ethereum.samples.TestNetSample
adlew run -PmainClass=org.ethereum.samples.TransactionBomb

Importing project to IntelliJ IDEA:

t clone https://github.com/ethereum/ethereumj
 ethereumj
adlew build

IDEA:

• File -> New -> Project from existing sources?
• Select ethereumj/build.gradle
• Dialog ?Import Project from gradle?: press ?OK?
• After building run either org.ethereum.Start, one of org.ethereum.samples.* or create your own main.

Configuring EthereumJ

For reference on all existing options, their description and defaults you may refer to the default config ethereumj.conf (you may find it in either the library jar or in the source tree ethereum-core/src/main/resources) To override needed options you may use one of the following ways:

• put your options to the <working dir>/config/ethereumj.conf file
• put user.conf to the root of your classpath (as a resource)
• put your options to any file and supply it via -Dethereumj.conf.file=<your config>
• programmatically by using SystemProperties.CONFIG.override*()
• programmatically using by overriding Spring SystemProperties bean

Note that don?t need to put all the options to your custom config, just those you want to override.

Special thanks

YourKit for providing us with their nice profiler absolutely for free.

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Contact

Chat with us via Gitter

License

ethereumj is released under the LGPL-V3 license.