Fhenix

Fhenix 测试网自动交互脚本

Fhenix 是一个基于完全同态加密（FHE）技术的 EVM 兼容区块链。本脚本支持与 Fhenix 测试网上的加密合约进行交互，实现 ETH 的加密、解密和领取操作。

核心功能：
1. 加密操作 - 将 ETH 加密为 eETH（加密的 ETH）
2. 解密操作 - 将 eETH 解密回 ETH
3. 领取操作 - 领取所有已解密的 ETH
4. 批量处理 - 支持多钱包自动执行
5. 灵活配置 - 可独立启用/禁用各个操作

功能特性：
- 完全同态加密技术体验
- 支持三种操作模式
- 可配置交易次数和金额
- 自动余额检查
- 支持自动执行和循环
- 详细的执行日志

使用说明：

【平台介绍】
Fhenix：基于 FHE 的 Layer 2 区块链
- 官网：https://fhenix.io/
- 测试网：基于 Ethereum Sepolia
- 技术：完全同态加密（Fully Homomorphic Encryption）
- 特点：支持链上加密计算
- 合约地址：0x87A3effB84CBE1E4caB6Ab430139eC41d156D55A

【配置说明】
在 config.ini 中设置：

【Network Settings（网络设置）】
- rpc_url：RPC 节点地址（默认 https://sepolia.drpc.org/）
- 如果默认 RPC 失效，可以修改为其他 Sepolia RPC
- 备用 RPC：https://rpc.sepolia.org/ 或 https://ethereum-sepolia.blockpi.network/v1/rpc/public

【Operation Settings（操作设置）】
- enable_encrypt：是否启用加密操作（默认 True）
- True：将 ETH 加密为 eETH
- False：跳过加密操作

• enable_decrypt：是否启用解密操作（默认 True）
• True：将 eETH 解密为 ETH
• False：跳过解密操作

• 注意：需要先有 eETH 才能解密

• enable_claim：是否启用领取操作（默认 True）

• True：领取所有已解密的 ETH
• False：跳过领取操作

• 注意：需要先执行解密操作

• encrypt_amount：每次加密的 ETH 数量（默认 0.01）

• 建议值：0.001 - 0.1 ETH

• 注意：需要确保钱包有足够余额（包括 Gas 费）

• decrypt_amount：每次解密的 eETH 数量（默认 0.0001）

• 建议值：0.0001 - 0.01 eETH

• 注意：不能超过已加密的 eETH 数量

• transactions_per_operation：每个操作的交易次数（默认 1）

• 建议值：1 - 5 次
• 例如：设置为 3，则加密 3 次、解密 3 次、领取 1 次

【Advanced Settings（高级设置）】
- request_timeout：交易确认超时时间，秒（默认 120）

【功能详细说明】

1. 加密操作（Encrypt ETH）

功能：将普通 ETH 加密为 eETH（加密的 ETH）

执行流程：
1. 检查钱包 ETH 余额
2. 调用合约的 encryptETH 函数
3. 发送指定数量的 ETH 到合约
4. ETH 被加密为 eETH 并记录在合约中
5. 等待交易确认

配置参数：
- enable_encrypt：是否启用
- encrypt_amount：每次加密的 ETH 数量
- transactions_per_operation：执行次数

注意事项：
- 需要有足够的 ETH（包括 Gas 费）
- 加密后的 eETH 存储在合约中
- 每次加密会消耗指定数量的 ETH
- 建议小额测试

2. 解密操作（Decrypt eETH）

功能：将 eETH 解密回 ETH

执行流程：
1. 调用合约的 decrypt 函数
2. 指定要解密的 eETH 数量
3. 合约将 eETH 标记为待领取状态
4. 等待交易确认
5. 解密后需要执行领取操作才能收到 ETH

配置参数：
- enable_decrypt：是否启用
- decrypt_amount：每次解密的 eETH 数量
- transactions_per_operation：执行次数

注意事项：
- 需要先执行加密操作（有 eETH 余额）
- 解密数量不能超过已有的 eETH
- 解密后 ETH 还在合约中，需要领取
- 建议与加密操作配合使用

3. 领取操作（Claim All Decrypted）

功能：领取所有已解密的 ETH

执行流程：
1. 调用合约的 claimAllDecrypted 函数
2. 合约将所有已解密的 ETH 转回钱包
3. 等待交易确认
4. ETH 到账

配置参数：
- enable_claim：是否启用

注意事项：
- 需要先执行解密操作
- 会领取所有已解密但未领取的 ETH
- 只执行一次（不受 transactions_per_operation 影响）
- 如果没有可领取的 ETH，交易可能失败

4. 完整工作流程

典型使用场景：

场景一：完整流程（加密 → 解密 → 领取）

1. 启用所有操作
2. 设置 encrypt_amount = 0.01
3. 设置 decrypt_amount = 0.0001
4. 设置 transactions_per_operation = 3

执行顺序：
- 加密 3 次（每次 0.01 ETH）
- 等待 5-10 秒
- 解密 3 次（每次 0.0001 eETH）
- 等待 5-10 秒
- 领取 1 次（领取所有已解密的 ETH）

场景二：仅加密

1. 启用 enable_encrypt = True
2. 禁用 enable_decrypt = False
3. 禁用 enable_claim = False

