Skip to main content

Farcaster Integration API

Overview​

Endpoints to support the Vartovii Farcaster Frame and Mini App. Allows Farcaster users to check crypto contract safety directly within the social network. Base path: /api/farcaster

🖼️ Farcaster Frame​

Get Frame Start (HTML)​

GET /api/farcaster/frame

Returns the initial HTML metadata for the Farcaster Frame. Renders the "Verify Contract 🛡️" button and input field.

Check Contract (Frame Action)​

POST /api/farcaster/frame/check

Handles the user interaction from the Frame or Mini App. Accepts a Base/Ethereum contract address and returns a safety analysis.

Input:

  • Standard Farcaster signed frame packet (untrustedData).
  • Or direct JSON for Mini App: {"address": "0x123..."}.

Output:

  • Frame Request: Returns HTML with frame_result.html template.
  • Mini App Request: Returns JSON with Trust Score and Risk Level.

📱 Mini App Manifest​

Get Manifest​

The manifest is hardcoded in the router but structure conforms to Farcaster spec:

{
  "name": "Vartovii Trust Security",
  "homeUrl": "https://sentryanalytic.com/api/farcaster/frame",
  "webhookUrl": "https://sentryanalytic.com/api/farcaster/frame/check"
}