Dash - Backend API

Comprehensive backend service for Dash providing:

📊 Real-time Price Feeds (Pyth Network Oracle)
✍️ Price Signing for on-chain verification
🚀 Relay Service for gasless transactions
🤖 Automated Order Execution (Limit orders, Grid trading, TP/SL)
📊 Position Monitoring with auto-liquidation
🎲 One Tap Profit betting settlement

🌟 Key Features

Price Oracle & Signing

✅ Pyth Network Integration - Cryptographically verified price feeds
✅ Multi-Asset Support - 12 assets (BTC, ETH, SOL, AVAX, NEAR, BNB, XRP, AAVE, ARB, DOGE, LINK, MATIC)
✅ Price Signing - ECDSA signatures for on-chain verification
✅ WebSocket Broadcasting - Real-time price updates every 5 seconds
✅ Binance Fallback - Automatic fallback if Pyth unavailable

Trading Automation

✅ Limit Order Keeper - Auto-executes limit orders when price triggers
✅ Grid Trading Bot - Manages grid trading sessions
✅ TP/SL Monitor - Auto-executes take-profit and stop-loss orders
✅ Tap-to-Trade Executor - Fast backend-only order execution
✅ Position Monitor - Auto-liquidates undercollateralized positions
✅ One Tap Profit Settlement - Automatic bet settlement

Infrastructure

✅ Relay Service - Gasless transactions with USDC gas payment
✅ RESTful API - Comprehensive endpoints for all features
✅ WebSocket Server - Real-time updates for prices and positions
✅ TypeScript - Type-safe development with full type coverage

📋 Prerequisites

Node.js >= 18.x
npm atau yarn

🚀 Installation

Install dependencies:

npm install

Setup environment variables:

cp .env.example .env

Edit .env sesuai kebutuhan:

PORT=3001
NODE_ENV=development
DEBUG=true

Configure Pyth Feeds (Add/Override Pairs)

Default feeds are defined in code, but you can add/override feeds via env:

# Option A: Individual env vars (read all keys that start with PYTH_FEED_)
PYTH_FEED_BTC=0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43
PYTH_FEED_EURUSD=0xa995d00bb36a63cef7fd2c287dc105fc8f3d93779f062f09551b0af3e81ec30b

# Option B: Provide all feeds as a JSON object (SYMBOL -> priceId)
# PYTH_FEEDS={\"BTC\":\"0x...\",\"ETH\":\"0x...\",\"XAUUSD\":\"0x...\"}

Precedence: PYTH_FEED_* overrides PYTH_FEEDS, both override defaults. Set an empty value (e.g. PYTH_FEED_SOL=) to disable a default feed.

💻 Development

npm run dev

Server akan running di http://localhost:3001

🏗️ Build & Production

# Build TypeScript to JavaScript
npm run build

# Run production
npm start

Stability Fund Streaming

Backend cron calls streamToVault() on STABILITY_FUND_ADDRESS every 6 hours using the relayer/keeper wallet (RELAY_PRIVATE_KEY and KEEPER_ADDRESS).
Interval can be adjusted with VAULT_STREAM_INTERVAL_MINUTES (default 360 minutes = 6 hours).

📡 API Endpoints

REST API

Get All Prices

GET http://localhost:3001/api/price/all

Response:

{
  "success": true,
  "data": {
    "BTC": {
      "symbol": "BTC",
      "price": 97234.56,
      "confidence": 45.32,
      "expo": -8,
      "timestamp": 1704567890123,
      "source": "pyth",
      "publishTime": 1704567890
    },
    "ETH": { ... },
    ...
  },
  "count": 12,
  "timestamp": 1704567890123
}

Get Single Asset Price

GET http://localhost:3001/api/price/current/BTC

Response:

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "price": 97234.56,
    "confidence": 45.32,
    "expo": -8,
    "timestamp": 1704567890123,
    "source": "pyth"
  },
  "timestamp": 1704567890123
}

Health Check

GET http://localhost:3001/health

Response:

{
  "success": true,
  "service": "Dash Backend",
  "uptime": 123.456,
  "priceService": {
    "status": "connected",
    "lastUpdate": 1704567890123,
    "assetsMonitored": 12
  },
  "timestamp": 1704567890123
}

WebSocket

Connect to: ws://localhost:3001/ws/price

Message Format:

{
  "type": "price_update",
  "data": {
    "BTC": {
      "symbol": "BTC",
      "price": 97234.56,
      "confidence": 45.32,
      "timestamp": 1704567890123,
      "source": "pyth"
    },
    "ETH": { ... }
  },
  "timestamp": 1704567890123
}

🔗 Integration dengan Frontend

WebSocket Client Example (JavaScript/TypeScript)

const ws = new WebSocket('ws://localhost:3001/ws/price');

ws.onopen = () => {
  console.log('Connected to Pyth price feed');
};

