Genesis 部署 — 实现

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

Goal: 用全部 44 个系统合约（含 OracleHub 0x8016 + DID 0x8017-0x8019）重新部署 genesis，验证 Oracle operator tx 注入和 DID 系统合约功能的端到端流程。

Architecture: 清理旧环境 → 修改 OracleHub.initialize() 权限 → 编译系统合约 + bootloader → zkstack ecosystem init 部署 L1 + genesis → 启动节点 + Oracle 后台 → post-genesis 合约初始化 → E2E 验证全部功能。

Tech Stack: Rust (nightly-2025-03-19), Solidity (0.8.20), Docker (reth + postgres), zkstack CLI, Foundry (foundry-zksync), cast

Task 1: OracleHub.initialize() 修饰符修改 + 编译验证

目标： 将 initialize() 从 onlyCallFromBootloader 改为 onlySystemCall，使 genesis 后可通过交易调用初始化。

Files:

Modify: era-contracts-l1/system-contracts/contracts/OracleHub.sol:66

Step 1: 修改 initialize() 修饰符

将 OracleHub.sol 第 66 行的 onlyCallFromBootloader 改为 onlySystemCall：

// 修改前 (line 66):
) external onlyCallFromBootloader {

// 修改后:
) external onlySystemCall {

同时更新注释（第 60 行）：

// 修改前 (line 60):
/// @dev Uses onlyCallFromBootloader since genesis deploys run as bootloader.

// 修改后:
/// @dev Uses onlySystemCall to allow post-genesis initialization via system call.

Step 2: 编译系统合约验证

cd /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1/system-contracts
nvm use 20
yarn preprocess:system-contracts
yarn build:system-contracts

Expected: 编译成功，无 error。

Step 3: 运行 Foundry 测试回归

cd /Users/judybaby/CodeBase/github/Layer2
forge test --match-contract OracleHub -vv

Expected: 所有 OracleHub 测试通过（19 tests in OracleHubLocal 不受影响，因为 OracleHubLocal 使用独立的 admin 访问控制）。

Step 4: Commit

cd /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1
git add system-contracts/contracts/OracleHub.sol
git commit -m "feat(oracle): change initialize() from onlyCallFromBootloader to onlySystemCall

Enables post-genesis initialization of OracleHub via system call transaction,
since genesis force-deployment no longer sets initial config."

Task 2: 环境清理 (Docker + PostgreSQL)

目标： 停止旧容器、清理旧数据库，为全新 genesis 做准备。

Step 1: 停止所有 Docker 容器

cd /Users/judybaby/CodeBase/github/Layer2/era-core
docker compose down

确认容器已停止：

docker ps

Expected: 无 reth/postgres 相关容器运行。

Step 2: 清理 PostgreSQL 数据库

查看当前数据库列表：

psql -U judybaby -d postgres -c "\l" | grep -E "zksync|prover"

删除旧数据库并重建：

# 删除旧 zksync 数据库（名称可能是 zksync_local_era 或类似）
psql -U judybaby -d postgres -c "DROP DATABASE IF EXISTS zksync_local_era;"
psql -U judybaby -d postgres -c "DROP DATABASE IF EXISTS prover_local_era;"
psql -U judybaby -d postgres -c "DROP DATABASE IF EXISTS zksync_server_localhost_era;"
psql -U judybaby -d postgres -c "DROP DATABASE IF EXISTS prover_localhost_era;"

Expected: DROP DATABASE 成功（或 "does not exist"）。

Step 3: 清理 era-core 生成的配置文件

cd /Users/judybaby/CodeBase/github/Layer2/era-core
# 清理 zkstack 生成的链配置（如有）
ls -la chains/era/configs/ 2>/dev/null || echo "No chain configs to clean"

Step 4: 重新启动 Docker 容器

cd /Users/judybaby/CodeBase/github/Layer2/era-core
docker compose up -d

验证容器运行：

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Expected: reth (port 8545) 和 postgres (port 5432) 运行中。

Step 5: 验证 L1 reth 节点

cast rpc eth_chainId --rpc-url http://127.0.0.1:8545

Expected: 0x9 (chain_id = 9)

Step 6: 验证 PostgreSQL 连接

psql -U judybaby -d postgres -c "SELECT 1;"

Expected: 返回 1。

Task 3: 编译系统合约 + Bootloader

目标： 编译包含 OracleHub (onlySystemCall) + DID 合约的完整系统合约集和 bootloader。

前提： Task 1 已修改 OracleHub.sol，Task 2 环境已就绪。

Step 1: 确认 Node.js 版本

nvm use 20
node --version

Expected: v20.x.x（v24 会导致 hardhat-zksync-solc 错误）

Step 2: 预处理 + 编译系统合约

cd /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1/system-contracts
yarn preprocess:system-contracts
yarn build:system-contracts

Expected: 编译 44 个系统合约成功（包括 OracleHub 0x8016, DIDRegistry 0x8017, CredentialRegistry 0x8018, IdentityVerifier 0x8019）。

Step 3: 预处理 + 编译 Bootloader

cd /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1/system-contracts
yarn preprocess:bootloader

Expected: 7 个 bootloader 变体编译成功。新的 bootloader 不含 Oracle memory slot 代码（已在 Phase 2.5b 移除），SCRATCH_SPACE_BEGIN_SLOT = 8。

Step 4: 编译 L1 合约

cd /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1/l1-contracts
forge build

Expected: L1 合约编译成功。

Step 5: 验证 bootloader hash 已更新

bootloader hash 会在编译后自动更新到 artifacts。zkstack ecosystem init 会读取这些 artifacts 生成 genesis config。

ls -la /Users/judybaby/CodeBase/github/Layer2/era-contracts-l1/system-contracts/bootloader/build/artifacts/

Expected: 存在 proved_batch.yul.zbin 等 artifact 文件。

Task 4: zkstack ecosystem init (L1 合约 + Genesis)

目标： 使用 zkstack 部署 L1 合约到本地 reth，生成包含 44 个系统合约的 genesis block。

前提： Task 2（环境就绪）+ Task 3（合约已编译）。

⚠️ 重要：关闭系统代理再执行！

unset http_proxy
unset https_proxy
unset HTTP_PROXY
unset HTTPS_PROXY

Step 1: 运行 zkstack ecosystem init

cd /Users/judybaby/CodeBase/github/Layer2/era-core
zkstack ecosystem init

按照交互提示选择：

部署 L1 合约到 http://127.0.0.1:8545（本地 reth）
Chain name: era
Chain ID: 271
Prover mode: NoProofs
VM type: EraVM
L1 batch commit data generator mode: Rollup
数据库 URL: postgres://judybaby@localhost:5432/postgres（⚠️ 必须指定 /postgres）

Expected:

生态系统合约部署（Bridgehub, Diamond Proxy, Verifier, Governance）
ERC20 测试代币部署
Chain "era" 注册 (chain_id: 271)
Genesis block 生成（包含 44 个系统合约）
数据库初始化

Step 2: 验证 genesis 配置生成

cat /Users/judybaby/CodeBase/github/Layer2/era-core/etc/env/base/contracts.toml | head -20

Expected: 新的 GENESIS_ROOT、GENESIS_BATCH_COMMITMENT 等值已更新。

Step 3: 验证数据库已初始化

psql -U judybaby -d postgres -c "\l" | grep -E "zksync|era"

Expected: 存在新创建的 zksync 数据库。

故障排除：

如果出现代理错误：确保 http_proxy 已 unset
如果出现数据库错误：确保 DB URL 以 /postgres 结尾
如果出现 forge build 错误：确保使用 foundry-zksync 而非标准 foundry

Task 5: 启动 zksync_server + 验证 API

目标： 启动节点，验证 API 正常工作，确认 genesis 包含正确的系统合约。

Step 1: 启动 zksync_server

cd /Users/judybaby/CodeBase/github/Layer2/era-core
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
zkstack server --chain era

等待日志显示 State Keeper 和 API Server 启动完成：

State Keeper: processing L1 batch...
API Server: JSON-RPC on http://127.0.0.1:3050

Step 2: 验证链 ID

cast rpc eth_chainId --rpc-url http://127.0.0.1:3050

Expected: 0x10f (271)

Step 3: 验证 L1 chain ID

cast rpc zks_L1ChainId --rpc-url http://127.0.0.1:3050

Expected: 0x9 (9)

Step 4: 验证区块持续增长

cast rpc eth_blockNumber --rpc-url http://127.0.0.1:3050
sleep 5
cast rpc eth_blockNumber --rpc-url http://127.0.0.1:3050

Expected: 区块号持续增长。

Step 5: 验证 OracleHub 系统合约已部署

cast code 0x0000000000000000000000000000000000008016 --rpc-url http://127.0.0.1:3050

Expected: 返回非空 bytecode（0x... 大量数据）。

Step 6: 验证 DID 系统合约已部署

# DIDRegistry
cast code 0x0000000000000000000000000000000000008017 --rpc-url http://127.0.0.1:3050
# CredentialRegistry
cast code 0x0000000000000000000000000000000000008018 --rpc-url http://127.0.0.1:3050
# IdentityVerifier
cast code 0x0000000000000000000000000000000000008019 --rpc-url http://127.0.0.1:3050

Expected: 三个地址均返回非空 bytecode。

Task 6: 合约初始化 (OracleHub + setOperator)

目标： 通过 cast 交易调用 OracleHub.initialize() 和 setOperator()，完成 post-genesis 初始化。

前提： Task 5（节点运行中）。

Step 1: 确认 fee_account (operator) 地址

查看配置中的 fee_account 地址：

grep fee_account /Users/judybaby/CodeBase/github/Layer2/era-core/etc/env/base/chain.toml

Expected: 0xde03a0B5963f75f1C8485B355fF6D30f3093BDE7 或当前配置的地址。

同时需要确认 operator 的私钥（zkstack 生成的 rich wallet）：

# zkstack 默认 rich wallets 位于
cat /Users/judybaby/CodeBase/github/Layer2/era-core/etc/test_config/constant/eth.json 2>/dev/null || \
cat /Users/judybaby/CodeBase/github/Layer2/era-core/chains/era/configs/wallets.yaml 2>/dev/null

Step 2: 准备 symbol hashes

# 计算常用交易对的 keccak256 hash
export ETH_HASH=$(cast keccak "ETH/USD")
export BTC_HASH=$(cast keccak "BTC/USD")
export USDC_HASH=$(cast keccak "USDC/USD")
echo "ETH/USD hash: $ETH_HASH"
echo "BTC/USD hash: $BTC_HASH"
echo "USDC/USD hash: $USDC_HASH"

Step 3: 调用 OracleHub.initialize()

⚠️ 需要使用 isSystem: true 标志发送系统调用交易。由于 cast send 不直接支持 isSystem flag，使用 zkSync 的 EIP-712 交易格式：

# 使用 --zksync flag 发送系统调用
# PRIVATE_KEY 是 fee_account 对应的私钥（从 wallets.yaml 获取）
export PRIVATE_KEY=<从wallets.yaml获取>
export RPC_URL=http://127.0.0.1:3050

# 初始化参数: symbolHashes=[ETH,BTC,USDC], staleness=60, deviation=500, minSource=1
cast send 0x0000000000000000000000000000000000008016 \
  "initialize(bytes32[],uint256,uint256,uint8)" \
  "[$ETH_HASH,$BTC_HASH,$USDC_HASH]" \
  60 500 1 \
  --private-key $PRIVATE_KEY \
  --rpc-url $RPC_URL \
  --zksync

Expected: 交易成功 (status: 1)。

⚠️ 如果 cast --zksync 不支持 isSystem flag：

可能需要编写简短的 Node.js/TypeScript 脚本使用 zksync-ethers SDK 发送系统调用
或者在 OracleHub.sol 中将 initialize() 改为无权限修饰符（只保留 require(stalenessThreshold == 0) 防重入）

Step 4: 验证初始化成功

# 检查 stalenessThreshold
cast call 0x0000000000000000000000000000000000008016 \
  "stalenessThreshold()(uint256)" \
  --rpc-url http://127.0.0.1:3050

# 检查 operator
cast call 0x0000000000000000000000000000000000008016 \
  "operator()(address)" \
  --rpc-url http://127.0.0.1:3050

Expected:

stalenessThreshold = 60
operator = fee_account 地址

Step 5: 调用 setOperator() (如需更新 operator)

export OPERATOR_ADDR=0xde03a0B5963f75f1C8485B355fF6D30f3093BDE7

cast send 0x0000000000000000000000000000000000008016 \
  "setOperator(address)" \
  $OPERATOR_ADDR \
  --private-key $PRIVATE_KEY \
  --rpc-url $RPC_URL \
  --zksync

Expected: 交易成功 (status: 1)。

Step 6: 验证 symbol 支持

cast call 0x0000000000000000000000000000000000008016 \
  "isSymbolSupported(bytes32)(bool)" \
  $ETH_HASH \
  --rpc-url http://127.0.0.1:3050

Expected: true

Task 7: E2E 验证 (Oracle + DID + Bridge)

目标： 端到端验证 Oracle 价格注入、DID 系统、L1→L2 Bridge 所有功能。

前提： Task 6（合约初始化完成）、节点+Oracle后台运行中。

Step 1: 启动 Oracle 后台服务

如果 Oracle 后台未自动启动（取决于 zkstack 配置），手动启动：

cd /Users/judybaby/CodeBase/github/Layer2/era-core
# Oracle 后台作为 zksync_server 的一部分运行（通过 OracleWiringLayer）
# 检查日志确认 Oracle price fetcher 是否启动
# 如果没有，需要确认 baby-chain.toml 配置已被加载

⚠️ 注意： Oracle 服务是通过 OracleWiringLayer 集成到 zksync_server 的。如果 zksync_server 没有加载 Oracle 配置，可能需要单独的 Oracle 服务进程，或确认 MempoolIO 已连接 SharedOracleService。

Step 2: 验证 Oracle 价格查询

等待 Oracle 后台至少运行一个 fetch 周期（12 秒）后：

# 查询 ETH/USD 价格
cast call 0x0000000000000000000000000000000000008016 \
  "getLatestPrice(bytes32)(uint128,uint128)" \
  $ETH_HASH \
  --rpc-url http://127.0.0.1:3050

Expected: 返回非零价格和时间戳（price > 0, timestamp > 0）。

如果返回 0/0，说明 Oracle operator tx 尚未注入价格。检查：

zksync_server 日志中是否有 Oracle tx injected 日志
SharedOracleService 是否有价格数据

Step 3: 验证 DID 创建

export PRIVATE_KEY=<rich wallet private key>
export RPC_URL=http://127.0.0.1:3050

# 创建 DID — createDID(bytes32[] publicKeys, bytes32 authMethod)
# 使用一个 dummy public key
export DUMMY_KEY=0x0000000000000000000000000000000000000000000000000000000000000001
export AUTH_METHOD=$(cast keccak "secp256k1")

cast send 0x0000000000000000000000000000000000008017 \
  "createDID(bytes32[],bytes32)" \
  "[$DUMMY_KEY]" \
  $AUTH_METHOD \
  --private-key $PRIVATE_KEY \
  --rpc-url $RPC_URL \
  --zksync

Expected: 交易成功 (status: 1)。

Step 4: 验证 DID 查询

# 查询刚创建的 DID 文档
# 地址从 PRIVATE_KEY 推导
export WALLET_ADDR=$(cast wallet address --private-key $PRIVATE_KEY)

cast call 0x0000000000000000000000000000000000008017 \
  "getDocument(address)" \
  $WALLET_ADDR \
  --rpc-url http://127.0.0.1:3050

Expected: 返回非空 DID 文档数据（包含 publicKeys 和 authMethod）。

Step 5: L1→L2 Deposit

# 获取 Bridgehub 地址
export BRIDGEHUB=$(grep BRIDGEHUB_PROXY_ADDR /Users/judybaby/CodeBase/github/Layer2/era-core/etc/env/base/contracts.toml | head -1 | cut -d'"' -f2)
echo "Bridgehub: $BRIDGEHUB"

# L1 rich wallet 私钥
export L1_PRIVATE_KEY=<从wallets获取>

# 发起 L1→L2 deposit
cast send $BRIDGEHUB \
  "requestL2TransactionDirect((uint256,uint256,address,uint256,bytes,uint256,uint256,bytes[],address))" \
  "(271,0,$(cast wallet address --private-key $L1_PRIVATE_KEY),0,0x,72000000,800,[],$WALLET_ADDR)" \
  --value 1ether \
  --private-key $L1_PRIVATE_KEY \
  --rpc-url http://127.0.0.1:8545

Expected: L1 交易成功。

Step 6: 验证 L2 余额增加

等待约 10 秒让 deposit 被处理：

sleep 10
cast balance $WALLET_ADDR --rpc-url http://127.0.0.1:3050

Expected: 余额 > 0（如果 wallet 之前没有余额）。

Step 7: 验证 Batch 提交到 L1

# 检查 L1 上的最新 block
cast rpc eth_blockNumber --rpc-url http://127.0.0.1:8545

检查 zksync_server 日志中是否有 CommitBlocks 交易。

Step 8: 综合验证清单

验证项

命令

期望结果

状态

链 ID

cast rpc eth_chainId --rpc-url localhost:3050

0x10f (271)

OracleHub 已部署

cast code 0x...8016 --rpc-url localhost:3050

非空

OracleHub 已初始化

cast call 0x...8016 "stalenessThreshold()"

60

Oracle 价格

cast call 0x...8016 "getLatestPrice(bytes32)" $ETH_HASH

非零

DID 创建

cast send 0x...8017 "createDID(...)"

status=1

DID 查询

cast call 0x...8017 "getDocument(address)"

非空

L1→L2 Deposit

cast send bridgehub ... --value 1ether

status=1

L2 余额

cast balance $ADDR --rpc-url localhost:3050

> 0

DIDRegistry 已部署

cast code 0x...8017

非空

CredentialRegistry 已部署

cast code 0x...8018

非空

IdentityVerifier 已部署

cast code 0x...8019

非空

Task 8: dev-log 更新

目标： 记录 genesis 重部署的完整过程、结果和踩坑记录。

Files:

Modify: docs/dev-log.md

Step 1: 在 dev-log 末尾追加 Genesis 重部署条目

在 docs/dev-log.md 末尾添加：

---

## 2026-03-05 — Genesis 完整重部署 + E2E 验证

### 背景

完成 Phase 2.5b (Oracle operator tx 注入) + Phase 5a (DID 系统合约) 后，需要用全部 44 个系统合约重新部署 genesis，验证端到端流程。

### 变更

1. **OracleHub.initialize()**: `onlyCallFromBootloader` → `onlySystemCall`，允许 genesis 后通过系统调用交易初始化
2. **环境全面清理**: 停止 Docker 容器、删除旧数据库、重启服务
3. **全新 genesis**: 包含 OracleHub(0x8016) + DIDRegistry(0x8017) + CredentialRegistry(0x8018) + IdentityVerifier(0x8019)

### E2E 验证结果

| 验证项 | 结果 |
|--------|------|
| 链 ID (271) | ✅ |
| 系统合约部署 (44 个) | ✅ |
| OracleHub 初始化 | ✅ |
| Oracle 价格注入 | ✅/❌ |
| DID 创建 + 查询 | ✅/❌ |
| L1→L2 Deposit | ✅/❌ |

（执行时更新具体结果）

### 踩坑记录

（执行时记录实际遇到的问题和解决方案）

Step 2: Commit

cd /Users/judybaby/CodeBase/github/Layer2
git add docs/dev-log.md
git commit -m "docs: genesis 重部署 + E2E 验证开发日志"

PreviousGenesis 部署 — 设计 Next社会恢复 + 企业 IAM — 设计

Last updated 10 minutes ago

Good morning

hashtagTask 1: OracleHub.initialize() 修饰符修改 + 编译验证

hashtagTask 2: 环境清理 (Docker + PostgreSQL)

hashtagTask 3: 编译系统合约 + Bootloader

hashtagTask 4: zkstack ecosystem init (L1 合约 + Genesis)

hashtagTask 5: 启动 zksync_server + 验证 API

hashtagTask 6: 合约初始化 (OracleHub + setOperator)

hashtagTask 7: E2E 验证 (Oracle + DID + Bridge)

hashtagTask 8: dev-log 更新

Task 1: OracleHub.initialize() 修饰符修改 + 编译验证

Task 2: 环境清理 (Docker + PostgreSQL)

Task 3: 编译系统合约 + Bootloader

Task 4: zkstack ecosystem init (L1 合约 + Genesis)

Task 5: 启动 zksync_server + 验证 API

Task 6: 合约初始化 (OracleHub + setOperator)

Task 7: E2E 验证 (Oracle + DID + Bridge)

Task 8: dev-log 更新