Skip to content

feat(pow): apply WoT-distance-based PoW reductions - #779

Open
Priyanshubhartistm wants to merge 2 commits into
cameri:mainfrom
Priyanshubhartistm:feat/wot-aware-pow-policy
Open

Priyanshubhartistm wants to merge 2 commits into
cameri:mainfrom
Priyanshubhartistm:feat/wot-aware-pow-policy

Conversation

@Priyanshubhartistm

Copy link
Copy Markdown
Collaborator

Description

nostream now has a Web of Trust graph exposing a distance-lookup API, and a relay-load-aware adaptive PoW pipeline that scales the required eventId difficulty with observed event rate. The two didn't talk to each other every pubkey faced the same computed difficulty regardless of how trusted it is.

This wires the WoT graph into the adaptive PoW pipeline via limits.event.pow.wotThresholds: an ordered list of { maxDistance, difficultyFactor } entries. The eligible threshold with the smallest maxDistance applies, scaling the computed difficulty by difficultyFactor (0 bypasses eventId PoW entirely, 1 requires the full computed difficulty, fractional values in between). A pubkey outside the trust graph, or beyond every configured threshold, always pays the full
computed difficulty. Disabled by default (no thresholds configured), and only ever consults the WoT graph when at least one threshold is configured, so relays not using this stay unaffected.

EventMessageHandler.canAcceptEvent() is now async to support the distance lookup every other check in handleMessage's chain was already async, so this keeps the same style rather than special-casing one synchronous check.

Related Issue

Closes #778

Motivation and Context

A fixed adaptive difficulty treats a well-connected community member the same as a completely unknown pubkey under load. Reducing (or waiving) the PoW requirement for pubkeys inside the operator's trust circle means a trusted author can keep posting instantly during a spam flood, while an unknown pubkey still has to prove it isn't a bot.

Signed-off-by: Priyanshubhartistm <bhartipriyanshustm@gmail.com>
Signed-off-by: Priyanshubhartistm <bhartipriyanshustm@gmail.com>
@changeset-bot

changeset-bot Bot commented Sep 15, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: acc6622

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
nostream Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coveralls

Copy link
Copy Markdown
Collaborator

Coverage Status

coverage: 72.494% (+0.09%) from 72.408% — Priyanshubhartistm:feat/wot-aware-pow-policy into cameri:main

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: WoT-aware adaptive PoW policy engine (NIP-02 + NIP-13)

2 participants