haveno/README.md

99 lines
6.5 KiB
Markdown
Raw Normal View History

2021-05-04 20:20:30 -04: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 06:08:44 -05: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-01-21 06:08:44 -05:00
[![Matrix rooms](https://img.shields.io/badge/Matrix%20room-%23haveno-blue)](https://matrix.to/#/#haveno:haveno.network)
2021-05-04 20:20:30 -04:00
</div>
2021-05-04 20:20:01 -04:00
2021-05-04 20:20:30 -04:00
## What is Haveno?
2021-05-04 20:20:01 -04:00
2022-01-21 06:08:44 -05: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-04 20:20:01 -04:00
2022-01-21 06:08:44 -05: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, the platform doesn't provide any liquidity.
- 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.
See the [FAQ on our website](https://haveno.exchange/faq/) for more information.
2021-05-04 20:20:01 -04:00
2021-06-16 07:29:38 -04: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-04 20:20:30 -04:00
## 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:
2021-05-04 20:20:30 -04:00
- **[haveno](https://github.com/haveno-dex/haveno)** - This repository. The heart of Haveno.
- **[haveno-ui-poc](https://github.com/haveno-dex/haveno-ui-poc)** - The PoC of the future user interface. Uses gRPC APIs to serve the UI in React.
- **[haveno-meta](https://github.com/haveno-dex/haveno-meta)** - For project-wide discussions and proposals.
- **[haveno-site](https://github.com/haveno-dex/haveno-site)** - The repository of the website.
2021-05-04 20:20:30 -04:00
If you wish to help, take a look at the [issue tracker](https://github.com/haveno-dex/haveno/issues). We run a bounty program to incentivize development. See [Bounties](#bounties)
2021-05-04 20:20:30 -04:00
2022-01-21 06:08:44 -05: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-04 20:20:30 -04:00
## Keep in touch and help out!
2022-01-21 06:08:44 -05:00
Haveno is a community-driven project. For it to be successful 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).
2021-05-04 20:20:30 -04:00
2022-01-21 06:08:44 -05: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-04 20:20:30 -04:00
Email: contact@haveno.exchange
2021-05-04 20:20:30 -04:00
2021-10-30 09:34:32 -04:00
## Running a local Haveno test network
2021-10-30 09:34:32 -04:00
See [docs/installing.md](docs/installing.md)
2021-10-30 09:34:32 -04:00
## Contributing to Haveno
2021-05-04 20:20:30 -04:00
2021-10-30 09:34:32 -04:00
We are looking for help building Haveno. There are many [tasks](https://github.com/haveno-dex/haveno/issues) to complete, and many tasks have bounties.
2021-05-04 20:20:30 -04:00
2021-10-30 09:34:32 -04:00
See the [developer guide](docs/developer-guide.md) to get started developing for Haveno. At this stage, we're mostly looking for help building the backend and APIs.
2021-05-04 20:20:30 -04:00
2021-10-30 09:34:32 -04: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-04 20:20:30 -04: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-04 20:20:30 -04: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 10:35:16 -04: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>
2021-05-04 20:20:30 -04:00
## Support
To bring Haveno to life, we need resources. If you have the possibility, please consider donating to the project:
2021-05-04 20:20:30 -04:00
### Monero
2021-05-04 20:20:30 -04: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 `donations@haveno.network` as the "receiver" address.
### Bitcoin
`bc1q4j5a9hfjxltfvv66gnfaw6478hagzpmjx3zkam`
![Qr code](https://raw.githubusercontent.com/haveno-dex/haveno/master/media/qrbtc.png)