Skip to content

Zcash pseudonyms on Free2Z over Nym - #80

Merged
amiller merged 6 commits into
work/zcon-portable-publicfrom
work/zcash-pseudonyms
Oct 27, 2026
Merged

amiller merged 6 commits into
work/zcon-portable-publicfrom
work/zcash-pseudonyms

Conversation

@amiller

@amiller amiller commented Oct 27, 2026

Copy link
Copy Markdown
Owner

Adds ~/pseudonym new|list|login|whoami|exit NAME: Zcash transparent-address pseudonyms derived from the wallet seed, each logging into Free2Z with only a signature.

  • Pseudonym n's key is m/44'/133'/(1000+n)'/0/0 of the Zkool seed in the vault, so the seed is the backup. Checked against Zkool 6.34.0 with two test mnemonics: our address is the one Zkool stores at diversifier index 0 for account 1000+n (Zkool displays a different index).
  • Login is Free2Z's /api/auth/zcash/challenge/ + /login/ (zcashd signmessage format, signed with @noble/curves). A new address creates an account; the knox token is kept in the vault.
  • Free2Z refuses Tor exits (403 on every exit tried), so each pseudonym gets its own nym-socks5-client with its keys in the vault and a recorded exit that passed a Free2Z probe. A dead exit is an error; pseudonym exit NAME picks another. No Tor or clearnet fallback.
  • 2Z can be bought from a shielded wallet with memo {"act":"buy_2z","id":"<username>"}, so the t-address never needs to hold ZEC (not implemented here).

Tested in the QEMU twin on zed: two pseudonyms created real Free2Z accounts through separate Nym exits, tokens survived lock/unlock, read-only GET /api/auth/user/ worked. Unit tests: 4/4. test-home-command.py has one pre-existing failure (test_unlock_one_request_after_drop_no_secret_argv) that also fails without this change.

Not yet in the image, so the command fails on a stick built from this branch:

  • aarch64 nym-socks5-client at /opt/nym/
  • portable-nym system account
  • nftables egress rules for that uid (generate-policy.mjs needs to emit them)

The Nym clients currently use free testnet bandwidth with no credential.

@amiller
amiller marked this pull request as ready for review October 27, 2026 23:08
@amiller
amiller merged commit af319df into work/zcon-portable-public Oct 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant