Bisq 2 - Revision history

SuddenWhipVapor: add link to bisq 2 mobile

2025-10-11T15:18:44Z

add link to bisq 2 mobile

SuddenWhipVapor: /* Download and verify */ revert to the user of Alejandro Garcia key

2025-02-05T12:53:19Z

Download and verify: revert to the user of Alejandro Garcia key

Strayorigin: fixed multiple spelling and grammatical errors

2024-12-23T04:15:17Z

fixed multiple spelling and grammatical errors

SuddenWhipVapor: /* Download and verify */

2024-10-23T13:23:27Z

Download and verify

SuddenWhipVapor: /* Download and verify */

2024-10-23T13:19:45Z

Download and verify

SuddenWhipVapor: Added verification instructions from GitHub release notes

2024-10-21T21:49:04Z

Added verification instructions from GitHub release notes

SuddenWhipVapor: Added and reworded "known issues with installation" from GitHub release note

2024-10-21T21:27:58Z

Added and reworded "known issues with installation" from GitHub release note

SuddenWhipVapor at 21:08, 21 October 2024

2024-10-21T21:08:49Z

Show changes

SuddenWhipVapor: SuddenWhipVapor moved page Bisq2 to Bisq 2 over redirect: Undid previous change.

2024-10-21T21:07:57Z

SuddenWhipVapor moved page Bisq2 to Bisq 2 over redirect: Undid previous change.

SuddenWhipVapor: Moved and refactored for "Bisq2"

2024-10-21T21:06:49Z

Moved and refactored for "Bisq2"

Show changes

← Older revision		Revision as of 15:18, 11 October 2025
Line 1:		Line 1:
−	Bisq 2 is the successor to the original Bisq ([[Bisq 1\|Bisq v1]]). It has been developed from the ground up to allow for multiple trade protocols to be accessed via a single decentralized exchange platform.	+	Bisq 2 is the successor to the original Bisq ([[Bisq 1\|Bisq v1]]). It has been developed from the ground up to allow for multiple trade protocols to be accessed via a single decentralized exchange platform, and it also sports a proper mobile version, [[Bisq 2 mobile]].

	At the initial launch of Bisq 2 will support only one trading protocol '[[Bisq Easy]]'. Over time more trading protocols will be added.		At the initial launch of Bisq 2 will support only one trading protocol '[[Bisq Easy]]'. Over time more trading protocols will be added.

