Softchat/com.softcose.softchat.sdk/AccountRelays

AccountRelays

class AccountRelays

Rust-owned durable relay catalog for one account.

Rust validates endpoints, reconciles caller-supplied authenticated discovery with user choices, and commits the complete catalog transaction. The managed transport consumes the effective catalog directly; low-level hosts may use the same values with their own socket.

Functions

suspend fun add(relayUrl: String): RelayCatalogMutation

Add or reactivate a custom relay and commit the complete catalog.

fun endpoint(configuredUrl: String): RelayEndpoint

Validate a configured endpoint for managed or low-level transport.

suspend fun entries(): List<RelayCatalogEntry>

Return the complete durable catalog.

suspend fun exclude(relayUrl: String): RelayCatalogMutation

Exclude an automatic relay or remove custom ownership.

failoverCandidates

suspend fun failoverCandidates(failedUrl: String): List<String>

Return ordered effective candidates after failedUrl.

fun observe(): Flow<List<RelayCatalogEntry>>

Observe the complete catalog after every durable account change.

suspend fun reconcile(discovered: List<DnsRelayRecord>, fallbackUrl: String, dnsAuthenticated: Boolean): StoredRelayCatalogPlan

Reconcile authenticated DNS discovery and commit it atomically.

restoreAutomatic

suspend fun restoreAutomatic(): RelayCatalogMutation

Restore every currently discovered automatic relay.

fun retry(attempt: UInt, failure: RelayFailureKind, bypassDelayOnce: Boolean = false): RelayRetryPlan

Return bounded retry/failover policy for one transport result.

suspend fun setActive(relayUrl: String): RelayCatalogMutation

Select exactly one effective active relay.