KarpelesLab / libwallet / 24420128405

25%

push

github

wltwc: WalletConnect v2 envelope cryptography

First piece of the WalletConnect v2 implementation: the crypto
envelope. Covers Type-0 (symmetric, for session traffic) and Type-1
(asymmetric X25519, for the one-shot sessionPropose) exactly as the
WC v2 spec defines them:

- sealType0/openEnvelope Type 0: [0x00][nonce:12][ct][tag:16]
- sealType1/openEnvelope Type 1: [0x01][senderPub:32][nonce:12][ct][tag:16]
- deriveSymKey: X25519 → HKDF-SHA256 (empty salt/info)
- topicFromSymKey / topicFromDerivedKey: sha256 hex
- newX25519KeyPair

ChaCha20-Poly1305 via x/crypto, curve25519 + HKDF from x/crypto.
Gorilla WebSocket added as a dep in prep for the relay client (next).

5 unit tests cover roundtrip (both envelope types), wrong-key failure,
topic shape, and two-sided symmetric-key agreement.

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

76 of 126 new or added lines in 1 file covered. (60.32%)

2038 of 8105 relevant lines covered (25.14%)

3.1 hits per line