| # Cloudflare Workers Proxy for Binance Testnet |
|
|
| This proxy bypasses geo-restrictions (Error 451) when accessing Binance testnet from HuggingFace Spaces. |
|
|
| ## 🎯 Quick Start |
|
|
| ### 1. Deploy the Worker (15 minutes) |
|
|
| Follow the step-by-step guide in **[DEPLOYMENT_GUIDE.md](./DEPLOYMENT_GUIDE.md)** |
|
|
| **Summary:** |
| 1. Sign up at [workers.cloudflare.com](https://workers.cloudflare.com) (FREE, no credit card) |
| 2. Create a new Worker |
| 3. Copy code from `binance-testnet-proxy.js` |
| 4. Save and Deploy |
| 5. Copy your Worker URL |
|
|
| ### 2. Configure HuggingFace Space |
|
|
| Add your Worker URL to HuggingFace Secrets: |
|
|
| 1. Go to your Space Settings → Repository Secrets |
| 2. Add new secret: |
| - **Name:** `BINANCE_TESTNET_PROXY_URL` |
| - **Value:** `https://your-worker.workers.dev` |
| 3. Restart the Space |
|
|
| ### 3. Test Locally (Optional) |
|
|
| Before deploying to HuggingFace, test locally: |
|
|
| ```bash |
| # Add to .env file |
| echo "BINANCE_TESTNET_PROXY_URL=https://your-worker.workers.dev" >> .env |
| |
| # Run test script |
| python test_proxy.py |
| ``` |
|
|
| If all tests pass ✅, you're ready to deploy to HuggingFace! |
|
|
| --- |
|
|
| ## 📊 Free Tier Limits |
|
|
| - **Requests:** 100,000 per day (FREE) |
| - **CPU Time:** 50ms per request |
| - **Workers:** 30 deployed scripts |
| - **Storage:** 1GB total |
|
|
| **For a single trading bot:** These limits are more than enough! |
|
|
| --- |
|
|
| ## 🔒 Security |
|
|
| - ✅ You control the proxy code |
| - ✅ API keys are not logged or stored |
| - ✅ CORS protection limits access to your HuggingFace Spaces only |
| - ✅ All traffic is encrypted (HTTPS) |
|
|
| --- |
|
|
| ## 📁 Files in This Directory |
|
|
| - **`binance-testnet-proxy.js`** - The Cloudflare Worker code |
| - **`DEPLOYMENT_GUIDE.md`** - Detailed deployment instructions |
| - **`README.md`** - This file |
| |
| --- |
| |
| ## 🆘 Need Help? |
| |
| 1. Check the [DEPLOYMENT_GUIDE.md](./DEPLOYMENT_GUIDE.md) for troubleshooting |
| 2. Review Cloudflare Workers docs: https://developers.cloudflare.com/workers/ |
| 3. Check if your Worker is deployed correctly in the Cloudflare dashboard |
| |
| --- |
| |
| ## ✅ Success Checklist |
| |
| - [ ] Cloudflare account created |
| - [ ] Worker deployed with proxy code |
| - [ ] Worker URL copied |
| - [ ] `BINANCE_TESTNET_PROXY_URL` added to HuggingFace Secrets |
| - [ ] HuggingFace Space restarted |
| - [ ] Testnet tab working! 🎉 |
| |
