KarpelesLab / libwallet / 24421247051

25%

push

github

WalletConnect v2: pairing, sessions, requests, events, Dart surface

Ties together the crypto + relay foundations into a full
WalletConnect v2 wallet-side implementation.

Go (wltwc):
- Manager: owns the relay WebSocket with reconnect + backoff,
  replays subscriptions for every non-disconnected session on
  startup, decrypts inbound envelopes, classifies wc_* methods.
- session.go: SQL-backed wcSession struct (pairing / proposed /
  active / disconnected), persists topic, symKey, X25519 keys,
  peer metadata, approved namespaces, and expiry.
- pairing.go: parses wc:TOPIC@2?relay-protocol=irn&symKey=... URIs
  and validates the symKey-derived topic matches.
- manager: handles wc_sessionPropose (stashes + emits
  wc_session_propose host event), wc_sessionRequest (emits
  wc_session_request), wc_sessionDelete (marks disconnected),
  wc_sessionEvent / ping (ACK only). Builds wc_sessionSettle on
  approval with CAIP-10 accounts mapped per namespace.
- api.go: endpoints WalletConnect:start / stop / pair / sessions /
  approveSession / rejectSession / respond / respondError /
  emitEvent / disconnect.
- wltbase.InitEnv now calls wltwc.InitEnv (creates the SQL table,
  wires the per-env Manager).

Dart:
- client.walletConnect (WalletConnectApi) with all endpoints.
- client.walletConnectProposals / walletConnectRequests streams
  built on top of the existing event bus (WcSessionProposal /
  WcSessionRequest models).
- Typed WcSession with isPairing/isProposed/isActive/isDisconnected
  getters and peerName convenience.

Docs:
- dart/doc/walletconnect_integration.md: full host walkthrough
  (start → pair → approve → respond → emitEvent → disconnect),
  CAIP-10 / CAIP-2 notes, troubleshooting table.
- dart/README.md + api.md updated.

Tests: 106 Dart integration tests pass (4 new WC smoke tests);
wltwc unit tests cover crypto + URI parsing.

v1 scope notes:
- Signing approvals still go through the existing
  client.pendingRequests flow inside client.web3.request... (continued)

57 of 749 new or added lines in 5 files covered. (7.61%)

2095 of 9080 relevant lines covered (23.07%)

2.77 hits per line