Initiate native token transfers on the LEZ with the wallet UI

[kashepavadan]

From: #342

[weboko]

Dogfooded on Ubuntu 24.04.4 LTS x86_64 (headless).

I installed Nix, enabled flakes, cloned the repo, and ran nix build — the flake evaluates correctly and the build is in progress (Qt/C++ app). I could not complete the GUI portion (wallet UI requires a display). See inline comments for specific issues.

The docs structure, screenshots, and flow look clear. Two things need attention before this is ready for non-developer users.

[weboko]

Additional dogfood note (eco-dev-eng): I attempted nix build on x86_64 Linux from scratch. After ~30 minutes the build is still in progress, with ~270MB of Rust crates and Qt/C++ dependencies downloading and compiling from source on a cold cache. A first-run nix run on a fresh machine can be significantly slower than a reader unfamiliar with Nix might expect. The What to expect section should set an expectation about cold-build time (e.g. nix run may take 20–60 minutes on a cold cache before the UI window appears). Subsequent runs will be instant from cache.

[weboko]

Build update: nix build completed successfully on x86_64 Linux after ~50 minutes on a cold cache. All components built cleanly:

• logos-execution-zone-wallet-ffi-0.1.0 ✓
• logos-lez_wallet_ui-module-lib-1.0.0 ✓
• logos-lez_wallet_ui-module ✓

Could not test the UI itself (headless environment, no display). The cold-build time note in the previous comment stands.

[weboko]

Dogfooded on x86_64 Linux (headless). The two inline issues (SSH URL, flakes) are fixed — thanks for addressing those. One remaining issue before this is ready:

Cold build time is not communicated. nix run on a cold Nix cache builds Qt/C++/Rust from source and takes 20–60 minutes. A first-time user who sees no output for several minutes and terminates the process thinking it is hung will have a bad experience. This was raised in a comment but the doc was not updated.

The nix run step should add a note immediately after the code block, e.g.:

On a cold Nix cache, the first run compiles the wallet UI from source (Qt/C++ and Rust dependencies). This can take 20–60 minutes. Subsequent runs are instant from cache.

Alternatively, add a bullet to ## What to expect covering build time so users know upfront.