Before you begin, you'll need to set up a testing environmentg:
- Begin by choosing Android Device or an Emulator: You can test on a;
- physical Android phone
- Use an Android simulator via Android Studio for advanced users.
- Or use BlueStacks is another option with a gentler learning curve, for the more non-technical.
- Download Latest Pre-release Builds: Obtain the latest pre-release builds from the Releases page. These are typically updated weekly, they are connected to stagenet, so do not send real XMR funds to these addresses, we are in the testing period while I audit the code in full.
Important: Follow the instructions in this guide carefully for Haveno App to function correctly.
Note Android is better in generally for remaining live in the background for notifications, for now it's recommended you woh with that until the Telegram bot is completed.
To ensure all traffic is securely routed through Tor, you must install and activate a Tor VPN relay on your mobile device. The recommended two apps are:
Step by Step Guide
- Download Orbot; a. Orbot on Google Play or if you trust the community project also, you can find InviZible on Google Play. b. Alternatively, download InviZible on F-Droid, I may decide to release this soon, it's up to the Monero core teams decision.
- Open the app of your choice and follow the on-screen instructions to activate it. Ensure that Tor is enabled and the VPN is activated.
- Configure the VPN relay to route your Haveno App app traffic through Tor. The app will not load if a VPN relay is not configured first, by design, for your security.
The Haveno App app is available as alpha pre-release builds for Android and Windows. Download the app from the Releases page. The desktop clients are designed to be user-friendly, with custom installers for quick setup.
The app currently works best on macOS which is available in a cask, which has been documented on the haveno installation wiki page, the most reliable way to install is using the cask, please report any bugs if you find them on the issues section of this repo.
Note: Haveno App is currently configured to use the stagenet (a test network) for at least the next 1 more months. It is not intended for real-life trading. DO NOT DESOSIT REAL XMR YET, you can use a stagenet faucet, you can find a few of them just on google.
- Windows: (Coming soon)
- MacOS: Download Intel, Download Silicon or Install via Homebrew Cask
- Android Download Universal APK
- Linux: Alpha (testing)
- Docker: Haveno Docker Hub (For advanced users, limited documentation thus far but useful deployment based on simple configuration options)
- iOS (Coming lastly)
You can check out the wiki ran by our community members which gives more specific information of you're not sure about whether your installation is working, or you can always
- How to Install Haveno on Desktop
- How to Install Haveno on Mobile
- How to Install Haveno on Server with Docker
- How to Setup your own Haveno Network
- How to connect Haveno with Telegram to Receive Notifications in real-time.
- Milestone 1: Protocol Interface (✅) - Paid by CCS
- Milestone 2: Complete UI + Providers + lots more - (✅) Kindly requesting paymenet from CCS
The extras I included were not expected to covered or to be paid for in the CSS, but tie in nicely:
- Caching system to ease the load on the daemon SQLite
- AES encryption on shared shared preferences and DB (not tested, will including on wallet too if nessesary)
The project is currently in the testing peroid of Milestone 2 having completed it, but not also on fully completion peroid of milestonen 3 and 4, I am currently waiting for milestone 2 to be paid ideally before I push milestone 3 & 4, as I've read many issues about payment on these on the monero workgrounp chat. (Sorry to be a pain to the community, but I've been spending months on this and we hoping that people would be happy with it to not cause problems, I've writen more about this on my blog in a lot of detail but I wont touch on this too much here)
Haveno runs as a large decentralized network, it works quite quite well, much like Bisq, but it's flawed in that it's quite easy to monopolize with one large network, which has some benefits but definetely goes against the principle of why the software was decided to be devloped in the first place, the Haveno App UI which currently Haveno.com is responsible for developing in full. The aim is to ensure running a federated network on Haveno is easy enough for anyone to do, and to ensure that it's also just as easy to choose whatever network you wish to use by changing the configuration in the settings, all current networks that exist lock you in to their ecosystem generally in order to capture more of the trade volume, we should encourage legal use of decentralized and federated finance where it is legal to do so, if you want to learn more about how to change your haveno network or how to setup your own haveno network in order to to earn a fee for each trade in return for your time in arbitrating issues. Always make sure you check your local laws as privacy coins and systems are becoming more scrutinized by governments while being praised by others, so check the reason based on your own circumstances.
- Haveno Dart SDK API - (✅)
- Haveno Dark SDK Documentation - (✅)
- Haveno Complete UI - (✅)
- Linux desktop Support with Haveno.AppImage Donwload - (✅)
- macOS Desktop Support with [Haveno.app Download] & [Homebrew Installer] - (✅)
- Android Mobile Support with Haveno.apk Donwload - (✅)
- Haveno Python SDK Client (WIP)
- Haveno Rust SDK Client (WIP)
- Complete
(Haveno) Tor Tunnelsproject to smoothly run gRPC over SOCKS5 to an onion service in rust via tunnels (MOSTLY DONE) - Complete Full Arbitration Scope on Payment Dispite (TODO)
- Add client authentication for onion-hosted daemons. (TODO)
- iOS support. (TODO)
- Easy whitelisting and fund transfers to Cake Wallet or similar. (TODO)
- Biometric security for mobile devices, with PIN or password protection for those without biometric options. (TODO)
- Standalone version not requiring desktop or server (considerable work; community support may be needed). (TODO)
- Enable FIDO2 protected transactions using FIDO2 App on Trezor / Ledger hardware wallets. (TODO)
- Support for Monero Atomic Swaps (TODO)
- Implementation of a local Monero wallet (to prevent unessesarily excessively amount of funds on the daemon aka hot-wallet) (TODO)
- Spend about tripple the time it took me to do this project just trying to actually get Monero CCS to pay their debts for my time and effort to produce this (don't worry I am only expecting the market value at the time it was promised which is like half the amount in USD at this point...) (TODO)
Testing on old phones or laptops and providing high-quality feedback is the best way to contribute. A discussion section will be set up for initial feedback and contributions.
HAVENO.APP represents the official haveno app website and services as a client to a Haveno Daemon only, and HAVENO.EXCHANGE represents everything else, including not not limited to the P2P server network protocol, daemon nodes and price nodes, there are now also lots of app-specific guides located at haveno documentation and setup section of the site, which are atuned towards the new app.
None of the code in this repository (haveno-app) is intrinically holding custody of philosophy in what may be considered 'crypto-assets' OR transmitting any such 'crypto-assets' or other financial services across the the wire, network or the general internet.