welshman/docs/app/wot.md

Web of Trust

app.use(Wot) computes a web-of-trust graph from follow (FollowLists) and mute (MuteLists) lists, rooted at the current user. When there is no signed-in user, the graph is built from the union of all known follow lists. All computations are throttled (1s) to stay cheap under churn.

The score for a pubkey is the number of roots that follow it minus the number that mute it.

Aggregate projections

Each returns a Projection (.get() / .$):

const wot = app.use(Wot)

wot.graph                      // Projection<Map<string, number>> — score per pubkey
wot.max                        // Projection<number | undefined> — highest score in the graph
wot.followersByPubkey          // Projection<Map<string, Set<string>>>
wot.mutersByPubkey             // Projection<Map<string, Set<string>>>

Per-pubkey queries

wot.follows(pubkey)                       // Projection<string[]> — who pubkey follows
wot.mutes(pubkey)                         // Projection<string[]> — who pubkey mutes
wot.followers(pubkey)                     // Projection<string[]> — who follows pubkey
wot.muters(pubkey)                        // Projection<string[]> — who mutes pubkey
wot.network(pubkey)                       // Projection<string[]> — follows-of-follows (minus direct follows)

wot.followsWhoFollow(pubkey, target)      // Projection<string[]>
wot.followsWhoMute(pubkey, target)        // Projection<string[]>
wot.wotScore(pubkey, target)              // Projection<number>

wotScore(pubkey, target):

• With a pubkey: (pubkey's follows who follow target) − (pubkey's follows who mute target).
• Without a pubkey: followers(target).length − muters(target).length.

Examples

const wot = app.use(Wot)

// Sort a list of pubkeys by trust, descending
const graph = wot.graph.get()
const sorted = [...pubkeys].sort((a, b) => (graph.get(b) ?? 0) - (graph.get(a) ?? 0))

// Reactive trust score between me and someone else
const score$ = wot.wotScore(myPubkey, theirPubkey).$

// Discover the extended network for a "follows of follows" feed
const network = wot.network(myPubkey).get()

The WoT graph also feeds profile search ranking and the Scope/WoT-range pubkey resolution used by feeds.