# Base App Mini App Submission Packet — Vaultfire

**For:** [dashboard.base.org](https://dashboard.base.org) → Mini Apps → Submit
**Wallet to connect:** `0xa054f831b562e729f8d268291ebde1b2edcfb84f` (vaultfire-sentinel.vns)
**Time required:** ~3 minutes

---

## Pre-flight verification (already passed ✅)

| Check | Status |
|---|---|
| Manifest at `/.well-known/farcaster.json` | ✅ 200, JSON valid |
| All required fields present | ✅ |
| `name` length (≤32) | ✅ 9/32 |
| `subtitle` length (≤30) | ✅ 15/30 |
| `description` length (≤170) | ✅ 78/170 |
| `buttonTitle` length (≤32) | ✅ 14/32 |
| `primaryCategory` valid enum | ✅ `utility` |
| Tags (≤5, lowercase, ≤20ch) | ✅ 5/5 |
| Icon 1024×1024 square | ✅ |
| Hero image 3:2 (1200×800) | ✅ |
| Splash image square 1024+ | ✅ |
| All asset URLs return 200 | ✅ |
| `fc:frame` meta tags in HTML | ✅ |
| All routes return 200 | ✅ 8/8 |

---

## Submission steps

### 1. Open Base App on your phone
Tap browser → go to **dashboard.base.org**

### 2. Connect wallet
Tap "Connect Wallet" → select Base App wallet → approve.
Address must be `0xa054…fb84f` (the founding wallet that owns the Vaultfire contracts).

### 3. Navigate to Mini Apps
Tap **Mini Apps** → **Submit New App** (or "Add Mini App" — Base may rename).

### 4. Paste these exact values

| Field | Value |
|---|---|
| **App URL** | `https://vaultfire-mini.vercel.app` |
| **Manifest URL** *(if asked)* | `https://vaultfire-mini.vercel.app/.well-known/farcaster.json` |
| **Name** | `Vaultfire` |
| **Subtitle / Tagline** | `Know Your Agent` |
| **Category** | `Utility` |
| **Tags** | `ai, agents, trust, identity, base` |
| **Description** | `Register and manage AI agents on-chain. The trust layer for the agent economy.` |
| **Long description** *(if separate field)* | See "Long description" section below |
| **Icon (1024×1024)** | Upload from `public/base-listing/icon-1024.png` OR link `https://vaultfire-mini.vercel.app/base-listing/icon-1024.png` |
| **Hero / Cover (3:2)** | Upload from `public/base-listing/hero-3x2.png` OR link `https://vaultfire-mini.vercel.app/base-listing/hero-3x2.png` |
| **Splash background color** | `#0a0a0b` |
| **Primary chain** | `Base` (chainId 8453) |
| **Website** | `https://theloopbreaker.com` |
| **GitHub** | `https://github.com/Ghostkey316/ghostkey-316-vaultfire-init` |

### 5. Long description (paste verbatim)

> Vaultfire is the trust layer for the agent economy. Register your AI agent on-chain via ERC-8004, stake real ETH bonds with partner agents, and build verifiable, non-custodial reputation — all from your phone.
>
> Built on Base mainnet. Open source. No KYC, no custody, no surveillance — Know Your Agent, not Know Your Customer. Human thriving over extraction.
>
> **What you can do:**
> - Register a real on-chain ERC-8004 identity in seconds
> - View live agent status (name, capabilities, registration, active state)
> - Create Partnership Bonds locked by smart contract
> - Deploy Belief-In-Practice (BIP) vaults
> - Earn Street Cred soulbound badges
> - Sign HTTP requests via ERC-8128 from your wallet
>
> All interactions signed by your own wallet. Nothing custodial. Nothing fake.

### 6. Sign ownership message
The dashboard will prompt your wallet to sign a message proving you control the domain / app URL. **This is the critical step** — without this signature Base cannot list it.

### 7. Submit
Hit submit. Listing usually goes live within minutes; featured/curated placement is a separate Base review process that takes 1–7 days.

---

## After submission

1. **Test the listing** — open Base App → search "Vaultfire" → confirm icon, name, splash render correctly
2. **Share the deeplink** — Base App generates a `https://base.app/...` style link you can post on X / Farcaster
3. **Builder rewards** — Base awards rewards based on **actual usage** (active wallets, sessions, transactions), not just listing. Eligibility builds over time as people use the app.

---

## If Base rejects or asks for changes

Common reasons + fixes:

- **"Manifest unreachable / invalid"** → already verified ✅; if Base reports this anyway, ask which field
- **"Asset dimensions wrong"** → already 1024×1024 + 1200×800 ✅
- **"Domain not verified"** → wallet ownership signature failed; redo step 6 with the right wallet
- **"Description too long / disallowed"** → trim long description to fit their actual limit (the 170-char field is just the manifest)
- **"Inappropriate category"** → switch from `utility` to `developer-tools` if reviewers prefer

If anything fails, screenshot the exact error and we'll fix it in <5 min.

---

## Live URLs (for reference / pasting)

- App: https://vaultfire-mini.vercel.app
- Manifest: https://vaultfire-mini.vercel.app/.well-known/farcaster.json
- Icon (1024): https://vaultfire-mini.vercel.app/base-listing/icon-1024.png
- Hero (1200×800): https://vaultfire-mini.vercel.app/base-listing/hero-3x2.png
- Splash: https://vaultfire-mini.vercel.app/base-listing/splash-1024.png
- Main site: https://theloopbreaker.com
- Source: https://github.com/Ghostkey316/ghostkey-316-vaultfire-init
