Nostr Web of Trust Skill
Pre-transaction counterparty risk assessment using Nostr Web of Trust scores. Accepts hex pubkeys or npub1... bech32 addresses.
- 52K+ pubkeys indexed with 2.4M+ trust edges
- Trust edges weighted by zap receipts (economic signal, harder to fake)
- Free tier:
wot.klabo.world(50 req/day per IP), no key required - Paid fallback:
maximumsats.com/api/wot-report(100 sats via L402) when free tier exhausted - 1-hour local cache to avoid redundant API calls
Usage
bun run nostr-wot/nostr-wot.ts <subcommand> [options]Subcommands
trust-score
Look up WoT trust score, rank, and percentile. Checks against configurable thresholds.
bun run nostr-wot/nostr-wot.ts trust-score --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts trust-score --npub npub1abc...Output:
{
"success": true,
"cached": false,
"api": "free",
"pubkey": "2b4603d2...",
"trusted": true,
"normalized_score": 87,
"rank": 142,
"percentile": 99.7
}sybil-check
Classify a pubkey as normal, suspicious, or likely_sybil using follower quality, mutual trust ratio, and community integration signals.
bun run nostr-wot/nostr-wot.ts sybil-check --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts sybil-check --npub npub1abc...Output:
{
"success": true,
"pubkey": "2b4603d2...",
"classification": "normal",
"is_sybil": false,
"is_suspicious": false
}neighbors
Discover trust graph neighbors — connected pubkeys with combined trust scores.
bun run nostr-wot/nostr-wot.ts neighbors --pubkey 2b4603d2...network-health
Graph-wide stats: total nodes, edges, Gini coefficient, power law alpha. No pubkey required.
bun run nostr-wot/nostr-wot.ts network-healthconfig
View or update trust thresholds. Stored at ~/.aibtc/nostr-wot/config.json.
bun run nostr-wot/nostr-wot.ts config # view current thresholds
bun run nostr-wot/nostr-wot.ts config --min-rank 5000
bun run nostr-wot/nostr-wot.ts config --require-top100
bun run nostr-wot/nostr-wot.ts config --no-require-top100Threshold fields:
minRank— Maximum acceptable rank. Default:10000requireTop100— Reject if not in top 100. Default:false
cache-status
Show cache statistics. Cache stored at ~/.aibtc/nostr-wot/cache.json with 1-hour TTL.
bun run nostr-wot/nostr-wot.ts cache-statusTrust Thresholds
| Rank | Meaning |
|---|---|
| 1–100 | Elite (top 100 Nostr users by WoT) |
| 101–1000 | Well-connected, high economic activity |
| 1001–10000 | Active community member |
| >10000 | Low trust, new account, or no Nostr activity |
API Details
Two endpoints, tried in order:
| Base | Auth | Cost | Rate |
|---|---|---|---|
https://wot.klabo.world | None | Free | 50 req/day/IP |
https://maximumsats.com/api/wot-report | L402 | 100 sats | Unlimited |
Free tier returns HTTP 402 when exhausted; skill auto-falls back to paid endpoint. L402 payment requires a Lightning client — without one, paid calls return an error with the BOLT11 invoice.