ws.onmessage = (event) => {
  const message = JSON.parse(event.data);
  
  if (message.type === 'price_update') {
    const prices = message.data;
    
    // Update your UI with Pyth Oracle prices
    console.log('BTC Price from Pyth:', prices.BTC.price);
    console.log('Confidence:', prices.BTC.confidence);
    
    // Display as yellow line on TradingView chart
    updateChartWithOraclePrice(prices.BTC.price);
  }
};

ws.onerror = (error) => {
  console.error('WebSocket error:', error);
};

ws.onclose = () => {
  console.log('Disconnected from price feed');
};

REST API Example (fetch)

async function getPythPrices() {
  try {
    const response = await fetch('http://localhost:3001/api/price/all');
    const result = await response.json();
    
    if (result.success) {
      const prices = result.data;
      console.log('All prices from Pyth:', prices);
      return prices;
    }
  } catch (error) {
    console.error('Failed to fetch prices:', error);
  }
}

📊 Supported Assets

Symbol	Pyth Price ID	Binance Symbol
BTC	0xe62df6...	BTCUSDT
ETH	0xff61491...	ETHUSDT
SOL	0xef0d8b6...	SOLUSDT
AVAX	0x93da335...	AVAXUSDT
NEAR	0xc415de8...	NEARUSDT
BNB	0x2f95862...	BNBUSDT
XRP	0xec5d399...	XRPUSDT
AAVE	0x2b9ab1e...	AAVEUSDT
ARB	0x3fa4252...	ARBUSDT
DOGE	0xdcef50d...	DOGEUSDT
LINK	0x8ac0c70...	LINKUSDT
MATIC	0x5de33a9...	MATICUSDT

🛠️ Architecture

┌─────────────────────────────────────────┐
│         Pyth Network Oracle             │
│     (Hermes API - hermes.pyth.network)  │
└────────────────┬────────────────────────┘
                 │ Price Feeds (5s interval)
                 ▼
┌─────────────────────────────────────────┐
│        Dash Backend Service             │
│  ┌───────────────────────────────────┐  │
│  │   PythPriceService                │  │
│  │   - Fetch all assets prices       │  │
│  │   - Fallback to Binance           │  │
│  │   - Real-time updates             │  │
│  └───────────────────────────────────┘  │
│                                          │
│  ┌──────────┐      ┌──────────────┐    │
│  │ REST API │      │  WebSocket   │    │
│  └──────────┘      └──────────────┘    │
└────────────┬─────────────┬──────────────┘
             │             │
             ▼             ▼
┌────────────────────────────────────────┐
│         Frontend Application            │
│  - TradingView Chart                   │
│  - Yellow line for Oracle price        │
│  - Real-time price updates             │
└────────────────────────────────────────┘

🖥️ Production Deployment (VPS)

Prerequisites

Ubuntu/Debian VPS (recommended: 2GB RAM minimum)
Node.js 18+ installed
Domain name (optional, for HTTPS)
Firewall configured

Step 1: Setup VPS

# Update system
sudo apt update && sudo apt upgrade -y

# Install Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# Install PM2 (process manager)
sudo npm install -g pm2

# Install Nginx (reverse proxy)
sudo apt install -y nginx

Step 2: Deploy Backend

# Clone repository
cd /var/www
sudo git clone <your-repo-url> dash-trade
cd dash-trade/dash-be

# Install dependencies
npm install

# Build TypeScript
npm run build

# Setup environment variables
sudo nano .env
# Copy all values from .env.example and configure

Step 3: Configure Environment

Edit .env file with production values:

# Server
PORT=3001
NODE_ENV=production
DEBUG=false

# Smart Contracts (from deployment)
CHAIN_ID=84532
RPC_URL=https://sepolia.base.org
MARKET_EXECUTOR_ADDRESS=0x...
POSITION_MANAGER_ADDRESS=0x...
LIMIT_EXECUTOR_ADDRESS=0x...
TAP_TO_TRADE_EXECUTOR_ADDRESS=0x...
ONE_TAP_PROFIT_ADDRESS=0x...
VAULT_POOL_ADDRESS=0x...
STABILITY_FUND_ADDRESS=0x...
USDC_TOKEN_ADDRESS=0x...
DASH_STAKING_ADDRESS=0x...
USDC_PAYMASTER_ADDRESS=0x...
# ... copy the rest from deployments JSON

# Wallets (IMPORTANT: Keep private keys secure!)
PRICE_SIGNER_PRIVATE_KEY=0x...
RELAY_PRIVATE_KEY=0x...
LIMIT_ORDER_KEEPER_PRIVATE_KEY=0x...

Step 4: Run with PM2

# Start backend with PM2
pm2 start npm --name "dash-backend" -- start

# Save PM2 config
pm2 save

# Enable PM2 startup on boot
pm2 startup
sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u $USER --hp $HOME

# Check status
pm2 status
pm2 logs dash-backend

Step 5: Configure Nginx (Reverse Proxy)

Create Nginx config:

