Softchat/com.softcose.softchat.sdk/RelaySession

RelaySession

class RelaySession : AutoCloseable

Serialized relay protocol state machine for a host-owned socket lifecycle.

Constructors

RelaySession

constructor()

Functions

authenticate

fun authenticate(event: SignedNostrEvent): ERROR CLASS: Cannot infer argument for type parameter T

Queue one verified NIP-42 AUTH response while authentication is pending.

authenticated

fun authenticated(): ERROR CLASS: Cannot infer argument for type parameter T

Complete an authentication phase and replay queued operations.

cancel

fun cancel(): RelaySessionAction

Permanently cancel the session and request transport closure.

open override fun close(): ERROR CLASS: Unresolved name: close

Release native state; use cancel first when a transport is active.

closeSubscription

fun closeSubscription(id: String): ERROR CLASS: Cannot infer argument for type parameter T

Close and forget one subscription.

confirmIngested

fun confirmIngested(eventId: NostrEventId): ERROR CLASS: Cannot infer argument for type parameter T

Confirm that one received event was durably committed by the host.

confirmSent

fun confirmSent(eventIds: List<NostrEventId>): ERROR CLASS: Cannot infer argument for type parameter T

Confirm socket handoff for one drained frame.

connect

fun connect(): RelaySessionAction

Begin a connection attempt and request transport creation.

drainOutbound

fun drainOutbound(limit: UInt): List<OutboundRelayFrame>

Remove at most limit queued outbound frame records.

publish

fun publish(events: List<SignedNostrEvent>): ERROR CLASS: Cannot infer argument for type parameter T

Queue one bounded batch of signed events for delivery tracking.

receive

fun receive(frameJson: String): List<RelaySessionAction>

Consume one relay text frame and return required platform actions.

snapshot

fun snapshot(): RelaySessionSnapshot

Read one redacted diagnostic snapshot.

fun subscribe(id: String, filtersJson: List<String>): ERROR CLASS: Cannot infer argument for type parameter T

Add or replace a subscription using canonical filter JSON values.

transportConnected

fun transportConnected(): ERROR CLASS: Cannot infer argument for type parameter T

Notify the state machine that the platform transport is connected.

transportLost

fun transportLost(): List<RelaySessionAction>

Notify the session of transport loss and calculate recovery actions.