Zum Hauptinhalt springen

Farcaster Mini App Launch Checklist

Scope​

This checklist covers production launch readiness for Vartovii Farcaster Mini App and deep-link funnel integration with sentryanalytic.com.

1. Production Environment Configuration​

Apply these environment variables on the production backend service:

FARCASTER_DOMAIN=sentryanalytic.com
FARCASTER_HOME_URL=https://sentryanalytic.com/api/farcaster/frame
FARCASTER_WEBHOOK_URL=https://sentryanalytic.com/api/farcaster/frame/check
FARCASTER_CAST_SHARE_URL=https://sentryanalytic.com/api/farcaster/frame?source=cast_share
FARCASTER_URL_VERSION=20260228-2
FARCASTER_APP_NAME=Vartovii Trust Security
FARCASTER_APP_SUBTITLE=Base Contract Risk Intel
FARCASTER_APP_TAGLINE=Scan Base contracts in seconds
FARCASTER_APP_DESCRIPTION=AI-assisted smart contract scanner for Base. Evaluate risk, ownership, activity, and open full forensic reports.
FARCASTER_BUTTON_TITLE=Verify Contract 🛡️
FARCASTER_PRIMARY_CATEGORY=developer-tools
FARCASTER_TAGS=security,base,forensics,smart-contracts,developer-tools
FARCASTER_SCREENSHOT_URLS=https://sentryanalytic.com/app/public/farcaster_embed.png,https://sentryanalytic.com/app/public/farcaster_screenshot_scan.png,https://sentryanalytic.com/app/public/farcaster_screenshot_result.png
FARCASTER_OG_TITLE=Vartovii Trust Security for Base Contracts
FARCASTER_OG_DESCRIPTION=Instant trust score + risk reasons for Base contracts. Open full forensic report on Vartovii.
FARCASTER_OG_IMAGE_URL=https://sentryanalytic.com/app/public/farcaster_embed.png
FARCASTER_NOINDEX=false
FARCASTER_ANALYSIS_VERSION=farcaster-hybrid-v1
FORENSIC_CACHE_TTL_SECONDS=3600
FORENSIC_AI_TIMEOUT_SECONDS=5.0
FORENSIC_CHAIN_TIMEOUT_SECONDS=4.0
BASE_RPC_TIMEOUT_SECONDS=4.0
FORENSIC_PREWARM_ADDRESSES=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006

Manifest field guardrails (must pass):

  • subtitle length <= 30
  • tagline length <= 30

2. Pre-Deploy Local Validation​

pytest -q -m integration tests/test_farcaster.py
npm -C dashboard_app run lint -- src/router.jsx src/pages/forensics/ForensicsPage.jsx
npm -C dashboard_app run build

Expected: all commands pass.

3. Deploy Sequence​

  1. Commit and push to your integration branch.
  2. Open PR and merge into master.
  3. Verify CI workflow success.
  4. Confirm Cloud Build / Cloud Run deployment finished.
  5. In Farcaster Developer Dashboard, click Refresh for manifest.

4. Manifest Verification (Production)​

curl -s https://sentryanalytic.com/.well-known/farcaster.json | jq '.frame'

Confirm non-empty values for:

  • primaryCategory
  • tags
  • screenshotUrls (>= 3)
  • subtitle
  • tagline
  • ogTitle
  • ogDescription
  • ogImageUrl
  • castShareUrl
  • noindex is false

Current validated production snapshot (2026-02-28):

  • Manifest status: valid
  • Discovery metadata present: category + tags + screenshots + OG fields
  • Mini App links include versioned query (v=20260228-2)

If users still see stale Mini App UI after deploy, bump URL version:

FARCASTER_URL_VERSION=20260228-3

Then refresh the Mini App manifest in Farcaster dashboard.

5. User-Side Testing Plan​

Use two accounts:

  • Account A: app owner/admin
  • Account B: independent user (non-owner)

Scenario A — Discoverability​

  1. Login with Account B.
  2. Open Farcaster Mini Apps search.
  3. Search using: Vartovii, Trust Security, and creator handle.
  4. Verify app appears and opens.

Scenario B — Scanner Flow​

  1. Open Mini App.
  2. Enter valid Base contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
  3. Verify response includes:
    • score
    • risk level
    • key risks / positive factors
    • "Why this score" reason chips

Scenario C — Invalid Input​

  1. Enter 0x123.
  2. Verify deterministic error behavior (no hallucinated success payload).

Scenario D — Cache Behavior​

  1. Repeat scan on same address.
  2. Verify second response is faster and indicates cached branch.

Scenario E — Share + Deep Link​

  1. Click Share Result.
  2. Verify Warpcast compose opens with Mini App embed link.
  3. Click View Full Report.
  4. Verify redirect to: /app/forensics/:address?source=farcaster...

6. Growth Event Checks​

Validate event ingestion logs for:

  • miniapp_open
  • scan_submit
  • scan_success
  • scan_share_click
  • deep_link_open

7. Share Copy Variants (A/B)​

Current Mini App share variants:

  1. ✅/⚠️/🟠/🚨 Vartovii scan: {tokenName} scored {score}/100 ({risk}).
  2. Base contract check by Vartovii | {tokenName}: {score}/100 ({risk}).

Both variants include Mini App embed URL from FARCASTER_CAST_SHARE_URL.

8. Release Gate​

Launch only when all are true:

  • Test suite green (tests/test_farcaster.py)
  • Manifest fields complete in production
  • Non-owner discoverability test passed
  • Share and deep-link flow passed
  • No critical latency regressions on warm path