Skip to content

openlawteam/eth-propeller-core

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ethereum Propeller

CircleCI Codacy Badge Codacy Badge

Ethereum Framework for JVM developers

Introduction

The name Ethereum Propeller comes from the idea that this framework should give your project the push it needs to reach success.

The goal of this project is to give JVM developers the tools to build applications on top of Ethereum.

The main concepts behind Ethereum propeller are:

  • Ethereum abstraction & easy integration. It should feel natural to work with ethereum and especially to work with smart contracts. The code should never be written for a particular backend, it should work regardless of your application working with RPC or an embedded client.
  • Ethereum testing. Testing is crucial for smart contracts. Any bug can be fatal and that's why writing tests should be easy
  • Type safety. Types are here to help developers write better code and can be used to sanitize inputs and document interfaces.

This is the core library for Ethereum Propeller. You still need to decide which backend you want to use. There are two possibilities right now:

  • If you want to use Ethereumj with a embedded full node, go to eth-propeller-ethj
  • If you want to use web3j to connect to a remote RPC API, go to eth-propeller-core

Getting started

Add the dependency

<dependency>
    <groupId>org.adridadou</groupId>
    <artifactId>eth-propeller-{ethj or core}</artifactId>
    <version>{latest version}</version>
</dependency>

Simply add the backend you want to use as a dependency. Right you, have the choice between ethereumj (ethj) and web3j

Create an EthereumFacade

Each backend has its own EthereumFacadeProvider

  • RpcEthereumFacadeProvider for web3j
  • EthjEthereumFacadeProvider for ethereumj

Quick introduction to EthereumFacade

EthereumFacade is your interface to Ethereum. This is how you interact with it:

  • Compile & deploy a smart contract
  • Send ether
  • Listen to Ethereum events (new block, new transactions)
  • Listen to Smart contract events
  • Interface with a smart contract

Install

mvn install -s .settings.xml

Testing

To run the project tests, install maven and then run mvn clean test.

In order to run unit tests on a mocked Ethereum network, please use eth-propeller-ethj and create a test

Note: Ethereumj's license is LPGL3. So make sure that your license is compatible with LPGL3 if you want to use ethereumJ for something else than testing

Deploy to GH Package

mvn deploy -s .settings.xml

About

Core library for Ethereum propeller

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • Java 76.3%
  • Scala 15.9%
  • Solidity 7.8%