Vom Gold-Basket zur Frame v2 Mini-App: Mein Farcaster-Setup auf der Website

gemini generated image m8ufrkm8ufrkm8uf

Wer im Web3-Bereich aktiv ist, kommt aktuell an Farcaster und der dazugehörigen App Warpcast kaum vorbei. Nach der erfolgreichen Umsetzung meines letzten Projekts – den Edelmetall-Körben (wie meinem $LGOLD-Konzept) – war es für mich der logische nächste Schritt, auch meine persönliche Website tiefer in dieses dezentrale Ökosystem zu integrieren.

Das Ziel: Die Unterstützung der brandneuen Frames v2 (Mini-Apps), damit die Website direkt innerhalb von Farcaster interaktiv nutzbar wird. Der Weg dorthin hielt allerdings eine klassische technische Hürde bereit.

Die „Henne-Ei-Blockade“ beim Manifest-Setup

Die Verifizierung einer Domain läuft bei Farcaster über eine JSON-Datei im Verzeichnis /.well-known/farcaster.json. Nutzt man dafür das entsprechende WordPress-Plugin, läuft man schnell in eine Sackgasse:

  • Das WordPress-Plugin verlangt eine Bestätigung, wartet auf die Signatur und verweigert die Speicherung, solange die Datei leer oder unvollständig ist.

  • Warpcast wiederum bricht den Signatur-Vorgang via Wallet mit einer Fehlermeldung ab, weil es die (noch nicht existierende) Datei auf dem Server nicht abfragen kann.

Die Lösung: Der gute alte FTP-Weg

Um diesen Teufelskreis zu durchbrechen, hilft nur der direkte Weg am Plugin vorbei. Ich habe das JSON-Gerüst kurzerhand manuell aufgesetzt, den .well-known-Ordner auf dem Server angesteuert und die Datei direkt per FTP hochgeladen.

Nachdem Warpcast das unvollständige JSON fehlerfrei (HTTP Status 200) lesen konnte, wurde die Wallet-Signatur sofort freigeschaltet. Wichtig hierbei: Farcaster ist extrem pingelig, was leere URL-Felder im "frame"-Objekt angeht. Wer dort leere Anführungszeichen ("") stehen lässt, fängt sich sofort Fehlermeldungen ein. Erst als alle optionalen Bild-Pfade sauber belegt oder entfernt waren und das Favicon als Platzhalter diente, gab auch der interne Validator des WordPress-Plugins endlich grünes Licht.

Was bedeutet das für die Zukunft der Seite?

Die Domain ist nun offiziell im Farcaster-Netzwerk verifiziert und mit meinem Profil verknüpft. Damit ist das Fundament gelegt, um zukünftig:

  1. Neue Blogbeiträge vollautomatisch als „Casts“ in das Netzwerk zu jagen.

  2. Interaktive Elemente (Frames) zu nutzen, bei denen Leser direkt in ihrer Timeline durch Artikel scrollen oder mit Web3-Funktionen interagieren können, ohne die Warpcast-App verlassen zu müssen.

Das Setup steht, alles leuchtet grün – das nächste Web3-Kapitel auf dieser Seite ist eröffnet!

Diskussion zum Beitrag

Scroll to Top