Skip to content

Commit

Permalink
Rename Haveno-reto to RetoSwap
Browse files Browse the repository at this point in the history
  • Loading branch information
boldsuck committed Dec 10, 2024
1 parent 516cc47 commit a542068
Show file tree
Hide file tree
Showing 8 changed files with 127 additions and 127 deletions.
2 changes: 1 addition & 1 deletion docs/haveno-ui/UX_tips.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Optimize your Haveno-reto usage and/or make it more comfortable
# Optimize your RetoSwap usage and/or make it more comfortable

### Settings

Expand Down
34 changes: 17 additions & 17 deletions docs/haveno-ui/backup_and_restore.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# 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 RetoSwap 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 RetoSwap itself (e.g. critical bugs). All RetoSwap 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
### 1. Back up the entire RetoSwap data directory

The safest, quickest, easiest, and most comprehensive thing you can do to safeguard your data is to back up the whole data directory at regular intervals. See the various elements of the data directory detailed here. In addition, to make restoring payment accounts easier, you may want to back up an export of your payment accounts.

#### 1.1 While Haveno-reto is running
#### 1.1 While RetoSwap is running

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).

Expand All @@ -16,9 +16,9 @@ Go to `Account` -> `Backup` and put in a location for your backup to be exported
Data directory backup screen.
///

