https://github.com/adridadou/eth-propeller-core
Core library for Ethereum propeller
https://github.com/adridadou/eth-propeller-core
ethereum framework java
Last synced: 8 months ago
JSON representation
Core library for Ethereum propeller
- Host: GitHub
- URL: https://github.com/adridadou/eth-propeller-core
- Owner: adridadou
- License: apache-2.0
- Created: 2017-04-11T09:41:01.000Z (almost 9 years ago)
- Default Branch: develop
- Last Pushed: 2022-11-16T02:40:11.000Z (over 3 years ago)
- Last Synced: 2023-03-22T13:03:32.571Z (about 3 years ago)
- Topics: ethereum, framework, java
- Language: Java
- Size: 633 KB
- Stars: 26
- Watchers: 10
- Forks: 16
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Ethereum Propeller
[](https://circleci.com/gh/adridadou/eth-propeller-core/tree/develop)
[](https://www.codacy.com/app/Adridadou/eth-propeller-core?utm_source=github.com&utm_medium=referral&utm_content=adridadou/eth-propeller-core&utm_campaign=Badge_Grade)
[](https://www.codacy.com/app/Adridadou/eth-propeller-core?utm_source=github.com&utm_medium=referral&utm_content=adridadou/eth-propeller-core&utm_campaign=Badge_Coverage)
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
```xml
org.adridadou
eth-propeller-{ethj or core}
{latest version}
```
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
## 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