Warren — 链上网站部署

将网站及文件永久部署至 MegaETH 主网。

网络：MegaETH 主网（链 ID：4326）
RPC：https://mainnet.megaeth.com/rpc
区块浏览器：https://megaeth.blockscout.com

初始化设置（仅需一次）

cd {baseDir}
bash setup.sh

合约地址（主网）

前置条件

1. 钱包 + MegaETH ETH

您需要一个在 MegaETH 主网上持有真实 ETH 的钱包，用于支付 Gas 费用。

• 通过官方 MegaETH 桥接器从 Ethereum 桥接 ETH 至 MegaETH。
• 单次网站部署成本约为 0.001 ETH。

设置您的私钥：

export PRIVATE_KEY=0xYourPrivateKey

2. Genesis 访问权限要求

部署脚本按以下顺序检查访问权限：

1. 持有 Human Genesis Key（0xRabbitNeo）
2. 持有 0xRabbit.agent Key
3. 若均未满足，则自动铸造一枚 0xRabbit.agent Key（免费）

默认 RABBIT_AGENT_ADDRESS：0x3f0CAbd6AB0a318f67aAA7af5F774750ec2461f2（可通过环境变量覆盖）。 若您覆盖或未设置该变量，请手动在以下地址铸造 Human Key：

• https://thewarren.app/mint

环境变量

部署

部署 HTML 字符串

cd {baseDir}
PRIVATE_KEY=0x... node deploy.js 
  --html "
Hello Warren!
" 
  --name "My First Site"

部署 HTML 文件

PRIVATE_KEY=0x... node deploy.js 
  --file ./my-site.html 
  --name "My Website"

通过 stdin 部署

echo "
Hello
" | PRIVATE_KEY=0x... node deploy.js --name "Piped"

CLI 参数选项

--private-key    钱包私钥（或使用 PRIVATE_KEY 环境变量）
--html        待部署的 HTML 内容
--file          待部署文件路径
--name          网站名称（默认为 "Untitled"）
--type          类型：file|image|video|audio|script（默认为 "file"）

输出示例

{
  "tokenId": 102,
  "rootChunk": "0x019E5E...",
  "depth": 0,
  "url": "https://thewarren.app/v/site=102"
}

示例工作流

快速批量部署循环

cd {baseDir}
for i in $(seq 1 5); do
  HTML="
Site #$i
$(date)
"
  PRIVATE_KEY=0x... node deploy.js --html "$HTML" --name "Site $i"
  sleep 2
done

部署单个文件

cd {baseDir}
PRIVATE_KEY=0x... node deploy.js --file ./my-site.html --name "Large Site"

查看已部署网站

https://thewarren.app/v/site={TOKEN_ID}

故障排查

“No ETH balance”（余额不足）

• 请先通过桥接器向 MegaETH 主网转入 ETH，然后重试。

“No Genesis Key found and RABBIT_AGENT_ADDRESS is not configured”（未找到 Genesis Key，且未配置 RABBIT_AGENT_ADDRESS）

• 请设置 RABBIT_AGENT_ADDRESS=0x3f0CAbd6AB0a318f67aAA7af5F774750ec2461f2，或前往 https://thewarren.app/mint 手动铸造 Human Genesis Key。

“RPC rate limit”（RPC 请求频率超限）

• 脚本会自动重试。如频繁部署，建议在每次调用间添加 sleep 5 延迟。

网站未立即加载

• 请等待 10–30 秒后，再次访问 viewer URL。

注意事项

• 主网上的内容永久不可变。
• 单次部署最大支持 500 KB。
• 默认分块大小为 15 KB（CHUNK_SIZE=15000）。
• Gas 费用由您自己的钱包承担。

安全与隐私

• 无数据外泄：所有内容仅作为区块链交易发送至所配置的 RPC 终端，不经过任何中间服务器。
• PRIVATE_KEY 处理方式：仅用于本地交易签名，绝不会被记录、写入磁盘或传输至第三方。
• 网络终端：仅连接所配置的 RPC_URL（默认为 mainnet.megaeth.com/rpc），无其他出站连接。
• 文件访问范围：仅读取 --file 参数指定的单一文件，不进行目录遍历或通配符展开。
• 无遥测功能：不收集任何分析数据、用户行为追踪或使用情况上报。