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

    Projects

    Status
    In Progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions