MINY Agent Vault docs

12-month roadmap from MVP to $500K–$2M ARR. Stack selection, wallet design, regulatory positioning, and risk controls.

• Technical Stack Recommendation

  FastAPI + Postgres + Stripe. Python for alignment with agent stack.
  Done
• Core Wallet Design

  Wallet structure: owner_type, balance, risk_score, policy_id, NFC unlock.
  Done
• Policy Engine (5-Point)

  Category check, daily cap, campaign budget, strategy match, decision log.
  Done
• Strategy Database Integration

  Agent queries 1,597 strategies before spend. Reject if ROI/stage mismatch.
  Done
• NFC + Physical Integration

  Collectibles unlock wallet tiers, increase caps, fund campaigns.
  Done
• Regulatory Safe Design

  Closed-loop, no yield, no profit promises, utility-only positioning.
  Done
• 12-Month Revenue Roadmap

  Phase 1: pilot 10 artists. Phase 2: $10K–$30K MRR. Phase 3: white-label.
  In Progress

Production-ready engineering spec: Postgres schema (11 tables), 22+ API endpoints, security controls, 2-week MVP scope.

• Data Model (Postgres)

  wallets, ledger_accounts, ledger_entries, policies, agent_api_keys, spend_requests, onchain_intents
  Done
• Double-Entry Ledger

  Every transaction = debit + credit. Fiat, USDC, ACP revenue all reconciled.
  Done
• Spending & Settlement Flows

  Flow 1: fiat via Stripe. Flow 2: onchain USDC settlement on Base.
  Done
• Base Receipt Contract

  Event-only MinyReceipt.sol: ~21K gas (~$0.001) per emission.
  Done
• API Surface (22+ endpoints)

  Wallets, policies, agents, spending, strategies, x402, NFC, onchain, webhooks.
  Done
• Security & Controls

  Hard caps, 2-step approval, key scoping, freeze switch, full audit trail.
  Done

Locked decision: fiat-ledger-first with Base for proofs, access gating, and optional settlement. Not a crypto custody platform.

• Base Usage (v1)

  Onchain receipts, NFC access gating, optional settlement rail.
  Done
• Coinbase Integration Order

  Onramp (hosted first, headless later) + native USDC on Base.
  Done
• System of Record

  MINY Ledger (Postgres) = source of truth. Base = onchain proof surface.
  Done
• Account Abstraction

  Sponsor gas via paymasters. Agents never manage ETH.
  Done
• Transaction Flows

  Flow A: fiat via Stripe + optional Base receipt. Flow B: Onramp USDC + onchain settle.
  Done

What Base provides, wallet primitive options, integration checklist. Agent-first path using Base only for proofs and settlement.

• Base Chain (L2)

  Low-fee transactions for receipts, access passes, proofs, usage logs.
  Done
• Coinbase Onramp

  Card/Apple Pay/bank funding to USDC on Base. Hosted first, headless later.
  Done
• AA + Sponsored Gas

  Smart accounts with gas sponsorship. No ETH management for agents.
  Done
• Wallet Primitive Choice

  Pattern 1: smart accounts per agent. Pattern 2: one treasury + offchain.
  Done

Coinbase x402 HTTP-native payments + Agentic Wallets. MINY is the policy/strategy brain; Coinbase provides payment pipes.

• x402 Protocol

  402 Payment Required. Agent signs USDC payload. Facilitator settles.
  Done
• Agentic Wallets

  Self-custody on Base, configurable caps, KYT screening, key isolation.
  Done
• 3 Revenue Streams

  Strategy-as-a-Service, Agent-to-Agent Commerce, NFC-Triggered x402 Credits.
  Done
• Revised Architecture

  Replace custom key mgmt with Agentic Wallets. Keep policy engine + ledger.
  Done

Revenue Incentives for AI ($1M/month). ACP service registration, epoch tracking, dual-payout accounting. 76x revenue multiplier.

• ACP Service Registration

  Register 25+ strategies as ACP services with pricing and categories.
  Phase 1
• Epoch Revenue Tracking

  New ledger types: ACP_SERVICE_REVENUE, ACP_USDC_INCENTIVE, ACP_TOKEN_BUYBACK.
  Phase 1
• Dual Payout Handling

  50% USDC auto-deposit + 50% token buyback tracking with vesting.
  Phase 2
• Revenue Flywheel

  Auto-reinvestment, dynamic pricing, agent-to-agent commerce.
  Phase 3
• Tokenization

  Tokenize MINY through Virtuals. Connect token to service flywheel.
  Phase 4

5-minute quickstart: create a wallet, fund it, set a policy, propose a spend, and execute it.

• Environment Setup

  Install dependencies, configure database, start the API server.
  Planned
• Create Your First Wallet

  POST /wallets with owner_type, fund with deposit, check balances.
  Planned
• Set a Spending Policy

  Daily cap, category allowlist, approval threshold. PUT /policies.
  Planned
• Propose & Execute a Spend

  Full lifecycle: propose, policy eval, approve, execute, verify ledger.
  Planned

Build autonomous agents that manage budgets, execute strategies, and settle transactions through MINY.

• Agent Registration

  Register agent, receive scoped API key, configure wallet binding.
  Planned
• Strategy Validation Flow

  Query strategy DB, validate ROI thresholds, propose spend with strategy_refs.
  Planned
• x402 Payments

  Configure Agentic Wallet, handle 402 responses, sign USDC payloads.
  Planned
• Webhook Integration

  Listen for spend lifecycle events, settlement confirmations, policy alerts.
  Planned

Common policy configurations for different use cases: artist wallets, campaign agents, marketplace agents.

• Conservative Artist Policy

  $50/day cap, marketing-only categories, human approval over $25.
  Planned
• Campaign Agent Policy

  $500/day, broad categories, strategy validation required, 1hr cooldown.
  Planned
• ACP Marketplace Policy

  Epoch-aware limits, pricing validation, token vesting compliance checks.
  Planned

Connect physical MINY collectibles to wallet capabilities. NFC tap to AccessPass.sol mint to agent activation.

• Edition Setup

  Create NFC edition, program chips, configure access tiers.
  Planned
• Tap Processing

  NFC tap event, signature verification, AccessPass.sol mint on Base.
  Planned
• Wallet Activation

  Map AccessPass ownership to wallet permissions and budget credits.
  Planned

Full request/response reference for all 22+ endpoints across 10 route groups. For interactive exploration, see /docs.

• Health & Wallets

  GET /health, POST /wallets, POST /wallets/{id}/fund, GET /wallets/{id}/balances
  Live at /docs
• Policies & Agents

  PUT /policies, POST /agents, GET /agents/{id}, scope management
  Live at /docs
• Spending Lifecycle

  POST /spend/propose, POST /spend/{id}/approve, POST /spend/{id}/execute
  Live at /docs
• Strategies & x402

  GET /strategies, POST /strategies/recommend, x402 paywall integration
  Live at /docs
• NFC & Onchain

  POST /nfc/tap, GET /nfc/editions, POST /onchain/intents
  Live at /docs