Nostr WoT

Dokumentation

Alles, was Sie brauchen, um Web of Trust in Ihre Anwendung zu integrieren.

Schnellstart

Starte in wenigen Minuten mit Web of Trust.

Oracle aus einem Browser oder Server abfragen

Oracle v0.3.0 unterstützt standardmäßige fetch-Anfragen. Verwende vollständige öffentliche Schlüssel mit 64 Hexadezimalzeichen. Keine Erweiterung und kein SDK erforderlich.

Follow-Distanz abfragen

typescript
async function getFollowDistance(from: string, to: string) {
  const query = new URLSearchParams({ from, to, max_hops: "2" });
  const response = await fetch(
    "https://wot-oracle.mappingbitcoin.com/distance?" + query
  );
  if (!response.ok) throw new Error("Oracle HTTP " + response.status);
  const data = await response.json();
  return data.hops as number | null;
}

// Replace with real public keys before querying.
const hops = await getFollowDistance("a".repeat(64), "b".repeat(64));
console.log(hops === null ? "No indexed path within 2 hops" : hops);

Hop-Werte: 0 = du selbst, 1 = direkt gefolgt, 2 = von einer Person gefolgt, der du folgst. Ein null-Ergebnis bedeutet, dass im indexierten Graphen innerhalb der angefragten Tiefe kein Pfad gefunden wurde. Die Abdeckung hängt von den konfigurierten Relays ab. Die Erweiterung stellt Signierung und Identität bereit; sie beantwortet keine Graphabfragen.

Server (mit Oracle API)

Verwende für serverseitige Anwendungen die Oracle-REST-API. Keine Erweiterung erforderlich.

Öffentliche Stummschaltungsdaten einbeziehen

javascript
const from = "a".repeat(64); // Replace with source pubkey
const to = "b".repeat(64); // Replace with target pubkey
const query = new URLSearchParams({ from, to, max_hops: "3" });
const response = await fetch(
  "https://wot-oracle.mappingbitcoin.com/trust?" + query
);
if (!response.ok) throw new Error("Oracle HTTP " + response.status);
const { follow_distance, public_mute_evidence } = await response.json();
console.log(follow_distance.hops, follow_distance.path_count);
console.log(public_mute_evidence.source_mutes_target);
console.log(public_mute_evidence.source_mute_list_known);

Follow-Distanz und öffentliche Stummschaltungsbeobachtungen aus kind-10000 sind getrennte Indizien. Die API kombiniert sie nicht zu einem numerischen Wert und entschlüsselt keine privaten Stummschaltungseinträge. Unbekannte Stummschaltungslisten und Listen ohne öffentliche Einträge sind unterschiedliche Zustände. Lege die Regeln deiner Anwendung ausdrücklich fest.

cURL verwenden

Terminal
$curl --fail-with-body "https://wot-oracle.mappingbitcoin.com/health"
$curl --fail-with-body "https://wot-oracle.mappingbitcoin.com/ready"

SDK-Kompatibilität

Die veröffentlichte Version @nostr-wot/[email protected] verwendet ältere entfernte Endpunkte und Antwortfelder, die Oracle v0.3.0 nicht bereitstellt. Entfernte SDK-Distanzabfragen können nach einem 404 null zurückgeben. Interpretiere das daher nicht als bestätigtes Graphergebnis. Verwende für diesen Oracle die obigen fetch-Beispiele.

Die SDK-Pakete für Daten, Relays und Identität bleiben unabhängig davon nützlich. Für lokale Graphabfragen und die React-Integration siehe die geprüften SDK-Beispiele. useTrustScore gehört nicht zur veröffentlichten WoT-1.0-API.

Aus dem Quellcode erstellen

Klonen Sie das Repository und erstellen Sie es lokal für die Entwicklung oder zur Überprüfung des Codes.

Terminal
$git clone https://github.com/nostr-wot/nostr-wot-extension.git
$cd nostr-wot-extension && npm install && npm run build

Gehen Sie zu chrome://extensions, aktivieren Sie den Entwicklermodus, klicken Sie auf Entpackte Erweiterung laden und wählen Sie den dist/-Ordner.