ForgeOS

ForgeOS is the on-chain spending firewall for autonomous AI agents.

Most agent stacks give an AI a wallet and hope for the best. ForgeOS does the opposite: you grant one scoped, revocable ERC-7715 permission in MetaMask Flask, and every sub-delegation an agent creates can only narrow in scope — never widen. One kill switch revokes the entire tree on-chain.

What it does

• Activation: MetaMask Smart Accounts (ERC-7715/7710) with spend caps, allowed targets, and expiry caveats backed by verified MetaMask Delegation Framework enforcers on Sepolia

• A2A coordination: 2-hop narrowing chain (Orchestrator → DeFi agent → Payment agent) with on-chain CaveatWideningNotAllowed reverts when an agent tries to expand permissions

• Venice AI: Zero-retention intent parsing in the main loop, paid per call via x402 USDC on Base

• 1Shot relay: Gasless ERC-7710 execution with Ed25519-verified webhooks → SSE → dashboard; UI only shows “Confirmed” after a real receipt

• Treasury: Per-user USDC budgets in AgentTreasury before any spend

• Product surface: No-code agent builder, marketplace, delegation tree UI, system status page, and always-visible kill switch

Live demo: https://forgeagent.vercel.app
Contracts (Sepolia): OSKernel, AgentTreasury, ForgeOSRegistry — verified on Etherscan
Repo: https://github.com/Officialhomie/ForgeOS

Built for the MetaMask × 1Shot × Venice Dev Cook Off. Targets: Best Agent, Best A2A Coordination, Best x402 + ERC-7710, Best Venice AI, Best 1Shot Relayer.

Progress During Hackathon

Week 1 — Core primitive

• Deployed OSKernel, AgentTreasury, and ForgeOSRegistry to Ethereum Sepolia

• Implemented ERC-7715 activation wizard (connect → deploy kernel → scoped permission grant → fund treasury)

• Built delegation encoding, proof bundles, and creation-time narrowing validation (CaveatWideningNotAllowed)

• Wired 1Shot relayer_send7710Transaction with webhook verification and SSE status pipeline

Week 2 — Agent runtime & integrations

• End-to-end command flow: Venice intent → action plan → 1Shot gasless relay → webhook-confirmed UI state

• Auto 2-hop sub-delegation chain (500 USDC → 100 USDC / single call) without extra user signatures

• Venice x402 micropayments on Base mainnet for zero-retention inference

• Agent cron runner, treasury fund/withdraw, and kill-switch revokeAll path

Week 3 — Product & ship

• No-code agent builder (3-step flow with enforcer-backed caveats)

• Marketplace UI with install flow and registry API

• Dashboard: delegation tree, spending view, subscriptions, system status (truthful red/green checks)

• The Graph subgraph for delegations/registry; RPC fallback when indexing lags

• Per-wallet activation persistence, stale-state recovery after contract redeploys

• Production deploy to Vercel; 12/12 Foundry tests; full Next.js build (35 routes)

• Submission assets: Playwright screenshot pipeline, demo scripts, and documentation (README, SUBMISSION.md, DEMO_PLAYBOOK)

Current state: Full-stack MVP live on Sepolia + Base x402. Marketplace listings are UI-complete; golden-path Etherscan evidence txs are being recorded for final submission proof.