Add Netlify deployment, Qdrant integration with openSVM compatibility, and REST API for dynamic IDL management

.env.example

@@ -0,0 +1,11 @@
+# Qdrant Database Configuration
+# Get your Qdrant instance from https://cloud.qdrant.io/
+QDRANT_URL=http://localhost:6333
+QDRANT_API_KEY=your_qdrant_api_key_here
+
+# Alternative environment variables (for compatibility with aldrin-labs/openSVM)
+QDRANT_SERVER=http://localhost:6333
+QDRANT=your_qdrant_api_key_here
+
+# Node Environment
+NODE_ENV=development

NETLIFY.md

@@ -0,0 +1,211 @@
+# Netlify Deployment Guide for IDLHub
+
+This guide covers deploying IDLHub to Netlify with Qdrant integration for enhanced search capabilities.
+
+## Quick Deploy
+
+[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/openSVM/idlhub)
+
+## Prerequisites
+
+- Netlify account (free tier works)
+- Qdrant instance (local or [Qdrant Cloud](https://cloud.qdrant.io/))
+- GitHub account (for automatic deployments)
+
+## Deployment Steps
+
+### 1. Connect Repository to Netlify
+
+1. Log in to [Netlify](https://app.netlify.com/)
+2. Click **"Add new site"** → **"Import an existing project"**
+3. Select **GitHub** and authorize Netlify
+4. Choose the `openSVM/idlhub` repository
+5. Configure build settings (Netlify will auto-detect `netlify.toml`)
+
+### 2. Configure Environment Variables
+
+In Netlify dashboard, go to **Site settings** → **Environment variables** and add:
+
+```
+QDRANT_URL=https://your-qdrant-instance.qdrant.tech:6333
+QDRANT_API_KEY=your_qdrant_api_key_here
+NODE_ENV=production
+```
+
+**Getting Qdrant credentials:**
+- Sign up at [Qdrant Cloud](https://cloud.qdrant.io/)
+- Create a new cluster
+- Copy the cluster URL and API key
+
+### 3. Deploy
+
+Click **"Deploy site"**. Netlify will:
+- Build the site (no build step needed for static files)
+- Deploy to CDN
+- Set up redirects (configured in `netlify.toml`)
+
+### 4. Initialize Qdrant Database
+
+After deployment, initialize Qdrant with IDL data:
+
+```bash
+# Clone the repository locally
+git clone https://github.com/openSVM/idlhub.git
+cd idlhub
+
+# Install dependencies
+npm install
+
+# Set environment variables
+cp .env.example .env
+# Edit .env with your Qdrant credentials
+
+# Initialize Qdrant
+npm run qdrant:init
+```
+
+## Netlify Configuration
+
+The `netlify.toml` file configures:
+
+### Redirects
+
+- `/mcp` → `/install.sh` - Installation script endpoint
+- `/install` → `/install.sh` - Alternative endpoint
+- `/*` → `/index.html` - SPA fallback
+
+### Headers
+
+- **Content-Type** headers for `.sh` and `.json` files
+- **Security headers** (X-Frame-Options, X-XSS-Protection, etc.)
+- **Cache-Control** headers for optimal performance
+
+## Custom Domain Setup
+
+1. In Netlify dashboard, go to **Domain settings**
+2. Click **"Add custom domain"**
+3. Enter your domain (e.g., `idlhub.com`)
+4. Configure DNS:
+   - Add CNAME record: `your-site.netlify.app`
+   - Or use Netlify DNS (recommended)
+
+## Qdrant Integration Features
+
+Once Qdrant is initialized, IDLHub gains:
+
+- **Semantic search** for programs and protocols
+- **Similar program discovery**
+- **Fast metadata queries**
+- **Full IDL storage** within program metadata
+- **openSVM compatibility** - Uses the same ProgramMetadataEntry model
+
+### Qdrant Collections
+
+The following collections are created (matching aldrin-labs/openSVM structure):
+
+1. **program_metadata** - Program metadata with full IDL objects (ProgramMetadataEntry model)
+2. **token_metadata** - Token metadata (for future expansion)
+3. **idl_cache** - Additional IDL caching layer
+
+### openSVM Compatibility
+
+IDLHub uses the same database model as aldrin-labs/openSVM:
+- **ProgramMetadataEntry** interface for all programs
+- IDL stored as part of program metadata (`idl` field)
+- Same collection names and structure
+- Compatible search and retrieval patterns
+
+## Testing the Deployment
+
+### Test Installation Script
+
+```bash
+curl -fsSL https://your-site.netlify.app/mcp | sh
+```
+
+### Test API Endpoints
+
+```bash
+# Test main site
+curl https://your-site.netlify.app/
+
+# Test index.json
+curl https://your-site.netlify.app/index.json
+
+# Test specific IDL
+curl https://your-site.netlify.app/IDLs/jupiterIDL.json
+```
+
+## Continuous Deployment
+
+Netlify automatically deploys when you push to GitHub:
+
+1. Make changes to your repository
+2. Commit and push to main branch
+3. Netlify detects changes and redeploys
+4. Changes are live in ~1-2 minutes
+
+## Performance Optimization
+
+Netlify provides:
+
+- **Global CDN** - Fast delivery worldwide
+- **Automatic HTTPS** - Free SSL certificates
+- **Branch deploys** - Preview deployments for PRs
+- **Edge functions** - Optional serverless functions
+
+## Monitoring
+
+View deployment logs and analytics:
+- **Netlify Dashboard** → Your site → **Deploys**
+- **Analytics** tab for traffic insights
+- **Functions** tab (if using edge functions)
+
+## Troubleshooting
+
+### Deployment Fails
+
+Check Netlify deploy logs for errors:
+- Go to **Deploys** → Click failed deploy → View logs
+
+### Qdrant Connection Issues
+
+1. Verify environment variables are set in Netlify
+2. Check Qdrant instance is running
+3. Verify API key and URL are correct
+4. Check Qdrant firewall allows connections
+
+### Redirects Not Working
+
+1. Verify `netlify.toml` is in repository root
+2. Check redirect configuration syntax
+3. Clear browser cache
+4. Test with curl: `curl -I https://your-site.netlify.app/mcp`
+
+## Local Development
+
+Test Netlify configuration locally:
+
+```bash
+# Install Netlify CLI
+npm install -g netlify-cli
+
+# Run local dev server
+netlify dev
+
+# Test redirects
+curl http://localhost:8888/mcp
+```
+
+## Additional Resources
+
+- [Netlify Documentation](https://docs.netlify.com/)
+- [Qdrant Documentation](https://qdrant.tech/documentation/)
+- [IDLHub GitHub](https://github.com/openSVM/idlhub)
+
+## Support
+
+For issues with:
+- **Netlify deployment**: [Netlify Support](https://answers.netlify.com/)
+- **Qdrant integration**: [Qdrant Discord](https://discord.gg/qdrant)
+- **IDLHub**: [GitHub Issues](https://github.com/openSVM/idlhub/issues)

README.md

@@ -114,6 +114,106 @@ npm run mcp:websocket
 
 See [mcp-server/README.md](mcp-server/README.md) for complete documentation.
 
+## 🔌 REST API
+
+IDLHub provides a REST API for dynamically loading and uploading IDL files.
+
+### Quick Start
+
+```bash
+# Start the API server
+npm run api:start
+
+# Server runs on http://localhost:3000
+```
+
+### Key Endpoints
+
+- **`POST /api/idl/load-from-github`** - Load IDL from GitHub repository
+- **`POST /api/idl/upload`** - Upload IDL directly
+- **`GET /api/programs`** - List all programs
+- **`GET /api/programs/:id/idl`** - Get specific program IDL
+- **`GET /api/search`** - Semantic search using Qdrant
+
+### Load IDL from GitHub
+
+```bash
+curl -X POST http://localhost:3000/api/idl/load-from-github \
+  -H "Content-Type: application/json" \
+  -d '{
+    "owner": "coral-xyz",
+    "repo": "anchor",
+    "path": "tests/example.json",
+    "branch": "master",
+    "programId": "example",
+    "name": "Example Program",
+    "category": "defi"
+  }'
+```
+
+### Upload IDL Directly
+
+```bash
+curl -X POST http://localhost:3000/api/idl/upload \
+  -H "Content-Type: application/json" \
+  -d '{
+    "programId": "myprogram",
+    "name": "My Program",
+    "category": "defi",
+    "idl": {
+      "version": "0.1.0",
+      "name": "my_program",
+      "instructions": []
+    }
+  }'
+```
+
+See [api/README.md](api/README.md) for complete API documentation.
+
+## 🚀 Deployment
+
+### Netlify (Recommended)
+
+Deploy IDLHub to Netlify with one click:
+
+[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/openSVM/idlhub)
+
+IDLHub includes a complete Netlify configuration (`netlify.toml`) with:
+- Automatic redirects for the `/mcp` installation endpoint
+- Optimized caching and security headers
+- CDN distribution for fast global access
+
+**Quick setup:**
+1. Click the deploy button above
+2. Configure environment variables for Qdrant (optional)
+3. Deploy and get your custom domain
+
+See [NETLIFY.md](NETLIFY.md) for detailed deployment instructions.
+
+### Qdrant Integration
+
+IDLHub supports Qdrant for enhanced search and discovery:
+
+```bash
+# Install dependencies
+npm install
+
+# Configure Qdrant credentials
+cp .env.example .env
+# Edit .env with your Qdrant URL and API key
+
+# Initialize Qdrant collections
+npm run qdrant:init
+```
+
+This enables:
+- Semantic search across protocols
+- Similar protocol discovery
+- Fast metadata queries
+- Search history tracking
+
+Qdrant configuration is based on [aldrin-labs/openSVM](https://github.com/aldrin-labs/openSVM) for compatibility.
+
 ## 📦 Protocol Categories
 
 - **DEX**: Decentralized exchanges (Orca, Raydium, Phoenix, OpenBook)