执行：
- 只执行加密操作
- eETH 保留在合约中
- 可以后续再执行解密和领取

场景三：解密和领取

1. 禁用 enable_encrypt = False
2. 启用 enable_decrypt = True
3. 启用 enable_claim = True

执行：
- 解密之前加密的 eETH
- 领取解密后的 ETH
- 适合分批次操作

【使用步骤】

第一步：获取测试网 ETH
1. 访问 Sepolia 水龙头获取测试 ETH
2. 推荐水龙头：
- https://sepoliafaucet.com/
- https://www.alchemy.com/faucets/ethereum-sepolia
- https://faucet.quicknode.com/ethereum/sepolia
3. 每个钱包建议至少 0.1 ETH（包括 Gas 费）

第二步：配置参数
1. 在 config.ini 中设置操作选项
2. 启用需要的操作（加密/解密/领取）
3. 设置金额和交易次数
4. 检查 RPC URL 是否可用

第三步：准备私钥
1. 在 UI 中加载 EVM 私钥
2. 确保私钥格式正确（不带 0x 前缀）
3. 钱包需要有 Sepolia 测试网 ETH

第四步：执行脚本
1. 点击「开始执行」
2. 查看日志输出
3. 等待所有钱包完成操作
4. 检查余额变化

【操作建议】

金额设置建议：
- 加密金额：0.001 - 0.01 ETH（小额测试）
- 解密金额：0.0001 - 0.001 eETH（不超过已加密的量）
- 首次使用建议最小金额测试

交易次数建议：
- 测试：1 次（了解流程）
- 正常：3-5 次（增加交互次数）
- 避免设置过高（可能导致余额不足）

操作顺序建议：
- 第一次：只启用加密，测试功能
- 第二次：启用解密和领取，完成完整流程
- 后续：根据需要灵活组合

批量处理建议：
- 钱包数量：5-20 个
- 钱包间延迟：5-10 秒
- 使用「按顺序」执行
- 确保每个钱包都有足够 ETH

【重要提示】

1. 网络要求
   - 使用 Ethereum Sepolia 测试网
   - 需要稳定的网络连接
   - RPC 可能会失效，需要更换
   - 交易确认时间约 15-30 秒

2. 余额管理
   - 加密会消耗 ETH（转入合约）
   - 解密和领取需要 Gas 费
   - 建议每个钱包留 0.01 ETH 作为 Gas 储备
   - 定期检查余额避免不足

3. 操作顺序
   - 必须先加密才能解密
   - 必须先解密才能领取
   - 可以分批次执行（先加密，后解密领取）
   - 不同钱包之间互不影响

4. Gas 费说明
   - 加密：约 0.0001 - 0.001 ETH
   - 解密：约 0.0001 - 0.001 ETH
   - 领取：约 0.0001 - 0.001 ETH
   - Gas Price 会自动从网络获取

5. 测试网特性
   - 测试网可能不稳定
   - RPC 节点可能限流
   - 交易可能需要更长确认时间
   - 如遇问题可更换 RPC

6. 错误处理
   - 余额不足：会自动跳过该钱包
   - 交易失败：会记录错误继续下一个
   - 网络超时：会等待最多 120 秒
   - RPC 失效：需要手动更换

【常见问题】

Q: 什么是 FHE（完全同态加密）？
A: FHE 是一种加密技术，允许在加密数据上直接进行计算，无需解密。Fhenix 将此技术应用于区块链，实现链上隐私计算。

Q: eETH 是什么？
A: eETH 是加密的 ETH，存储在 Fhenix 合约中。通过加密操作将 ETH 转换为 eETH，通过解密操作将 eETH 转回 ETH。

Q: 加密后的 ETH 去哪了？
A: 加密后的 ETH 存储在智能合约中，以 eETH 的形式记录。通过解密和领取操作可以取回。

Q: 解密后为什么还要领取？
A: 解密操作只是标记 eETH 为「可领取」状态，实际的 ETH 转账需要通过 claim 操作完成。这是两步式设计。

Q: 可以只执行部分操作吗？
A: 可以。通过配置文件中的 enable_encrypt、enable_decrypt、enable_claim 独立控制每个操作。

Q: 交易失败怎么办？
A: 检查余额是否足够、RPC 是否可用、网络是否稳定。如果是 eETH 不足，需要先执行加密操作。

Q: 为什么交易很慢？
A: Sepolia 测试网可能比较拥堵，交易确认时间较长。建议耐心等待或更换 RPC 节点。

Q: 如何检查操作是否成功？
A: 查看脚本日志中的余额变化。加密后余额减少，领取后余额增加。也可以在区块浏览器查看交易。

Q: 需要多少 ETH？
A: 每个钱包建议至少 0.1 ETH。加密消耗指定金额，Gas 费约 0.001 ETH/交易。

Q: 多个钱包之间会互相影响吗？
A: 不会。每个钱包的 eETH 余额独立记录在合约中，互不影响。

依赖库：
- web3：以太坊交互库

官方信息：
- 项目：Fhenix
- 网站：https://fhenix.io/
- 类型：基于 FHE 的 Layer 2 区块链
- 测试网：Sepolia
- 合约：0x87A3effB84CBE1E4caB6Ab430139eC41d156D55A

适用场景：
- Fhenix 测试网交互
- FHE 技术体验
- 加密/解密操作测试
- 批量钱包管理