modbender Warren - On-Chain Website Deployment
Deploy websites and files permanently on MegaETH mainnet.
Network: MegaETH Mainnet (Chain ID: 4326)
RPC: https://mainnet.megaeth.com/rpc
Explorer: https://megaeth.blockscout.com
Setup (One Time)
cd {baseDir}
bash setup.sh
Contract Addresses (Mainnet)
| Contract | Address |
|---|---|
| Genesis Key NFT (0xRabbitNeo) | 0x0d7BB250fc06f0073F0882E3Bf56728A948C5a88 |
| 0xRabbit.agent Key NFT | 0x3f0CAbd6AB0a318f67aAA7af5F774750ec2461f2 |
| MasterNFT Registry | 0xf299F428Efe1907618360F3c6D16dF0F2Bf8ceFC |
Prerequisites
1. Wallet + MegaETH ETH
You need a wallet with real ETH on MegaETH mainnet for gas fees.
- Bridge ETH from Ethereum via the official MegaETH bridge.
- Approximate cost: ~0.001 ETH per site deploy.
Set your private key:
export PRIVATE_KEY=0xYourPrivateKey
2. Genesis Access Requirement
The deploy script checks access in this order:
- Human Genesis Key (0xRabbitNeo) ownership
- 0xRabbit.agent Key ownership
- If missing, auto-mint 0xRabbit.agent Key (free)
Default RABBIT_AGENT_ADDRESS: 0x3f0CAbd6AB0a318f67aAA7af5F774750ec2461f2 (override via env).
If you override or unset it, mint a human key manually at:
Environment Variables
| Variable | Required | Default | Purpose |
|---|---|---|---|
PRIVATE_KEY |
Yes | — | Wallet private key for signing transactions |
RPC_URL |
No | https://mainnet.megaeth.com/rpc |
MegaETH RPC endpoint |
CHAIN_ID |
No | 4326 |
MegaETH mainnet chain ID |
GENESIS_KEY_ADDRESS |
No | 0x0d7B...5a88 |
Genesis Key NFT contract |
RABBIT_AGENT_ADDRESS |
No | 0x3f0C...61f2 |
0xRabbit.agent NFT contract |
MASTER_NFT_ADDRESS |
No | 0xf299...eFC |
MasterNFT registry contract |
CHUNK_SIZE |
No | 15000 |
Bytes per chunk (15KB) |
GROUP_SIZE |
No | 500 |
Max addresses per tree node |
Deploy
Deploy HTML string
cd {baseDir}
PRIVATE_KEY=0x... node deploy.js \
--html "<html><body><h1>Hello Warren!</h1></body></html>" \
--name "My First Site"
Deploy HTML file
PRIVATE_KEY=0x... node deploy.js \
--file ./my-site.html \
--name "My Website"
Deploy via stdin
echo "<h1>Hello</h1>" | PRIVATE_KEY=0x... node deploy.js --name "Piped"
CLI Options
--private-key <key> Wallet private key (or PRIVATE_KEY env)
--html <string> HTML content to deploy
--file <path> Path to file to deploy
--name <name> Site name (default: "Untitled")
--type <type> file|image|video|audio|script (default: "file")
Output
{
"tokenId": 102,
"rootChunk": "0x019E5E...",
"depth": 0,
"url": "https://thewarren.app/v/site=102"
}
Example Workflows
Quick deploy loop
cd {baseDir}
for i in $(seq 1 5); do
HTML="<html><body><h1>Site #$i</h1><p>$(date)</p></body></html>"
PRIVATE_KEY=0x... node deploy.js --html "$HTML" --name "Site $i"
sleep 2
done
Deploy a file
cd {baseDir}
PRIVATE_KEY=0x... node deploy.js --file ./my-site.html --name "Large Site"
View Sites
https://thewarren.app/v/site={TOKEN_ID}
Troubleshooting
"No ETH balance"
- Bridge ETH to MegaETH mainnet and retry.
"No Genesis Key found and RABBIT_AGENT_ADDRESS is not configured"
- Set
RABBIT_AGENT_ADDRESS=0x3f0CAbd6AB0a318f67aAA7af5F774750ec2461f2, or mint human Genesis Key athttps://thewarren.app/mint.
"RPC rate limit"
- The script retries automatically. Add
sleep 5between repeated deployments.
Site does not load immediately
- Wait 10-30 seconds and retry the viewer URL.
Notes
- Mainnet content is permanent and immutable.
- Max 500KB per deployment.
- Default chunk size is 15KB (
CHUNK_SIZE=15000). - You pay gas from your own wallet.
Security & Privacy
- No data exfiltration: Content is sent only as blockchain transactions to the configured RPC endpoint. No intermediary servers.
- PRIVATE_KEY handling: Used solely to sign transactions. Never logged, stored on disk, or transmitted to third parties.
- Network endpoints: Only the configured
RPC_URL(default:mainnet.megaeth.com/rpc). No other outbound connections. - File access: Reads only the single file specified by
--file. No directory scanning or glob expansion. - No telemetry: No analytics, tracking, or usage reporting.