From c9f670d7001802fd7f9588a1655f1e2efedbcf80 Mon Sep 17 00:00:00 2001
From: fiatjaf <fiatjaf@gmail.com>
Date: Fri, 31 Jan 2025 22:47:10 -0300
Subject: [PATCH] sdk: FetchWriteRelays() and comments explaining these relay
 functions.

---
 sdk/outbox.go | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/sdk/outbox.go b/sdk/outbox.go
index be56800..0bd521e 100644
--- a/sdk/outbox.go
+++ b/sdk/outbox.go
@@ -14,6 +14,10 @@ type ostcEntry struct {
 	when   time.Time
 }
 
+// FetchOutboxRelays uses a bunch of heuristics and locally stored data about many relays, including hints, tags,
+// NIP-05, past attempts at fetching data from a user from a given relay, including successes and failures, and
+// the "write" relays of kind:10002, in order to determine the best possible list of relays where a user might be
+// currently publishing their events to.
 func (sys *System) FetchOutboxRelays(ctx context.Context, pubkey string, n int) []string {
 	ostcIndex, _ := strconv.ParseUint(pubkey[12:14], 16, 8)
 	now := time.Now()
@@ -42,6 +46,8 @@ func (sys *System) FetchOutboxRelays(ctx context.Context, pubkey string, n int)
 	return relays
 }
 
+// FetchWriteRelays just reads relays from a kind:10002, that's the only canonical place where a user reveals
+// the relays they intend to receive notifications from.
 func (sys *System) FetchInboxRelays(ctx context.Context, pubkey string, n int) []string {
 	rl := sys.FetchRelayList(ctx, pubkey)
 	if len(rl.Items) == 0 || len(rl.Items) > 7 {
@@ -57,3 +63,24 @@ func (sys *System) FetchInboxRelays(ctx context.Context, pubkey string, n int) [
 
 	return relays
 }
+
+// FetchWriteRelays just reads relays from a kind:10002, it's different than FetchOutboxRelays, which relies on
+// other data and heuristics besides kind:10002.
+//
+// Use FetchWriteRelays when deciding where to publish on behalf of a user, but FetchOutboxRelays when deciding
+// from where to read notes authored by other users.
+func (sys *System) FetchWriteRelays(ctx context.Context, pubkey string, n int) []string {
+	rl := sys.FetchRelayList(ctx, pubkey)
+	if len(rl.Items) == 0 || len(rl.Items) > 7 {
+		return []string{"wss://relay.damus.io", "wss://nos.lol"}
+	}
+
+	relays := make([]string, 0, n)
+	for _, r := range rl.Items {
+		if r.Outbox {
+			relays = append(relays, r.URL)
+		}
+	}
+
+	return relays
+}