Package xyz.tcheeric.cashu.voucher.nostr.config

Class NostrRelayConfig.NostrRelayConfigBuilder

java.lang.Object

xyz.tcheeric.cashu.voucher.nostr.config.NostrRelayConfig.NostrRelayConfigBuilder

Enclosing class:

NostrRelayConfig

public static class NostrRelayConfig.NostrRelayConfigBuilder
extends Object

Builder that owns the relay list, so relays can be added one at a time or chosen from a preset. Until one of those is called the list is null, and the Cashu relays apply.

Constructor Summary

Constructors

Constructor	Description
NostrRelayConfigBuilder()

Method Summary

Modifier and Type	Method	Description
NostrRelayConfig.NostrRelayConfigBuilder	relayUrl(String relayUrl)	Appends a relay URL to the relays chosen so far.
NostrRelayConfig.NostrRelayConfigBuilder	relayUrls(List<String> relayUrls)	Sets multiple relay URLs at once, replacing any chosen before.
NostrRelayConfig.NostrRelayConfigBuilder	useCashuRelays()	Uses Cashu-specific relays.
NostrRelayConfig.NostrRelayConfigBuilder	useWellKnownRelays()	Uses well-known public relays.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

NostrRelayConfigBuilder

public NostrRelayConfigBuilder()

Method Details

relayUrl

public NostrRelayConfig.NostrRelayConfigBuilder relayUrl(String relayUrl)

Appends a relay URL to the relays chosen so far. On a fresh builder() nothing is chosen yet, so the first call replaces the default relays; after toBuilder() or a preset it adds to that list.

Parameters:

relayUrl - the WebSocket URL of the relay (must start with wss:// or ws://)

Returns:

this builder for chaining

Throws:

IllegalArgumentException - if URL is invalid

relayUrls

public NostrRelayConfig.NostrRelayConfigBuilder relayUrls(List<String> relayUrls)

Sets multiple relay URLs at once, replacing any chosen before. null leaves the current choice unchanged.

Parameters:

relayUrls - list of relay URLs

Returns:

this builder for chaining

Throws:

IllegalArgumentException - if any URL is invalid

useWellKnownRelays

public NostrRelayConfig.NostrRelayConfigBuilder useWellKnownRelays()

Uses well-known public relays.

Returns:

this builder for chaining

useCashuRelays

public NostrRelayConfig.NostrRelayConfigBuilder useCashuRelays()

Uses Cashu-specific relays.

Returns:

this builder for chaining