ethereum/kohaku

Privacy-first tooling for the Ethereum ecosystem

TypeScript

403

220 commits

updated Sep 21, 2026

See the code

README

Kohaku logo

Privacy-first tooling for the Ethereum ecosystem

[!IMPORTANT] Some parts of this project are work in progress and NOT READY FOR PRODUCTION USE. Packages contain UNAUDITED CODE. Consult underlying package READMEs for more detailed information.

Repository Structure

PackageStatusDescription
@kohaku-eth/railgunrailgun shielded pool protocol lib
@kohaku-eth/tornado-cashtornado cash shielded pool protocol lib
@kohaku-eth/privacy-poolsprivacy pools shielded pool protocol lib
@kohaku-eth/pluginsshielded pool protocols standardized plugin interface
@kohaku-eth/providerprovider abstraction (ethers, viem, helios, colibri)
@kohaku-eth/pq-accountpost-quantum 4337 account implementation

Development

Navigate to the README in each package in packages/ for package specific details.

In general, easiest way to have a stable dev environment is to use nix. Install Nix here

then run:

nix develop --extra-experimental-features "nix-command flakes" --command $SHELL

fill your .env file in the root dir manually (with the vars in .env.sample) OR get a maintainer to register a sops key for you, so you can decrypt env secrets directly.

Contributors

kassandraoftroy

63 commits

lucemans

39 commits

Robert-MacWha

25 commits

ethereum/kohaku

Privacy-first tooling for the Ethereum ecosystem

TypeScript

403

220 commits

updated Sep 21, 2026

See the code

README

Kohaku logo

Privacy-first tooling for the Ethereum ecosystem

[!IMPORTANT] Some parts of this project are work in progress and NOT READY FOR PRODUCTION USE. Packages contain UNAUDITED CODE. Consult underlying package READMEs for more detailed information.

Repository Structure

PackageStatusDescription
@kohaku-eth/railgunrailgun shielded pool protocol lib
@kohaku-eth/tornado-cashtornado cash shielded pool protocol lib
@kohaku-eth/privacy-poolsprivacy pools shielded pool protocol lib
@kohaku-eth/pluginsshielded pool protocols standardized plugin interface
@kohaku-eth/providerprovider abstraction (ethers, viem, helios, colibri)
@kohaku-eth/pq-accountpost-quantum 4337 account implementation

Development

Navigate to the README in each package in packages/ for package specific details.

In general, easiest way to have a stable dev environment is to use nix. Install Nix here

then run:

nix develop --extra-experimental-features "nix-command flakes" --command $SHELL

fill your .env file in the root dir manually (with the vars in .env.sample) OR get a maintainer to register a sops key for you, so you can decrypt env secrets directly.

Contributors

kassandraoftroy

63 commits

lucemans

39 commits

Robert-MacWha

25 commits

Languages

TypeScript

49.8%

Rust

35.4%

Solidity

5.4%

JavaScript

4.6%

HTML

1.8%

Python

1.4%

Sage

1.2%