@@ Line 150: / Line 150: @@
 Bisq2 can be downloaded [https://bisq.network/downloads/ here]. Before installing software that manages your funds, you should always verify the installer has not been tampered with, to avoid the risk of losing funds due to a compromised download.
 To import the key in Linux and MacOS:
-  <code>curl https://bisq.network/pubkey/387C8307.asc | gpg --import </code>
+  <code>curl https://bisq.network/pubkey/E222AA02.asc | gpg --import </code>
 GPG will return "This key is not certified with a trusted signature!", this is normal (see https://serverfault.com/questions/569911/how-to-verify-an-imported-gpg-key for background information what it means)

@@ Line 9: / Line 9: @@
 * Bisq 2 is a desktop application that works across platforms.
 * Bisq 2 allows users to choose between multiple trading protocols to find the best fit for their preference. Aspects like privacy and security, convenience, costs and trade duration will differ and the user can make the choice.
-* Bisq 2 is a peer-to-peer network the enables users to find people to trade with, make and take offers to buy and sell bitcoin, communicate with their trading peers and when necessary access support.
+* Bisq 2 is a peer-to-peer network that enables users to find people to trade with, make and take offers to buy and sell bitcoin, communicate with their trading peers and when necessary access support.
 * Bisq 2 is privacy focused, no verified accounts or KYC will be required and run over the Tor network (as well as I2P in future).
 * Bisq 2 is self custodial. Your keys are always under your control.
@@ Line 16: / Line 16: @@
 == Why Bisq 2? ==
 Bisq v1 is a powerful tool for bitcoiners that want to be able to buy and sell bitcoin peer to peer whilst maintaining their privacy, not having to undergo arduous KYC processes, and keeping control of their bitcoin.
-Bisq v1 was launched on mainnet in April 2016 and whilst there has been constant improvements to the trade protocol and user interface over the years it was designed from the outset to support only one trade protocol. As bitcoin has developed and Bisq user base has grown there has been an obvious need for Bisq to expand it's offerings to offer more options to it's users for example trades over lightening and access via mobile devices. Bisq 2 is the first step to develop something that is built from the ground up to be more accessible to users and provide access to multiple trading protocols that can expend over time.
+Bisq v1 was launched on mainnet in April 2016 and whilst there has been constant improvements to the trade protocol and user interface over the years it was designed from the outset to support only one trade protocol. As bitcoin has developed and Bisq user base has grown there has been an obvious need for Bisq to expand its offerings to offer more options to its users for example trades over lightning and access via mobile devices. Bisq 2 is the first step to develop something that is built from the ground up to be more accessible to users and provide access to multiple trading protocols that can expand over time.
 The core benefits of Bisq 2 are:
@@ Line 24: / Line 24: @@
 === Multiple Trade Protocols ===
-Bisq 2 will offer a variety of [[trade protocols]] for users. Each trade protocol will come with it's own benefits and tradeoffs. Having multiple protocols allows users to choose what trade protocols are best for them based on; convenience, security, miner costs, trade fees, privacy, available support etc. All trade protocols can be accessed independently and users can switch between protocols for different trades.
+Bisq 2 will offer a variety of [[trade protocols]] for users. Each trade protocol will come with its own benefits and tradeoffs. Having multiple protocols allows users to choose what trade protocols are best for them based on; convenience, security, miner costs, trade fees, privacy, available support etc. All trade protocols can be accessed independently and users can switch between protocols for different trades.
 The follow trade protocols are on the roadmap:
-* [[Bisq_Easy|Bisq Easy]]: Reputation based trading with no security deposit requirements (included in the intitial launch)
+* [[Bisq_Easy|Bisq Easy]]: Reputation based trading with no security deposit requirements (included in the initial launch)
 * Bisq Multisig: Similar to the current trade protocol used by Bisq 1 but with some improvements
@@ Line 50: / Line 50: @@
 Having multiple networks adds resilience in case one network has availability issues (as it happened multiple times with Tor when DoS attacks decreased the Tor network stability and with that Bisq's availability and stability).
-The P2P network has also a build in DoS protection using Proof of Work and come with many improvements compared the the Bisq 1 P2P network.
+The P2P network has also a built in DoS protection using Proof of Work and comes with many improvements compared to the Bisq 1 P2P network.
 ===Multiple Identities ===
-Bisq 1 used a single onion address and key pair which represent the users identify. Bisq 2 will allow to create multiple identities, giving the user more control and better privacy. The user can choose between the highest level of convenience and use just one global identity for all interactions (like Bisq 1) or at the other extreme use a separate identity for any type of interaction (e.g. use a different identity for each trade as well as for each chat room). And anything in between (separating fiat and altcoin trades,...).
+Bisq 1 used a single onion address and key pair which represent the user's identity. Bisq 2 will allow users to create multiple identities, giving the user more control and better privacy. The user can choose between the highest level of convenience and use just one global identity for all interactions (like Bisq 1) or at the other extreme use a separate identity for any type of interaction (e.g. use a different identity for each trade as well as for each chat room). And anything in between (separating fiat and altcoin trades,...).
 Find out more about how Bisq 2 manages [[Identity|identities]].
@@ Line 72: / Line 72: @@
 At launch time Bisq 2 will not include a wallet, but work is underway to support multiple wallet options.
-Bitcoin core as full wallet is already implemented (but not exposed in the UI). For users who do not want to run a full Bitcoin node, there will be a light wallet option. Currently Electrum is implemented but we might change to another solution.
+Bitcoin core as a full wallet is already implemented (but not exposed in the UI). For users who do not want to run a full Bitcoin node, there will be a light wallet option. Currently Electrum is implemented but we might change to another solution.
-For the different trade protocols there will be the specific wallets requires. E.g. for Liquid the Elements wallet is already integrated. For Monero Swaps we need to provide an interface for using the Monero wallet. Find out more about the [[Bisq_2_Wallet|Bisq 2 wallet]].
+For the different trade protocols there will be the specific wallets required. E.g. for Liquid the Elements wallet is already integrated. For Monero Swaps we need to provide an interface for using the Monero wallet. Find out more about the [[Bisq_2_Wallet|Bisq 2 wallet]].
 === Bonded Roles ===
@@ Line 88: / Line 88: @@
 == Bisq Easy ==
-Bisq Easy was designed for new Bitcoin users who have not yet purchased Bitcoin and thererfor cannot use Bisq 1 due the requirements of the security deposit. A lot of effort was put into making it as simple to use as possible.
+Bisq Easy was designed for new Bitcoin users who have not yet purchased Bitcoin and therefore cannot use Bisq 1 due the requirements of the security deposit. A lot of effort was put into making it as simple to use as possible.
-Bisq Easy tries to replicate the experience of a novice Bitcoiner visiting a Bitcoin meetup and getting a gentle and friendly introduction into the Bitcoin world as well has the opportunity to purchase their first Bitcoin from a helpful peer. This is inspired by the famous Satoshi Squares (early days informal Bitcoin meetups), which was also the initial name inspiration for Bitsquare - the previous brand name of Bisq.
+Bisq Easy tries to replicate the experience of a novice Bitcoiner visiting a Bitcoin meetup and getting a gentle and friendly introduction into the Bitcoin world as well as the opportunity to purchase their first Bitcoin from a helpful peer. This is inspired by the famous Satoshi Squares (early days informal Bitcoin meetups), which was also the initial name inspiration for Bitsquare - the previous brand name of Bisq.
-The seller is expected to be an experienced Bitcoin and Bisq user and to have built up reputation. The seller should be helpful and serve as guide through the newbies first Bitcoin trade.
+The seller is expected to be an experienced Bitcoin and Bisq user and to have built up a reputation. The seller should be helpful and serve as guide through the newbie's first Bitcoin trade.
 Bisq Easy tries to be a much more social experience as it is the case on Bisq 2. It also provides a "learn" section where newbies can learn about important topics like wallets, privacy and security. The various sections for chat rooms should also boost the social and communicative aspect of Bisq Easy.
@@ Line 108: / Line 108: @@
 === Main differences for BTC sellers ===
-Initially when Bisq 2 is launched the difference between versions will be that Bisq 2 will allow for users sell bitcoin with no security deposit, no trade fees and no security deposit. Whereas, Bisq 1 will allow users to sell bitcoin with a security deposit and incur trade fees and miner costs.
+Initially when Bisq 2 is launched the difference between versions will be that Bisq 2 will allow users to sell bitcoin with no security deposit, no trade fees and no security deposit. Whereas, Bisq 1 will allow users to sell bitcoin with a security deposit and incur trade fees and miner costs.
-Sellers on Bisq 2 will be expected to build their [[reputation]]. This can be done in multiple ways but to achieve a high reputation they will need to either burn BSQ and / or create a BSQ bond that locks in a specific amount of BSQ for a specified length of time.
+Sellers on Bisq 2 will be expected to build their reputation. This can be done in multiple ways but to achieve a high reputation they will need to either burn BSQ and / or create a BSQ bond that locks in a specific amount of BSQ for a specified length of time.
 The first iteration of Bisq 2 will have more buyers than sellers. That means a small number of sellers will be servicing the buyers. Bitcoin sellers on Bisq 2 will be required to make a judgement on how best to achieve their reputation and what the cost of doing so will involve. Bitcoin seller's using Bisq 2 will also need to account for the fact that bitcoin buyers are not putting down a security deposit for their trades so there will likely be a higher trade abandonment than in Bisq 1.
-It is expected that some bitcoin sellers currently active on Bisq 1 may choose to experiment with Bisq 2, and the number of buyer and sellers on Bisq 2 will grow over time.
+It is expected that some bitcoin sellers currently active on Bisq 1 may choose to experiment with Bisq 2, and the number of buyers and sellers on Bisq 2 will grow over time.
 As in Bisq 1 seller's will be able to choose the price above or below market they wish to sell their bitcoin for.
-Due the requirements on bonds and the potential higher effort on communication with a newbie Bitcoiner, the price premium can be expected to be much higher than in Bisq 1 (maybe 10-15% above market). The Seller is the one who sets the price.
+Due to the requirements on bonds and the potential higher effort on communication with a newbie Bitcoiner, the price premium can be expected to be much higher than in Bisq 1 (maybe 10-15% above market). The Seller is the one who sets the price.
 == How Bisq 2 keeps data private ==
-Bisq 2 achieves date privacy for users in the same way as Bisq 1:
+Bisq 2 achieves data privacy for users in the same way as Bisq 1:
 * Using Bisq requires no registration or centralized identity verification
@@ Line 135: / Line 135: @@
 * Bisq’s network is a fully distributed P2P network, and thus difficult to shut down
 * Bisq’s network is built on top of Tor (I2P), and thus inherits Tor’s own censorship resistance
-* Bisq is an open source projet and a DAO, not a company; it is not incorporated, and thus cannot be dis-incorporated
+* Bisq is an open source project and a DAO, not a company; it is not incorporated, and thus cannot be dis-incorporated
 == Advanced configurations for Bisq 2 ==
@@ Line 167: / Line 167: @@
 Replace BINARY with the name of the file you downloaded.
-In Windows. you can import the key, and subsequently verify the installer, by using [https://www.gpg4win.org/download.html Kleopatra].
+In Windows you can import the key, and subsequently verify the installer, by using [https://www.gpg4win.org/download.html Kleopatra].
 === Known issues with installation ===

@@ Line 151: / Line 151: @@
 Bisq2 can be downloaded [https://bisq.network/downloads/ here]. Before installing software that manages your funds, you should always verify the installer has not been tampered with, to avoid the risk of losing funds due to a compromised download.
-Usually, installation binaries are signed by Alejandro García (key ID: E222AA02, primary release manager). However, since this key has expired — and the expired key was included in previous versions of the Bisq2 app — the in-app verification process will fail when attempting to download version 2.1.2. To prevent this issue, the secondary release manager assumed responsibility for signing that release. The signingkey.asc file specifies the key used for signing the binaries.
+Usually, installation binaries are signed by Alejandro García (key ID: E222AA02, primary release manager). However, since this key has expired — and the expired key was included in previous versions of the Bisq2 app — the in-app verification process would fail when attempting to download version 2.1.2. To prevent this issue, the secondary release manager assumed responsibility for signing that release. The signingkey.asc file specifies the key used for signing the binaries.
 HenrikJannsen's signing key can be downloaded [https://bisq.network/pubkey/387C8307.asc here] (full fingerprint: B8A5 D214 ADFA A387 A14C  8BCF 02AA 2BAE 387C 8307).

@@ Line 157: / Line 157: @@
 To import the key in Linux and MacOS:
-<code>curl https://bisq.network/pubkey/387C8307.asc | gpg --import </code>
+ <code>curl https://bisq.network/pubkey/387C8307.asc | gpg --import </code>
 GPG will return "This key is not certified with a trusted signature!", this is normal (see https://serverfault.com/questions/569911/how-to-verify-an-imported-gpg-key for background information what it means)
@@ Line 163: / Line 163: @@
 To verify the installer against the signature:
-<code>gpg --digest-algo SHA256 --verify BINARY{.asc*,}</code>
+ <code>gpg --digest-algo SHA256 --verify BINARY{.asc*,}</code>
 Replace BINARY with the name of the file you downloaded.

@@ Line 145: / Line 145: @@
 For more info see the GitHub pull request [https://github.com/bisq-network/bisq2/pull/2201 here].
-== Known issues with installation ==
+== Installation ==
-=== MacOS ===
+=== Download and verify ===
 Notarization was removed from the build pipeline because of the risk of Apple certification revocation ([https://github.com/bisq-network/bisq/discussions/6341 GitHub issue]). Unfortunately this will require extra steps when installing Bisq on macOS.
@@ Line 159: / Line 183: @@
 You will be prompted to enter your password to execute the command as super user, and this should allow you to start Bisq 2 normally.
-=== Windows ===
+'''Windows'''
 The developer code signing was removed for the same reason as above. You can ignore the warning after having verified the installer.
@@ Line 171: / Line 195: @@
 [2] Data directory (contains all Bisq data): C:\Users<username>\AppData\Roaming\Bisq2
-=== Linux ===
+'''Linux'''
 Debian users: if you have issues starting Bisq, run <code>/opt/bisq2/bin/Bisq2</code>

← Older revision		Revision as of 21:27, 21 October 2024
Line 144:		Line 144:

	For more info see the GitHub pull request [https://github.com/bisq-network/bisq2/pull/2201 here].		For more info see the GitHub pull request [https://github.com/bisq-network/bisq2/pull/2201 here].
		+
		+	== Known issues with installation ==
		+
		+	=== MacOS ===
		+
		+	Notarization was removed from the build pipeline because of the risk of Apple certification revocation ([https://github.com/bisq-network/bisq/discussions/6341 GitHub issue]). Unfortunately this will require extra steps when installing Bisq on macOS.
		+
		+	Please follow the guide at https://support.apple.com/en-us/HT202491 in the section "If you want to open an app that hasn’t been notarized or is from an unidentified developer".
		+
		+	If you are using macOS Ventura (13.0+) you need to execute the following in your terminal to be able to start Bisq 2:
		+
		+	<code>sudo xattr -rd com.apple.quarantine /Applications/Bisq2.app</code>
		+
		+	You will be prompted to enter your password to execute the command as super user, and this should allow you to start Bisq 2 normally.
		+
		+	=== Windows ===
		+
		+	The developer code signing was removed for the same reason as above. You can ignore the warning after having verified the installer.
		+
		+	There are known issues with antivirus software: Bisq or Tor processes could be prevented from running, files could get deleted in the data directory [2] or the application directory [1]), or startup could be delayed to the point that Tor is terminated, and a lockfile is left behind preventing Bisq from being started again (this requires you to restart Windows in order to remove the lockfile). These issues are currently being evaluated and addressed.
		+
		+	Windows suffers from a much wider attack surface compared to Linux or OSX, please consider using a different operating system when dealing with cryptocurrencies.
		+
		+	[1] Application directory (contains application installation files): C:\Users<username>\AppData\Local\Bisq2
		+
		+	[2] Data directory (contains all Bisq data): C:\Users<username>\AppData\Roaming\Bisq2
		+
		+	=== Linux ===
		+
		+	Debian users: if you have issues starting Bisq, run <code>/opt/bisq2/bin/Bisq2</code>
		+
		+	If your Linux distribution does not support .deb files please follow these instructions:
		+
		+	<code>
		+	cd ~/Downloads
		+
		+	mkdir tmp
		+
		+	cd tmp
		+
		+	ar x ../Bisq-64bit-2.1.2.deb
		+
		+	sudo tar Jxvf data.tar.xz
		+
		+	sudo cp -rp opt/Bisq2 /opt/
		+	</code>
		+
		+	The above is not tested in all distributions, if you encounter issues please report them [https://github.com/bisq-network/bisq2/issues here].

← Older revision	Revision as of 21:07, 21 October 2024
(No difference)