sudo nano /etc/nginx/sites-available/dash-backend

Add configuration:

server {
    listen 80;
    server_name api.yourdomain.com; # or use IP address

    location / {
        proxy_pass http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # WebSocket support
    location /ws {
        proxy_pass http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Enable site:

# Create symlink
sudo ln -s /etc/nginx/sites-available/dash-backend /etc/nginx/sites-enabled/

# Test Nginx config
sudo nginx -t

# Restart Nginx
sudo systemctl restart nginx

Step 6: Setup SSL (HTTPS) - Optional but Recommended

# Install Certbot
sudo apt install -y certbot python3-certbot-nginx

# Get SSL certificate
sudo certbot --nginx -d api.yourdomain.com

# Auto-renewal is configured automatically
sudo certbot renew --dry-run

Step 7: Configure Firewall

# Allow SSH, HTTP, HTTPS
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

# Check status
sudo ufw status

Step 8: Monitor & Maintain

# View logs
pm2 logs dash-backend
pm2 logs dash-backend --lines 100

# Restart service
pm2 restart dash-backend

# Stop service
pm2 stop dash-backend

# Monitor resources
pm2 monit

# Update code
cd /var/www/dash-trade/dash-be
sudo git pull
npm install
npm run build
pm2 restart dash-backend

Important Production Notes

⚠️ Security Best Practices:

Private Keys: NEVER commit .env to Git. Store securely
Relay Wallet: Fund with Base Sepolia ETH for gas fees
Firewall: Only expose ports 22, 80, 443
SSL: Always use HTTPS in production
Monitoring: Setup uptime monitoring (UptimeRobot, etc.)

💰 Wallet Funding:

Relay wallet needs Base Sepolia ETH (~0.1 ETH recommended)
Price signer wallet doesn't need ETH (signing only)
Keeper wallet needs Base Sepolia ETH for order execution

🔄 Auto-Restart on Crash: PM2 automatically restarts the service if it crashes. Check logs:

pm2 logs dash-backend --err

Troubleshooting VPS Deployment

Issue: Port 3001 already in use

sudo lsof -ti:3001 | xargs sudo kill -9
pm2 restart dash-backend

Issue: Nginx 502 Bad Gateway

# Check if backend is running
pm2 status

# Check backend logs
pm2 logs dash-backend

# Restart Nginx
sudo systemctl restart nginx

Issue: Out of Memory

# Increase Node.js memory limit
pm2 start npm --name "dash-backend" --max-memory-restart 500M -- start

Issue: WebSocket connection fails

Check firewall allows connections
Verify Nginx WebSocket config
Check frontend connects to correct wss:// URL (not ws://)

🎯 Frontend Integration

Environment Variables for Frontend

Update dash-fe/.env:

# Development
NEXT_PUBLIC_BACKEND_URL=http://localhost:3001
NEXT_PUBLIC_WS_URL=ws://localhost:3001

# Production
NEXT_PUBLIC_BACKEND_URL=https://api.yourdomain.com
NEXT_PUBLIC_WS_URL=wss://api.yourdomain.com

📝 Notes

Pyth Oracle menyediakan harga yang cryptographically verified
Price update interval: 5 detik (lebih cepat dari TradingView free plan)
Confidence interval menunjukkan akurasi harga
Fallback ke Binance jika Pyth tidak available

🔧 Troubleshooting

Port already in use

# Windows
netstat -ano | findstr :3001
taskkill /PID <PID> /F

# Linux/Mac
lsof -ti:3001 | xargs kill -9

WebSocket connection failed

Check firewall settings
Make sure backend is running
Verify correct URL and port

📄 License

MIT

👥 Team

Dash Development Team

Name		Name	Last commit message	Last commit date
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

Dash - Backend API

🌟 Key Features

Price Oracle & Signing

Trading Automation

Infrastructure

📋 Prerequisites

🚀 Installation

Configure Pyth Feeds (Add/Override Pairs)

💻 Development

🏗️ Build & Production

Stability Fund Streaming

📡 API Endpoints

REST API

Get All Prices

Get Single Asset Price

Health Check

WebSocket

🔗 Integration dengan Frontend

WebSocket Client Example (JavaScript/TypeScript)

REST API Example (fetch)

📊 Supported Assets

🛠️ Architecture

🖥️ Production Deployment (VPS)

Prerequisites

Step 1: Setup VPS

Step 2: Deploy Backend

Step 3: Configure Environment

Step 4: Run with PM2

Step 5: Configure Nginx (Reverse Proxy)

Step 6: Setup SSL (HTTPS) - Optional but Recommended

Step 7: Configure Firewall

Step 8: Monitor & Maintain

Important Production Notes

Troubleshooting VPS Deployment

🎯 Frontend Integration

Environment Variables for Frontend

📝 Notes

🔧 Troubleshooting

Port already in use

WebSocket connection failed

📄 License

👥 Team

About

Resources

Stars

Watchers

Forks

Contributors

Languages