Warren Deploy

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. Create a Wallet

node -e "const w = require('ethers').Wallet.createRandom(); console.log('Address:', w.address); console.log('Private Key:', w.privateKey)"

Set the private key:

export PRIVATE_KEY=0xYourPrivateKey

2. Get MegaETH ETH

You need 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.

Check balance:

node -e "const{ethers}=require('ethers');new ethers.JsonRpcProvider('https://mainnet.megaeth.com/rpc',4326).getBalance('$YOUR_ADDRESS').then(b=>console.log(ethers.formatEther(b),'ETH'))"

3. 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

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 larger site (~50KB)

python3 -c "
html = '<html><body>'
for i in range(1000):
    html += f'<p>Paragraph {i}: Lorem ipsum dolor sit amet</p>'
html += '</body></html>'
print(html)
" > large-site.html

PRIVATE_KEY=0x... node deploy.js --file large-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 100KB (CHUNK_SIZE=100000).
• You pay gas from your own wallet.