Decentralized P2P exchange built on Monero and Tor
Go to file
2021-05-22 14:43:42 -04:00
.github update documentation 2021-05-16 09:56:20 -04:00
.idea Bisq 2021-05-04 20:20:01 -04:00
apitest Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
assets/src Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
cli/src Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
common/src add todo for using bitcoinj network params 2021-05-12 18:23:50 -04:00
core display actual XMR amount in offerFromUnsignedAccount warning instead of hardcoded 0.01 BTC 2021-05-22 14:43:42 -04:00
daemon/src Bisq 2021-05-04 20:20:01 -04:00
desktop display actual XMR amount in offerFromUnsignedAccount warning instead of hardcoded 0.01 BTC 2021-05-22 14:43:42 -04:00
docs bounties.md: fix link to CONTRIBUTING.md 2021-05-16 10:16:17 -04:00
gradle Haveno 2021-05-04 22:49:48 -04:00
inventory/src/main Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
media re-add donation qr 2021-05-05 14:53:13 -04:00
monitor Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
p2p/src lfs files are testnet (#51) 2021-05-07 11:01:58 -04:00
pricenode converted bisq pricenode install to haveno install (#31) 2021-05-04 22:50:24 -04:00
proto/src/main/proto Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
relay Bisq 2021-05-04 20:20:01 -04:00
scripts remove some more files 2021-05-04 22:50:24 -04:00
seednode Change base networks from btc to xmr, e.g. BTC_REGTEST -> XMR_STAGENET (#55) 2021-05-08 13:57:32 -04:00
statsnode/src/main Bisq 2021-05-04 20:20:01 -04:00
.editorconfig Bisq 2021-05-04 20:20:01 -04:00
.gitattributes lfs files are testnet (#51) 2021-05-07 11:01:58 -04:00
.gitignore rename bisq-* executables to haveno-* (#63) 2021-05-10 22:12:09 -04:00
build.gradle rename bisq-* executables to haveno-* (#63) 2021-05-10 22:12:09 -04:00
gradle.properties Bisq 2021-05-04 20:20:01 -04:00
gradlew Bisq 2021-05-04 20:20:01 -04:00
gradlew.bat Bisq 2021-05-04 20:20:01 -04:00
LICENSE Haveno 2021-05-04 22:49:48 -04:00
Makefile rename bisq-* executables to haveno-* (#63) 2021-05-10 22:12:09 -04:00
README.md update documentation 2021-05-16 09:56:20 -04:00
settings.gradle Haveno 2021-05-04 22:49:48 -04:00

Haveno logo

Codacy Badge GitHub Workflow Status GitHub issues with bounty | Twitter Follow Matrix Room

What is Haveno?

Haveno (pronounced ha‧ve‧no) is a private and decentralized way to exchange Monero for national currencies or other cryptocurrencies. Haveno uses peer-to-peer networking and multi-signature escrow to facilitate trading without a trusted third party custodian. Disputes can be resolved using non-custodial arbitration. Everything is built around Monero and Tor.

Haveno is the Esperanto word for "Harbor". The project is stewarded by a core Team, currently formed by 2 people: ErCiccione and Woodser. See the FAQ in the wiki for more information about the project.

Status of the project

At the moment Haveno is only a Proof of Concept. It's already possible to initiate crypto <-> XMR and fiat <-> XMR trades, but the platform still needs a lot of work before being available for public use.

The project is divided between multiple repositories:

  • haveno - This repository. Contains the Proof of Concept of what will be the heart of Haveno.
  • haveno-ui-poc - The PoC of the future user interface. Uses gRPC APIs to serve the UI in React.
  • haveno-design - Temporary (for now empty) repository for design discussions.
  • haveno-meta - For project-wide discussions and proposals.
  • haveno-site - The repository of the future website.

Currently, efforts are focused in developing the core repository ('haveno'). If you wish to help, take a look at the issue tracker and the Kanban boards (projects). We run a bounty program to incentivize development, the issues elegible for a reward in XMR are labelled '💰bounty'.

Trade protocol

See docs/trade-protocol.md

Keep in touch and help out!

Haveno is a community-driven project. For it to be succesful it's fundamental to have the support and help of the Monero community. We have our own Matrix server. Registrations are not open at the moment, but the rooms are public and can be joined from any matrix client (like Element). We look forward to hearing from you!

  • General discussions: Haveno (#haveno:haveno.network) relayed on Freenode (#haveno)
  • Development discussions: Haveno Development (#haveno-dev:haveno.network) relayed on Freenode (#haveno-dev)

Temporary email: havenodex@protonmail.com

Styling guidelines

See CONTRIBUTING.md

Bounties

To incentivize development and reward contributors we adopt a simple bounty system. Contributors may be awarded bounties after completing a task (resolving an issue). More details in the docs.

Running a local Haveno test network

  1. Download Monero CLI for your system and sync Monero stagenet: ./monerod --stagenet --rpc-login superuser:abctesting123, or alternatively, set up a local Monero stagenet network (recommended)
  2. Download and install Bitcoin-Qt
  3. Run Bitcoin-Qt in regtest mode, e.g.: ./Bitcoin-Qt -regtest -peerbloomfilters=1
  4. In Bitcoin-Qt console, mine BTC regtest blocks: generatetoaddress 101 bcrt1q6j90vywv8x7eyevcnn2tn2wrlg3vsjlsvt46qz
  5. Install git lfs for your system (Ubuntu: sudo apt install git-lfs)
  6. git clone https://github.com/Haveno-Dex/haveno
  7. Copy monero-wallet-rpc from step 1 to the haveno project root
  8. Apply permission to run monero-wallet-rpc, e.g. chmod 777 monero-wallet-rpc
  9. Optionally modify WalletConfig.java with custom settings
  10. cd haveno
  11. ./gradlew build
  12. Start seed node, arbitrator, Alice, and Bob:
    1. ./haveno-seednode --baseCurrencyNetwork=XMR_STAGENET --useLocalhostForP2P=true --useDevPrivilegeKeys=true --nodePort=2002 --appName=haveno-XMR_STAGENET_Seed_2002 --daoActivated=false
    2. ./haveno-desktop --baseCurrencyNetwork=XMR_STAGENET --useLocalhostForP2P=true --useDevPrivilegeKeys=true --nodePort=4444 --appName=haveno-XMR_STAGENET_arbitrator --daoActivated=false --apiPassword=apitest --apiPort=9998
    3. ./haveno-desktop --baseCurrencyNetwork=XMR_STAGENET --useLocalhostForP2P=true --useDevPrivilegeKeys=true --nodePort=5555 --appName=haveno-XMR_STAGENET_Alice --daoActivated=false --apiPassword=apitest --apiPort=9999
    4. ./haveno-desktop --baseCurrencyNetwork=XMR_STAGENET --useLocalhostForP2P=true --useDevPrivilegeKeys=true --nodePort=6666 --appName=haveno-XMR_STAGENET_Bob --daoActivated=false --apiPassword=apitest --apiPort=10000
  13. Arbitrator window > Account > cmd+n to register a new arbitrator
  14. Arbitrator window > Account > cmd+d to register a new mediator
  15. Deposit stagenet XMR to Alice and Bob's Haveno wallets (wallet address printed to terminal)
  16. When deposited XMR is available, proceed to post offers, etc

Running a local Monero stagenet network

  1. Build monero-project with the following modification to the bottom of hardforks.cpp:
    const hardfork_t stagenet_hard_forks[] = {
      // version 1 from the start of the blockchain
      { 1, 1, 0, 1341378000 },
    
      // versions 2-7 in rapid succession from March 13th, 2018
      { 2, 10, 0, 1521000000 },
      { 3, 20, 0, 1521120000 },
      { 4, 30, 0, 1521240000 },
      { 5, 40, 0, 1521360000 },
      { 6, 50, 0, 1521480000 },
      { 7, 60, 0, 1521600000 },
      { 8, 70, 0, 1537821770 },
      { 9, 80, 0, 1537821771 },
      { 10, 90, 0, 1550153694 },
      { 11, 100, 0, 1550225678 },
      { 12, 110, 0, 1571419280 },
      { 13, 120, 0, 1598180817 },
      { 14, 130, 0, 1598180818 }
    };
    
  2. Using the executables built in step 1:
    • ./monerod --stagenet --no-igd --hide-my-port --data-dir node1 --p2p-bind-ip 127.0.0.1 --p2p-bind-port 48080 --rpc-bind-port 48081 --zmq-rpc-bind-port 48082 --add-exclusive-node 127.0.0.1:38080 --rpc-login superuser:abctesting123 --rpc-access-control-origins http://localhost:8080
    • ./monerod --stagenet --no-igd --hide-my-port --data-dir node2 --p2p-bind-ip 127.0.0.1 --rpc-bind-ip 0.0.0.0 --confirm-external-bind --add-exclusive-node 127.0.0.1:48080 --rpc-login superuser:abctesting123 --rpc-access-control-origins http://localhost:8080
  3. Mine the first 130 blocks to a random address before using so wallets only use the latest output type. For example, in a daemon: start_mining 56k9Yra1pxwcTYzqKcnLip8mymSQdEfA6V7476W9XhSiHPp1hAboo1F6na7kxTxwvXU6JjDQtu8VJdGj9FEcjkxGJfsyyah 1

Sponsors

Would you like to help us build Haveno? Become a sponsor! We will show your logo here. Contact us at havenodex@protonmail.com.

Monero community logo Samourai wallet logo Cake wallet logo Don Yakka logo

Support

To bring Haveno to life, we need resources. If you have the possibility, please consider donating to the project. At this stage, donations are fundamental:

42sjokkT9FmiWPqVzrWPFE5NCJXwt96bkBozHf4vgLR9hXyJDqKHEHKVscAARuD7in5wV1meEcSTJTanCTDzidTe2cFXS1F

Qr code

If you are using a wallet that supports Openalias (like the 'official' CLI and GUI wallets), you can simply put donations@haveno.network as the "receiver" address.