Medusa

From Local Area Network
Revision as of 21:57, 10 October 2026 by Eleutherious (talk | contribs) (Parallel Wiki build: page from sourced research, source-checked 9 October 2026)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Medusa
What it does: A self-custody privacy wallet for the Logos Execution Zone, run as a Basecamp module
Stage: Prototype
Licence: GPL-3.0
Verified on 9 October 2026 against README, CHANGELOG and release v0.4.4 (26 August 2026).

Medusa is a private, self-custodial wallet for the Logos Execution Zone (LEZ), built by the developer ParadoxComputer as a Basecamp module.

What it does

  • Medusa holds your keys and sends public transfers, private transfers and tokens. Your keys never leave the wallet.
  • Private transfers come in three kinds: shield (public to private), deshield (private to public) and private to private. LAN Issue 1 notes that in private accounts the amount and the sender stay hidden.
  • A private transfer builds a zero-knowledge proof on your own machine. This is fast on the local devnet. On a real-proof zone it takes minutes, and the README reports 20 to 40 minutes or more on a busy machine.
  • Your password encrypts the keys on disk. The wallet locks itself when idle.
  • It ships with four zones: a local devnet, the Paradox Computer sequencer over clearnet, the same sequencer over Tor, and the Logos public testnet. You can add your own sequencer, by URL or .onion address.
  • Connect with Medusa is a small JavaScript SDK (@paradoxcomputer/medusa-connect). It lets another Basecamp module ask the wallet for a payment. The user approves every connection and every transfer inside the wallet. The repository includes a demo Tip Jar module.
  • LAN Issue 1 says it supports multiple identities in one wallet. It is part of the same developer's wider Logos work, which includes LEZ ZoneScan, an explorer for the Logos Execution Zone.

Stage: Prototype. The README status line reads "v0.4.0 (testnet, LEZ v0.2.2)" and its security section says to read it "before trusting it with anything but testnet play-money."

Use it

  1. Download the release assets for your platform from the releases page: medusa_core and medusa_ui. Always install them as a pair.
  2. Install them from Basecamp (Apps, then install a package), or unpack the medusa-wallet bundle and run its install.sh. The bundle needs no Nix, Rust or Tor.
  3. Close and reopen Basecamp. It has no hot reload.
  4. Open Medusa, choose Create wallet and set a password. Write down the 24-word recovery phrase.
  5. On devnet, make a new account and claim the faucet (150 LEZ). Then try Send, Shield, Deshield or Private.

On a Mac: the build is for Apple Silicon only and is not notarised. Clear the quarantine flag on the downloaded files first, and install tor with Homebrew for the Tor zone. Intel Macs are not built.

Read the README's "Security posture" section before you use it. Three points from it:

  • Basecamp does not yet isolate modules from each other, so your password is the main defence.
  • Check the address shown next to the zone name before you send anything large. That is how you spot a wallet someone has repointed.
  • Each .lgx carries a signature, but Basecamp does not yet enforce a signature policy on install and the GitHub release assets are unsigned. Verify what you install.

A known limit on testnet: a private account can receive only once, so the wallet offers fresh private accounts as destinations.

Build it

You need Nix with flakes, Rust (cargo), Logos Basecamp and tor.

  1. bash wallet/build.sh clones the upstream zone at a pinned commit, applies the Medusa patches and builds the wallet and sequencers.
  2. bash module/scripts/install-dev.sh --launch builds the module with Nix, installs it into Basecamp and restarts Basecamp.

Releases

  • v0.2.3, 13 July 2026: first public release.
  • v0.3.0, 30 July 2026.
  • v0.4.0, 11 August 2026: moves to LEZ v0.2.2, adds an on-chain token faucet and closes a gap that let a locked wallet be repointed to another sequencer.
  • v0.4.4, 26 August 2026: the latest release. The wallet's opening screen shows the build you are running.

User reviews

Add your review on the talk page.

See also

Sources

Page status: Usable. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.