Skip to content
Dhiva-LabsPublic

About

Open-source Monero wallet for Linux, Windows and Android. Full-node or light-wallet (LWS) sync, multiple wallets, mainnet/stagenet/testnet.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Kilonova

Rust core Linux Windows Android Bindings Design lint Regtest Public nodes Fuzz License: MIT Platforms

An open-source Monero wallet for Linux, Windows and Android, by Dhiva Labs.

Documentation: step-by-step guides at learn.dhivalabs.com: install · beginner guide · troubleshooting. New to the topic? Try the Crypto wallets learning track.

Kilonova can sync two ways, chosen per wallet:

  • Full mode: the app scans the blockchain itself against a Monero node, either one of the bundled public nodes or your own. No keys leave your device.
  • LWS mode: a monero-lws server you choose does the scanning, so sync is fast. The server receives your private view key and can see your incoming payments. Your spend key always stays on your device.

It holds multiple wallets side by side, and each wallet belongs to one network: mainnet, stagenet or testnet.

Not audited. Kilonova works end to end (sync, send, receive) and is tested against Monero's reference wallet, but it has not had an external security review. Do not keep more in it than you can afford to lose. Stagenet and testnet are there to try it without risk.

What it does

  • Several wallets on mainnet, stagenet and testnet: create, or restore from a 25-word or Polyseed seed, a spend key, or as view-only.
  • Full sync from a node you choose, including payments waiting in the pool.
  • Light wallet server sync with consent per server; every output the server reports is checked with your own keys.
  • Send to several recipients or send everything; review what the signed transaction pays before confirming with your password or fingerprint.
  • QR codes and amount requests; camera scanning on Android, image files on desktop.
  • Address book, transaction notes and payment proofs.
  • Tor or SOCKS5 proxy for all traffic, onion nodes, pinned certificates for your own node.
  • Optional, off by default: prices in your currency, payment notifications, checks for payments while the app is closed on Android.

Download

Builds for Android, Linux (.deb and tarball) and Windows (installer and zip) are on the releases page, with SHA256SUMS. How releases are made is in docs/RELEASING.md.

How it is built

Part Technology Location
Interface Flutter app/
Wallet core Rust, on monero-oxide core/
Bridge flutter_rust_bridge 2.13 core/kn-ffi, app/lib/src/rust (generated)
Local test networks Docker Compose: monerod + monero-lws tools/devnet

Keys, scanning, transaction building and signing live in the Rust core. The Flutter app never handles a spend key directly. The reasoning is in docs/adr/0001-rust-core-and-monero-oxide.md.

Build from source

You need:

  • Rust (the version is pinned in core/rust-toolchain.toml; rustup installs it)
  • Flutter 3.44 or newer
  • Linux: clang, cmake, ninja-build, pkg-config, libgtk-3-dev
  • Windows: Visual Studio 2022 with the "Desktop development with C++" workload
  • Android: Android SDK and NDK (Android Studio installs both)
git clone https://github.com/Dhiva-Labs/kilonova
cd kilonova/app
flutter run -d linux      # or: -d windows, or an Android device id

The Rust core is compiled automatically for the target platform on the first build, through cargokit.

Run the checks CI runs:

tools/check.sh             # add --regtest with tools/devnet running

Contributing

Contributions are welcome. Start with CONTRIBUTING.md, which covers setup, the pull request flow and the design rules in docs/DESIGN.md. Issues labelled good first issue are a good place to begin.

Please report security problems privately, as described in SECURITY.md, not in public issues.

Privacy

Kilonova collects nothing. There are no accounts, no analytics and no crash reporting. The privacy policy explains what each network connection reveals and to whom. The same text ships inside the app under Settings, Privacy policy.

License

MIT. The bundled IBM Plex fonts are under the SIL Open Font License.

Kilonova is an independent project and is not affiliated with the Monero Project.

About

Open-source Monero wallet for Linux, Windows and Android. Full-node or light-wallet (LWS) sync, multiple wallets, mainnet/stagenet/testnet.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages