1bcMax
6f77ed2fcb
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
4.9 KiB
BlockRun Base (EVM) Wallet Setup Guide
This guide explains how to use a Base network EVM wallet to pay for AI usage through BlockRun — no API key required.
What is BlockRun?
BlockRun is a decentralized AI inference gateway that lets you access top AI models (Claude, GPT, Gemini, Grok, DeepSeek, etc.) by paying per request with USDC — no monthly subscriptions, no API key signups.
NOFX integrates BlockRun via the x402 micropayment protocol: each AI inference request automatically pays a small USDC fee directly from your wallet. You only pay for what you use.
Why Use BlockRun?
| Feature | Traditional API Key | BlockRun Wallet |
|---|---|---|
| Setup | Register + billing | Just a wallet address |
| Cost model | Monthly subscription | Pay-per-request |
| Models | One provider | All top models |
| Privacy | Account required | Pseudonymous |
| Control | Rate limits apply | Your wallet, your budget |
Prerequisites
- An EVM wallet with USDC on Base network (chain ID 8453)
- The wallet private key (hex format:
0x...)
Getting USDC on Base
- Buy USDC on Coinbase and withdraw to Base, or
- Bridge USDC from Ethereum using bridge.base.org, or
- Swap on Aerodrome or Uniswap on Base
Tip: A few dollars of USDC is enough to start — each AI call costs fractions of a cent.
Step 1: Get Your Wallet Private Key
⚠️ Security Warning: Never share your private key with anyone. Use a dedicated trading wallet, not your main holdings wallet.
Option A — Create a new wallet (recommended):
- Open MetaMask → Create New Account
- Go to Account Details → Export Private Key
- Copy the hex key (starts with
0x)
Option B — Use an existing wallet:
- MetaMask → Account Details → Export Private Key
- Enter your MetaMask password to reveal the key
Option C — Generate via CLI:
# Using cast (foundry)
cast wallet new
# Output: Address: 0x... | Private key: 0x...
Step 2: Fund the Wallet with USDC on Base
Send USDC to your wallet address on Base network:
- USDC contract:
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 - Network: Base (chain ID 8453)
- Recommended starting amount: $5–$20 USDC
Check your balance at basescan.org.
Step 3: Configure in NOFX
- Open NOFX at
http://localhost:3000 - Log in and go to Config tab
- Click + Add AI Model
- In Step 0, scroll to Via BlockRun Wallet section
- Select BlockRun · Base Wallet
- In Step 1, configure:
- Wallet Private Key: Your hex private key (
0x...) - Select Model: Choose from Claude Opus, GPT-5.4, Gemini 3 Pro, Grok 3, DeepSeek R1, or leave as Auto for best available
- Wallet Private Key: Your hex private key (
- Click Save
How Payment Works
When NOFX sends an AI request:
- Request goes to
https://blockrun.ai/api/v1/chat/completions - Server responds with HTTP
402 Payment Required+ payment details - NOFX signs a ERC-3009 TransferWithAuthorization (EIP-712) with your private key
- Payment signature is attached and request is retried
- BlockRun verifies the signature, routes the request to the AI model, and charges USDC
Privacy: Your private key never leaves your NOFX instance. Only the cryptographic signature is sent.
Available Models via BlockRun
| Model ID | Provider | Use Case |
|---|---|---|
gpt-5.4 |
OpenAI | Flagship (default) |
claude-opus-4.6 |
Anthropic | Flagship |
gemini-3.1-pro |
Flagship | |
grok-3 |
xAI | Flagship |
deepseek-chat |
DeepSeek | Flagship |
minimax-m2.5 |
MiniMax | Flagship |
Security Best Practices
- ✅ Use a dedicated wallet with only trading budget, not your main wallet
- ✅ Keep only a small USDC balance (top up as needed)
- ✅ Your private key is encrypted at rest in NOFX's database
- ✅ Signatures are spend-limited — each signature authorizes only the exact amount for one request
- ❌ Never export or share your private key outside of NOFX
Troubleshooting
| Issue | Solution |
|---|---|
no private key set |
Check your key was saved correctly; re-enter in Config |
payment retry failed |
Ensure you have USDC on Base (not Ethereum mainnet) |
invalid private key |
Key must be hex format with 0x prefix, 66 chars total |
| Payment deducted but no response | Check BlockRun status at blockrun.ai |
| Slow responses | Try selecting a specific model instead of "Auto" |
Monitoring Spend
Check your USDC balance and transaction history at:
- Basescan — search your wallet address
- BlockRun dashboard — usage history