ensframe

Supercharging ENS on Farcaster with Frames

Introduction

What is Farcaster Frames?

Frames are similar to Youtube embeddings, where linking a Youtube video on Facebook for example, lets users watch the video directly on the site.

By utilizing Frames in the same way, ENS names can be displayed in an interactive manner on Farcaster or any application which supports Farcaster Frames.

Getting Started

All frames are casted with the ensframe domain: https://ensframe.com

  • Random listings:

    /listings/[id]

    Displays a random ENS name listed under the provided id, across various marketplaces. The id can be an ENS name, or an ENS label name.

    Displayed buttons:

    • Next:Generates another random listed ENS name.
    • Buy NowExternal link to the marketplace listing.

    Examples:

    • ensframe.com/listings/aaalex.eth
    • ensframe.com/listings/aaalex
  • Bulk listings:

    /bulk/[id]?n=...

    Displays selected ENS names (up to 6), listed across various marketplaces. The id can be an ENS name, or an ENS label name.

    Use the ?n parameter to provide a list of ENS names, ?n=aaalex,bob,david.eth. A mixture of ENS names and label names are supported.

    Keep in mind the limitations: only the first 6 names are used. If the frame does not display, it's due to the size of the url. In other words, too many names were provided.

    Displayed buttons:

    • NamesValue is based on the provided ENS names, which links to an external marketplace.
    • Back/NextUsed for pagination, if more than 3 names were provided.

    Examples:

    • ensframe.com/bulk/aaalex?n=heb,jina,marsh,autopayments
  • Single listing:

    /listings/[id]/[name]

    Displays the marketplace listing of provided ENS under the provided id. The id and name can be an ENS name or label name. If listed across multiple marketplaces, the cheapest listed price is shown.

    Displayed buttons:

    • Buy NowExternal link to the marketplace listing.

    Examples:

    • ensframe.com/listings/aaalex.eth/heb.eth
    • ensframe.com/listings/aaalex/heb
  • Social Card:

    /cards/[name]

    Displays your ENS name as an interactive social card, using your onchain text records. The provided name can be either an ENS name or label name.

    Text records must follow format described in ensip-5-text-records

    Displayed buttons:

    • WebsiteAny valid url defined in the url text record.
    • Social MediaLinks to external social media sites defined by a valid service label.Supported social media includes: Twitter, Discord, Twitch, Youtube, Github, LinkedIn.

    Examples:

    • ensframe.com/cards/aaalex.eth

Examples

Example of a frame
Example of a frame
Example of a frame
Example of a frame
Example of a frame
Example of a frame

follow our socials

X logoX logo