Nostr WoT

Documentation

Everything you need to integrate Web of Trust into your application.

Overview

Nostr Web of Trust provides two complementary tools for trust-based filtering:

Both answer the same fundamental question: ""What is the social distance between two pubkeys?""

Choose Your Integration

Browser Extension

For client-side web apps. Users need the WoT extension installed.

Extension API Docs →

Oracle REST API

For server-side apps. No user extension required. Use our public server or self-host.

Oracle API Docs →

JavaScript SDK

TypeScript SDK for the Oracle API with React hooks and error handling.

SDK Docs →

Quick Example

Here's a simple example using the browser extension:

javascript
// Check if extension is available
if (window.nostr?.wot) {
  // Get distance to a pubkey
  const distance = await window.nostr.wot.getDistance(
    "npub1targetpubkey..."
  );

  if (distance !== null && distance <= 2) {
    console.log(`Trusted: ${distance} hops away`);
  } else {
    console.log("Not in your web of trust");
  }
}