Skip to content

EFP follow-ups: skill, Omnigraph example queries, and plugin documentation #2324

Description

@shrugs

Tracking the documentation/DX follow-ups for the EFP (Ethereum Follow Protocol) integration landed in #2296. The PR ships the full EFP surface (indexer plugin, efp_* schema, Query.efp / Account.efp Omnigraph API) but intentionally leaves the following for a follow-up:

1. EFP agent skill

  • No efp skill exists under packages/ensskills/skills/. Consider whether EFP querying warrants its own skill, or a section in the existing omnigraph skill, covering: the two-step Primary List validation, the validated follow graph (following/followers, block/mute exclusion), and protocol-level vs account-rooted queries (Query.efp vs Account.efp).
  • Follow the placement rule in the root CLAUDE.md (external integrator knowledge → packages/ensskills or docs/ensnode.io, never internal AGENTS.md).

2. Omnigraph example queries

  • packages/ensnode-sdk/src/omnigraph-api/example-queries.ts has no EFP entries. Add runnable examples for the common shapes, e.g.:
    • Account.efp.primaryList lookup
    • Account.efp.following / Account.efp.followers (the validated social graph)
    • Query.efp.lists(where:) / Query.efp.list(by:) browse
    • Account.efp.metadata(key:)
  • These surface in the docs site and ENSAdmin.

3. EFP plugin documentation

  • Document the efp plugin in docs/ensnode.io: how to enable it (PLUGINS), what it indexes, and the resulting API surface.
  • Cross-link from the Omnigraph API reference and the plugins overview.

Refs: #2296

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocs related

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    Status
    In Progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions