fhevm README

The project's README from github.com/zama-ai/fhevm. As one markdown file: README.md.

fhevm


📃 Read white paper | 📒 Documentation | 💛 Community support | 📚 FHE resources by Zama

SLSA 3

About

What is FHEVM?

FHEVM is the core framework of the Zama Confidential Blockchain Protocol. It enables confidential smart contracts on EVM-compatible blockchains by leveraging Fully Homomorphic Encryption (FHE), allowing encrypted data to be processed directly onchain.

FHEVM ensures both confidentiality and composability, with the following guarantees:



Table of contents

Project structure

The directories of this repository are organized in the following way:

FHEVM Contracts
FHEVM Compute Engines
FHEVM Utilities

Main features

Learn more about FHEVM features in the documentation and in our whitepaper.

Use cases

FHEVM is built for developers to write confidential smart contracts without the need to learn cryptography. Leveraging FHEVM, you can unlock a myriad of new use cases such as DeFi, gaming, and more. For instance:

Learn more use cases in the list of examples.

Resources

↑ Back to top

Working with FHEVM

Citations

To cite FHEVM or the whitepaper in academic papers, please use the following entries:

@Misc{FHEVM,
title={{FHEVM: A full-stack framework for integrating Fully Homomorphic Encryption (FHE) with blockchain applications},
author={Zama},
year={2025},
note={\url{https://github.com/zama-ai/fhevm}},
}

Contributing

There are two ways to contribute to FHEVM:

Becoming an approved contributor involves signing our Contributor License Agreement (CLA). Only approved contributors can send pull requests, so please make sure to get in touch before you do!

License

This software is distributed under the BSD-3-Clause-Clear license. Read this for more details.

FAQ

Is Zama’s technology free to use?

Zama’s libraries are free to use under the BSD 3-Clause Clear license only for development, research, prototyping, and experimentation purposes. However, for any commercial use of Zama's open source code, companies must purchase Zama’s commercial patent license.

Everything we do is open source, and we are very transparent on what it means for our users, you can read more about how we monetize our open source products at Zama in this blog post.

What do I need to do if I want to use Zama’s technology for commercial purposes?

To commercially use Zama’s technology you need to be granted Zama’s patent license. Please contact us at [email protected] for more information.

Do you file IP on your technology?

Yes, all Zama’s technologies are patented.

Can you customize a solution for my specific use case?

We are open to collaborating and advancing the FHE space with our partners. If you have specific needs, please email us at [email protected].

Support

Support

🌟 If you find this project helpful or interesting, please consider giving it a star on GitHub! Your support helps to grow the community and motivates further development.

↑ Back to top

fhevm (zama-ai/fhevm)

Searching Database…

24.8K ·GitHub
Что это такое?FHEVM — это фулстек-фреймворк от Zama для конфиденциальных смарт-контрактов: он совмещает полностью гомоморфное шифрование (FHE) с блокчейнами, совместимыми с EVM, чтобы зашифрованные данные можно было обрабатывать прямо в блокчейне.
Так это блокчейн, который я разворачиваю, или фреймворк, на котором я пишу своё dApp?Это фреймворк: вы пишете обычные контракты на Solidity с использованием библиотеки FHEVM и деплоите их в любую EVM-совместимую сеть. В этом репозитории есть и офчейн-часть — копроцессор на Rust, шлюз и хост-контракты, коннектор KMS, Helm-чарты и Docker-образы.
С чего начать разработку?Начните с официальной документации и репозитория с примерами. Контракты пишутся как обычный Solidity и собираются через Hardhat (поддержка Foundry появится позже); собственный набор e2e-тестов репозитория запускается командой cd test-suite/fhevm && bun run test.
Что нужно на компьютере, чтобы поднять весь стек локально?E2e-стек запускается через Docker Compose, деплой делается с помощью Helm-чартов, а базовые образы — это готовые Docker-образы для Node.js и Rust; сам тестовый скрипт работает на Bun. Ни Python, ни Go не нужны.
Какие сейчас есть подводные камни и шероховатости?Foundry пока не поддерживается — он помечен как coming soon, так что сейчас сборка только через Hardhat. Кроме того, пулл-реквесты могут открывать только одобренные контрибьюторы, подписавшие CLA; баги и идеи со стороны принимаются через issues или [email protected].
Мне нужно разбираться в криптографии, чтобы писать такие контракты?Нет — FHEVM специально создан для того, чтобы разработчики писали конфиденциальные смарт-контракты без изучения криптографии: вы просто указываете в Solidity, что остаётся зашифрованным и кто имеет доступ.
Кто на самом деле может видеть мои данные транзакций?Никто — транзакции и состояние остаются зашифрованными от начала до конца, и обновление состояния происходит без расшифровки. Расшифровка идёт через систему управления ключами на основе многосторонних вычислений (MPC), так что ни одна сторона не может расшифровать данные в одиночку.
Могу ли я бесплатно выпустить на нём коммерческий продукт?Сразу нет: код распространяется по лицензии BSD-3-Clause-Clear и бесплатен только для разработки, исследований, прототипирования и экспериментов. Любое коммерческое использование требует покупки коммерческой патентной лицензии Zama — технология запатентована.
Для каких приложений это вообще нужно?В README перечислены конфиденциальные переводы без миксеров, приватный обмен токенами и RWA, слепые аукционы, ончейн-игры со скрытыми ходами или картами, конфиденциальное голосование, защищённое от подкупа, и зашифрованные DID с аттестациями, которым не нужен ZK.
Насколько большими могут быть зашифрованные числа?До 256 бит точности, с полным набором операторов — сложение, вычитание, умножение, деление, сравнения, тернарный if и булевы операции — при этом количество последовательных FHE-операций не ограничено.
Почему вычисления над зашифрованными данными не безумно медленные?Все FHE-операции выполняются символьно на хост-цепочке, а само вычисление над зашифрованными данными асинхронно выносится на копроцессор — по словам README, это держит выполнение быстрым и масштабируемым.
Схема шифрования не устареет в будущем?Нет — используемая криптосхема FHE описывается как устойчивая к квантовым атакам, а расшифровка через KMS на базе MPC остаётся безопасной, даже если часть сторон, хранящих ключи, скомпрометирована или ведёт себя недобросовестно.
Creator
zama-ai
Size
192 MB
Stars
24.8K
Age
1y
Commits · 90 Days