Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hyperledger-web3j/web3j-evm
A library for running an embedded Ethereum EVM in-process on a JVM
https://github.com/hyperledger-web3j/web3j-evm
ethereum evm-bytecode solidity web3j
Last synced: 3 days ago
JSON representation
A library for running an embedded Ethereum EVM in-process on a JVM
- Host: GitHub
- URL: https://github.com/hyperledger-web3j/web3j-evm
- Owner: hyperledger-web3j
- License: other
- Created: 2019-11-05T09:26:52.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-13T07:32:29.000Z (12 days ago)
- Last Synced: 2025-01-15T01:20:03.249Z (10 days ago)
- Topics: ethereum, evm-bytecode, solidity, web3j
- Language: Kotlin
- Homepage: https://web3j.io/
- Size: 43.9 MB
- Stars: 66
- Watchers: 11
- Forks: 26
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# web3j-evm [](https://github.com/web3j/web3j-evm/actions/workflows/build.yml)
Web3j-evm is an embedded freestanding Ethereum EVM and ledger running
within a Java process, which can be used for unit and integration
testing your Web3j projects.
As everything is local and in-process, there is no need to start up
external Ethereum nodes, which helps with easy of use and performance.
Everything runs within the JVM process, including EVM bytecode, which
allows for easy debugging of Solidity smart contracts.
## Getting started
Often you'd use this together with the [web3j-unit](https://github.com/web3j/web3j-unit)
project, allowing you to run unit and integration tests without the need
to start an Ethereum node.
If you want to use this within our own project directly, you would need
the EVM dependency + a few external libraries. Have a look at
the [example project](https://github.com/web3j/web3j-evmexample) on how
to do this.
```groovy
repositories {
mavenCentral()
}
dependencies {
implementation "org.web3j:core:4.12.2"
implementation "org.web3j:web3j-evm:4.12.2"
}
```
Below is a simple demonstration of ETH transactions, contract deployment
and simple contract interactions. Using the ConsoleDebugTracer, we're
able to step through the EVM bytecode, inspect the stack and also see
where in the related solidity code we're currently at.
The demo also show to how get started with the `EmbeddedWeb3jService`
which is what you'd use when building your web3j instance.
This demo is available on the [example project](https://github.com/web3j/web3j-evmexample).
