docs: generally improve docs and add maker page (#242)

* improve introduction and installation docs

* add some maker documentation

* improve maker docs

* Add network section, explain multiaddr, move docker commands into table

* Finally fix src-gui/.gitignore

* Fix .env.development

* Refine cancel, refund, punish explanation

* Add to changelog

* Make donation addresses copyable

* Apply suggestions
This commit is contained in:
Einliterflasche 2025-01-21 16:05:05 +01:00 committed by GitHub
parent 29da23ea60
commit 9e27c6548b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
13 changed files with 408 additions and 29 deletions

View file

@ -1,10 +1,12 @@
# Swapping on Testnet
Swapping on the testnet is a great way to test out the swap functionality without risking your mainnet assets. The testnet is a separate network from the mainnet, and the assets on the testnet are worthless.
To be exact, `testnet3` bitcoin will be swapped for `stagenet` Monero. You will need to set up two wallets to perform a swap:
Swapping on testnet is a great way to test out the swap functionality without risking your mainnet assets.
The _testnet_ is a separate network from the _mainnet_, only used for testing the blockchains.
The assets on testnet are worthless.
When we talk about "testnet", what we actually mean is the `Testnet3` network for Bitcoin and the `Stagenet` network for Monero.
You will need a wallet in each of these networks to perform a swap.
- A Testnet3 Electrum Wallet (Bitcoin)
- A Stagenet Monero GUI Wallet
Here are the steps to set up the wallets using Electrum and Monero GUI.
## Electrum
@ -24,7 +26,7 @@ import { Tabs, Tab } from 'nextra/components'
```
</Tab>
<Tab>
If you install Electrum on Windows, you will have two programs you can start. One of them is called "Electrum Testnet".
Open the `Electrum Testnet` program from your start menu.
</Tab>
</Tabs>
@ -32,11 +34,14 @@ To get some free Testnet coins visit a faucet like [this](https://testnet-faucet
## Monero
If you use the `monero-wallet-cli` you simply need to start it with the `--stagenet` flag. If you use the GUI you can follow [this](https://www.youtube.com/watch?v=5E4aO3UAqJo) tutorial. A list of stagenet remote nodes can be found [here](https://monero.fail/?chain=monero&network=stagenet).
If you use `monero-wallet-cli` you simply need to start it with the `--stagenet` flag.
If you use the GUI you can follow [this](https://www.youtube.com/watch?v=5E4aO3UAqJo) tutorial.
A list of stagenet remote nodes can be found [here](https://monero.fail/?chain=monero&network=stagenet).
## Launching the GUI
View the [Installation Instructions](../getting_started/install_instructions) if you haven't already installed the GUI. Then start the GUI in testnet mode.
View the [Installation Instructions](../getting_started/install_instructions) if you haven't already installed the GUI.
Then start the GUI in testnet mode.
<Tabs items={['Linux', 'macOS']}>
<Tab>
@ -51,4 +56,5 @@ View the [Installation Instructions](../getting_started/install_instructions) if
</Tab>
</Tabs>
From here on you can follow the [Complete your first swap](../usage/first_swap) guide with the difference that you will be using the testnet wallets. The process is the same, but you will be using the testnet wallets instead of the mainnet wallets.
From here on you can follow the [Complete your first swap](../usage/first_swap) guide.
The process is the same, but you will be using the testnet wallets instead of the mainnet wallets.