Taiko

[!WARNING] The main branch is under active development. For the latest version of the Taiko Alethia protocol contracts (Unzen fork), please use the taiko-alethia-protocol-v3.1.0 branch. The release process involves security measures that the main branch does not guarantee.

Documentation

Get started with Taiko Alethia:

• Taiko Alethia docs — High-level concepts, guides, resources, and reference pages for getting started (source: taiko-docs).
• Protocol specs — In-depth specifications of the Taiko Alethia protocol for deeper understanding.
• Smart contracts — Taiko Alethia protocol smart contracts, fully documented with NatSpec.

Packages

[!TIP] Make sure your node is using the latest version tags for taiko-client and alethia-reth. Check out the node releases page for the latest versions.

Package	Description
balance-monitor	Service that monitors Ethereum L1/L2 addresses and token balances.
bridge-ui	Bridge UI.
ejector	Preconfirmation ejector service for operators with issues.
eventindexer	Event indexer.
fork-diff	Fork diff page.
nfts	NFT-related smart contracts and utilities.
protocol	Taiko Alethia protocol smart contracts.
relayer	Bridge backend relayer.
supplementary-contracts	Supplementary contracts not part of the Taiko Alethia protocol.
taiko-client

Issues

If you find a bug or have a feature request, please open an issue.

Development prerequisites

Use the Node.js version pinned in .nvmrc and pnpm 9 for local development and CI. Node.js 22.23.4 includes the October 2026 security fixes.

From the repository root:

nvm install
nvm use
npm install --global pnpm@9
pnpm install

Contributing

Check out CONTRIBUTING.md for details on how to contribute. You can also check out our grants cycle at https://taiko.xyz/grant-program.

Getting support

Reach out to the community on Discord if you need any help!