windfall-inference
Spatially-routed LLM inference at $0.004/req. Routes to cheapest, greenest energy. 200+ models. OpenAI-compatible. Onchain attestations on Base.
- License 许可
- Apache-2.0
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- windfall-inference
- homepage
- https://windfall.ecofrontiers.xyz
- metadata
- { "openclaw": { "os": [ "darwin", "linux", "win32" ], "emoji": "⚡", "requires": { "env": [ "WINDFALL_API_KEY" ] }, "primaryEnv": "WINDFALL_API_KEY" } }
- description
- Spatially-routed LLM inference at $0.004/req. Routes to cheapest, greenest energy. 200+ models. OpenAI-compatible. Onchain attestations on Base.
- user-invocable
- true
02 资源文件 46
- 参考文档_meta.json290 B
- 参考文档acp-service.json2.6 KB
- 脚本deploy/setup.sh746 B
- 许可证LICENSE.md3.0 KB
- 参考文档package-lock.json422.9 KB
- 参考文档package.json1.3 KB
- 其他public/assets/shared.css6.0 KB
- 脚本public/assets/shared.js7.1 KB
- 其他public/assets/tailwind.css21.9 KB
- 资产文件public/assets/windfall-logo-square.svg914 B
- 资产文件public/assets/windfall-logo.svg826 B
- 参考文档public/dashboard.html18.9 KB
- 参考文档public/imprint.html10.5 KB
- 参考文档public/index.html44.3 KB
- 参考文档public/privacy.html19.3 KB
- 参考文档public/robots.txt127 B
- 其他public/sitemap.xml937 B
- 参考文档public/terms.html18.2 KB
- 参考文档public/topup.html17.0 KB
- 脚本scripts/acp-negative-test.ts3.3 KB
- 脚本scripts/acp-positive-test.ts4.2 KB
- 脚本scripts/graduate.ts7.3 KB
- 脚本src/config.ts2.8 KB
- 脚本src/index.ts30.8 KB
- 脚本src/routes/inference.ts19.2 KB
- 脚本src/services/acp-handler.ts13.4 KB
- 脚本src/services/api-keys.ts8.5 KB
- 脚本src/services/cache.ts6.1 KB
- 脚本src/services/eas-attestation.ts4.7 KB
- 脚本src/services/energy-oracle.ts6.6 KB
- 脚本src/services/engagement-classifier.ts5.7 KB
- 脚本src/services/eth-watcher.ts6.5 KB
- 脚本src/services/free-tier.ts5.6 KB
- 脚本src/services/onchain-identity.ts3.2 KB
- 脚本src/services/openrouter-proxy.ts2.8 KB
- 脚本src/services/payment.ts6.1 KB
- 脚本src/services/sessions.ts670 B
- 脚本src/services/spatial-router.ts4.9 KB
- 脚本src/services/stripe.ts3.0 KB
- 脚本src/services/usdc-watcher.ts5.7 KB
- 脚本src/services/x402.ts3.7 KB
- 其他src/styles/input.css59 B
- 脚本src/types.ts2.7 KB
- 脚本tailwind.config.js891 B
- 参考文档testing-guide.md4.3 KB
- 参考文档tsconfig.json445 B
03 SKILL.md 正文
Windfall Inference
Spatially-routed LLM inference gateway for AI agents on Base. Routes every request to the cheapest model on the cleanest energy.
Setup
Set WINDFALL_API_KEY in your environment. Get one free at:
curl -X POST https://windfall.ecofrontiers.xyz/api/keys \
-H "Content-Type: application/json" \
-d '{"wallet_address": "YOUR_WALLET"}'
Keys with an ERC-8004 agent identity or Basename get 100 free requests. Anonymous keys get 25.
Usage
Use as an OpenAI-compatible endpoint. Set these two environment variables:
OPENAI_BASE_URL=https://windfall.ecofrontiers.xyz/v1
OPENAI_API_KEY=wf_YOUR_KEY
Or call directly:
curl https://windfall.ecofrontiers.xyz/v1/chat/completions \
-H "Authorization: Bearer $WINDFALL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{"role": "user", "content": "Hello"}]
}'
x402 Payment (No API Key Needed)
Windfall supports the x402 payment protocol. Any agent with a Base wallet can pay per-request without creating an API key. Send a request without auth and the server returns HTTP 402 with a PAYMENT-REQUIRED header containing USDC payment instructions on Base. Your x402 client handles the rest.
Routing Modes
greenest(default) — lowest carbon intensitycheapest— lowest energy costbalanced— Pareto-weighted cost + carbon
Set via "mode" in the request body or X-Routing-Mode header.
Models
Default: DeepSeek V3 (auto-selected by engagement classifier). Override with "model" field. 200+ models available via OpenRouter.
Pricing
- Standard: $0.004/request
- Premium (Claude, GPT-4): $0.008/request
- Green surcharge: +10% for
greenestmode - Cache hits: free
Response Headers
Every response includes:
X-Windfall-Cache— HIT or MISSX-Windfall-Mode— routing mode usedX-Windfall-Model— model that handled the requestX-Windfall-Node— node that executed the requestX-Windfall-Cost— cost chargedX-Windfall-Saved— savings vs direct API (cache hits)
Onchain Attestations
Every inference call produces a verifiable EAS attestation on Base with: node location, energy price, carbon intensity, model used, and response hash. Query at base.easscan.org.
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.