confidential-fhevm

What problem does it solve?

It solves the difficulty of writing correct, production-ready confidential smart contracts by guiding an AI agent through the full Zama FHEVM workflow—contract architecture, encrypted I/O, ACL permissions, testing, deployment, and SDK v3 frontend integration—while preventing common mistakes like forbidden branching on encrypted booleans or missing FHE.allowThis after encrypted writes.

Core Features & Use Cases

• Solidity contract patterns for FHEVM: teaches the encrypted handle mental model, required ZamaEthereumConfig inheritance, and safe encrypted control-flow using FHE.select.
• Permission and decryption correctness: enforces ACL rules (FHE.allowThis, FHE.allow, allowTransient, makePubliclyDecryptable) and covers both user decryption and public 3-step decryption (makePubliclyDecryptable → publicDecrypt → checkSignatures).
• Testing and deployment across toolchains: supports both Foundry (forge-fhevm) and Hardhat (@fhevm/hardhat-plugin) tracks, plus Sepolia deployment workflow and frontend ABI syncing.
• Frontend integration with SDK v3: provides guidance for Next.js + wagmi + @zama-fhe/react-sdk v3 hooks (useEncrypt, useUserDecrypt, usePublicDecrypt, token/ERC-7984 flows) and UX patterns for making privacy understandable.
• Safety validation via a static linter: includes fhevm-lint to detect critical and high-risk anti-patterns before returning code.

Quick Start

Use the confidential-fhevm skill to generate a complete end-to-end confidential voting dApp using the prompt: "Write me a confidential voting contract with encrypted YES/NO weights, test it locally, and ship a Next.js SDK v3 frontend that supports public reveal after the deadline."