nostr-wot

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

利用Nostr Web of Trust评分进行交易前对手方风险评估。支持十六进制公钥或

npub1...

格式的bech32地址。

已索引52000+公钥，包含240万+信任关系
信任关系基于zap收据加权（经济信号，更难伪造）
免费层级：
```
wot.klabo.world
```
（每IP每日50次请求），无需密钥
付费备用方案：当免费层级耗尽时，使用
```
maximumsats.com/api/wot-report
```
（通过L402支付100聪）
1小时本地缓存，避免重复API调用

Usage

使用方法

bun run nostr-wot/nostr-wot.ts <subcommand> [options]

bun run nostr-wot/nostr-wot.ts <子命令> [选项]

Subcommands

子命令

trust-score

Look up WoT trust score, rank, and percentile. Checks against configurable thresholds.

bash

bun run nostr-wot/nostr-wot.ts trust-score --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts trust-score --npub npub1abc...

Output:

json

{
  "success": true,
  "cached": false,
  "api": "free",
  "pubkey": "2b4603d2...",
  "trusted": true,
  "normalized_score": 87,
  "rank": 142,
  "percentile": 99.7
}

查询WoT信任评分、排名及百分位。可根据配置的阈值进行校验。

bash

bun run nostr-wot/nostr-wot.ts trust-score --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts trust-score --npub npub1abc...

输出：

json

{
  "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.

bash

bun run nostr-wot/nostr-wot.ts sybil-check --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts sybil-check --npub npub1abc...

Output:

json

{
  "success": true,
  "pubkey": "2b4603d2...",
  "classification": "normal",
  "is_sybil": false,
  "is_suspicious": false
}

根据关注者质量、互信比例及社区融入度等信号，将公钥分类为

normal

（正常）、

suspicious

（可疑）或

likely_sybil

（疑似女巫账号）。

bash

bun run nostr-wot/nostr-wot.ts sybil-check --pubkey 2b4603d2...
bun run nostr-wot/nostr-wot.ts sybil-check --npub npub1abc...

输出：

json

{
  "success": true,
  "pubkey": "2b4603d2...",
  "classification": "normal",
  "is_sybil": false,
  "is_suspicious": false
}

neighbors

Discover trust graph neighbors — connected pubkeys with combined trust scores.

bash

bun run nostr-wot/nostr-wot.ts neighbors --pubkey 2b4603d2...

发现信任图谱中的关联节点——具有综合信任评分的关联公钥。

bash

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.

bash

bun run nostr-wot/nostr-wot.ts network-health

全图谱统计信息：总节点数、关系数、基尼系数、幂律alpha值。无需提供公钥。

bash

bun run nostr-wot/nostr-wot.ts network-health

config

View or update trust thresholds. Stored at

~/.aibtc/nostr-wot/config.json

bash

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-top100

Threshold fields:

```
minRank
```
— Maximum acceptable rank. Default:
```
10000
```
```
requireTop100
```
— Reject if not in top 100. Default:
```
false
```

查看或更新信任阈值。配置文件存储于

~/.aibtc/nostr-wot/config.json

。

bash

bun run nostr-wot/nostr-wot.ts config                    # 查看当前阈值
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-top100

阈值字段：

```
minRank
```
— 可接受的最高排名。默认值：
```
10000
```
```
requireTop100
```
— 若不在前100则拒绝。默认值：
```
false
```

cache-status

Show cache statistics. Cache stored at

~/.aibtc/nostr-wot/cache.json

with 1-hour TTL.

bash

bun run nostr-wot/nostr-wot.ts cache-status

显示缓存统计信息。缓存存储于

~/.aibtc/nostr-wot/cache.json

，TTL为1小时。

bash

bun run nostr-wot/nostr-wot.ts cache-status

Trust 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

排名	含义
1–100	精英层级（WoT排名前100的Nostr用户）
101–1000	连接广泛，经济活跃度高
1001–10000	活跃社区成员
>10000	信任度低、新账号或无Nostr活动

API Details

API详情

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.

两个端点，按顺序尝试：

基础地址	认证方式	成本	速率限制
`https://wot.klabo.world`	无	免费	每IP每日50次请求
`https://maximumsats.com/api/wot-report`	L402	100聪	无限制

当免费层级耗尽时，会返回HTTP 402状态码；工具会自动切换到付费端点。L402支付需要Lightning客户端——若无该客户端，付费调用会返回包含BOLT11发票的错误信息。