RAAKH — Ethereum L2 powered by OP Stack

Reproducible, modular, and developer-friendly. Spin up a full EVM chain with one script, secure RPC, and detailed docs—built for experimentation, education, and sovereign infra.

Goal: Enable developers & researchers to launch their own OP-Stack L2 with zero DevOps hassle.

🔧 Features

✅ EVM Compatibility

Runs on op-geth; deploy any Solidity contracts with standard tools.

🦊 Wallet Ready

Add to MetaMask as a custom RPC and start building instantly.

🚀 OP Stack

op-node + op-geth orchestrated via Kurtosis.

📦 One-Line Setup

Launch EL, batcher, proposer, bridge—containerized & reproducible.

🔐 SSL RPC

Nginx + Certbot for secure JSON-RPC at https://rpc.raakh.net.

🧪 Dev Genesis

Pre-funded accounts & fast blocks for a smooth DX.

🧩 Forkable

Tweak chain ID, block time, token meta, premine—make it yours.

📚 Detailed Docs

Step-by-step guides even if you’re new to infra.

📘 What’s inside the repo

Configs

genesis.json, kurtosis.yml, network_params.yaml

Installer

install-raakh.sh — one-shot setup & launch

Gateway

Nginx reverse proxy with SSL (Certbot)

Dockerized

All services isolated; no dependency hell

⚙️ Requirements

System

OS
Ubuntu 22.04+
Privileges
root
Disk
25–40+ GB
RAM
4–8+ GB
CPU
2 vCPUs+

Domain & Ports

Domain
rpc.raakh.net → A record to server IP
Open Ports
443, 80, 8545, 9545, 30303, 9001
SSL
Certbot via Nginx

Tools

curl, git, docker, docker-compose, nginx, certbot, bash, systemd, Kurtosis CLI


Folder Structure

network/
├─ optimism-package/
│  ├─ kurtosis.yml
│  └─ network_params.yaml
├─ raakh-setup-files/
│  ├─ genesis.json
│  ├─ install-raakh.sh
│  └─ nginx.conf
└─ README.md

🛠 Installation & Usage

Clone

git clone https://github.com/HOOPAAD/RAAKH.git
cd RAAKH/network

Make Executable

chmod +x raakh-setup-files/install-raakh.sh

Run Installer

./raakh-setup-files/install-raakh.sh

Installs deps, Kurtosis CLI, copies configs, and launches the OP-Stack enclave.

🔐 RPC & Wallet

Local RPC

http://localhost:8545

Reverse Proxy

https://rpc.raakh.net

Add to MetaMask

Network Name
RAAKH Devnet
RPC URL
https://rpc.raakh.net
Chain ID
1337
Currency
KHAS
Explorer
(optional)

🧰 RAAKH Tools

🔎 Explorer

🖼️ NFTShop

🧪 TokenFactory

📥 TokenShop

🤝 P2Pdex

❗ Troubleshooting

Kurtosis not found

echo 'export PATH="$HOME/.kurtosis/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Port 8545 in use

sudo lsof -i :8545

Nginx reload error

sudo nginx -t
sudo systemctl reload nginx

Clean & re-run

kurtosis clean --enclave raakhnet
kurtosis run . --enclave raakhnet