KarpelesLab / libwallet / 24420236433

25%

push

github

wltwc: relay WebSocket client

Goroutine-safe client for a WalletConnect v2 relay (wss://relay…) over
gorilla/websocket. Handles the irn_* JSON-RPC protocol:

- Subscribe(topic) → subId
- Publish(topic, msg, tag, ttl) with the standard WC tags baked in
  (1100 propose / 1102 settle / 1108 request / 1109 response / 1110
  event / 1112 delete). `prompt` is set for propose + request so the
  relay can deliver push notifications to backgrounded wallets.
- Unsubscribe(topic, subId)
- Inbound irn_subscription fans out on an Events channel; each message
  is ACKed to the relay so it isn't redelivered.

Auth: per-connection Ed25519 JWT via the `auth` query-string param
(did:key iss, did:key-encoded via multicodec + base58btc). Ed25519
keypair is passed in so the caller can persist it across restarts —
the relay treats it as the client's stable identity. ProjectId is the
standard WC paid-tier query param.

Read + write pumps run as goroutines for the lifetime of Start;
Close() cancels. Reconnect / backoff will be wired by the Manager on
top once session state lands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

0 of 226 new or added lines in 1 file covered. (0.0%)

2038 of 8331 relevant lines covered (24.46%)

3.01 hits per line