Skip to content

Commit

Permalink
Add USDC, images for Backup-Restore, changing links to Retoswap
Browse files Browse the repository at this point in the history
  • Loading branch information
boldsuck committed Nov 29, 2024
1 parent de4cddb commit 3aa8ef3
Show file tree
Hide file tree
Showing 11 changed files with 52 additions and 40 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
![Website](https://img.shields.io/website?url=https%3A%2F%2Fdocs.haveno-reto.com)
![Website](https://img.shields.io/website?url=https%3A%2F%2Fdocs.retoswap.com)

# Haveno Documentation

This repository hosts the documentation related to Haveno-reto. It's online at [https://docs.haveno-reto.com](https://docs.haveno-reto.com).
This repository hosts the documentation related to Haveno-reto. It's online at [https://docs.retoswap.com](https://docs.retoswap.com).
24 changes: 12 additions & 12 deletions docs/haveno-ui/backup_and_restore.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Backing up application data

Backing up your Haveno-reto data is crucial to ensure you can retain control over trades, disputes, payment accounts, and funds in case of issues with your machine (e.g.: drive failure) or Haveno-reto itself (e.g.: critical bugs). All Haveno-reto data is stored right on your computer—it's never stored (or even sent) to a central server, so backing it up is your job. We will see data restoration after the backup.
Backing up your Haveno-reto data is crucial to ensure you can retain control over trades, disputes, payment accounts, and funds in case of issues with your machine (e.g. drive failure) or Haveno-reto itself (e.g. critical bugs). All Haveno-reto data is stored right on your computer—it's never stored (or even sent) to a central server, so backing it up is your job. We will see data restoration after the backup.

### 1. Back up the entire Haveno-reto data directory

Expand All @@ -10,21 +10,21 @@ The safest, quickest, easiest, and most comprehensive thing you can do to safegu

Go to `Account` -> `Backup` and put in a location for your backup to be exported to (note that this section is titled "Backup wallet" in the software but it actually exports the entire data directory).

<!---
![Export backup](../resources/img/haveno-ui/backup.png)
![Export backup](../resources/img/haveno-ui/backup_dark.png#only-light)
![Export backup](../resources/img/haveno-ui/backup_light.png#only-dark)
/// caption
Data directory backup screen.
///
-->

#### 1.2 While Haveno-reto is closed

When Haveno-reto is closed, you can simply copy the entire data directory and paste it somewhere safe. Find the location of your data directory by clicking on the `Open Directory` button (see screenshot above) or see data directory locations here:

Linux: ~/.local/share/Haveno-reto/
macOS: ~/Library/Application Support/Haveno-reto/
Windows: ~\AppData\Roaming\Haveno-reto\

```
Linux: ~/.local/share/Haveno-reto/
macOS: ~/Library/Application Support/Haveno-reto/
Windows: ~\AppData\Roaming\Haveno-reto\
```

#### 1.3 Encrypt your backup

Expand Down Expand Up @@ -75,7 +75,7 @@ A payment account export only contains metadata (name, bank information, etc). F

If you have a payment accounts export file, import it in `Account` -> `Traditional Currency Accounts`

If you don't have an export file, but you do have a full backup, you can salvage your payment account metadata from `xmr_mainnet/db/UserPayload` by running the *strings* utility on the UserPayload file (e.g.: run `strings /path/to/backup/xmr_mainnet/db/UserPayload` in a terminal window). The command will output a simplified version of the UserPayload file to your terminal. Scroll up a bit and you should see your payment account information.
If you don't have an export file, but you do have a full backup, you can salvage your payment account metadata from `xmr_mainnet/db/UserPayload` by running the *strings* utility on the UserPayload file (e.g. run `strings /path/to/backup/xmr_mainnet/db/UserPayload` in a terminal window). The command will output a simplified version of the UserPayload file to your terminal. Scroll up a bit and you should see your payment account information.

Use the output to copy and paste the details into new payment accounts in Haveno-reto, paying special attention to make sure each field is copied over with 100% accuracy (including the salt): even a 1 character difference in any field will cause the hash of the payment account to be different, which means aging and signing status will not be restored in the following step.

Expand Down Expand Up @@ -103,14 +103,14 @@ Restore payment account aging and signing status

Once you've restored your payment account metadata, you'll see the accounts in Haveno-reto, but they'll have no aging or signing status. You can get aging and signing status back by replacing `xmr_mainnet/keys/sig.key` from your backup.

- Make sure you have no active offers, trades or disputes; once you change sig.key, you will become unreachable.
- Make sure you have no active offers, trades or disputes; once you change `sig.key`, you will become unreachable.
- Close Haveno-reto. Also make sure you've made a backup of your data directory (just in case).
- Replace `/path/to/data/directory/xmr_mainnet/keys/sig.key` with the sig.key from your backup.
- Replace `/path/to/data/directory/xmr_mainnet/keys/sig.key` with the `sig.key` from your backup.

Upon opening Haveno-reto, you should see account aging and signing status restored for your fiat payment accounts. If you don't, double-check:

- You copied account metadata and salt correctly in the previous step.
- The sig.key you copied is the correct one (i.e., the one you were using when your accounts accrued aging and/or got signed)
- The `sig.key` you copied is the correct one (i.e., the one you were using when your accounts accrued aging and/or got signed)

### 4. Restore onion address

Expand Down
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
Welcome to the documentation of Haveno-reto, the Decentralized, peer-to-peer network based on Monero.

Take a look at the menu on the left and start exploring. Make sure you also take a look at the [Haveno FAQ](https://haveno.exchange/faq/) on the developer website.
You can find further illustrated tutorials at the [Posts by nihilist](https://haveno-reto.com/#posts)
You can find further illustrated tutorials at the [Posts by nihilist](https://retoswap.com/#posts)

[:material-web: Haveno-reto Website](https://haveno-reto.com){ .md-button .md-button--primary }
[:material-web: Haveno-reto Website](https://retoswap.com/){ .md-button .md-button--primary }
[:material-github: Github Project](https://github.com/retoaccess1/){ .md-button .md-button--primary }
[:simple-slack: SimpleX group](https://simplex.chat/contact#/?v=2-7&smp=smp%3A%2F%2Fhpq7_4gGJiilmz5Rf-CswuU5kZGkm_zOIooSw6yALRg%3D%40smp5.simplex.im%2F2KNui9H8xxaPTuHAsQzJlfLmz_SOMsFk%23%2F%3Fv%3D1-3%26dh%3DMCowBQYDK2VuAyEA8BPETTg3ooyvQ1LiMGeCFbh2MeK9NyubT6NLE8EJzyA%253D%26srv%3Djjbyvoemxysm7qxap7m5d5m35jzv5qq6gnlv7s4rsn7tdwwmuqciwpid.onion&data=%7B%22type%22%3A%22group%22%2C%22groupLinkId%22%3A%22wNDKKQR3EW8Y045FsVofSg%3D%3D%22%7D){ .md-button .md-button--primary }
5 changes: 5 additions & 0 deletions docs/resources/img/crypto/usdc.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/resources/img/haveno-ui/backup_dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/resources/img/haveno-ui/backup_light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 10 additions & 15 deletions docs/the-project/account_limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Elevated account limits apply to fiat payment accounts in order to limit damage a malicious user can do while allowing honest users to start trading immediately with no KYC and utmost privacy.

Altcoin accounts can trade 96 XMR right away, but all fiat payment account types have limits lower than 96 XMR to match their particular risk profiles (see [this table](payment_methods/0-all-methods.md/#1-fiat-payment-methods) for details). Some payment methods with chargeback risk implement a mechanism called **account signing** that restricts trading activity until a trader proves their integrity to further secure against foul play.
Cryptocurrency accounts can trade 96 XMR right away (528 XMR since Haveno v1.0.15), but all fiat payment account types have limits lower than 96 XMR to match their particular risk profiles (see [this table](payment_methods/0-all-methods.md/#1-fiat-payment-methods) for details). Some payment methods with chargeback risk implement a mechanism called **account signing** that restricts trading activity until a trader proves their integrity to further secure against foul play.

## Which payment accounts are affected

Expand All @@ -12,23 +12,19 @@ All fiat payment methods in all markets limit total trade size depending on the

Despite these limitations, chargebacks can still be possible for certain payment methods. Haveno reduces this risk with a mechanism called **account signing**.

Account signing only applies to payment accounts that meet **both** of the following conditions:
Account signing only applies to payment accounts that are subject to chargeback risk: SEPA, SEPA Instant, Interac e-Transfer, Zelle, Revolut, Chase QuickPay, Popmoney, MoneyBeam, Uphold, and any kind of bank transfer.

- used in the following markets: USD, EUR, CAD, GBP, AUD, or BRL
- is subject to chargeback risk: SEPA, SEPA Instant, Interac e-Transfer, Zelle, Revolut, Chase QuickPay, Popmoney, MoneyBeam, Uphold, and any kind of bank transfer.

This means that all payment accounts that deal in currencies not listed above do **not** require account signing, even if they are subject to chargeback risk.

## Account aging

Account age is no longer used to determine trade size limits for most payment methods. It is still measured, however, and you can see a payment account's age in the offer book before taking an offer, but we caution against using it as a measure of integrity. Older accounts are not **necessarily** safer.
Account age is not used to determine trade size limits for payment methods. However, it is measured, and you can see a payment account's age in the offer book before taking an offer, but we caution against using it as a measure of integrity. Older accounts are not **necessarily** safer.

![Account age in Offer book](../resources/img/haveno-ui/account-age_light.png)
/// caption
See account age in the offer book.
///

**Practically, this means that all payment methods on Haveno have full selling capability from the moment they are created.** Selling limits no longer phase in over time.
**All payment methods on Haveno have full selling capability from the moment they are created.**

Some payment methods implement a variation of account aging called account signing whereby limits are increased in stages over a period of 60 days after signing. More about this below.

Expand All @@ -54,7 +50,7 @@ First let's observe what happens if a new SEPA account is never signed. Notice h
| Day 0 | 3 XMR | 12 XMR |
| Day 30 | 3 XMR | 12 XMR |
| Day 60 | 3 XMR | 12 XMR |
| Day 90 | 3 XMR | 12 XMR |
| > 60 | 3 XMR | 12 XMR |

If that SEPA account manages to get signed on the same day it's created, it will see its 3 XMR limit increased on Day 30. Selling limits are unaffected.

Expand All @@ -63,16 +59,16 @@ If that SEPA account manages to get signed on the same day it's created, it will
| Day 0 - Account Signed | 3 XMR | 12 XMR |
| Day 30 | 6 XMR | 12 XMR |
| Day 60 | 12 XMR | 12 XMR |
| Day 90 | 12 XMR | 12 XMR |
| > 60 | 12 XMR | 12 XMR |

But if that SEPA account isn't signed until Day 30, it won't see its limits lifted until Day 60. Again, selling limits are unaffected.

| Time Since Creating SEPA Payment Account | Maximum Trade Size (Buy) | Maximum Trade Size (Sell) |
| ---------------------------------------- | ------------------------ | ------------------------- |
| Day 0 | 3 XMR | 12 XMR |
| Day 30 - Account Signed | 3 XMR | 12 XMR |
| Day 60 | 6 XMR | 12 XMR |
| Day 90 | 12 XMR | 12 XMR |
| Day 60 | 12 XMR | 12 XMR |
| > 60 | 12 XMR | 12 XMR |

## How to get an account signed

Expand All @@ -83,7 +79,6 @@ Payment accounts that require signing cannot buy more than 3 XMR until 30 days *
To sign your account you have to buy XMR following these requirements:

- trade amount is greater than or equal to 0.1 XMR and lesser than or equal to 3 XMR
- offer must be in a market that requires signing (USD, EUR, CAD, GBP, AUD, BRL)
- seller's account must have been signed for over 30 days at the time of the signing trade

Through taking an offer you can make sure that the offer fulfils the requirements to sign your account. Making an offer could not sign your account, because taker could be unable to sign your account (signed since less than 30 days, or unsigned).
Expand All @@ -95,7 +90,7 @@ The Haveno interface makes it easy to determine if an offer can help you get sig
Top offers won't get you signed. Bottom offers will get you signed.
///

In the image above, the offer on top does not have a check mark, but the offer on the bottom does. And it's a valid size (i.e., between 0.1 XMR and 3 XMR), so taking that offer and successfully completing the trade will result in a signed account.
In the image above, the offers on top do not have a check mark, but the offers on the bottom do. And it's a valid size (i.e. between 0.1 XMR and 3 XMR), so taking that offer and successfully completing the trade will result in a signed account.

You can see your payment account's limits and signing status at <br>
`Accounts` > `Traditional Currency Accounts` Pick an account and look toward the bottom:
Expand All @@ -105,7 +100,7 @@ You can see your payment account's limits and signing status at <br>

### 2. With your own signed account

Once you have 1 signed payment account, any new payment account you create that requires signing will be self-signed as long as it uses the **exact same name** as your previously signed account. The payment account can be of a different type (e.g. a signed SEPA account can self-sign a SEPA Instant account), but a payment account created with a name that is even slightly different will not be self-signed.
Once you have 1 signed payment account, any **new** payment account you create that requires signing will be self-signed as long as it uses the **exact same name** as your previously signed account. The payment account can be of a different type (e.g. a signed SEPA account can self-sign a SEPA Instant account), but a payment account created with a name that is even slightly different will not be self-signed.

Payment account types that don't require your full name cannot be self-signed (e.g. Revolut, which only requires an email address) and they cannot self-sign other payment accounts.

Expand Down
8 changes: 8 additions & 0 deletions docs/the-project/assets.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ These are the cryptocurrencies currently listed on Haveno:
!!! info "Remember"
Monero is the base base currency of all the cryptocurrencies below (e.g. XMR/BTC, XMR/ETH).

<!-- Crypto Logos Archive: https://github.com/coinwink/crypto-logos-cc -->

![Monero](../resources/img/crypto/monero.svg){ .crypto-logos } [Monero](https://getmonero.org)

![Bitcoin](../resources/img/crypto/bitcoin.svg){ .crypto-logos } [Bitcoin](https://bitcoin.org)
Expand All @@ -25,6 +27,12 @@ These are the cryptocurrencies currently listed on Haveno:

![TetherUSDT](../resources/img/crypto/tether-usdt.svg){ .crypto-logos } [Tether USDT](https://tether.to)

![USDC](../resources/img/crypto/usdc.svg){ .crypto-logos } [USDC](https://www.circle.com/usdc)

??? info "Version info"
Tether (USDT-ERC20 & USDT-TRC20) support has been available since Haveno 1.0.13
USDC (USDC-ERC20) support has been available since Haveno 1.0.15


## Payment Methods and fiat currencies

Expand Down
11 changes: 7 additions & 4 deletions docs/the-project/payment_methods/0-all-methods.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,11 +79,14 @@ Below is a list of fiat payment methods Haveno currently supports.

## 2. Cryptocurrency payment methods

Haveno also supports a variety of cryptocurrencies for buying and selling Monero, like BTC, ETH, LTC, BCH, USDT. Because altcoin transfers are irreversible and relatively quick, altcoin trades can be up to 96 XMR in size right away (no need to wait for account aging or account signing).
Haveno also supports a variety of cryptocurrencies for buying and selling Monero, like BTC, ETH, LTC, BCH, USDT, USDC. Because cryptocurrency transfers are irreversible and relatively quick, cryptocurrency trades can be up to 96 XMR in size right away (no need to wait for account aging or account signing).

??? info "Version info"
Since Haveno 1.0.15, the trading limit for cryptocurrencies has been increased from 96 XMR to 528 XMR.

| Payment Method | Trading Period | Trade limit |
| ---------------- | :------------: | :---------: |
| Cryptocurrency | 1 Day | 96.00 XMR |
| Cryptocurrency Instant | 1 Hour | 96.00 XMR |
| Cryptocurrencies | 1 Day | 96.00 XMR |
| Cryptocurrencies Instant | 1 Hour | 96.00 XMR |

- Cryptocurrency Instant trades go by fast! Please remember to disable Instant offers in `Portfolio` > `My Open Offers` if you might not be around to settle an Instant trade.
- Cryptocurrencies Instant trades go by fast! Please remember to disable Instant offers in `Portfolio` > `My Open Offers` if you might not be around to settle an Instant trade.
3 changes: 3 additions & 0 deletions docs/the-project/payment_methods/Revolut.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,14 @@
Revolut offers banking services in [various countries](https://www.revolut.com/help/getting-started/verifying-identity/what-countries-are-supported) with [various currencies](https://www.revolut.com/help/getting-started/adding-money-to-revolut). It is most heavily used in the EUR market, but has seen action in other markets increase as Revolut has expanded the markets it operates, representing a good chance for international payments and USD payments. Due to recurring issues with other banks, it's not possible to add a Revolut SEPA account or use it as "faster payments" at Haveno. This payment method is only for transfers between Revolut users.

#### 1. Creating the account in Haveno

Setting up a Revolut account in Haveno. To create a Revolut payment account in Haveno, you need to input the country for your Revolut account, your revolut username, and the currencies that you wish to trade with the account.
Remember that none of this information can be modified once an account is created, and account signing data can be lost if not properly backed up. If you edit your username, a new Haveno account should have to be created, unsigned and with 3 XMR trading limits.

#### 2. Revolut username

On the bottom of your Revolut app, tap the two arrows symbol in the middle. Then, under your real name, there's a @username. This is what should go into your account details, and what you should use to make a Revolut payment. **Usernames are case-sensitive.**

#### 3. Pay to username

Revolut calls usernames "Revtags", and has a help center article called [How can I send money by Revtag?](https://help.revolut.com/help/transfers/internal-transfers/username-payments/how-can-i-send-money-by-username) which explains how to send money to one. If that doesn't work, see [Why can’t I pay someone by Revtag?](https://help.revolut.com/help/transfers/internal-transfers/username-payments/why-cant-i-pay-someone-by-username) and make sure that "Payments with friends" is enabled.
Loading

0 comments on commit 3aa8ef3

Please sign in to comment.