Skip to content
BranchesTags

Latest commit

History

6,991 Commits

Folders and files

NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle

Repository files navigation

teku

Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow

Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.

See the Changelog for details of the latest releases and upcoming breaking changes.

Useful links

Teku users

See our user documentation.

Raise a documentation issue or get in touch in the #teku channel on Discord if you've got questions or feedback.

Teku developers

Binary Releases

Binary releases are available from the releases page. Binary builds that track the latest changes on the master branch are available on Dockerhub using the develop version or as binary downloads (tar.gz format or zip format).

We recommend only using release versions for Mainnet, but develop builds are useful for testing the latest changes on testnets.

Release notifications are available via:

Build Instructions

Install Prerequisites

  • Java 25+

Note: Official builds of Teku are performed with Java 25. Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.

Build and Dist

To create a ready to run distribution:

git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist

This produces:

  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku

Build and Test

To build, clone this repo and run with gradle:

git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.

Other Useful Gradle Targets

TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image

Code Style

We use Google's Java coding conventions for the project. To reformat code, run:

./gradlew spotlessApply

Code style is checked automatically during a build.

Testing

All the unit tests are run as part of the build, but can be explicitly triggered with:

./gradlew test

Special thanks

YourKit

YourKit Logo

For providing us free open source licenses for their profiler.

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

OrbStack

OrbStack Logo

For providing us free open source licenses for their application.

OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.

About

🚀 Open-source Ethereum consensus client written in Java

consensys.io/teku

Topics

beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku

Resources

Readme
Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

777 stars

Watchers

32 watching

Forks

388 forks
Report repository

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
})();
GitHub - Consensys/teku: 🚀 Open-source Ethereum consensus client written in Java · GitHub
Skip to content
BranchesTags
Latest commit
History
6,991 Commits
Folders and files
NameName
Last commit message
Last commit date
.codespell
.codespell
.github
.github
.openapidoc
.openapidoc
acceptance-tests
acceptance-tests
beacon
beacon
buildSrc
buildSrc
data
data
docker
docker
docs
docs
eth-benchmark-tests
eth-benchmark-tests
eth-reference-tests
eth-reference-tests
eth-tests
eth-tests
ethereum
ethereum
fork-choice-tests
fork-choice-tests
fuzz
fuzz
gradle
gradle
infrastructure
infrastructure
interop-keys
interop-keys
networking
networking
scripts
scripts
services
services
specrefs
specrefs
storage
storage
teku
teku
test-network
test-network
validator
validator
.gitattributes
.gitattributes
.gitignore
.gitignore
AGENTS.md
AGENTS.md
BugTriaging.md
BugTriaging.md
CHANGELOG.md
CHANGELOG.md
CLA.md
CLA.md
CLAUDE.md
CLAUDE.md
CODE-OF-CONDUCT.md
CODE-OF-CONDUCT.md
CODEOWNERS
CODEOWNERS
CONTRIBUTING.md
CONTRIBUTING.md
GOVERNANCE.md
GOVERNANCE.md
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
build.gradle
build.gradle
community-membership.md
community-membership.md
gradle.properties
gradle.properties
gradlew
gradlew
mlc_config.json
mlc_config.json
renovate.json
renovate.json
settings.gradle
settings.gradle
Repository files navigation
teku
Build StatusGitHub LicenseDocumentationconsensus-specsDiscordTwitter Follow
Teku is an open-source Ethereum consensus client written in Java and containing a full beacon node and validator client implementation.
See the Changelog for details of the latest releases and upcoming breaking changes.
Useful links
Teku users
See our user documentation.
Raise a documentation issue or get in touch in
the #teku channel on Discord if you've got questions or feedback.
Teku developers
Binary Releases
Binary releases are available from the releases page.
Binary builds that track the latest changes on the master branch are available on
Dockerhub using the develop version or as binary
downloads (tar.gz format
or zip format).
We recommend only using release versions for Mainnet, but develop builds are useful for testing
the latest changes on testnets.
Release notifications are available via:
Build Instructions
Install Prerequisites
  • Java 25+
Note: Official builds of Teku are performed with Java 25.
Building on a more recent version of Java is supported, but the resulting build will not work on earlier versions of Java.
Build and Dist
To create a ready to run distribution:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew distTar installDist
This produces:
  • Fully packaged distribution in build/distributions
  • Expanded distribution, ready to run in build/install/teku
Build and Test
To build, clone this repo and run with gradle:
git clone https://github.com/Consensys/teku.git
cd teku && ./gradlew

After a successful build, distribution packages are available in build/distributions.
Other Useful Gradle Targets
TargetBuilds
distTarFull distribution in build/distributions (as .tar.gz)
distZipFull distribution in build/distributions (as .zip)
installDistExpanded distribution in build/install/teku
distDockerThe consensys/teku docker image
Code Style
We use Google's Java coding conventions for the project. To reformat code, run:
./gradlew spotlessApply
Code style is checked automatically during a build.
Testing
All the unit tests are run as part of the build, but can be explicitly triggered with:
./gradlew test
Special thanks
YourKit
YourKit Logo
For providing us free open source licenses for their profiler.
YourKit supports open source projects with innovative and intelligent tools
for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler,
YourKit .NET Profiler,
and YourKit YouMonitor.
OrbStack
OrbStack Logo
For providing us free open source licenses for their application.
OrbStack delivers a fast, light, and easy way to run Docker containers and Linux. Check it out on https://orbstack.dev/.
About
🚀 Open-source Ethereum consensus client written in Java
consensys.io/teku
Topics
beacon-chainconsensyseth2eth2-clientsethereumjavaproof-of-staketeku
Resources
Readme
Apache-2.0 license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Custom properties
Stars
777 stars
Watchers
32 watching
Forks
388 forks
Report repository
Releases
Used by
Contributors
Languages