haveno/README.md

103 lines
6.6 KiB
Markdown
Raw Normal View History

2021-05-05 00:20:30 +00:00
<div align="center">
<img src="https://raw.githubusercontent.com/haveno-dex/haveno-meta/721e52919b28b44d12b6e1e5dac57265f1c05cda/logo/haveno_logo_landscape.svg" alt="Haveno logo">
2022-01-21 11:08:44 +00:00
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/1a4ddf140d634f2ca1fd120a7cff4574)](https://app.codacy.com/gh/haveno-dex/haveno/dashboard)
[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/1a4ddf140d634f2ca1fd120a7cff4574)](https://app.codacy.com/gh/haveno-dex/haveno/dashboard)
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/haveno-dex/haveno/CI)
[![GitHub issues with bounty](https://img.shields.io/github/issues-search/haveno-dex/haveno?color=%23fef2c0&label=Issues%20with%20bounties&query=project%3Ahaveno-dex%2F2)](https://github.com/orgs/haveno-dex/projects/2) |
[![Twitter Follow](https://img.shields.io/twitter/follow/HavenoDEX?style=social)](https://twitter.com/havenodex)
2022-04-27 13:50:13 +00:00
[![Matrix rooms](https://img.shields.io/badge/Matrix%20room-%23haveno-blue)](https://matrix.to/#/#haveno:haveno.network) [![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
2022-01-21 11:08:44 +00:00
Haveno (pronounced ha‧ve‧no) is a platform for people who want to exchange [Monero](https://getmonero.org) for fiat currencies like EUR, GBP and USD or other cryptocurrencies, like BTC, ETH, BCH .
2021-05-05 00:20:01 +00:00
2022-01-21 11:08:44 +00:00
Main features:
- All communications are routed through **Tor**, to preserve your privacy
- Trades are **peer-to-peer**: trades on Haveno will happen between people only, there is no central authority.
2022-01-21 11:08:44 +00:00
- Trades are **non-custodial**: Haveno provides arbitration in case something goes wrong during the trade, but we will never have access to your funds.
- There is **No token**, because we don't need it. Transactions between traders are secured by non-custodial multisignature transactions on the Monero network.
- The revenue generated by Haveno will be managed by an entity called Council (more info soon), composed by members of the Monero/Haveno community, not the Haveno Core Team and will be used to **fund Haveno and Monero** development.
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
2021-06-16 11:29:38 +00:00
Haveno is still work in progress. There are no binaries available at this stage. If you want to test Haveno you have to compile it first (see [docs/installing.md](docs/installing.md)).
2021-05-05 00:20:30 +00:00
## Status of the project
2022-05-06 08:28:56 +00:00
Haveno is currently being developed, but it's already possible to test XMR <->fiat/crypto trades using the legacy user interface.
2021-05-05 00:20:30 +00:00
2022-05-06 08:28:56 +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-ui](https://github.com/haveno-dex/haveno-ui)** - The user interface.
- **[haveno-ts](https://github.com/haveno-dex/haveno-ts)** - TypeScript library for using Haveno.
- **[haveno-meta](https://github.com/haveno-dex/haveno-meta)** - For project-wide discussions and proposals.
2021-05-05 00:20:30 +00:00
2022-05-06 08:28:56 +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
2022-01-21 11:08:44 +00:00
The project is lead by a core Team formed of 2 people: ErCiccione and Woodser. The PGP keys of the core team members are in `gpg_keys/`.
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
2022-01-21 11:08:44 +00:00
- General discussions: **Haveno** ([#haveno:haveno.network](https://matrix.to/#/#haveno:haveno.network)) relayed on IRC/Libera (`#haveno`)
- Development discussions: **Haveno Development** ([#haveno-dev:haveno.network](https://matrix.to/#/#haveno-dev:haveno.network)) relayed on IRC/Libera (`#haveno-dev`)
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
## Running a local Haveno test network
2021-10-30 13:34:32 +00:00
See [docs/installing.md](docs/installing.md)
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 eligible for a bounty on the [dedicated Kanban board](https://github.com/orgs/haveno-dex/projects/2) or look for [issues labelled '💰bounty'](https://github.com/haveno-dex/haveno/issues?q=is%3Aissue+is%3Aopen+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
## Sponsors
Would you like to help us build Haveno? Become a sponsor! We will show your logo here. Contact us at contact@haveno.exchange.
2021-05-05 00:20:30 +00:00
<a href="https://getmonero.org"><img src="/media/sponsors/monero-community.png" title="Monero community" alt="Monero community logo" width="100px"></a>
<a href="https://samouraiwallet.com/"><img src="/media/sponsors/samourai.png" title="Samourai wallet" alt="Samourai wallet logo" width="100px"></a>
<a href="https://cakewallet.com/"><img src="/media/sponsors/cake-logo-blue.jpg" title="Cake wallet" alt="Cake wallet logo" width="100px"></a>
<a href="https://twitter.com/DonYakka"><img src="/media/sponsors/donyakka.jpg" title="Don Yakka" alt="Don Yakka logo" width="100px"></a>
2021-06-27 14:35:16 +00:00
<a href="https://twitter.com/mikedogsmd"><img src="/media/sponsors/mikedogsmd.jpg" title="Mike Dogs, MD" alt="Mike Dogs logo" width="100px"></a>
<a href="https://majesticbank.sc"><img src="/media/sponsors/mb.png" title="MajesticBank" alt="MajesticBank logo" width="100px"></a>
2022-07-22 07:44:30 +00:00
<a href="https://beldex.io"><img src="/media/sponsors/beldex.jpg" title="Beldex" alt="Beldex logo" width="100px"></a>
2021-05-05 00:20:30 +00:00
2022-07-22 13:30:43 +00:00
*Note: Sponsors are generous donors that contributed substantially to the Haveno project. Being listed as a sponsor doesn't necessarily imply endorsement.*
2021-05-05 00:20:30 +00:00
## Support
To bring Haveno to life, we need resources. If you have the possibility, please consider donating to the project:
2021-05-05 00:20:30 +00:00
### Monero
2021-05-05 00:20:30 +00:00
`42sjokkT9FmiWPqVzrWPFE5NCJXwt96bkBozHf4vgLR9hXyJDqKHEHKVscAARuD7in5wV1meEcSTJTanCTDzidTe2cFXS1F`
![Qr code](https://raw.githubusercontent.com/haveno-dex/haveno/master/media/qrhaveno.png)
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.
### Bitcoin
`bc1q4j5a9hfjxltfvv66gnfaw6478hagzpmjx3zkam`
![Qr code](https://raw.githubusercontent.com/haveno-dex/haveno/master/media/qrbtc.png)