Nostr WoT

Your identity across Nostr

Nostr WoT brings signing, Lightning payments and account management together so you can get started easily and connect compatible apps with control over your identity.

Founded by Leon Acosta

Get started. Connect. Stay in control.

For people using Nostr and developers connecting its ecosystem.

Identity and access

Create or import an account, then connect compatible apps without starting over in each one.

Signing and permissions

Review signing requests and manage what each connected site can do.

Lightning wallet

Connect a wallet, send payments and use zaps across compatible apps.

Tools for developers

Integrate signing, access and payments with reusable SDK and UI components.

Web of Trust: one part of the experience

Web of Trust adds context for discovery and filtering by measuring social distance: the number of follow-graph hops between accounts.

You
1 hop
2 hops
3+ hops

What the distance means

1-Hop (Direct Follows)

Accounts you follow directly. A follow is a connection, not a certification.

2-Hop (Extended Network)

Accounts reached through two follow links. This describes a path through the graph.

3+ hops (extended network)

Accounts three or more follow links away. Distance alone does not establish reliability.

Web of Trust architecture

Your App / WebsiteNostr client, marketplace, social app
WoT SDKnostr-wot-sdk (client-side)
Local IndexIndexedDB (privacy)
or
WoT OracleRemote API (speed)
Nostr RelaysFollow lists (Kind 3 events)

Use Cases

Web of Trust enables a wide range of applications that benefit from decentralized reputation.

Spam Filtering

Filter content by social distance without centralized blocklists. Only show content from people within 2-3 hops.

Trust Scores

Build reputation systems for marketplaces, reviews, and recommendations based on social proximity.

Smart Notifications

Prioritize notifications from close connections. Alert immediately for 1-hop, batch for 2-hop, mute beyond.

Content Discovery

Surface content from your extended network. Find interesting posts from friends-of-friends.

Code Examples

typescript
// Check if someone is in your web of trust
import { WoT } from "@nostr-wot/wot";

const wot = new WoT({ rootPubkey: myPubkey, maxHops: 2 });
const result = await wot.getDistance(pubkey);

if (result && result.hops <= 2) {
  console.log("Social distance: " + result.hops + " hops away");
}
terminal
# Query social distance between two users
$curl "https://wot-oracle.mappingbitcoin.com/distance?from=PUBKEY1&to=PUBKEY2"
$
# Response
${ "distance": 2, "paths": 5, "mutual": false }

# Clone the repository:

git clone https://github.com/nostr-wot/nostr-wot-extension.git

# Go to chrome://extensions in your browser

# Enable "Developer mode" (toggle in top right)

# Click "Load unpacked"

# Select the nostr-wot-extension folder

Or install manually:

No build required - the extension loads directly from source.

Interactive Demo

Try the Playground

Explore your Web of Trust graph interactively. See your social connections, trust distances, and how the extension works in real-time.

Install from Chrome Web Store

The extension is now available on the Chrome Web Store for easy installation:

Install from Chrome Web Store
Open Playground

Ready to Get Started?

Explore our documentation or dive straight into the code.