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)

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:

1. Human Genesis Key (0xRabbitNeo) ownership
2. 0xRabbit.agent Key ownership
3. 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:

• https://thewarren.app/mint

Environment Variables

Deploy

Deploy HTML string

cd {baseDir}
PRIVATE_KEY=0x... node deploy.js \
  --html "\x3Chtml>\x3Cbody>\x3Ch1>Hello Warren!\x3C/h1>\x3C/body>\x3C/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 "\x3Ch1>Hello\x3C/h1>" | PRIVATE_KEY=0x... node deploy.js --name "Piped"

CLI Options

--private-key \x3Ckey>   Wallet private key (or PRIVATE_KEY env)
--html \x3Cstring>       HTML content to deploy
--file \x3Cpath>         Path to file to deploy
--name \x3Cname>         Site name (default: "Untitled")
--type \x3Ctype>         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="\x3Chtml>\x3Cbody>\x3Ch1>Site #$i\x3C/h1>\x3Cp>$(date)\x3C/p>\x3C/body>\x3C/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 at https://thewarren.app/mint.

"RPC rate limit"

• The script retries automatically. Add sleep 5 between 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.