fhEVM 现已上线以太坊主网
fhEVM 合约已于 12 月 30 日部署在以太坊主网上。本文将在近期更新以包含主网内容。
创建项目
使用 zama-ai/fhevm-hardhat-template 的官方模板来创建项目，点击 “use this template” 按钮，然后将其克隆到本地。
git clone <YOUR_REPO_URL>然后使用包管理器（如 npm 或 pnpm）安装必要的开发依赖。本文将使用 pnpm：
$ pnpm i要让项目正常工作，有几个注意事项。首先，@fhevm/solidity 包的演进非常快，可能需要更新到较新的版本。在我的情况下，需要更新到 0.10.0 版本。同样的，Hardhat 的 @fhevm/hardhat-plugin 插件也需要更新到预发布版本 0.3.0-4。
$ pnpm add @fhevm/solidity@0.10.0
$ pnpm add -D @fhevm/hardhat-plugin@0.3.0-4如果你不是从默认的 npm registry 安装，而是从镜像源安装，你可能会发现有些包缺失。我必须设置 --registry https://registry.npmjs.org/ 标志来安装 @nomicfoundation/slang 版本 1.3.1，这是 prettier-plugin-solidity 的一个依赖。
构建和测试
在继续之前，你需要设置 Hardhat 变量来存储一些 API 密钥或钱包私钥。这些包括你的 MetaMask 助记词、用于连接到以太坊测试网络（如 Sepolia）的 INFURA 端点 API 密钥。
$ pnpm hardhat vars set MNEMONIC
$ pnpm hardhat vars set INFURA_API_KEY构建项目
现在你可以使用以下命令编译示例合约：
$ pnpm compile
> fhevm-hardhat-template@0.3.0-1 compile /Users/chuck/Projects/fhevm-quickstart
> cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile
Generating typings for: 3 artifacts in dir: types for target: ethers-v6
Successfully generated 26 typings!
Compiled 2 Solidity files successfully (evm target: cancun).
> fhevm-hardhat-template@0.3.0-1 postcompile /Users/chuck/Projects/fhevm-quickstart
> npm run typechain
> fhevm-hardhat-template@0.3.0-1 typechain
> cross-env TS_NODE_TRANSPILE_ONLY=true hardhat typechain本地运行测试
在本地运行测试有两种方式：使用内存模拟或使用本地网络模拟。前者是默认方式，也是最快的。
$ pnpm test
> fhevm-hardhat-template@0.3.0-1 test /Users/chuck/Projects/fhevm-quickstart
> hardhat test
Counter
Counter.getCount() === 0
✔ count should be zero after deployment
✔ increment the counter by 1
✔ decrement the counter by 1
FHECounter
✔ encrypted count should be uninitialized after deployment
✔ increment the counter by 1 (43ms)
✔ decrement the counter by 1
FHECounterSepolia
This hardhat test suite can only run on Sepolia Testnet
- increment the counter by 1
6 passing (113ms)
1 pending要在本地网络上运行，你需要在单独的终端中启动 Hardhat 本地网络。
$ pnpm hardhat node
Nothing to compile
No need to generate any newer typings.
deploying "FHECounter" (tx: 0x34e7da2e5ca6185dabe9514c39a2edcf20f6c16f4bbedd25c093d4a9dc665ebb)...: deployed at 0x32103E46a0edb5F5F3509A532308755D0F6F3149 with 605285 gas
FHECounter contract: 0x32103E46a0edb5F5F3509A532308755D0F6F3149
Started HTTP and WebSocket JSON-RPC server at http://127.0.0.1:8545/
Accounts
========
Account #0: 0xD8C83D1C163aF2A69d77deeba0FD97FDA1C3b041 (10000 ETH)
Account #1: 0x92bE91002Eb44086CCee18cAD8e112c5c0dE6baA (10000 ETH)
Account #2: 0x47749FC0E32D821451f433b4E1Bff951eE371473 (10000 ETH)
Account #3: 0x479BE9b5Db5eBc457C6C01bC42a74c1DfBEebf0F (10000 ETH)
Account #4: 0x74EcD30B4a054800c029449110Cf9aA389753E7F (10000 ETH)
Account #5: 0x3d896DFea5Bf023111e0d3469C3BF608a57668E6 (10000 ETH)
Account #6: 0x4A98CBf4803275B31a6846000Cc5ab162E12bF5A (10000 ETH)
Account #7: 0xaE4f1D571bfcDA092D6CF60ef0554b127FC430Bb (10000 ETH)
Account #8: 0x5C3A21FE64B536B86f5e87395FF1971EBb40B502 (10000 ETH)
Account #9: 0xc3f59F5BaF08c22abFaB83e474663fE752BAedf9 (10000 ETH)
Account #10: 0xaF88a0c7D7D0850787f1F195410EE43293EF6A36 (10000 ETH)
Account #11: 0xbfED755917DceDa978432F2F26fa785200496f83 (10000 ETH)
Account #12: 0x2f939E5f0f5766bE195275a556F6939095da666F (10000 ETH)
Account #13: 0x5D5557ea284393D27082293B31e0dD49EDEb01D2 (10000 ETH)
Account #14: 0x65c11434fe5E6B3574F51682226dEe8ad07EB1CC (10000 ETH)
Account #15: 0xa446B10D9B10957e9Ba484A136f36abcc97b1fE0 (10000 ETH)
Account #16: 0x4F1C88990d05134F49a1760812556843f73DdfDC (10000 ETH)
Account #17: 0x95F9B794FBb50c4934C3158aCCa656B9fa7cd0C9 (10000 ETH)
Account #18: 0xf48e344C771e842b1C57809a59a9236E7859Be7b (10000 ETH)
Account #19: 0x2646d4Cd01D1eC281aDF1288e4610da6B5163fff (10000 ETH)然后使用以下命令运行测试：
$ REPORT_GAS=true pnpm hardhat test --network localhost
Counter
Counter.getCount() === 0
✔ count should be zero after deployment
✔ increment the counter by 1
✔ decrement the counter by 1
FHECounter
✔ encrypted count should be uninitialized after deployment
✔ increment the counter by 1 (54ms)
✔ decrement the counter by 1 (45ms)
FHECounterSepolia
This hardhat test suite can only run on Sepolia Testnet
- increment the counter by 1
6 passing (223ms)
1 pending
·············································································································
| Solidity and Network Configuration │
························|·················|···············|·················|································
| Solidity: 0.8.27 · Optim: true · Runs: 800 · viaIR: false · Block: 30,000,000 gas │
························|·················|···············|·················|································
| Methods │
························|·················|···············|·················|················|···············
| Contracts / Methods · Min · Max · Avg · # calls · usd (avg) │
························|·················|···············|·················|················|···············
| Counter · │
························|·················|···············|·················|················|···············
| decrement · - · - · 22,103 · 2 · - │
························|·················|···············|·················|················|···············
| increment · - · - · 43,819 · 4 · - │
························|·················|···············|·················|················|···············
| FHECounter · │
························|·················|···············|·················|················|···············
| decrement · - · - · 188,247 · 2 · - │
························|·················|···············|·················|················|···············
| increment · 210,595 · 210,607 · 210,601 · 4 · - │
························|·················|···············|·················|················|···············
| Deployments · · % of limit · │
························|·················|···············|·················|················|···············
| Counter · - · - · 152,763 · 0.5 % · - │
························|·················|···············|·················|················|···············
| FHECounter · - · - · 605,285 · 2 % · - │
························|·················|···············|·················|················|···············
| Key │
·············································································································
| ◯ Execution gas for this method does not include intrinsic gas overhead │
·············································································································
| △ Cost was non-zero but below the precision setting for the currency display (see options) │
·············································································································
| Toolchain: hardhat │
·············································································································设置 REPORT_GAS 环境变量还可以获取每个测试的 Gas 估算。
在 Sepolia 测试网上部署
如果到目前为止一切顺利，你可以继续在以太坊 Sepolia 测试网上部署，并验证已部署合约的源代码。
$ pnpm hardhat deploy --network sepolia
Generating typings for: 10 artifacts in dir: types for target: ethers-v6
Successfully generated 38 typings!
Compiled 7 Solidity files successfully (evm target: cancun).
deploying "FHECounter" (tx: 0x9a3970e5b63b94f0a559f5af9a0dcedd45fad4e39b1e1291a371cafc838282c9)...: deployed at 0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e with 605263 gas
FHECounter contract: 0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e验证功能不起作用。我发现 ./hardhat.config.ts 中的以下行需要更新。
// 这样不工作
etherscan: {
apiKey: {
sepolia: vars.get("ETHERSCAN_API_KEY", ""),
},
},
// 但这样可以工作
etherscan: {
apiKey: vars.get("ETHERSCAN_API_KEY", ""),
},pnpm hardhat verify --network sepolia 0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e
[INFO] Sourcify Verification Skipped: Sourcify verification is currently disabled. To enable it, add the following entry to your Hardhat configuration:
sourcify: {
enabled: true
}
Or set 'enabled' to false to hide this message.
For more information, visit https://v2.hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-verify#verifying-on-sourcify
Successfully submitted source code for contract
contracts/FHECounter.sol:FHECounter at 0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e
for verification on the block explorer. Waiting for verification result...
Successfully verified contract FHECounter on the block explorer.
https://sepolia.etherscan.io/address/0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e#code现在你可以在 BlockScout 上手动检查已部署的合约：https://eth-sepolia.blockscout.com/address/0x518C0365e6969a0Df58c3B9029de81ca1A8dfC2e。