haveno/README.md

82 lines
5.1 KiB
Markdown
Raw Permalink Normal View History

2022-11-18 19:47:07 +00:00
<div align="center">
2021-05-05 00:20:30 +00:00
<img src="https://raw.githubusercontent.com/haveno-dex/haveno-meta/721e52919b28b44d12b6e1e5dac57265f1c05cda/logo/haveno_logo_landscape.svg" alt="Haveno logo">
2022-11-18 19:47:07 +00:00
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/haveno-dex/haveno/build.yml?branch=master)
[![GitHub issues with bounty](https://img.shields.io/github/issues-search/haveno-dex/haveno?color=%23fef2c0&label=Issues%20with%20bounties&query=is%3Aopen+is%3Aissue+label%3A%F0%9F%92%B0bounty)](https://github.com/haveno-dex/haveno/issues?q=is%3Aopen+is%3Aissue+label%3A%F0%9F%92%B0bounty)
[![Twitter Follow](https://img.shields.io/twitter/follow/HavenoDEX?style=social)](https://twitter.com/havenodex)
2022-11-18 19:47:07 +00:00
[![Matrix rooms](https://img.shields.io/badge/Matrix%20room-%23haveno-blue)](https://matrix.to/#/#haveno:monero.social) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/haveno-dex/.github/blob/master/CODE_OF_CONDUCT.md)
2021-05-05 00:20:30 +00:00
</div>
2021-05-05 00:20:01 +00:00
2021-05-05 00:20:30 +00:00
## What is Haveno?
2021-05-05 00:20:01 +00:00
2024-05-09 19:55:25 +00:00
Haveno (pronounced ha‧ve‧no) is an open source platform to exchange [Monero](https://getmonero.org) for fiat currencies like USD, EUR, and GBP or other cryptocurrencies like BTC, ETH, and BCH.
2021-05-05 00:20:01 +00:00
2022-01-21 11:08:44 +00:00
Main features:
- Communications are routed through **Tor**, to preserve your privacy.
2022-01-21 11:08:44 +00:00
2024-05-09 19:55:25 +00:00
- Trades are **peer-to-peer**: trades on Haveno happen between people only, there is no central authority.
2022-01-21 11:08:44 +00:00
2024-05-09 19:55:25 +00:00
- Trades are **non-custodial**: Haveno supports arbitration in case something goes wrong during the trade, but arbitrators never have access to your funds.
2022-01-21 11:08:44 +00:00
2024-05-09 19:55:25 +00:00
- There is **No token**, because it's not needed. Transactions between traders are secured by non-custodial multisignature transactions on the Monero network.
2022-01-21 11:08:44 +00:00
See the [FAQ on our website](https://haveno.exchange/faq/) for more information.
2021-05-05 00:20:01 +00:00
2024-10-26 18:09:53 +00:00
## Installing Haveno
2021-05-05 00:20:30 +00:00
Haveno can be installed on Linux, macOS, and Windows by using a third party installer and network.
> [!note]
> The official Haveno repository does not support making real trades directly.
>
> To make real trades with Haveno, first find a third party network, and then use their installer or build their repository. We do not endorse any networks at this time.
2024-05-17 10:52:11 +00:00
2024-10-26 18:09:53 +00:00
A test network is also available for users to make test trades using Monero's stagenet. See the [instructions](https://github.com/haveno-dex/haveno/blob/master/docs/installing.md) to build Haveno and connect to the test network.
Alternatively, you can [create your own mainnet network](create-mainnet.md).
2024-05-09 19:55:25 +00:00
Note that Haveno is being actively developed. If you find issues or bugs, please let us know.
2021-05-05 00:20:30 +00:00
## Main repositories
2021-05-05 00:20:30 +00:00
2022-05-06 08:28:56 +00:00
- **[haveno](https://github.com/haveno-dex/haveno)** - This repository. The core of Haveno.
- **[haveno-ts](https://github.com/haveno-dex/haveno-ts)** - TypeScript library for using Haveno.
- **[haveno-ui](https://github.com/haveno-dex/haveno-ui)** - A new user interface (WIP).
- **[haveno-meta](https://github.com/haveno-dex/haveno-meta)** - For project-wide discussions and proposals.
2021-05-05 00:20:30 +00:00
If you wish to help, take a look at the repositories above and look for open issues. We run a bounty program to incentivize development. See [Bounties](#bounties).
2021-05-05 00:20:30 +00:00
## Keep in touch and help out!
2022-05-06 08:28:56 +00:00
Haveno is a community-driven project. For it to be successful it's fundamental to have the support and help of the community. Join the community rooms on our Matrix server:
2021-05-05 00:20:30 +00:00
- General discussions: **Haveno** ([#haveno:monero.social](https://matrix.to/#/#haveno:monero.social)) relayed on IRC/Libera (`#haveno`)
2024-11-21 14:54:04 +00:00
- Development discussions: **Haveno Development** ([#haveno-development:monero.social](https://matrix.to/#/#haveno-development:monero.social)) relayed on IRC/Libera (`#haveno-development`)
2021-05-05 00:20:30 +00:00
Email: contact@haveno.exchange
Website: [haveno.exchange](https://haveno.exchange)
2021-05-05 00:20:30 +00:00
2021-10-30 13:34:32 +00:00
## Contributing to Haveno
2021-05-05 00:20:30 +00:00
2022-05-06 08:28:56 +00:00
See the [developer guide](docs/developer-guide.md) to get started developing for Haveno.
2021-05-05 00:20:30 +00:00
2021-10-30 13:34:32 +00:00
See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for our styling guides.
If you are not able to contribute code and want to contribute development resources, [donations](#support) fund development bounties.
## 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). Take a look at the [issues labeled '💰bounty'](https://github.com/haveno-dex/haveno/issues?q=is%3Aopen+is%3Aissue+label%3A%F0%9F%92%B0bounty) in the main `haveno` repository. [Details and conditions for receiving a bounty](docs/bounties.md).
2021-05-05 00:20:30 +00:00
## Support and sponsorships
2021-05-05 00:20:30 +00:00
To bring Haveno to life, we need resources. If you have the possibility, please consider [becoming a sponsor](https://haveno.exchange/sponsors/) or donating to the project:
2021-05-05 00:20:30 +00:00
2024-09-01 16:33:17 +00:00
<p>
2024-09-26 12:28:35 +00:00
<img src="https://raw.githubusercontent.com/haveno-dex/haveno/master/media/donate_monero.png" alt="Donate Monero" width="115" height="115"><br>
2024-09-01 16:33:17 +00:00
<code>42sjokkT9FmiWPqVzrWPFE5NCJXwt96bkBozHf4vgLR9hXyJDqKHEHKVscAARuD7in5wV1meEcSTJTanCTDzidTe2cFXS1F</code>
</p>
2021-05-05 00:20:30 +00:00
If you are using a wallet that supports OpenAlias (like the 'official' CLI and GUI wallets), you can simply put `fund@haveno.exchange` as the "receiver" address.