haveno-app/README.md
2024-10-02 05:23:37 +01:00

6.2 KiB

Haveno App

Table of Contents

  1. Prerequisites
  2. Setup Your Mobile Device
  3. Setup Your Desktop or Server
  4. Project Status
  5. Security
  6. Project Activity
  7. Roadmap
  8. Contributing
  9. Open Source Plans

Prerequisites (For Testing)

Before you begin, you'll need to set up a testing environment:

  • Android Device or Emulator: You can test on a physical Android phone or use an Android simulator via Android Studio for advanced users. BlueStacks is another option with a gentler learning curve.
  • Latest Pre-release Builds: Obtain the latest pre-release builds from the Releases page. These are typically updated weekly.

Important: Follow the instructions in this guide carefully for Haveno Plus to function correctly.

Setup Your Mobile Device

Install Tor VPN Relay

To ensure all traffic is securely routed through Tor, you must install and activate a Tor VPN relay on your mobile device. The recommended apps are:

Steps:

  1. Download Orbot on Google Play or InviZible on Google Play.
  2. 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.
  3. Configure the VPN relay to route your Haveno Plus app traffic through Tor. The app will not load if a VPN relay is not configured first, by design, for your security.

Install Haveno Plus

The Haveno Plus 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.

Note: Haveno Plus is currently configured to use the stagenet (a test network) for at least the next 2 months. It is not intended for real-life trading during this time.

Setup Your Desktop or Server

Install Haveno Plus Desktop

To streamline the installation process Haveno Daemon is automatically downloaded and installed from this fork of the original Haveno project, and has been created with reliable installers. Supported OS distributions include:

  • Windows: Download Here
  • MacOS: (Coming soon)
  • Linux: (Coming soon)
  • Docker: (Coming soon)

Step-by-Step Instructions

  1. Run the installer for your OS and follow the installation walkthrough.
  2. Once installed, launch the app and allow it to initialize.
  3. Navigate to the Menu.
  4. Click Link your Mobile Device.
  5. Open the app on your mobile device and scan the QR code to pair. You can also obtain the APK files from the releases section.

Security: Pairing is done securely using a Tor onion address and a 16-bit hash authentication string, randomly generated for each installation.

Project Status

The project is currently in a public pre-release stage aimed at gathering feedback for improvements. All pre-release builds are set up on the Haveno stagenet, with test daemons hosted by the community.

Security

Important: Pre-release builds are not intended for any financial transactions. It's recommended to install these builds on disposable phones or emulators. Tor routing is enforced, which may be illegal in some jurisdictions. Please verify the laws in your country before using Tor.

Network Endorsements

Haveno Plus does not endorse or denounce any particular network. The choice of network will be available upon official release.

Project Activity

The project is actively developed full-time for at least the next 2 months. Continued support may require sponsorships or feature bounties. The goal is to provide significant value to the XMR community.

Roadmap

  • Beta release
  • Windows desktop Support
  • MacOS desktop support
  • Android mobile Support
  • Complete full arbitration scope.
  • Improve design consistency.
  • Add client authentication for onion-hosted daemons.
  • iOS support.
  • Linux desktop support.
  • Easy whitelisting and fund transfers to Cake Wallet or similar.
  • Biometric security for mobile devices, with PIN or password protection for those without biometric options.
  • Standalone version not requiring desktop or server (considerable work; community support may be needed).
  • Support for Monero Atomic Swaps

Contributing

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.

Additional Resources

Kewbit the maintainers blog is at Kewbit.org