Luca + AEON skills: ERC-4337 classification, agent read-order, Surplus inference & buy/sell

[danbuildss]

Summary

• ERC-4337 smart account classification: adds smart_account address type (detected via validateUserOp selector) so smart-account operator wallets are no longer misclassified as smart_contract and blocked from books. Adds an admin endpoint (/api/admin/registry/update-wallet-type) to override wallet types manually.
• Stale-figure fix + global read-order doctrine: force-regenerates stored reports and adds a hard "AGENT READ-ORDER" rule to Luca's shared doctrine so financial figures for any of the 143 indexed agents are always read live from Zetta truth (/api/v1/luca/agent-read) instead of memory or stale stored report prose. Non-indexed agents get a clearly labeled observational fallback.
• Surplus inference via Zetta proxy for Hermes: new POST /api/v1/luca/inference, authenticated with the same v1 API key Luca already uses for every other skill (previously the only proxy required ZETTA_INTERNAL_SECRET, which Hermes doesn't have). Spend is logged automatically to inference_events and agent_economic_events.
• Surplus buy/sell interface (inference credits): Luca can now self-issue its own inf_ buyer key via SIWE so inference settles in USDC from its own wallet on Base, making spend attributable on-chain:
  • GET /api/v1/luca/surplus/challenge — fetch SIWE challenge to sign
  • POST /api/v1/luca/surplus/buyer-key — exchange signed message for inf_ key
  • GET /api/v1/luca/surplus/status — balance / allowance / active keys
  • GET /api/v1/luca/surplus/prices — per-token USDC pricing
  • GET /api/v1/luca/surplus/models — available models
  • /api/v1/luca/inference now prefers LUCA_SURPLUS_BUYER_KEY over the shared SURPLUS_API_KEY once set
• Skills catalog (/api/luca/skills) updated with agent-read, surplus-inference, and all 5 Surplus buy/sell endpoints.

Test plan

• Verify /api/admin/registry/update-wallet-type correctly overrides a wallet's address_type and that agent_books_cache invalidation/regeneration reflects it
• Confirm Luca on Telegram answers agent financial questions using live /api/v1/luca/agent-read data, not stale stored report figures
• Confirm /api/v1/luca/inference succeeds from Hermes using the standard v1 API key (no ZETTA_INTERNAL_SECRET needed)
• Run the Surplus SIWE flow end-to-end (challenge → sign → buyer-key) and confirm the returned inf_ key works against /api/v1/luca/surplus/status
• After setting LUCA_SURPLUS_BUYER_KEY, confirm inference spend settles from Luca's wallet on Base rather than the shared key

🤖 Generated with Claude Code

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
zetta	Ready	Preview, Comment	Jun 29, 2026 10:55pm