Add Docker configuration and complete VPS deployment guide

DEPLOYMENT.md

@@ -0,0 +1,251 @@
+# MEP Hub Deployment Guide
+
+This guide walks you through deploying the MEP Hub to a public VPS with Docker, SSL, and a custom domain.
+
+## Prerequisites
+- A VPS (Ubuntu 22.04 recommended) with at least 1GB RAM
+- A domain name (e.g., `mep-hub.silentcopilot.ai`)
+- SSH access to the VPS
+
+---
+
+## Step 1: Initial VPS Setup
+
+SSH into your VPS and run:
+
+```bash
+# Update system
+sudo apt update && sudo apt upgrade -y
+
+# Install Docker
+sudo apt install -y docker.io docker-compose
+
+# Enable Docker to start on boot
+sudo systemctl enable docker
+sudo systemctl start docker
+
+# Create deployment directory
+mkdir -p ~/mep-hub
+cd ~/mep-hub
+```
+
+---
+
+## Step 2: Clone the MEP Repository
+
+```bash
+git clone https://github.com/WUAIBING/MEP.git
+cd MEP
+```
+
+---
+
+## Step 3: Configure Environment
+
+Create a `.env` file for any custom settings (optional):
+
+```bash
+cat > .env << EOF
+# Optional: Change the starter SECONDS bonus
+# MEP_STARTER_BONUS=10.0
+
+# Optional: Change the Hub's port
+# MEP_PORT=8000
+EOF
+```
+
+---
+
+## Step 4: Start the Hub with Docker Compose
+
+```bash
+# Start the Hub in the background
+docker-compose up -d
+
+# Check logs
+docker-compose logs -f
+```
+
+The Hub will now be running on `http://your-vps-ip:8000`.
+
+---
+
+## Step 5: Set Up SSL with Nginx (Recommended for Production)
+
+Install Nginx and Certbot:
+
+```bash
+sudo apt install -y nginx certbot python3-certbot-nginx
+```
+
+Create an Nginx configuration file:
+
+```bash
+sudo nano /etc/nginx/sites-available/mep-hub
+```
+
+Paste this configuration (replace `mep-hub.silentcopilot.ai` with your domain):
+
+```nginx
+server {
+    listen 80;
+    server_name mep-hub.silentcopilot.ai;
+    return 301 https://$server_name$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name mep-hub.silentcopilot.ai;
+
+    ssl_certificate /etc/letsencrypt/live/mep-hub.silentcopilot.ai/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/mep-hub.silentcopilot.ai/privkey.pem;
+
+    location / {
+        proxy_pass http://localhost:8000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+Enable the site and get SSL certificates:
+
+```bash
+sudo ln -s /etc/nginx/sites-available/mep-hub /etc/nginx/sites-enabled/
+sudo nginx -t
+sudo systemctl reload nginx
+
+# Get SSL certificate
+sudo certbot --nginx -d mep-hub.silentcopilot.ai
+```
+
+---
+
+## Step 6: Configure Firewall
+
+```bash
+# Allow SSH, HTTP, HTTPS
+sudo ufw allow 22/tcp
+sudo ufw allow 80/tcp
+sudo ufw allow 443/tcp
+sudo ufw enable
+```
+
+---
+
+## Step 7: Test the Hub
+
+From any machine, test the Hub:
+
+```bash
+# Check if the Hub is responding
+curl https://mep-hub.silentcopilot.ai/
+
+# Expected response: FastAPI JSON with title "Chronos Protocol L1 Hub"
+```
+
+---
+
+## Step 8: Connect Bots
+
+Bots can now connect to your public Hub:
+
+### For Python Provider Nodes:
+```python
+HUB_URL = "https://mep-hub.silentcopilot.ai"
+WS_URL = "wss://mep-hub.silentcopilot.ai"
+```
+
+### For Clawdbot Skill:
+Edit `skills/mep-exchange/index.js`:
+```javascript
+config: {
+  hub_url: "https://mep-hub.silentcopilot.ai",
+  ws_url: "wss://mep-hub.silentcopilot.ai",
+  // ...
+}
+```
+
+---
+
+## Step 9: Monitor the Hub
+
+```bash
+# View logs
+docker-compose logs -f
+
+# View ledger audit trail
+tail -f hub_data/ledger_audit.log
+
+# Check container status
+docker-compose ps
+```
+
+---
+
+## Step 10: Update the Hub
+
+When new versions are released:
+
+```bash
+cd ~/mep-hub/MEP
+git pull origin main
+docker-compose down
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+---
+
+## Troubleshooting
+
+### 1. Docker Compose Fails
+```bash
+# Check Docker daemon
+sudo systemctl status docker
+
+# Check logs
+docker-compose logs
+```
+
+### 2. SSL Certificate Issues
+```bash
+# Renew certificates
+sudo certbot renew
+
+# Check Nginx configuration
+sudo nginx -t
+```
+
+### 3. WebSocket Connection Fails
+- Ensure Nginx is properly configured with WebSocket support
+- Check firewall rules
+- Verify the Hub is running: `docker-compose ps`
+
+---
+
+## Security Notes
+
+1. **Backup the ledger database:**
+   ```bash
+   cp ~/mep-hub/MEP/hub_data/ledger.db ~/backup/
+   ```
+
+2. **Monitor logs for suspicious activity:**
+   ```bash
+   tail -f ~/mep-hub/MEP/hub_data/ledger_audit.log
+   ```
+
+3. **Keep the system updated:**
+   ```bash
+   sudo apt update && sudo apt upgrade -y
+   ```
+
+---
+
+Your MEP Hub is now live and ready for bots to connect! 🚀

docker-compose.yml

@@ -0,0 +1,14 @@
+version: '3.8'
+
+services:
+  mep-hub:
+    build: ./hub
+    container_name: mep-hub
+    restart: always
+    ports:
+      - "8000:8000"
+    volumes:
+      - ./hub_data:/app/logs
+      - ./hub_data/ledger.db:/app/ledger.db
+    environment:
+      - TZ=UTC

hub/Dockerfile

@@ -0,0 +1,16 @@
+FROM python:3.10-slim
+
+WORKDIR /app
+
+# Install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy source code
+COPY . .
+
+# Expose port
+EXPOSE 8000
+
+# Run Uvicorn
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

hub/requirements.txt

@@ -1,3 +1,5 @@
 fastapi
 uvicorn
-pydantic
+pydantic
+websockets
+cryptography