#### 1.2 While Haveno-reto is closed
#### 1.2 While RetoSwap 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:
When RetoSwap 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/
Expand Down Expand Up @@ -49,21 +49,21 @@ If you want to carry over a particular onion address (and keep your local reputa
### 5. Export trade history

In `Portfolio` -> `History` you'll find an `Export to CSV` button to export your trade history.
There's no way to import this data back into Haveno-reto, but it can be useful to have a copy of this data for yourself for record-keeping, analysis, etc.
There's no way to import this data back into RetoSwap, but it can be useful to have a copy of this data for yourself for record-keeping, analysis, etc.

### 6. Export transaction history

In `Funds` -> `Transactions` you'll find an `Export to CSV` button to export your trade history.
There's no way to import this data back into Haveno-reto, but it can be useful to have a copy of this data for yourself for record-keeping, analysis, etc.
There's no way to import this data back into RetoSwap, but it can be useful to have a copy of this data for yourself for record-keeping, analysis, etc.

## Restore Haveno data

Restoring application data can be useful to bring back payment accounts, onion addresses, and other items from a backup—or to move your Haveno-reto instance to an entirely new machine.
Restoring application data can be useful to bring back payment accounts, onion addresses, and other items from a backup—or to move your RetoSwap instance to an entirely new machine.
You can restore an entire data directory at once, or just the parts you want.

### 1. Restore an entire data directory

First make sure Haveno-reto is closed. Then copy the entire Haveno-reto directory from your backup and paste it in your machine's default data directory location. If there already is a directory called Haveno-reto there, remove it (or rename it) and replace it with your backup.
First make sure RetoSwap is closed. Then copy the entire RetoSwap directory from your backup and paste it in your machine's default data directory location. If there already is a directory called RetoSwap there, remove it (or rename it) and replace it with your backup.

Data directories work across operating systems, so you can copy a data directory created on a Mac to the appropriate location on Linux or Windows, and it will work. But, please do not run the same data directory on 2 machines at the same time, even if you don't run both instances at the same time, as data may get corrupted in strange ways.

Expand All @@ -77,7 +77,7 @@ If you have a payment accounts export file, import it in `Account` -> `Tradition

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.
Use the output to copy and paste the details into new payment accounts in RetoSwap, 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.

There are quirks. Here's an example of output from a *strings* command:

Expand All @@ -101,13 +101,13 @@ If you're on Windows, or cannot use the *strings* utility for some other reason,
It may be tempting to just replace the entire UserPayload file from a backup, but this is **not recommended**, as it may contain other data that could result in data corruption in your new instance.
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.
Once you've restored your payment account metadata, you'll see the accounts in RetoSwap, 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.
- Close Haveno-reto. Also make sure you've made a backup of your data directory (just in case).
- Close RetoSwap. 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.

Upon opening Haveno-reto, you should see account aging and signing status restored for your fiat payment accounts. If you don't, double-check:
Upon opening RetoSwap, 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)
Expand All @@ -118,20 +118,20 @@ Your onion address determines your local reputation, so depending on your prefer

If you want to restore it:

- Close Haveno-reto. Also make sure you've made a backup of your data directory (just in case).
- Close RetoSwap. Also make sure you've made a backup of your data directory (just in case).
- Replace the `/path/to/data/directory/xmr_mainnet/tor/hiddenservices/` folder with the `xmr_mainnet/tor/hiddenservices/` folder from your backup.

When you open Haveno-reto, your onion address will be restored: this means that the peers that have traded with you will see bubbles with trade counts in their offer books for your offers.
When you open RetoSwap, your onion address will be restored: this means that the peers that have traded with you will see bubbles with trade counts in their offer books for your offers.

### 5. Restore trade history

You may want to keep your trade history despite changing wallets. You can do so by:

- Closing Haveno-reto.
- Closing RetoSwap.
- Replacing the `/path/to/data/directory/xmr_mainnet/db/ClosedTrades` file on your new directory with the file from backup with the same name.

You will see bubbles with trade counts in the offer books for any any peers you traded with.

### 6. Restore wallet

If starting a new data directory, it's generally best to just send funds from one Haveno-reto instance to another with an on-chain transaction.
If starting a new data directory, it's generally best to just send funds from one RetoSwap instance to another with an on-chain transaction.
87 changes: 72 additions & 15 deletions docs/haveno-ui/get_started.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,85 @@
# Getting Started
# Get started on RetoSwap

- This guide covers just what you need to get trading quickly!
### 1. Launching Haveno

**Before you can start trading on Haveno-reto, you'll need a little Moneroj for a security deposit and fees (0.2 XMR should be enough). Each trader must lock Moneroj in a multisignature escrow until the trade is complete—this is part of what makes trading on Haveno-reto highly secure.**
![Image](../resources/img/haveno-ui/startup.png)
/// caption
Nothing to do expect launching the app and waiting for all services initalized
///

### 1. [Download and Install Haveno-reto](https://haveno-reto.com/#downloads)

- It's also a good idea to verify your installer file with our [PGP key](https://haveno-reto.com/reto_public.asc)
![Image](../resources/img/haveno-ui/home.png)
/// caption
Once all services are ready, the market will be shown.
///

If you'd like to build Haveno-reto from source, [here are directions](https://github.com/retoaccess1/haveno-reto/blob/master/docs/installing.md). Haveno is free/libre open-source software that you can contribute to [(github)](https://github.com/retoaccess1/haveno-reto).
### 2. Backup your seed and setup a trading account

### 2. Back Up Keys, Write Down Seed
Go in `Account` and click on `Seed` tab to backup your main wallet.
![Image](../resources/img/haveno-ui/save_seed.png)

- With Haveno-reto, you're in total control of your funds and your data. This means you retain unparalleled sovereignty, but it also means no one can help you if you lose something important—so it's critical that you do proper backups before using Haveno-reto to trade.
You also can set a wallet password for additionnal security
![Image](../resources/img/haveno-ui/password_wallet.png)

More details at: [data backup and restoration](backup_and_restore.md).
Trading needs an account for the payment method and currency used to take and publish offers, it also ensure data integrity and protects against evil actors trying to use stolen accounts.
![Image](../resources/img/haveno-ui/create_trading_account.png)

### 3. Create a Payment Account
### 3. Trading

- In order to trade monero on Haveno-reto, you've got to set up some way to send or receive other funds. Haveno-reto only handles the monero side of a trade—the other side is handled through fiat payment services (banks, money orders, cash) or altcoin wallets.
### 3.1 Create, fund and publish your offer (maker)

Not sure which kind of payment account to set up? There's a full list of [payment methods](../the-project/payment_methods/0-all-methods.md) on the wiki.
Go in the market you want to trade (in our example selling Monero for Bitcoin) and click on `CREATE OFFER TO SELL XMR`
![Image](../resources/img/haveno-ui/create_offer.png)

### 4. Do a Trade
You can set an optional minimum of XMR to buy, if you want flexible sizes to be accessible and setting a fixed price or a % derivation (below or above the market price) before clicking on `NEXT STEP`.
![Image](../resources/img/haveno-ui/price_fluctuation_or_fixed_price.png)

Making an offer will usually get you a better price and more control (e.g.: setting payment method and deposit percentage), but taking an offer can be more convenient.
To see both sides of a Haveno-reto trade at the same time, side-by-side: be sure to check out our [trading recommendations](trading-recommendations.md) and [linked tutorials made by the community](https://haveno-reto.com/#posts).
After the offer is set, you need to fund your trade offer with a security deposit worth 15% of the trade (as shown earlier) before placing your offer.
In our case since we sell we technically need 115% of the trade.
![Image](../resources/img/haveno-ui/place_offer.png)

It is generally advised to externally fund your trade so you'll need to wait for block confirmations, balance is shown as **pending** until the external deposit reached 10 block confirmations and you will have the possibility to click on `REVIEW: PLACE OFFER TO BUY BTC` when funds will be shown in **available balance**.
![Image](../resources/img/haveno-ui/wait_for_confirm_funding.png)

Confirm placing your offer, you can take your TradeID to share it privately to someone or reviewing the summary before confirming.
![Image](../resources/img/haveno-ui/confirm:placeoffer.png)

Now the offer is published, you can disable it if you wont be available or for activating it to people you know only.
![Image](../resources/img/haveno-ui/deactivate_offer.png)

### 3.2 Find and take an offer (taker)

As a taker, go in the market you want and take an offer.
![Image](../resources/img/haveno-ui/searchoffer.png)

Or filter TradeIDs / peer hidden-service to take specific offers.
![Image](../resources/img/haveno-ui/filteroffer.png)

Set a custom amount if the maker allows or if you need it, click on next step.
![Image](../resources/img/haveno-ui/takeoffer.png)

Fund your trade with a 15% security deposit and click on next step.
![Image](../resources/img/haveno-ui/fundtookoffer.png)

Confirm taking the offer and it will initiate the trade.
![Image](../resources/img/haveno-ui/takeofferprocess.png)

### 3.3 Trading steps

Once the trade is setup, go in `MY OPEN OFFERS` and click on your trade. To get the trading chat for contacting your peer, click on the chat icon.
![Image](../resources/img/haveno-ui/opened_trade.png)
/// caption
Peers need to wait 10 confirmations before trading (chain re-org protection)
///

In our example the taker buy XMR so marking `PAYMENT SENT` once BTC funds are sent to the maker.
![Image](../resources/img/haveno-ui/tradetakermarkpaymentsent.png)

The seller (maker in our case) receive the payment notification.
![Image](../resources/img/haveno-ui/makerreceivesnotificationpaymentsent.png)

The maker clicks on confirm receiving the payment after having verified it.
![Image](../resources/img/haveno-ui/makermarkconfirmation.png)

After the payment has been confirmed as received, both peers can close the trade and funds will be paid-out to their main wallets.
![Image](../resources/img/haveno-ui/makerclosetrade.png)
85 changes: 0 additions & 85 deletions docs/haveno-ui/haveno-reto_get_started.md

This file was deleted.

Loading

0 comments on commit a542068

Please sign in to comment.