mirror of https://github.com/laoxong/nofx.git synced 2026-06-04 09:58:22 +08:00

Files

T

1bcMax 6f77ed2fcb feat: add BlockRun wallet provider for pay-per-request AI access (#1408 )

Integrates BlockRun (blockrun.ai) as a new AI provider option via x402
micropayment protocol, allowing users to access top AI models with USDC
without requiring individual API keys.

- Add BlockRun Base (EVM) and Solana wallet providers to model selector
- Implement x402 v2 EIP-712 payment signing for Base (mcp/blockrun_base.go)
- Implement x402 v2 SPL TransferChecked signing for Solana (mcp/blockrun_sol.go)
- Wire blockrun-base and blockrun-sol into trader factory (auto_trader.go)
- Register both providers in supported models API (server.go)
- Add BlockRun card UI with wallet key input in Step 0/1 of model config modal
- Add BlockRun SVG icon and ModelIcons support
- Add setup guides for Base and Solana wallet configuration (docs/)
- Available flagship models: GPT-5.4, Claude Opus 4.6, Gemini 3.1 Pro,
  Grok 3, DeepSeek Chat, MiniMax M2.5

2026-03-10 14:54:50 +08:00

3.5 KiB

Raw Blame History

🚀 Getting Started with NOFX

Language: English | 中文

This section contains all the documentation you need to get NOFX up and running.

📋 Deployment Options

Choose the method that best fits your needs:

🐳 Docker Deployment (Recommended)

Best for: Beginners, quick setup, production deployments

English: docker-deploy.en.md
中文: docker-deploy.zh-CN.md

Pros:

✅ One-command setup
✅ All dependencies included
✅ Easy to update and manage
✅ Isolated environment

Quick Start:

cp config.json.example config.json
./scripts/start.sh start --build

🤖 AI Configuration

Custom AI Providers

English: custom-api.en.md
中文: custom-api.md

Use custom AI models or third-party OpenAI-compatible APIs:

Custom DeepSeek endpoints
Self-hosted models
Other LLM providers

💳 BlockRun Wallet (Pay-per-Request, No API Key)

Access all top AI models by paying with USDC — no API key signup required.

Provider	Guide	Payment Network
BlockRun (Base Wallet)	blockrun-base-wallet.md	Base (EVM) · USDC
BlockRun (Solana Wallet)	blockrun-sol-wallet.md	Solana · USDC

How it works: Each AI request automatically pays a micro-USDC fee via the x402 payment protocol. Your private key signs the payment authorization — no funds leave your wallet until the AI response is delivered.

🔑 Prerequisites

Before starting, ensure you have:

For Docker Method:

✅ Docker 20.10+
✅ Docker Compose V2

For Manual Method:

✅ Go 1.21+
✅ Node.js 18+
✅ TA-Lib library

📚 Next Steps

After deployment:

Configure AI Models → Web interface at http://localhost:3000
Set Up Exchange → Add Binance/Hyperliquid credentials
Create Traders → Combine AI models with exchanges
Start Trading → Monitor performance in dashboard

🔐 Optional: Enable Admin Mode (Single-User)

For single-tenant/self-hosted usage, you can enable strict admin-only access:

In config.json set the 2 fields below:

{
	"admin_mode": true,
  ...
  "jwt_secret": "YOUR_JWT_SCR"
}

Set environment variables (Docker compose already wired):

NOFX_ADMIN_PASSWORD — admin password (plaintext; hashed on startup)

Login at /login using the admin password. All non-essential endpoints are blocked to unauthenticated users while admin mode is enabled.

⚠️ Important Notes

Before Trading:

⚠️ Test on testnet first
⚠️ Start with small amounts
⚠️ Understand the risks
⚠️ Read Security Policy

API Keys:

🔑 Never commit API keys to git
🔑 Use environment variables
🔑 Restrict IP access
🔑 Enable 2FA on exchanges

🆘 Troubleshooting

Common Issues:

Docker build fails → Check Docker version, update to 20.10+
TA-Lib not found → brew install ta-lib (macOS) or apt-get install libta-lib0-dev (Ubuntu)
Port 8080 in use → Change API_PORT in .env file
Frontend won't connect → Check backend is running on port 8080

Need more help?

← Back to Documentation Home

3.5 KiB Raw Blame History