Skip to content

Commit eebac7a

Browse files
committed
update build instructions for mainnet
1 parent c224a7d commit eebac7a

File tree

1 file changed

+26
-14
lines changed

1 file changed

+26
-14
lines changed

docs/installing.md

Lines changed: 26 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
1-
# Set up environment
1+
# Build and run Haveno
22

3-
These are the steps needed to build Haveno. You can test it locally or on our test network.
3+
These are the steps needed to build and run Haveno. You can test it locally or on our test network using the official Haveno repository.
44

55
> [!note]
6-
> Trying to install Haveno for mainnet?
6+
> Trying to use Haveno on mainnet?
77
>
8-
> Find a third party network and use their installer or build their repository. We do not operate or endorse any mainnet network.
8+
> The official Haveno repository does not operate or endorse any mainnet network. Find a third party network and use their installer or build their repository.
9+
>
10+
> Alternatively you can [create your own mainnet network](create-mainnet.md).
911
1012
## Install dependencies
1113

@@ -49,13 +51,23 @@ git pull
4951
make clean && make
5052
```
5153

52-
When you run Haveno, your application folder will be installed to:
54+
## Run Haveno
5355

54-
* Linux: `~/.local/share/Haveno/`
55-
* macOS: `~/Library/Application\ Support/Haveno/`
56-
* Windows: `~\AppData\Roaming\Haveno\`
56+
> [!note]
57+
> When you run Haveno, your application folder will be installed to:
58+
> * Linux: `~/.local/share/Haveno/`
59+
> * macOS: `~/Library/Application\ Support/Haveno/`
60+
> * Windows: `~\AppData\Roaming\Haveno\`
61+
62+
### Mainnet
63+
64+
If you are building a third party repository which supports mainnet, you can start Haveno with:
65+
66+
```
67+
make haveno-desktop-mainnet
68+
```
5769

58-
## Join the public test network
70+
### Join the public test network
5971

6072
If you want to try Haveno in a live setup, launch a Haveno instance that will connect to other peers on our public test environment, which runs on Monero's stagenet (you won't need to download the blockchain locally). You'll be able to make test trades with other users and have a preview of Haveno's trade protocol in action. Note that development is very much ongoing. Things are slow and might break.
6173

@@ -69,19 +81,19 @@ Steps:
6981
6. Now if you are taking a trade you'll be asked to confirm you have sent the payment outside Haveno. Confirm in the app and wait for the confirmation of received payment from the other trader.
7082
7. Once the other trader confirms, deposits are sent back to the owners and the trade is complete.
7183

72-
## Run a local test network
84+
### Run a local test network
7385

7486
If you are a developer who wants to test Haveno in a more controlled way, follow the next steps to build a local test environment.
7587

76-
### Run a local XMR testnet
88+
#### Run a local XMR testnet
7789

7890
1. In a new terminal window run `make monerod1-local`
7991
1. In a new terminal window run `make monerod2-local`
8092
3. Now mine the first 150 blocks to a random address before using, so wallets only use the latest output type. Run in one of the terminal windows opened above:
8193

8294
`start_mining 9tsUiG9bwcU7oTbAdBwBk2PzxFtysge5qcEsHEpetmEKgerHQa1fDqH7a4FiquZmms7yM22jdifVAD7jAb2e63GSJMuhY75 1`
8395

84-
### Deploy
96+
#### Deploy
8597

8698
If you are a *screen* user, simply run `make deploy`. This command will open all needed Haveno instances (seednode, user1, user2, arbitrator) using *screen*.
8799

@@ -95,14 +107,14 @@ If you don't use *screen*, open 4 terminal windows and run in each one of them:
95107

96108
If this is the first time launching the arbitrator desktop application, register the arbitrator after the interface opens. Go to the *Account* tab and press `cmd+r`. Confirm the registration of the arbitrator.
97109

98-
### Fund your wallets
110+
#### Fund your wallets
99111

100112
When running user1 and user2, you'll see a Monero address prompted in the terminal. Send test XMR to the addresses of both user1 and user2 to be able to initiate a trade.
101113

102114
You can fund the two wallets by mining some test XMR coins to those addresses. To do so, open a terminal where you ran monerod and run: `start_mining ADDRESS 1`.
103115

104116
monerod will start mining local testnet coins on your device using one thread. Replace `ADDRESS` with the address of user1 first, and then user2's. Run `stop_mining` to stop mining.
105117

106-
### Start testing
118+
#### Start testing
107119

108120
You are all set. Now that everything is running and your wallets are funded, you can create test trades between user1 and user2. Remember to mine a few blocks after opening and accepting the test trade so the transaction will be confirmed.

0 commit comments

Comments
 (0)