https://github.com/hyperledger/besu
An enterprise-grade Java-based, Apache 2.0 licensed Ethereum client https://wiki.hyperledger.org/display/besu
https://github.com/hyperledger/besu
besu blockchain ethereum java p2p
Last synced: about 1 month ago
JSON representation
An enterprise-grade Java-based, Apache 2.0 licensed Ethereum client https://wiki.hyperledger.org/display/besu
- Host: GitHub
- URL: https://github.com/hyperledger/besu
- Owner: hyperledger
- License: apache-2.0
- Created: 2019-09-04T21:11:20.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-04-10T19:43:15.000Z (12 months ago)
- Last Synced: 2025-04-11T00:42:01.403Z (12 months ago)
- Topics: besu, blockchain, ethereum, java, p2p
- Language: Java
- Homepage: https://www.hyperledger.org/projects/besu
- Size: 90 MB
- Stars: 1,598
- Watchers: 55
- Forks: 912
- Open Issues: 224
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS.md
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
- Library-of-Ethereum - Besu - Java (Misc / Validator Clients)
- awesome-quorum - Hyperledger Besu - Enterprise Ethereum client written in Java under Apache 2.0 license, compatible with both public and permissioned networks (Software components / Enterprise Ethereum Client)
README
# Besu Ethereum Client
[](https://circleci.com/gh/hyperledger/besu/tree/main)
[](https://github.com/hyperledger/besu/actions/workflows/codeql.yml)
[](https://bestpractices.coreinfrastructure.org/projects/3174)
[](https://github.com/hyperledger/besu/blob/main/LICENSE)
[](https://discord.com/invite/hyperledger)
[](https://twitter.com/HyperledgerBesu)
[Download](https://github.com/hyperledger/besu/releases)
Besu is an Apache 2.0 licensed, MainNet compatible, Ethereum client written in Java.
## Useful Links
* [Besu User Documentation]
* [Besu Issues]
* [Besu Wiki](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/)
* [How to Contribute to Besu](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22156850/How+to+Contribute)
* [Besu Roadmap & Planning](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154278/Besu+Roadmap+Planning)
## Issues
Besu issues are tracked [in the github issues tab][Besu Issues].
See our [guidelines](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154243/Issues) for more details on searching and creating issues.
If you have any questions, queries or comments, [Besu channel on Discord] is the place to find us.
## Besu Users
To install the Besu binary, follow [these instructions](https://besu.hyperledger.org/public-networks/get-started/install/binary-distribution).
## Besu Developers
* [Contributing Guidelines]
* [Coding Conventions](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154259/Coding+Conventions)
* [Command Line Interface (CLI) Style Guide](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154260/Besu+CLI+Style+Guide)
* [Besu User Documentation] for running and using Besu
### Development
Instructions for how to get started with developing on the Besu codebase. Please also read the
[wiki](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154251/Pull+Requests) for more details on how to submit a pull request (PR).
* [Checking Out and Building](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154264/Building+from+source)
* [Code Coverage](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154288/Code+coverage)
* [Logging](https://lf-hyperledger.atlassian.net/wiki/spaces/BESU/pages/22154291/Logging) or the [Documentation's Logging section](https://besu.hyperledger.org/public-networks/how-to/monitor/logging)
### Profiling Besu
Besu supports performance profiling using [Async Profiler](https://github.com/async-profiler/async-profiler), a low-overhead sampling profiler.
You can find setup and usage instructions in the [Profiling Guide](docs/PROFILING.md).
Profiling can help identify performance bottlenecks in block processing, transaction validation, and EVM execution.
Please ensure the profiler is run as the same user that started the Besu process.
## Release Notes
[Release Notes](CHANGELOG.md)
## Reference Tests and JSON Tracing
Besu includes support for running Ethereum reference tests and generating detailed EVM execution traces.
To learn how to run the tests and enable opcode-level JSON tracing for debugging and correctness verification, see the [Reference Test Execution and Tracing Guide](REFERENCE_TESTS.md).
[Besu Issues]: https://github.com/hyperledger/besu/issues
[Besu User Documentation]: https://besu.hyperledger.org
[Besu channel on Discord]: https://discord.com/invite/hyperledger
[Contributing Guidelines]: CONTRIBUTING.md