Bisq Wiki - User contributions [en]

ACH Transfer

2026-05-03T17:57:38Z

Strayorigin: Fixed typos; improved formatting and scannability; added prominent security warning regarding micro-deposit risks.

'''ACH Transfer''', or Automated Clearing House transfer, is a payment method introduced in Bisq v1.8.0. It is primarily used for domestic, low-value payments between participating financial institutions in the United States. Along with [[Domestic_Wire_Transfer|domestic wire transfers]], ACH is one of the two primary bank transfer methods used in the US.

== Quick Facts ==

* '''Supported Countries:''' United States only.
* '''Supported Currencies:''' USD only.
* '''Maximum Trade Duration:''' 5 days (though most complete within 1–2 business days).
* '''Trade Limits:''' {{MaxTradeSizeBisq1}}.
* '''Account Signing:''' Not required.

<div style="background-color: #fff3cd; color: #856404; padding: 15px; border: 1px solid #ffeeba; border-left: 5px solid #856404; margin: 20px 0;">
'''SECURITY WARNING: Never confirm micro-deposits for a Bisq trade.'''

Some banks verify external accounts using micro-deposits (small transfers of a few cents). If a trade partner initiates micro-deposits, they are likely attempting to "link" your account to theirs. In the ACH system, a linked account may allow the other party to '''debit (withdraw)''' funds from your account without further authorization.
* '''Sellers:''' If you receive micro-deposits, do not verify the amounts for the buyer.
* '''Buyers:''' Do not use "Direct Deposit" setup methods; use standard "Third-Party Transfer" or "Bill Pay" features.
</div>

== Account Setup & Limits ==

=== Is my bank compatible? ===
Not all banks offer third-party ACH transfers. Many banks only allow ACH transfers to other accounts '''you own'''. Before trading, verify that your bank supports "Third-Party ACH Transfers" or "External Transfers" to individuals. If your bank insists on micro-deposit verification, it is likely not a true third-party transfer service.

=== Fees and Limits ===
* '''Fees:''' Usually low-cost or free, but some banks charge for "Same Day ACH" or expedited delivery. Always check your bank's fee schedule.
* '''Transfer Limits:''' Your bank likely has daily or monthly "External Transfer" limits. Ensure these limits accommodate your Bisq trade size before opening an offer.

== Adding ACH Transfer to Bisq ==

To add your ACH account to Bisq:
# Head to the top menu and select '''Account'''.
# Choose '''National Currency Accounts'''.
# Click on '''Add new account'''.
# Select '''ACH'''.
# Fill in the necessary details (Routing Number, Account Number, etc.).
# '''Account Name:''' You can set a custom name (e.g., "ACH - Chase - Jane Doe") to help you stay organized. This name is only visible to you.
# Click '''Save new account'''.

'''Note:''' Ensure all details are accurate. Sellers can only confirm payment if the name associated with the incoming ACH transfer matches the account name listed in Bisq.

== How to Trade with ACH ==

=== Buying BTC ===
# Make or take an offer on the USD market.
# Once the trade is confirmed, Bisq will provide the seller's ACH details.
# Send the payment through your bank's portal immediately.
# '''Payment Reference:''' Leave this '''blank'''. If your bank requires one, only use your name. Never mention "Bisq," "Bitcoin," or "Crypto."
# Click '''Payment Started''' in Bisq.

=== Selling BTC ===
# Make or take an offer to sell BTC on the USD market.
# After confirmation, Bisq will provide the buyer with your ACH details.
# Wait for the buyer to send the payment and click "Payment Started."
# '''Verify the funds:''' Once the funds arrive in your bank account, click '''Confirm Payment Received''' to release the BTC.
# '''Security Note:''' If you receive small "micro-deposits" instead of the full trade amount, '''do not''' communicate those amounts to the buyer.

== Dispute Resolution ==

If a dispute occurs, the mediator may ask the buyer to provide proof of payment (e.g., a PDF receipt) showing the correct amount and recipient details. The mediator may also ask the seller for a redacted statement to prove their account details or to show that a payment was not received.

For more information, see [[dispute resolution]].

Connecting to your own Bitcoin node

2026-05-03T17:36:02Z

Strayorigin: clean up code section for easy copy

Bisq will '''connect to [[Installing_your_own_Bitcoin_node|your local Bitcoin node]]''' if it finds it upon starting up. This article contains the requirements for this to work correctly.

You can also specify the addresses of particular Bitcoin nodes in <code>Settings</code> > <code>Network Info</code>.

__TOC__

= General node settings =

The <code>bitcoin.conf</code> file needs to contain the following settings. You can copy and paste this block directly into your configuration file:

<pre>
server=1
prune=0
peerbloomfilters=1
</pre>

* '''server=1''': enables the block server mode
* '''prune=0''': disables the pruning of old blocks
* '''peerbloomfilters=1''': allows Bisq to run its SPV wallet

Multiple reports have been received, where any declination of the Ronin node just won't work, or will work once, only to stop working after the next reboot, requiring a restore to network provided nodes. We are not able to suggest a workaround, except involving Ronin support.

= Connecting to a local Bitcoin node =

If you're running a Bitcoin full node on the same machine as Bisq, Bisq should connect to your node on startup—it will look for Bitcoin Core or <code>bitcoind</code> running on <code>localhost</code> on port 8333.

Just make sure to not be running any other Bitcoin-based altcoin nodes (like LTC) while starting Bisq.

= Connecting to another Bitcoin node =

By default, Bisq maximizes your privacy by connecting to nodes run by trusted Bisq contributors.

If you'd like to connect to another node, you can specify its address in <code>Settings</code> > <code>Network Info</code>. Bisq will validate the address and connect to the specified node the next time it starts.

Bisq supports connecting to Bitcoin nodes with Tor v3 addresses: this is the easiest path to take, since you only have to fill in your node's onion address in settings. 
If your node is on your local network, connecting directly to it rather than using Tor would reduce latency by a sensible degree. In order to do this:
* make sure the node's firewall allows incoming connections on port 8333 from the local network
* have Bitcoin daemon listen to <code>0.0.0.0</code> rather than <code>127.0.0.1</code> (add a line that says <code>bind=0.0.0.0</code>)
* uncheck "Use Tor for Bitcoin network" under Settings>Network in Bisq application
* fill in your node's local network <code>ipaddress:8333</code> in "Use custom bitcoin Core nodes" field

= Troubleshooting =

If you get into a state where Bisq is unable to connect, or stuck at SPV resync on the loading screen, you can revert to a provided node as follows.

For MacOS:
<pre>
/Applications/Bisq.app/Contents/MacOs/Bisq -btcNodes=ybryiy2k4p4pery4qseap4iu2rxput2akuvpvczwvg4eyfafcdsvyqid.onion:8333 -useTorForBtc=true
</pre>

For Linux:
<pre>
/opt/bisq/bin/Bisq -btcNodes=ybryiy2k4p4pery4qseap4iu2rxput2akuvpvczwvg4eyfafcdsvyqid.onion:8333 -useTorForBtc=true
</pre>

For Windows:
<pre>
%localappdata%\Bisq\Bisq.exe -btcNodes=ybryiy2k4p4pery4qseap4iu2rxput2akuvpvczwvg4eyfafcdsvyqid.onion:8333 -useTorForBtc=true
</pre>

After Bisq successfully started and synchronized by running it with that command, you should then go to Settings > Network info, and select again "Use provided Bitcoin Core nodes".

Contributor nodes can be seen [https://github.com/bisq-network/bisq/blob/8d345000ee22350ff6d203d4dee8c52285b6d302/core/src/main/java/bisq/core/btc/nodes/BtcNodes.java#L51-L67 here in the Bisq code].

[[Running_from_the_command_line|More info on running from the command line]].

[[Command_line_options|More info on command line options]].

US Postal Money Order

2026-01-17T16:53:13Z

Strayorigin: changed based on new regulations and support discussion

'''US Postal Money Orders''' (USPMO) are one of the most private payment methods available on Bisq. Because they are bearer instruments, they can be purchased with cash and mailed, providing a path to Bitcoin without a digital bank trail.

* '''Region:''' United States only
* '''Maximum Trade Period:''' 8 days
* '''Maximum Trade Size:''' 0.0625 BTC

This guide provides a complete overview of how to safely and privately use this payment method for buying and selling bitcoin on Bisq.

__TOC__

= Critical Trading Requirements =

Before you create or take an offer using US Postal Money Orders, you '''must''' understand and agree to the following rules. Failure to comply will result in losing any trade dispute.

{{Admonition_Note |
* '''Avoid "Same-Name" Fields:''' Do NOT write the BTC Seller’s name in both the "From" and "To" fields. Many banks and automated systems now flag these as suspicious, which can lead to complications or account closures for the Seller.
* '''Video Proof is Required:''' Photos are no longer sufficient to prove a payment was sent. BTC buyers must record a continuous video of the USPMO being filled out, placed into the envelope, and sealed with the tracking label visible.
* '''Use Tracking:''' All USPMOs must be sent with a service that provides delivery confirmation (e.g., USPS Tracking).
* '''Burden of Proof:''' In a dispute, the sender (BTC buyer) bears 100% of the responsibility to provide the required mailing video and tracking information.

If you are not prepared to follow these rules, do not trade using USPMO on Bisq.}}

= A Step-by-Step Guide to Trading with USPMO =

== Step 1: Set Up Your Payment Account ==

First, you need to [[Create_a_payment_account|set up a USPMO payment account]] in the Bisq UI. It is important to distinguish between the '''Account Information''' used within the software and the '''Physical Information''' used on the money order and envelope.

=== Account Information in Bisq UI ===
Similar to "Cash by Mail," the name you enter into your Bisq payment account does not need to match your real identity.
* '''Name:''' You may use a pseudonym or a randomly generated name in the Bisq software. This name is only seen by your trading partner in the app.
* '''Address:'''
** '''BTC Buyers:''' Use a valid return address. For privacy, a PO Box or a trusted secondary address is recommended. If the mail is returned and your return address is invalid, the funds will be lost.
** '''BTC Sellers:''' Must provide a valid mailing address where you can physically receive the envelope.

=== Information on the Physical Money Order ===
While your Bisq UI profile can be anonymous, the physical instrument has strict requirements:
* '''Never Use Fake Info:''' Writing a fake name or a pseudonym on a US Postal Money Order is a federal offense.
* '''For the Seller:''' To cash the money order, the "To" field must match your legal photo ID.
* '''For the Buyer:''' You must decide between using your '''real name''' in the "From" field (best for seller's bank compliance) or leaving it '''blank''' (best for your privacy). Do '''not''' use your Bisq pseudonym on the physical document.

== Step 2: Purchase the Money Order ==

* '''Amount Limit:''' Up to '''$1,000''' per money order. Multiple orders are allowed for larger trades.
* '''Payment Method:''' It is '''highly recommended''' to use cash. Paying with a debit card creates a data trail; credit cards are not accepted.
* '''Fees:''' As of January 2026, the fees are:
{| class="wikitable"
|+ USPMO Issuing Fees
|-
! Dollar Amount !! Fee
|-
| $0.01 to $500.00 || $2.55
|-
| $500.01 to $1,000.00 || $3.60
|-
| Postal Military Money Orders || $0.84
|}
* '''Receipt:''' Keep your receipt in a safe place. It is essential for tracking and is required if the money order is lost or damaged.

== Step 3: Filling and Sending ==

Because many banks now flag "Same-to-Same" transfers (where the same name is in both fields), you must change how you fill out the "From" (Purchaser) section.

=== Filling out the "From" Section ===
The "To" field must always be the Seller's legal name. For the "From" field, you have two choices:
# '''Your Information:''' Most secure for the seller's bank deposits.
# '''Leave Blank:''' Provides maximum privacy for the buyer, but some banks may refuse to accept the deposit if the sender information is missing.

=== Mandatory Video Proof ===
To prevent "ghost shipping" disputes, record a single continuous video:
# Show the completed USPMO (matching the trade amount and Seller's name).
# Show the USPS purchase receipt.
# Place the MO inside a blank sheet of paper (privacy layer) and then into the envelope.
# Seal the envelope and show the tracking label clearly.

== Step 4: Verify the Money Order (2025/2026 Designs) ==

Sellers should verify the authenticity of the USPMO before releasing bitcoin.

=== Red, Blue, & Red Design (2025/2026 Standard) ===
[[File:Red, Blue, & Red Postal Money Order (July 2025).jpeg|thumb|left|350px|Current Design]]
* '''Watermarks:''' Hold to light to see a '''Pony Express® rider''' on the left and "United States Postal Service" in a box on the right.
* '''Security Thread:''' A vertical thread to the right of the rider watermark with "USPS" repeating in alternating directions.
* '''QR Code:''' A QR Code on the front links directly to the USPS "Check Money Order Status" tool for easy verification.
 

=== Green & Purple Design (Legacy) ===
[[File:Green & Purple Postal Money Order (Point-of-Sale Version).jpeg|thumb|left|350px|Legacy Design]]
* '''Watermarks:''' A U.S. Mail eagle in the center and Benjamin Franklin watermarks on the left side.
* '''Security Thread:''' A vertical, multicolored security thread weaving in and out of the paper.
 

== Step 5: Cashing the Money Order ==

It is recommended to cash the USPMO at a Post Office. You will need a valid photo ID that matches the name in the "To" field.

If you are depositing into a bank, be aware that many physical branches now require you to use a teller for money orders rather than an ATM or mobile deposit.

Downloading and installing

2025-12-23T15:59:02Z

Strayorigin: cleanup

To use Bisq, you must first '''[https://bisq.network/downloads/ download and install]''' it. Most exchanges are centralized exchanges running on servers controlled by the exchange. Bisq is decentralized, running only on the desktops of Bisq users.

Bisq manages offers to trade using a peer-to-peer network. This is a global network made of users who are also running Bisq on their own computers.

Centralized services are easy to monitor, block, and shut down, while peer-to-peer networks like BitTorrent, Bitcoin and Bisq are difficult to surveil, censor, shut down or hack.

All of this means that if you want to use the Bisq network, you must download and run the software on your own machine.

== Download Bisq ==

The most convenient way to install Bisq on your machine is from a pre-built install file from the [https://bisq.network/downloads/ Bisq website] or [https://github.com/bisq-network/bisq/releases/latest latest GitHub release].

There's also a community-maintained [https://snapcraft.io/bisq-desktop Snap package] for various Linux distributions.

{{Admonition_Note|See [[#OS-specific_install_notes|install notes for various Linux distributions below]].}}

You can download the installer for your operating system and install Bisq right away, but we strongly recommend that you [[ #Verify installer file | verify the integrity ]] of your installer file first.

'''If you have issues, please check the ''Known issues with installation'' section in [https://github.com/bisq-network/bisq/releases/latest release notes].'''

== Verify installer file ==

=== Bisq2 specific instructions ===

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

To import the key in Linux and MacOS:

<nowiki>curl https://bisq.network/pubkey/387C8307.asc | gpg --import </nowiki>

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)

To verify the installer against the signature:

<nowiki>gpg --digest-algo SHA256 --verify BINARY{.asc*,}</nowiki>

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

Any software that manages funds, signs transactions, and deals with highly sensitive data is a prime target for malware. Bisq does all three. Therefore, it is highly recommended that you verify the integrity of the installer file you use to install Bisq.

This verification is something that you should do for the initial Bisq install. After the initial install, you will be prompted to install updates through Bisq's interface. The Bisq software will verify the integrity of updates for you.

Bisq installer files are currently built and signed by Alejandro Garcia (alejandrogarcia83). His public key ID is <code>E222AA02</code> and fingerprint is <code>B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</code>, which you can verify through [https://github.com/bisq-network/bisq/commits?author=alejandrogarcia83 commits on GitHub].

The full public key is available [https://bisq.network/pubkey/E222AA02.asc here on the Bisq website].


= Bisq 1: Obtain signature files for installer files =

All Bisq releases are cryptographically signed by its maintainer. Users can ensure that nobody tampered with the release by verifying its signatures. It’s recommended to download the GPG key from an independent keyserver (such as [https://keys.openpgp.org/ keys.openpgp.org] or [https://keyserver.ubuntu.com/ keyserver.ubuntu.com]) to ensure that no adversary replaced the GPG keys and signatures on the release server.

Bisq 1 releases are signed by Alejandro García (alejandrogarcia83), Gabriel Bernard (gabernard), or Henrik Jannsen (HenrikJannsen). Here are the public key ids and fingerprints of the keys:

Alejandro García (public key id <code>0xF806F422E222AA02</code>): <code>B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</code>
 
Gabriel Bernard (public key id <code>0x6C8D14D84A133008</code>): <code>1655 3BA9 2694 95EE 53BB A33A 6C8D 14D8 4A13 3008</code>
 
Henrik Jannsen (public key id <code>0x02AA2BAE387C8307</code>): <code>B8A5 D214 ADFA A387 A14C 8BCF 02AA 2BAE 387C 8307</code>


== Windows ==


=== Download and install Gpg4win ===

Windows does not come with GPG software installed by default, so you will need to install it in order to verify Bisq’s installer files. You can get Gpg4win [https://www.gpg4win.org/ here]. Double-click the installer file and proceed to install with all default settings.


=== Import Signing Keys ===

Open Kleopatra (part of Gpg4win) and click on “Lookup on Server”.

[[File:Image_1.cleaned.png]]

Next type into the search field <code>alejandro.garcia@disroot.org</code> (or <code>0x387C8307</code> if verifying a release signed by Henrik Jannsen) and press on search. You’ll see the following output:

[[File:Image 2.cleaned.png]]

Press on “Details…” to see the key’s fingerprint and confirm that it is correct based on the list above.

[[File:Image 3.cleaned.png]]

After verifying that the fingerprint is correct, press on “Close” and press on “Import” to import the key.


=== Verify the signature of the binary you downloaded ===

With the <code>install-file.exe</code> and <code>signature-file.exe.asc</code> in the same directory, double-click on the <code>.exe.asc</code> file.

You should see a Kleopatra window pop up with a green progress bar that says “Verified .exe with .exe.asc”. The program will continue to say “The data could not be verified” in bold but you can disregard that message.

This means the installer file we downloaded is intact and as intended. You can proceed to install Bisq by double-clicking the .exe file.


== Mac and Linux ==


=== Import Signing Keys ===

To import the signing keys for Alejandro García and Henrik Jannsen, open a terminal and run:

<pre>gpg --receive-keys 0xF806F422E222AA02 0x02AA2BAE387C8307</pre>
Next you need to verify key’s fingerprint and tell GPG to trust the key. For example, to verify Alejandro's key, run:

<pre>gpg --edit-key 0xF806F422E222AA02</pre>
Then type:

<pre>fpr</pre>
Now ensure that you see the same output as here:

<pre>gpg> fpr
pub rsa4096/0xF806F422E222AA02 2022-09-28 Alejandro García <alejandro.garcia@disroot.org>
Primary key fingerprint: B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</pre>
If the fingerprint matches you can trust the key. To trust the key type:

<pre>trust</pre>
Now you’ll see following output:

<pre>gpg> trust
pub rsa4096/0xF806F422E222AA02
created: 2022-09-28 expires: 2026-10-03 usage: SC
trust: unknown validity: unknown
sub rsa4096/0xE7F08D07C72561D0
created: 2022-09-28 expires: 2026-10-03 usage: E
[ unknown] (1). Alejandro García <alejandro.garcia@disroot.org>

Please decide how far you trust this user to correctly verify other users' keys
(by looking at passports, checking fingerprints from different sources, etc.)

1 = I don't know or won't say
2 = I do NOT trust
3 = I trust marginally
4 = I trust fully
5 = I trust ultimately
m = back to the main menu

Your decision?</pre>
Type <code>5</code> to trust to the key and you’ll see following output:

<pre>Do you really want to set this key to ultimate trust? (y/N) </pre>
Now type <code>y</code> to confirm. Now you can quit by typing <code>quit</code>.


=== Verify the signature of the binary you downloaded ===

With the installer file and installer signature file in the same directory, run:

<pre>gpg --verify INSTALLER.asc INSTALLER</pre>
Where <code>INSTALLER.asc</code> is the filename of the <code>.asc</code> file you just downloaded.

You should see an output similar to this:

<pre>gpg: Signature made Fri 22 Nov 2024 07:42:50 PM UTC
gpg: using RSA key B493319106CC3D1F252E19CBF806F422E222AA02
gpg: checking the trustdb
gpg: marginals needed: 3 completes needed: 1 trust model: pgp
gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u
gpg: next trustdb check due at 2026-10-03
gpg: Good signature from "Alejandro García <alejandro.garcia@disroot.org>" [ultimate]</pre>

== Build from source ==

[https://github.com/bisq-network/bisq/blob/master/docs/build.md Building Bisq from source] requires only a single command once you have the correct JDK installed on your machine.

Finding and installing the correct JDK can sometimes be frustrating, so Bisq's developers have written scripts to make it easier:
* [https://github.com/bisq-network/bisq/blob/master/scripts/install_java.sh For Linux and macOS]
* [https://github.com/bisq-network/bisq/blob/master/scripts/install_java.bat For Windows]

== OS-specific install notes ==

=== macOS ===

Starting with version v1.9.6, we remove notarization from our build pipeline because of of the risk of Apple certification revocation (see https://github.com/bisq-network/bisq/discussions/6341). Unfortunately this will require extra steps when installing Bisq on macOS.

You will receive an error popup saying that Bisq ''is damaged and can't be opened. You should move it to the Trash''.

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 running already macOS Ventura (13.0+) you need to do following to be able to start Bisq:
* enter following command in Apple Terminal <code>sudo xattr -d com.apple.quarantine /Applications/Bisq.app</code>
* hit enter and you will be prompted to enter your password to be able to execute the command as super user

After running this successfully you should be able to start Bisq as always.

If this procedure still does not allow you to install Bisq, a last resort workaround is to install Bisq in a Linux Virtual Machine running on your system.

=== Windows ===

Starting with version v1.9.6, we remove the developer code signing because of the same reason as with Apple.

For Windows you just have to ignore the warning after you have verified the installation file yourself and proceed with the installation.

=== Linux (General) ===

Bisq works with a number of Linux distros, but not all desktop environments are supported.

These are all known compatible desktop environments. This is a growing list. If you find another compatible desktop, please inform us so it can be added.

* GNOME
* Mate
* Xfce
* KDE Plasma
* Cinnamon

Bisq might not work properly if you switch from the original desktop environment of your Linux distribution to a different one.

Note: users with discrete GPUs may encounter issues launching Bisq in some desktop environments.

=== Arch Linux ===

The Bisq [https://bisq.network/downloads/ downloads page] includes a link to the Arch User Repository (AUR) page for the [https://aur.archlinux.org/packages/bisq/ bisq package].

# From the command line, clone the repository from AUR.
# Then from the cloned directory, run <code>makepkg -si</code>. This will read the PKGBUILD file to download, verify, build, and install the various tools necessary to install Bisq.

If the version found on AUR is not up to date, you can read [[Fix_Arch_release]].

Please be advised: when you're using AUR, you're responsible for your own safety. Be sure to verify the PKGBUILD file.

=== Gentoo ===

Use <code>eselect repository enable booboo</code> to use the 'booboo' overlay which carries the binaries, and then emerge <code>bisq</code>

=== Tails ===

Please see [[Running Bisq on Tails]] for details on downloading, installing, and configuring Bisq on Tails.

=== Qubes ===

Please see [[Running Bisq on Qubes]] for a detailed Qubes setup guide.

== Update Bisq ==

Installing a new Bisq version will update Bisq. More details at [[Updating Bisq]].

[[Category:Use Cases]]

Downloading and installing

2025-12-23T15:49:10Z

Strayorigin: add key for henrik hotfix

To use Bisq, you must first '''[https://bisq.network/downloads/ download and install]''' it. Most exchanges are centralized exchanges running on servers controlled by the exchange. Bisq is decentralized, running only on the desktops of Bisq users.

Bisq manages offers to trade using a peer-to-peer network. This is a global network made of users who are also running Bisq on their own computers.

Centralized services are easy to monitor, block, and shut down, while peer-to-peer networks like BitTorrent, Bitcoin and Bisq are difficult to surveil, censor, shut down or hack.

All of this means that if you want to use the Bisq network, you must download and run the software on your own machine.

== Download Bisq ==

The most convenient way to install Bisq on your machine is from a pre-built install file from the [https://bisq.network/downloads/ Bisq website] or [https://github.com/bisq-network/bisq/releases/latest latest GitHub release].

There's also a community-maintained [https://snapcraft.io/bisq-desktop Snap package] for various Linux distributions.

{{Admonition_Note|See [[#OS-specific_install_notes|install notes for various Linux distributions below]].}}

You can download the installer for your operating system and install Bisq right away, but we strongly recommend that you [[ #Verify installer file | verify the integrity ]] of your installer file first.

'''If you have issues, please check the ''Known issues with installation'' section in [https://github.com/bisq-network/bisq/releases/latest release notes].'''

== Verify installer file ==

=== Bisq2 specific instructions ===

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

To import the key in Linux and MacOS:

<nowiki>curl https://bisq.network/pubkey/387C8307.asc | gpg --import </nowiki>

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)

To verify the installer against the signature:

<nowiki>gpg --digest-algo SHA256 --verify BINARY{.asc*,}</nowiki>

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

Any software that manages funds, signs transactions, and deals with highly sensitive data is a prime target for malware. Bisq does all three. Therefore, it is highly recommended that you verify the integrity of the installer file you use to install Bisq.

This verification is something that you should do for the initial Bisq install. After the initial install, you will be prompted to install updates through Bisq's interface. The Bisq software will verify the integrity of updates for you.

Bisq installer files are currently built and signed by Alejandro Garcia (alejandrogarcia83). His public key ID is <code>E222AA02</code> and fingerprint is <code>B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</code>, which you can verify through [https://github.com/bisq-network/bisq/commits?author=alejandrogarcia83 commits on GitHub].

The full public key is available [https://bisq.network/pubkey/E222AA02.asc here on the Bisq website].


= Bisq 1: Obtain signature files for installer files =

All Bisq releases are cryptographically signed by its maintainer. Users can ensure that nobody tampered with the release by verifying its signatures. It’s recommended to download the GPG key from an independent keyserver (such as [https://keys.openpgp.org/ keys.openpgp.org] or [https://keyserver.ubuntu.com/ keyserver.ubuntu.com]) to ensure that no adversary replaced the GPG keys and signatures on the release server.

Bisq 1 releases are signed by Alejandro García (alejandrogarcia83), Gabriel Bernard (gabernard), or Henrik Jannsen (HenrikJannsen). Here are the public key ids and fingerprints of the keys:

Alejandro García (public key id <code>0xF806F422E222AA02</code>): <code>B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</code>
 
Gabriel Bernard (public key id <code>0x6C8D14D84A133008</code>): <code>1655 3BA9 2694 95EE 53BB A33A 6C8D 14D8 4A13 3008</code>
 
Henrik Jannsen (public key id <code>0x02AA2BAE387C8307</code>): <code>B8A5 D214 ADFA A387 A14C 8BCF 02AA 2BAE 387C 8307</code>


== Windows ==


=== Download and install Gpg4win ===

Windows does not come with GPG software installed by default, so you will need to install it in order to verify Bisq’s installer files. You can get Gpg4win [https://www.gpg4win.org/ here]. Double-click the installer file and proceed to install with all default settings.


=== Import Alejandro García’s key ===

Open Kleopatra (part of Gpg4win) and click on “Lookup on Server”.

[[File:Image_1.cleaned.png]]

Next type into the search field <code>alejandro.garcia@disroot.org</code> and press on search. You’ll see the following output:

[[File:Image 2.cleaned.png]]

Press on “Details…” to see the key’s fingerprint and confirm that it is correct.

[[File:Image 3.cleaned.png]]

After verifying that the fingerprint is correct, press on “Close” and press on “Import” to import the key.


=== Verify the signature of the binary you downloaded ===

With the <code>install-file.exe</code> and <code>signature-file.exe.asc</code> in the same directory, double-click on the <code>.exe.asc</code> file.

You should see a Kleopatra window pop up with a green progress bar that says “Verified .exe with .exe.asc”. The program will continue to say “The data could not be verified” in bold but you can disregard that message.

This means the installer file we downloaded is intact and as intended. You can proceed to install Bisq by double-clicking the .exe file.


== Mac and Linux ==


=== Import Alejandro García’s key ===

To import Alejandro García’s open a terminal and run:

<pre>gpg --receive-keys 0xF806F422E222AA02</pre>
Next you need to verify key’s fingerprint and tell GPG to trust the key. First run:

<pre>gpg --edit-key 0xF806F422E222AA02</pre>
Then type:

<pre>fpr</pre>
Now ensure that you see the same output as here:

<pre>gpg> fpr
pub rsa4096/0xF806F422E222AA02 2022-09-28 Alejandro García <alejandro.garcia@disroot.org>
Primary key fingerprint: B493 3191 06CC 3D1F 252E 19CB F806 F422 E222 AA02</pre>
If the fingerprint matches you can trust the key. To trust the key type:

<pre>trust</pre>
Now you’ll see following output:

<pre>gpg> trust
pub rsa4096/0xF806F422E222AA02
created: 2022-09-28 expires: 2026-10-03 usage: SC
trust: unknown validity: unknown
sub rsa4096/0xE7F08D07C72561D0
created: 2022-09-28 expires: 2026-10-03 usage: E
[ unknown] (1). Alejandro García <alejandro.garcia@disroot.org>

Please decide how far you trust this user to correctly verify other users' keys
(by looking at passports, checking fingerprints from different sources, etc.)

1 = I don't know or won't say
2 = I do NOT trust
3 = I trust marginally
4 = I trust fully
5 = I trust ultimately
m = back to the main menu

Your decision?</pre>
Type <code>5</code> to trust to the key and you’ll see following output:

<pre>Do you really want to set this key to ultimate trust? (y/N) </pre>
Now type <code>y</code> to confirm. Now you can quit by typing <code>quit</code>.


=== Verify the signature of the binary you downloaded ===

With the installer file and installer signature file in the same directory, run:

<pre>gpg --verify INSTALLER.asc INSTALLER</pre>
Where <code>INSTALLER.asc</code> is the filename of the <code>.asc</code> file you just downloaded.

You should see an output similar to this:

<pre>gpg: Signature made Fri 22 Nov 2024 07:42:50 PM UTC
gpg: using RSA key B493319106CC3D1F252E19CBF806F422E222AA02
gpg: checking the trustdb
gpg: marginals needed: 3 completes needed: 1 trust model: pgp
gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u
gpg: next trustdb check due at 2026-10-03
gpg: Good signature from "Alejandro García <alejandro.garcia@disroot.org>" [ultimate]</pre>

== Build from source ==

[https://github.com/bisq-network/bisq/blob/master/docs/build.md Building Bisq from source] requires only a single command once you have the correct JDK installed on your machine.

Finding and installing the correct JDK can sometimes be frustrating, so Bisq's developers have written scripts to make it easier:
* [https://github.com/bisq-network/bisq/blob/master/scripts/install_java.sh For Linux and macOS]
* [https://github.com/bisq-network/bisq/blob/master/scripts/install_java.bat For Windows]

== OS-specific install notes ==

=== macOS ===

Starting with version v1.9.6, we remove notarization from our build pipeline because of of the risk of Apple certification revocation (see https://github.com/bisq-network/bisq/discussions/6341). Unfortunately this will require extra steps when installing Bisq on macOS.

You will receive an error popup saying that Bisq ''is damaged and can't be opened. You should move it to the Trash''.

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 running already macOS Ventura (13.0+) you need to do following to be able to start Bisq:
* enter following command in Apple Terminal <code>sudo xattr -d com.apple.quarantine /Applications/Bisq.app</code>
* hit enter and you will be prompted to enter your password to be able to execute the command as super user

After running this successfully you should be able to start Bisq as always.

If this procedure still does not allow you to install Bisq, a last resort workaround is to install Bisq in a Linux Virtual Machine running on your system.

=== Windows ===

Starting with version v1.9.6, we remove the developer code signing because of the same reason as with Apple.

For Windows you just have to ignore the warning after you have verified the installation file yourself and proceed with the installation.

=== Linux (General) ===

Bisq works with a number of Linux distros, but not all desktop environments are supported.

These are all known compatible desktop environments. This is a growing list. If you find another compatible desktop, please inform us so it can be added.

* GNOME
* Mate
* Xfce
* KDE Plasma
* Cinnamon

Bisq might not work properly if you switch from the original desktop environment of your Linux distribution to a different one.

Note: users with discrete GPUs may encounter issues launching Bisq in some desktop environments.

=== Arch Linux ===

The Bisq [https://bisq.network/downloads/ downloads page] includes a link to the Arch User Repository (AUR) page for the [https://aur.archlinux.org/packages/bisq/ bisq package].

# From the command line, clone the repository from AUR.
# Then from the cloned directory, run <code>makepkg -si</code>. This will read the PKGBUILD file to download, verify, build, and install the various tools necessary to install Bisq.

If the version found on AUR is not up to date, you can read [[Fix_Arch_release]].

Please be advised: when you're using AUR, you're responsible for your own safety. Be sure to verify the PKGBUILD file.

=== Gentoo ===

Use <code>eselect repository enable booboo</code> to use the 'booboo' overlay which carries the binaries, and then emerge <code>bisq</code>

=== Tails ===

Please see [[Running Bisq on Tails]] for details on downloading, installing, and configuring Bisq on Tails.

=== Qubes ===

Please see [[Running Bisq on Qubes]] for a detailed Qubes setup guide.

== Update Bisq ==

Installing a new Bisq version will update Bisq. More details at [[Updating Bisq]].

[[Category:Use Cases]]

User:Strayorigin/zelle-draft

2025-12-04T18:56:36Z

Strayorigin: Created page with "= Zelle = '''Zelle''' is a digital payments network that allows for instant transfers between U.S. bank accounts. It is one of the most popular payment methods for buying and..."

= Zelle =

'''Zelle''' is a digital payments network that allows for instant transfers between U.S. bank accounts. It is one of the most popular payment methods for buying and selling Bitcoin in the US on Bisq.

== At a Glance ==

{| class="wikitable"
! Currency
! Region
! Signing Required
! Initial Buy Limit
! Max Trade Limit
! Trade Duration
|-
| USD
| 🇺🇸 United States
| [[Account_limits|Yes]] (to lift limits)
| 0.002 BTC
| {{MaxTradeSizeBisq1}}
| Max 4 days (Usually minutes)
|}

== Account Setup ==

To use Zelle on Bisq, you must first ensure you are enrolled via your bank's official app.

{{Admonition_Warn|'''App Discontinued:''' The standalone Zelle app was discontinued in April 2025. You '''must''' use Zelle through a participating bank or credit union's mobile app or website.}}

# Go to '''Account''' > '''National Currency Accounts'''.
# Select '''Add New Account''' and choose '''Zelle'''.
# '''Account Name:''' Enter a label for your internal use (e.g., "Chase Zelle").
# '''Full Name:''' Enter your name exactly as it appears on your bank account.
# '''Email or Mobile:''' Enter the email address OR U.S. mobile number registered with Zelle.

{{Admonition_Warn|'''Name Matching:''' The name on your Bisq account MUST match the name your bank shows to recipients. If these do not match, the seller cannot verify the payment.}}

== Trading Rules ==

While the general trading process follows the standard [[Trading|Bisq Trading Guide]], Zelle has specific requirements:

=== Payment Reference ===
* '''Buyers:''' Leave the "Memo" or "Note" field '''BLANK'''.
** If a note is absolutely required by your bank, use your name.
** '''NEVER''' write "Bitcoin," "Bisq," or the Trade ID.
* '''Sellers:''' Expect the payment to arrive with no memo or just the buyer's name.

=== Sending the Payment ===
* '''Buyers:''' Double-check the recipient's **Email** or **Phone Number** matches the Bisq trade details exactly.
* '''Sellers:''' Verify the money is **available** in your balance before clicking "Payment Received." Do not trust email notifications alone; log in to your bank to check.

== Risks, Fees & Limits ==

=== Limits ===
* '''Bisq Limits:''' Trade sizes are capped at {{MaxTradeSizeBisq1}}. New Zelle accounts are limited to '''0.002 BTC''' until [[Account_limits|signed]].
* '''Bank Limits:''' Most banks have daily/weekly Zelle limits (e.g., $500/day or $2,000/month). '''Check your bank's limit''' before taking a large trade.

=== The "Bank Freeze" Risk ===
Banks often flag Zelle transfers to new recipients as "suspicious activity."
* '''If your payment is blocked:''' Do '''not''' try to pay from a friend's account. Open a support ticket (Ctrl+O) immediately.
* '''Prevention:''' Some traders recommend sending a small "test" transaction to a friend first if you have never used Zelle before.

=== Fees ===
* Zelle itself does not charge fees, but your bank might.

== External Resources ==

* [https://www.zellepay.com/faq/top-zelle-questions Official Zelle FAQ]
* [https://www.zellepay.com/get-started List of Participating Banks]

User:Strayorigin/sepa instant-draft

2025-12-04T18:49:08Z

Strayorigin: Created page with "= SEPA Instant = '''SEPA Instant''' (SCT Inst) is an evolution of the standard SEPA scheme that allows for euro transactions to be settled in seconds, 24/7/365. It is increas..."

= SEPA Instant =

'''SEPA Instant''' (SCT Inst) is an evolution of the standard SEPA scheme that allows for euro transactions to be settled in seconds, 24/7/365. It is increasingly popular on Bisq for faster trade settlement.

== At a Glance ==

{| class="wikitable"
! Currency
! Region
! Signing Required
! Initial Buy Limit
! Max Trade Limit
! Trade Duration
|-
| EUR
| 🇪🇺 Europe (EU + select countries)
| [[Account_limits|Yes]] (to lift limits)
| {{MaxTradeSizeUnsigned}}
| {{MaxTradeSizeBisq1}}
| Max 1 day (Usually < 1 minute)
|}

== Account Setup ==

To use SEPA Instant on Bisq, you must configure your account settings.

# Go to '''Account''' > '''National Currency Accounts'''.
# Select '''Add New Account''' and choose '''SEPA Instant'''.
# '''Account Name:''' Enter a label for your internal use.
# '''IBAN / BIC:''' Enter your International Bank Account Number and Bank Identifier Code.
# '''Name:''' Enter the account owner's name exactly as it appears on your bank statement.

{{Admonition_Warn|'''Check Capability:''' Ensure your bank supports SEPA Instant for '''both''' sending and receiving. Some banks only support one direction. If your bank cannot receive instantly, trades may fail to settle within the 1-day limit.}}

== Trading Rules ==

While the general trading process follows the standard [[Trading|Bisq Trading Guide]], SEPA Instant has specific requirements:

=== Payment Reference ===
* '''Buyers:''' When sending payment, leave the reference field '''BLANK'''.
** If a reference is mandatory, use your own name.
** '''NEVER''' write "Bitcoin," "Bisq," or the Trade ID.
* '''Sellers:''' Expect the incoming payment to have a blank reference or the buyer's name.

=== Confirmation ===
* '''Buyers:''' Mark payment as "Started" immediately after the funds leave your account.
* '''Sellers:''' Verify funds have actually arrived before clicking "Payment Received."

== Risks, Fees & Limits ==

=== The "Fallback" Risk ===
Occasionally, a payment sent as "SEPA Instant" may fail to process instantly and revert to a standard SEPA transfer (taking 1-2 days).
* '''If this happens:''' The trade duration (1 day) may expire before funds arrive.
* '''Mediation Rule:''' If a dispute opens due to delay, mediators will check if both banks are technically capable of SEPA Instant. If the buyer can prove they sent the payment within 24 hours, no penalty is usually applied for the bank's delay.

=== Limits & Fees ===
* '''Bisq Limits:''' {{MaxTradeSizeUnsigned}} (Unsigned) / {{MaxTradeSizeBisq1}} (Signed).
* '''Bank Limits:''' Many banks cap Instant transfers lower than standard transfers (e.g., €15,000 or €100,000). Check your specific bank's limit.
* '''Fees:''' Usually free, though some banks charge a premium for "Instant" speed.

== Dispute Resolution ==

If a trade goes to mediation:
* '''Buyers''' must provide a PDF bank statement showing the timestamp of the transfer.
* '''Sellers''' must provide proof of non-receipt or late receipt.
* '''Mediators''' may verify bank compatibility using the [https://www.europeanpaymentscouncil.eu/sites/default/files/participants_export/sct_inst/sct_inst.pdf European Payments Council Register].

== External Resources ==

* [https://www.europeanpaymentscouncil.eu/what-we-do/sepa-instant-credit-transfer/ SEPA Instant - European Payments Council]
* [https://www.europeanpaymentscouncil.eu/what-we-do/be-involved/register-participants/registers-participants-sepa-payment-schemes List of Participating Banks]

User:Strayorigin/sepa-draft

2025-12-04T18:39:53Z

Strayorigin: Created page with "= SEPA = '''SEPA''' (Single Euro Payments Area) is a payment-integration initiative of the European Union for simplification of bank transfers denominated in euro. It is the..."

= SEPA =

'''SEPA''' (Single Euro Payments Area) is a payment-integration initiative of the European Union for simplification of bank transfers denominated in euro. It is the most common payment method for buying and selling Bitcoin in Europe on Bisq.

== At a Glance ==

{| class="wikitable"
! Currency
! Region
! Signing Required
! Initial Buy Limit
! Max Trade Limit
! Trade Duration
|-
| EUR
| 🇪🇺 Europe (EU + select countries)
| [[Account_limits|Yes]] (to lift limits)
| {{MaxTradeSizeUnsigned}}
| {{MaxTradeSizeBisq1}}
| Max 6 days (Usually < 2 days)
|}

== Account Setup ==

To use SEPA on Bisq, you must first configure your account settings.

# Go to '''Account''' > '''National Currency Accounts'''.
# Select '''Add New Account''' and choose '''SEPA'''.
# '''Account Name:''' Enter a label for your internal use (e.g., "My Deutsche Bank").
# '''IBAN / BIC:''' Enter your International Bank Account Number and Bank Identifier Code.
# '''Name:''' Enter the account owner's name exactly as it appears on your bank statement.

{{Admonition_Warn|title=Revolut Restrictions|text=Revolut SEPA accounts are '''not allowed''' on Bisq. This is due to a high rate of rejected transfers from counterparty banks when dealing with Revolut.}}

== Trading Rules ==

While the general trading process follows the standard [[Trading|Bisq Trading Guide]], SEPA has specific requirements:

=== Payment Reference ===
* '''Buyers:''' When sending the fiat payment from your bank, you must leave the payment reference/description '''BLANK'''.
** If your bank requires a reference, use your own name or account number.
** '''NEVER''' write "Bitcoin," "Bisq," or the Trade ID.
* '''Sellers:''' Expect the incoming payment to have a blank reference or simply the buyer's name.

=== Confirmation ===
* '''Buyers:''' Mark the payment as "Started" in Bisq immediately after sending the funds from your banking app.
* '''Sellers:''' Only click "Payment Received" once the funds are actually settled in your bank account, not just "pending."

== Risks, Fees & Limits ==

=== Limits ===
* '''Bisq Limits:''' Trade sizes are capped at {{MaxTradeSizeBisq1}}. New accounts are limited to {{MaxTradeSizeUnsigned}} until the account is [[Account_limits|signed]].
* '''Bank Limits:''' Your bank may have its own daily transfer limits (commonly €50,000 for SEPA). Check your bank's limit before accepting a large trade.

=== Fees ===
* SEPA transfers are generally free.
* Some banks may charge a small fee for international SEPA transfers (e.g., sending from France to Germany), though this is becoming rare.

== Dispute Resolution ==

If a trade goes to mediation:
* '''Buyers''' must provide a PDF bank statement showing the outgoing transfer to the seller's details.
* '''Sellers''' may be required to provide a PDF bank statement showing non-receipt of funds.
* '''Mediators''' will verify that the name on the bank account matches the name provided in the Bisq account details.

== External Resources ==

* [https://en.wikipedia.org/wiki/Single_Euro_Payments_Area Wikipedia: SEPA]
* [https://www.europeanpaymentscouncil.eu/ European Payments Council]

Finding your mediator

2025-11-18T17:13:30Z

Strayorigin: remove luis3672 bisq 2 tor address and added suddenwhipvapor's bisq 2 tor address

Here is a list of current Bisq mediators and their onion addresses, as well as how you can find the mediator for a specific Bisq trade.

If you need to find your arbitrator see [[Finding your arbitrator|here]].

__TOC__

= Get in touch with your mediator =

For open trades, you should be able to get in touch with your mediator through Bisq mediation chat itself.

If you cannot get in touch with your mediator on Bisq for 48 hours (sometimes Bisq message system fails), or the issue needs urgent attention, you can get in touch with them on the [[Matrix bisq.chat]] group. Their Matrix handles and onion addresses are displayed in the headline for the #support channel as well.

= How to find the mediator for a trade =

== In Bisq 1 ==

=== System message ===

Go to 'Support > Mediation' tab since mediation begins.

[[File:Finding mediator message system.png|400px|thumb|none]]

=== View contract in JSON ===

Alternatively, you can look for your mediator since the trade starts:

# Go to <code>Portfolio > Open Trades</code>, <code>Portfolio > History</code>, or <code>Portfolio > Failed Trades</code> (depending on the status of your trade)
# Click the <code>i</code> icon next to the trade ID of the trade in question (it's on the very left in the first column)
# In the pop-up that appears, toward the bottom, click <code>View Contract in JSON Format</code>.
# Ignore the <code>"mediatorNodeAddresses"</code> field, as this is the list of all active mediators when the trade started.
# Scroll down and you'll find <code>"mediatorNodeAddress"</code> field with a single <code>"hostName"</code> for the onion address.

This is the onion address of the mediator for your trade.

== In Bisq 2 ==

=== Bisq Easy ===
The mediator for a Bisq Easy trade can be found by going to the "My Open Trades" tab. Trade details, including the assigned mediator, are displayed for each open trade.

= Matrix and onion addresses =

{| class="wikitable"
! Mediator
! TorV3 Address
! GitHub Handle
! Matrix Handle
|-
| luis3672
| aguejpkhhl67nbtifvekfjvlcyagudi6d2apalcwxw7fl5n7qm2ll5id.onion:9999
| [https://github.com/luis3672 luis3672]
| [[Matrix bisq.chat | @luis3672:matrix.org]]
|-
| pazza83
| e2whe6q34o5mnta7b2rai4uspmj5wxhnhvipjjohicx6sgekw47apjqd.onion:9999
| [https://github.com/pazza83 pazza83]
| [[Matrix bisq.chat | @pazza83:matrix.org]]
|-
| solomon1923
| 3fatfssmx5h4tx4vqoty6t3skqqg33djkibs3jmyf6fqlsmwzjjhluqd.onion:19610
| [https://github.com/solomon1923 solomon1923]
| [[Matrix bisq.chat | @solomon1923:matrix.org]]
|-
| suddenwhipvapor
| 5wmuzi76l4ogbdh6ahvdafzlebk4c3sp3q5njhz5h5qa5fwbalexa7id.onion:9999 (Bisq 1) 3rpfdd5z3mem4ucmk7ada3fgzn2escdxcg4cqp5ailvpz3yeht3gacyd.onion:27368 (Bisq 2)
| [https://github.com/suddenwhipvapor suddenwhipvapor]
| [[Matrix bisq.chat | @suddenwhipvapor:matrix.org]]
|}

[[Category:Use Cases]]

US Postal Money Order

2025-08-26T16:32:11Z

Strayorigin:

'''US Postal Money Orders''' (USPMO) are one of the most private payment methods available on Bisq. Before starting a trade, please be aware of the specific parameters for this payment method:

* '''Region:''' United States only
* '''Maximum Trade Period:''' 8 days
* '''Maximum Trade Size:''' 0.0625 BTC

This guide provides a complete overview of how to safely and privately use this payment method for buying and selling bitcoin on Bisq.

__TOC__

= Critical Trading Requirements =

Before you create or take an offer using US Postal Money Orders, you '''must''' understand and agree to the following rules. Failure to comply will result in losing any trade dispute.

{{Admonition_Note |
* '''For BTC Buyers:''' You must write the BTC Seller’s name in both the "From" (Payer) and "To" (Payee) fields on the money order.
* '''Proof is Required:''' BTC buyers must take a high-resolution photo of the filled-out USPMO and another photo of the stamped envelope showing proof of tracking.
* '''Use Tracking:''' All USPMOs must be sent with a service that provides delivery confirmation (e.g., USPS Tracking).
* '''Burden of Proof:''' In a dispute, the sender (BTC buyer) bears 100% of the responsibility to provide the required photos and tracking information to the mediator. This includes the USPMO Serial Number, Post Office Number, and dollar amount.

If you are not prepared to follow these rules, do not trade using USPMO on Bisq.}}

= A Step-by-Step Guide to Trading with USPMO =

== Step 1: Set Up Your Payment Account ==

First, you need to [[Create_a_payment_account|set up a USPMO payment account]] in Bisq. Your setup will differ depending on whether you are buying or selling bitcoin. For maximum privacy, consider creating two separate accounts: one for buying and one for selling.

=== For Buying Bitcoin (Maximizing Privacy) ===
When buying bitcoin, the USPMO is a bearer instrument. This means the details of the sender are less important, allowing for greater privacy.

* '''Name:''' It is acceptable to use a pseudonym or a randomly generated name.
* '''Address:''' You must provide a return address. If the envelope is returned, it will go to this address. You have two main options:
** '''Option 1 (Less Secure):''' Use a random address. Be aware that if your mail is returned, the money order will likely be lost permanently.
** '''Option 2 (More Secure):''' Use a trusted secondary address, such as that of a friend, neighbor, or local business that you can access. This increases the chance of recovering a returned envelope.

'''Note:''' Using non-authentic information in a payment account is generally against Bisq trade protocol. This is a rare, accepted exception for the purpose of privacy when buying BTC with USPMO.

=== For Selling Bitcoin (Receiving Payment) ===
When selling bitcoin, you must use your real information to receive and cash the money order.

* '''Name:''' Must be your real, legal name as it appears on your photo ID.
* '''Address:''' Must be the correct and valid mailing address where you want to receive the envelope.

== Step 2: Purchase the Money Order ==

After taking an offer to buy bitcoin, go to any US Post Office location to purchase the USPMO.

* '''Amount Limit:''' You can send up to '''$1,000''' in a single money order. For larger trades, you will need to purchase multiple money orders.
* '''Payment Method:'''
** It is '''highly recommended''' to use cash. Paying with a debit card creates a data trail that compromises the privacy benefits of using a money order.
** Debit cards are accepted, but '''credit cards are not'''.
* '''Fees:''' You will pay the dollar value of the money order plus an issuing fee. As of August 2025, the fees are:
{| class="wikitable"
|+ USPMO Issuing Fees
|-
! Dollar Amount
! Fee
|-
| $0.01 to $500.00
| $2.55
|-
| $500.01 to $1,000.00
| $3.60
|-
| Postal Military Money Orders
| $0.84
|}
* '''Keep Your Receipt:''' The receipt is essential for tracking the money order and is critical evidence if a trade dispute arises. Keep it in a safe place until the trade is successfully completed.
* '''Privacy Tip:''' For maximum privacy, consider filling out the money order details away from the post office and its cameras.

== Step 3: Send the Money Order ==

Follow the critical requirements listed at the top of this article. Address the envelope to the seller and prepare it for mailing.

* '''Add a Privacy Layer:''' Fold a blank sheet of paper and place the money order inside it before putting it in the envelope. This makes it harder to see the contents when held up to a light.
* '''Buy Tracking:''' You must pay for a mailing option that includes tracking or delivery confirmation.
* '''Confirm in Bisq:''' Once you have mailed the envelope, click the '''Payment started''' button in your Bisq client. This is a crucial step that notifies the seller and continues the trade process.

<gallery widths="300px" heights="200px">
File:Uspmo-1.jpg|Step 1: Open the folded paper to create a privacy layer.
File:Uspmo-2.jpg|Step 2: Place the money order inside the folded sheet.
File:Uspmo-3.jpg|Step 3: Insert the sheet into the envelope and seal.
</gallery>
 

== Step 4: Verify the Money Order (How to Spot a Fake) ==

For the BTC seller, it is crucial to verify that a received money order is authentic before releasing the bitcoin. Real postal money orders have specific security features to prevent fraud. There are currently four valid designs in circulation.

When you receive a money order, hold it up to the light to check for the security features associated with its design.

=== Red, Blue, & Red Postal Money Order (July 2025) ===
[[File:Red, Blue, & Red Postal Money Order (July 2025).jpeg|thumb|left|350px|Red, Blue, & Red Design (July 2025)]]
* A watermark image of a Pony Express® rider is visible on the left side.
* A watermark of the words "United States Postal Service" appears in a box on the right side.
* An embedded security thread runs from top to bottom, revealing the letters "USPS" in alternating directions.
* A QR Code that links to the USPS "Check Money Order Status" tool.
 

=== Red, Blue, & Red Postal Money Order (February 2025) ===
[[File:Red, Blue, & Red Postal Money Order (February 2025).jpeg|thumb|left|350px|Red, Blue, & Red Design (February 2025)]]
* A watermark image of a Pony Express® rider is visible on the left side.
* A watermark of the words "United States Postal Service" appears in a box on the right side.
* An embedded security thread runs from top to bottom, revealing the letters "USPS" in alternating directions.
* A QR Code that links to the USPS "Check Money Order Status" tool.
 

=== Green & Purple Postal Money Order (Point-of-Sale Version) ===
[[File:Green & Purple Postal Money Order (Point-of-Sale Version).jpeg|thumb|left|350px|Green & Purple Design (Point-of-Sale)]]
* A watermark of the U.S. Mail eagle (1970 logo) is visible in the center.
* Watermarks of Ben Franklin repeat from top to bottom on the left side.
* A vertical, multicolored security thread with "USPS" is woven in and out of the paper to the right of the Franklin watermarks.
 

=== Green & Purple Postal Money Order (Paymaster Version) ===
[[File:Green & Purple Postal Money Order (Paymaster Version).jpeg|thumb|left|350px|Green & Purple Design (Paymaster)]]
* A watermark of the U.S. Mail eagle (1970 logo) is visible in the center.
* Watermarks of Ben Franklin repeat from top to bottom on the left side.
* A vertical, multicolored security thread with "USPS" is woven in and out of the paper to the right of the Franklin watermarks.
 

== Step 5: Redeem the Money Order ==

Once you have received and verified the USPMO, you have two main options for redemption.

=== Cashing It Out ===
You can redeem a USPMO for cash at any post office.

* You must present a valid photo ID that matches the name written in the "To" field.
* Post offices may have limited cash on hand. For larger amounts (e.g., $1,000), they may not have enough cash in a single drawer. You may need to visit different locations or at different times.

=== Exchanging for a New USPMO ===
You can exchange a USPMO you received for a new, blank USPMO in your name. This is useful if you want to use the funds to pay bills or send money elsewhere without depositing it into a bank account. Some cashiers may be unfamiliar with this process, but it is allowed. If you encounter resistance, politely ask for a manager.

US Postal Money Order

2025-08-26T16:19:52Z

2025-07-06T16:50:52Z

Strayorigin: /* Matrix and onion addresses */ typo

Here is a list of current Bisq arbitrators and their onion addresses, as well as how you can find the arbitrator for a specific Bisq trade.

If you need to find your mediator see [[Finding your mediator|here]].

__TOC__

= Get in touch with your arbitrator =

For open trades, you should be able to get in touch with your arbitrator through Bisq arbitration chat itself.

If you cannot get in touch with your arbitrator on Bisq for 72 hours (sometimes Bisq message system fails), or the issue needs urgent attention, you can get in touch with them on the [[Matrix bisq.chat]] group. Their Matrix handles and onion addresses are displayed in the headline for the #support channel as well.

= How to find the arbitrator for a trade =

== In Bisq 1 ==

=== System message ===

Go to 'Support > Arbitration' tab since arbitration begins.

=== View contract in JSON ===

Alternatively, you can look for your arbitrator since the trade starts:

# Go to <code>Portfolio > Open Trades</code>, <code>Portfolio > History</code>, or <code>Portfolio > Failed Trades</code> (depending on the status of your trade)
# Click the <code>i</code> icon next to the trade ID of the trade in question (it's on the very left in the first column)
# In the pop-up that appears, toward the bottom, click <code>View Contract in JSON Format</code>.
# Scroll down and you'll find <code>"refundAgentNodeAddress"</code> it is just below <code>"lockTime"</code> after the refundAgentNodeAddress you will see your arbitrators's onion address.

This is the onion address of the arbitrator for your trade.

= Matrix and onion addresses =

{| class="wikitable"
! Arbitrator
! TorV3 Address
! GitHub Handle
! Matrix Handle
|-
| refundagent2
| 3z5jnirlccgxzoxc6zwkcgwj66bugvqplzf6z2iyd5oxifiaorhnanqd.onion:9999
| [https://github.com/refund-agent2 refund-agent2]
| [[Matrix bisq.chat | @refundagent2:bitcoinist.org]]
|-
| refundagent3
| yjlcxr6rho6zkpecwdp3vlpduzcl7i6cbgaquvxqmvsbw3dnheus6qad.onion:9999
| [https://github.com/refundagent3 refundagent3]
| [[Matrix bisq.chat | @refundagent3:imagisphe.re]]
|}

[[Category:Use Cases]]

Revolut

2025-06-26T13:55:32Z

Strayorigin: fixed minor display issues

'''Revolut''' is a payment method that offers banking services, including instant Revolut-to-Revolut transfers. It is available in [https://www.revolut.com/help/getting-started/verifying-identity/what-countries-are-supported various countries] with [https://www.revolut.com/help/getting-started/adding-money-to-revolut various currencies], making it a popular option for EUR trades on Bisq and a good possibility for other international payments.

{{Admonition_Warn|'''Revolut-to-Revolut ONLY:''' Due to recurring issues with traditional bank transfers, you '''cannot''' use a Revolut IBAN for a SEPA trade or Revolut's bank details for a Faster Payments trade on Bisq. This payment method is strictly for instant transfers between two Revolut users.}}

{{Admonition_Note|'''Version Context:''' The details on this page, particularly regarding account signing, apply to trading on '''[[Bisq 1|Bisq v1]]'''.}}

__TOC__

== Revolut Characteristics ==

* '''Availability:''' Global (supports various currencies, heavily used in EUR market).
* '''Maximum Trade Duration:''' 1 day.
* '''Maximum BTC Limit (for a fully-signed account):''' 0.0625 BTC.
* '''[[Account_limits|Account Signing]] Required:''' Yes.

== Trading Limits ==
Because Revolut is a higher-risk payment method, it is subject to '''[[Account_limits|account signing]]''' to raise trade limits. Your selling limit is unaffected and is always the maximum for the payment method.

* '''Unsigned Accounts:''' When you first create a Revolut account in Bisq, your buy limit is restricted to '''0.002 BTC'''. This limit remains until the account is signed.
* '''Signed Accounts:''' To get your account signed, you must successfully complete a trade with a peer whose own account has been signed for at least 30 days. After your account is signed, your buy limit increases over time:
** '''First 30 days after signing:''' Your buy limit remains at '''0.002 BTC'''.
** '''30-60 days after signing:''' Your buy limit increases to 50% of the maximum ('''0.0312 BTC''').
** '''After 60 days of signing:''' Your buy limit increases to the full 100% ('''0.0625 BTC''').

== Setup ==

=== 1. Find Your Revolut Username (Revtag) ===

First, you need to find your Revolut username, which Revolut calls a '''Revtag'''. This is what your trading peer will use to pay you.

To find your Revtag in the current Revolut app:
# Open the Revolut app to the main '''Home''' screen.
# Tap on your '''profile icon or initials''' in the '''top-left corner'''.
# On your Profile screen, your Revtag is displayed under your name, formatted like `<code>@username</code>`.
# '''Revtags are case-sensitive.''' Note it down exactly as it appears in the Revolut app, '''including the `@` symbol'''.

=== 2. Create the Account in Bisq ===

{| class="wikitable" style="background-color: transparent; border: none;"
| style="vertical-align:top; border: none; padding: 0 1em 0 0;" |
To create a Revolut [[Create_a_payment_account|payment account]] in Bisq, you primarily need to input your '''Revolut username (Revtag)''' into the "User name" field. Be sure to enter the full Revtag exactly as it appears in your Revolut app, '''including the `@` symbol'''. You may also need to select the currencies you wish to trade.

Remember that ''none'' of this information can be modified after an account is created. [[Account_limits#Account_signing|Account signing]] data is tied to these details and can be lost if your data directory is not [[Backing_up_application_data#Back_up_payment_accounts|properly backed up]].
| style="vertical-align:top; border: none; padding: 0;" |
[[File:Revolut create account.png|thumb|400px|right|Setting up a Revolut account in Bisq v1.]]
|}

== Trading Process ==

=== Buying BTC with Revolut ===
# Make or take an offer to buy BTC using Revolut. If your account is unsigned, look for offers from sellers with a signed-account badge to get your account signed.
# Once the trade starts and the deposit confirms, view the seller's Revolut details (their Revtag) in the Bisq trade screen.
# Log in to your Revolut app and send the exact payment amount to the seller's Revtag. Revolut's help center explains [https://www.revolut.com/help/transfers/outbound-transfers/sending-money-to-another-revolut-user/how-do-i-pay-other-revolut-users/ how to pay other Revolut users].
# After sending the payment, click the '''Payment started''' button in Bisq.

=== Selling BTC with Revolut ===
# Make or take an offer to sell BTC using Revolut.
# Once the trade starts and the deposit confirms, the buyer will see your Revolut Revtag.
# Wait for the buyer to send the payment and click "Payment started" in Bisq.
# Log in to your Revolut account and '''verify''' you have received the correct amount.
# '''Verify''' the payment came from a sender whose name '''matches''' the BTC Buyer's name shown in the Bisq trade details. ''(Note: If the names do not match, do not confirm the payment. Open [[Dispute_Resolution_in_Bisq_1|dispute resolution]] immediately.)''
# Once payment is fully verified, click '''Confirm payment receipt''' in Bisq to release the BTC.

== Troubleshooting & Disputes ==

If you have trouble finding your trading peer by their Revtag, check Revolut's troubleshooting article: [https://www.revolut.com/help/transfers/outbound-transfers/sending-money-to-another-revolut-user/i-cant-find-my-friend-on-revolut/ I can't find my friend on Revolut]. A common reason is that you or your peer may need to enable the "Payments with friends" option in privacy settings.

For any other trade issues (e.g., payment not received, wrong amount), follow the [[Dispute_Resolution_in_Bisq_1|dispute resolution]] process, which may involve a [[Mediator]].

[[Category:Payment methods]]
[[Category:Guides]]

File:Revolut create account.png

2025-06-26T13:10:56Z

Strayorigin: Strayorigin uploaded a new version of File:Revolut create account.png

== Summary ==
Screenshot of Create Account for national currency Revolut payment method.

Revolut

2025-06-26T13:08:34Z

Strayorigin: Update Revtag instructions, account setup fields & signing limits to match current info; improve structure & links.

'''Revolut''' is a payment method that offers banking services, including instant Revolut-to-Revolut transfers. It is available in [https://www.revolut.com/help/getting-started/verifying-identity/what-countries-are-supported various countries] with [https://www.revolut.com/help/getting-started/adding-money-to-revolut various currencies], making it a popular option for EUR trades on Bisq and a good possibility for other international payments.

{{Admonition_Warn|'''Revolut-to-Revolut ONLY:''' Due to recurring issues with traditional bank transfers, you '''cannot''' use a Revolut IBAN for a SEPA trade or Revolut's bank details for a Faster Payments trade on Bisq. This payment method is strictly for instant transfers between two Revolut users.}}

{{Admonition_Note|'''Version Context:''' The details on this page, particularly regarding account signing, apply to trading on '''[[Bisq 1|Bisq v1]]'''.}}

__TOC__

== Revolut Characteristics ==

* '''Availability:''' Global (supports various currencies, heavily used in EUR market).
* '''Maximum Trade Duration:''' 1 day.
* '''Maximum BTC Limit (for a fully-signed account):''' 0.0625 BTC.
* '''[[Account_limits|Account Signing]] Required:''' Yes.

== Trading Limits ==
Because Revolut is a higher-risk payment method, it is subject to '''[[Account_limits|account signing]]''' to raise trade limits. Your selling limit is unaffected and is always the maximum for the payment method.

* '''Unsigned Accounts:''' When you first create a Revolut account in Bisq, your buy limit is restricted to '''0.002 BTC'''. This limit remains until the account is signed.
* '''Signed Accounts:''' To get your account signed, you must successfully complete a trade with a peer whose own account has been signed for at least 30 days. After your account is signed, your buy limit increases over time:
** '''First 30 days after signing:''' Your buy limit remains at '''0.002 BTC'''.
** '''30-60 days after signing:''' Your buy limit increases to 50% of the maximum ('''0.0312 BTC''').
** '''After 60 days of signing:''' Your buy limit increases to the full 100% ('''0.0625 BTC''').

== Setup ==

=== 1. Find Your Revolut Username (Revtag) ===

First, you need to find your Revolut username, which Revolut calls a '''Revtag'''. This is what your trading peer will use to pay you.

To find your Revtag in the current Revolut app:
# Open the Revolut app to the main '''Home''' screen.
# Tap on your '''profile icon or initials''' in the '''top-left corner'''.
# On your Profile screen, your Revtag is displayed under your name, formatted like `<code>@username</code>`.
# '''Revtags are case-sensitive.''' Note it down exactly as it appears in the Revolut app.

=== 2. Create the Account in Bisq ===

[[File:Revolut create account.png|thumb|400px|right|Setting up a Revolut account in Bisq v1.]]

To create a Revolut [[Create_a_payment_account|payment account]] in Bisq, you primarily need to input your '''Revolut username (Revtag)''' as found in the previous step. You may also need to select the currencies you wish to trade.

Remember that ''none'' of this information can be modified after an account is created. [[Account_limits#Account_signing|Account signing]] data is tied to these details and can be lost if your data directory is not [[Backing_up_application_data#Back_up_payment_accounts|properly backed up]].

== Trading Process ==

=== Buying BTC with Revolut ===
# Make or take an offer to buy BTC using Revolut. If your account is unsigned, look for offers from sellers with a signed-account badge to get your account signed.
# Once the trade starts and the deposit confirms, view the seller's Revolut details (their Revtag) in the Bisq trade screen.
# Log in to your Revolut app and send the exact payment amount to the seller's Revtag. Revolut's help center explains [https://www.revolut.com/help/transfers/outbound-transfers/sending-money-to-another-revolut-user/how-do-i-pay-other-revolut-users/ how to pay other Revolut users].
# After sending the payment, click the '''Payment started''' button in Bisq.

=== Selling BTC with Revolut ===
# Make or take an offer to sell BTC using Revolut.
# Once the trade starts and the deposit confirms, the buyer will see your Revolut Revtag.
# Wait for the buyer to send the payment and click "Payment started" in Bisq.
# Log in to your Revolut account and '''verify''' you have received the correct amount.
# '''Verify''' the payment came from a sender whose name '''matches''' the BTC Buyer's name shown in the Bisq trade details.
{{Admonition_Warn|If the names do not match, do not confirm the payment. Open [[Dispute_Resolution_in_Bisq_1|dispute resolution]] immediately.}}
# Once payment is fully verified, click '''Confirm payment receipt''' in Bisq to release the BTC.

== Troubleshooting & Disputes ==

If you have trouble finding your trading peer by their Revtag, check Revolut's troubleshooting article: [https://www.revolut.com/help/transfers/outbound-transfers/sending-money-to-another-revolut-user/i-cant-find-my-friend-on-revolut/ I can't find my friend on Revolut]. A common reason is that you or your peer may need to enable the "Payments with friends" option in privacy settings.

For any other trade issues (e.g., payment not received, wrong amount), follow the [[Dispute_Resolution_in_Bisq_1|dispute resolution]] process, which may involve a [[Mediator]].

[[Category:Payment methods]]
[[Category:Guides]]

Revolut

2025-06-26T12:24:50Z

Strayorigin: Cleanup and update content: Revise instructions for finding Revtag to match current app, fix broken external links, add v1 context note, and improve formatting.

Contributor checklist

2025-05-12T02:39:45Z

Strayorigin: Remove mailing list link; verify YouTube link; add categories & minor cleanup.

If you're interested in contributing to Bisq, welcome! This '''contributor checklist''' will get you plugged in and productive as quickly as possible.

Bisq is free and open source software, but contributing is not just about writing code. A contributor is any individual who works to improve and add value to the Bisq network and its users.

This can mean anything from fixing typos in documentation, to providing support, to testing out new growth strategies, to implementing new Bisq features and everything in between. All such contributions are eligible for [[compensation]] from the Bisq DAO.

__TOC__

== Basics ==

Suggestions below are in no particular order. Disregard developer-oriented items if you're not looking to contribute code.

# Join the [https://bisq.chat Matrix space].
# Introduce yourself in the <code>general</code> room. Say a bit about your skills and interests. This will help others point you in the right direction.
# Explore the other rooms on Matrix, and join the ones that are of interest to you. For a start, consider joining <code>dev</code> (if you’re a developer) and <code>growth</code>.
# Watch the following repositories on GitHub: [https://github.com/bisq-network/bisq core software], [https://github.com/bisq-network/bisq/discussions discussions], [https://github.com/bisq-network/proposals proposals], [https://github.com/bisq-network/growth growth], [https://github.com/bisq-network/roles roles] and [https://github.com/bisq-network/compensation compensation].
# Read the [https://github.com/bisq-network/bisq/blob/master/docs/README.md developer docs] to set up a Bisq development environment.
# Read [https://chris.beams.io/posts/git-commit How to Write a Git Commit Message] and follow its [https://chris.beams.io/posts/git-commit/#7-rules 7 rules] when contributing to Bisq projects.
# Get set up to [https://help.github.com/articles/signing-commits-using-gpg/ Sign your Git Commits] with GPG. Any commits to any Bisq repository must be signed.

== Learn how we work ==

# Read about [[Project_management|Bisq’s project management process]].
# Familiarize yourself with [https://ossec-docs.readthedocs.io/en/latest/docs/development/oRFC/orfc-1.html C4: The Collective Code Construction Contract]. It’s a simple set of collaboration rules based on GitHub’s fork+pull request model, and a foundational part of how we work together.
# For more context on C4 and the principles behind it, read author Pieter Hintjens' short book, [https://www.gitbook.com/?utm_source=legacy&utm_medium=redirect&utm_campaign=close_legacy Social Architecture].
# To understand the fundamentals of Bisq's mission and motivations, read the introductory wiki articles on [[Introduction|Bisq]] and the [[Introduction_to_the_DAO|Bisq DAO]].
# To understand Bisq’s commitment to radical transparency and radical honesty, read Part III of [https://www.amazon.com/Principles-Life-Work-Ray-Dalio/dp/1501124021/ Ray Dalio’s Principles].
# To get inspired about what building software in a non-hierarchical organization can be like (and what it requires of everyone involved), read the [https://steamcdn-a.akamaihd.net/apps/valve/Valve_NewEmployeeHandbook.pdf Valve Employee Handbook].
# Finally, a few words on [[Contributor_privacy_and_opsec|safeguarding your privacy]].

== Get connected ==

# Browse and subscribe to the [https://www.youtube.com/c/bisq-network Bisq YouTube channel] to catch up on meetings we hold, tutorials we publish, technical sessions, and more.
# Follow [https://twitter.com/bisq_network @bisq_network] on Twitter, or on any of the other channels listed [https://bisq.network/#community on the bottom of the website]: forum, Telegram, Matrix, Mastodon, etc.

If you decide to proceed and start contributing, you'll want to join Bisq's GitHub organization so you can be assigned to issues:

# Request an invite to the [https://github.com/bisq-network @bisq-network GitHub organization] on Matrix. An admin will get you set up. Doing this makes it possible to add you to the [https://github.com/orgs/bisq-network/teams @bisq-network/contributors] team and to assign you to GitHub issues.
# After accepting your GitHub invitation, consider changing your [https://github.com/orgs/bisq-network/people membership visibility] from <code>private</code> to <code>public</code>. This helps others know at a glance roughly how many contributors are involved with Bisq.

== Do valuable work and get compensated ==

After Browse GitHub repositories and Matrix discussions, you will start to develop a sense for what's happening, what's needed, and where you can help:

# '''Find a problem somewhere in Bisq-land''' that (a) needs fixing and (b) is a match for your skills and interests. Browse critical bugs, open bounties, follow chats on Matrix and the forums, and ask around about what other contributors think needs fixing.
# '''Get assigned to an issue''' or have your initiative acknowledged in some other way. While you don’t strictly need anybody’s permission to do anything for Bisq, you’ll want to make sure there's buy-in from other contributors so your work is received well. Otherwise, there are no guarantees that your work will be merged, reviewed, or eligible for compensation.
# '''Do work to fix that problem'''. Submit your fix for review with a pull request (for code and documentation changes) or with a GitHub issue (for everything else).
# '''Request that others review your work'''. The best way to do this is by writing good commit comments and pull request/issue descriptions that clearly explain the problem your work is intended to solve, why it’s important, and why you fixed it the way you did. Make it as easy as possible for others to review your work. Make it a pleasure for others to review your work.
# '''Incorporate review feedback''' you get until your fix gets merged or is otherwise accepted.
# '''Repeat''' steps 1–5.
# [[compensation|Submit a compensation request]] toward the end of the cycle.

{{Admonition Note|As you'll see from Browse the various repositories on GitHub, changes to Bisq are almost always discussed publicly. This helps maintain Bisq's commitment to transparency, invites feedback to improve the quality of contributions, and it helps keep compensation honest. '''Always try to make sure your work is documented somewhere so others can follow its progress and offer feedback.'''}}

Ultimately, please remember that all Bisq contributors participate on a voluntary basis, and the more energy and quality you bring to the table, the more existing contributors will be encouraged to pay you attention.

Regarding development, keep in mind that reviewing other contributors' work can be highly valuable as well (both to the project, and also to yourself as a way to learn how Bisq works). Quality code reviews are eligible for compensation just like any other contribution.

== Consider if you would like to become a Burning Man ==

For contributors wanting to receive regular bitcoin payments they may consider becoming performing a role as one of the Bisq [[Burning Men]]. It would be worth Bisq contributors understanding the pros and cons to becoming a burning man to decide if it is something they would like to do.

[[Category:Contributors]]
[[Category:Guides]]
[[Category:DAO]]

Reputation

2025-05-06T06:22:27Z

Strayorigin:

== Reputation in Bisq Easy ==

Reputation is a cornerstone of the security model in '''[[Bisq Easy]]''', a [[Bisq 2]] trade protocol. As buyers send their fiat payment ''before'' receiving Bitcoin, the seller's reputation provides the trust needed for the buyer to proceed confidently.

{{Admonition_Warn|'''Important Version Requirement:''' Please note that due to security updates, active trading on the Bisq network requires using software '''version 2.1.6 or higher'''. The reputation system described here applies to users on compatible versions participating in the [[Bisq Easy]] protocol.}}

[[File:Bisq2-build-reputation-screen.png|600px|thumb|left|The 'Build reputation' screen in Bisq 2 (accessed via 'Reputation' on the left menu), showing the four methods available.]] 

=== Why Reputation Matters ===

* '''For Buyers:''' Carefully review a seller's reputation (shown as stars) before accepting an offer. Choosing sellers with a higher reputation is crucial for minimizing trade risks.
* '''For Sellers:''' Building and maintaining a high reputation is essential. It increases buyer trust, makes your offers more attractive, helps you get more trades, and allows you to offer larger trade amounts. Maximizing reputation is key to success as a seller on [[Bisq Easy]]. There is expected to be competition among sellers to achieve higher reputation scores.

=== Reputation & Trade Rules (Version 2.1.1 and Later) ===

Starting with '''[[Bisq 2]] version 2.1.1''', several important rules link reputation directly to trading activity (within the currently required software version):

* '''Seller's Maximum Trade Amount:''' The maximum amount a seller can offer in a single trade now directly depends on their reputation score. Higher reputation allows sellers to create offers for larger amounts.
* '''System Trade Limits:''' While a seller's maximum depends on their reputation, the overall limits for ''any'' [[Bisq Easy]] trade are fixed between the fiat equivalent of '''6 USD''' (minimum) and '''600 USD''' (maximum). This avoids issues with Bitcoin price swings. (Note: Before v2.1.1, limits were 0.0001 - 0.01 BTC).
* '''Enhanced BSQ Value:''' To reward commitment and long-term participation, [[Introduction to the DAO|BSQ]] that is '''burned''' or '''bonded''' for reputation now contributes '''double its initial value''' to the score over the course of the first year (the score increases linearly during that year). This allows sellers to increase their eligible trade limits more quickly.
* '''Minimum Score Setting Removed:''' The previous option for buyers to set a specific minimum required reputation score for sellers (formerly defaulted to 30000) was removed in v2.1.1. The system now relies on the direct link between reputation and the allowed trade amount as a better way to handle risk.

[[File:Minimum-maximum-trade-amounts.png|400px|thumb|left|General [[Bisq Easy]] trade limits are 6 USD to 600 USD (or fiat equivalent). A seller's specific maximum offer size within this range depends on their reputation.]]
[[File:Minimum-required-reputation-score.png|400px|thumb|right|Previously, Bisq warned if trading below a set minimum score; this setting was removed in v2.1.1.]]
 

=== Understanding Reputation Stars ===

To make reputation easy to compare quickly, [[Bisq Easy]] displays scores using a simple '''0 to 5 star system'''.

[[File:Reputation-ranking-new.png|400px|thumb|left|The star system (0-5) provides an easy comparison of seller reputation based on their current rank among active users. 5 stars indicate the highest relative reputation.]]

* '''How it Works (Relative Ranking):''' Your star rating shows how your reputation '''compares to all other *active* users''' on the Bisq network at that moment. It's your current rank, not a fixed score. The highest-ranked active sellers get 5 stars, the lowest get 0 stars.
* '''Why Stars Change (Dynamic):''' Because it's a relative system based on active users, your star rating can change even if your score hasn't:
:'''User Inactivity:''' If a user is inactive for '''two weeks''', their profile is temporarily excluded from the ranking calculation. If a high-ranked user becomes inactive, others might see their star ratings go up.
:'''User Reactivation:''' When an inactive user returns, their reputation is factored back in, potentially shifting star ratings again.

'''In short:''' Stars give you a quick, dynamic view of a seller's current reputation rank compared to their active peers. The star display will change over time based on both your own score changes and the changing scores of other active users.
 

== How to Build Reputation ==

You can build your reputation score in [[Bisq Easy]] using four methods, accessed via the '''`Reputation`''' section on the main left-hand menu in Bisq 2. Your '''total reputation score''' is calculated as the '''sum''' of the points gained from all methods you use. This total score determines your reputation rank (stars) and your maximum trade offer size.

Reputation scores can change over time: points from [[Introduction to the DAO|BSQ]] Bonds are lost when unlocked, but you can burn or bond [[Introduction to the DAO|BSQ]] repeatedly. You can also import account age or signed account age, potentially replacing previous imported scores if the new import source is older.

 

=== Method 1: Burning BSQ ===

You permanently '''burn''' [[Introduction to the DAO|BSQ]] tokens to gain reputation. This represents a strong, long-term commitment to the network, akin to a proof of work. Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `DAO` > `PROOF OF BURN`. Paste the copied Profile ID into the '''`pre-image`''' field.
# '''Step 4:''' Enter the amount of [[Introduction to the DAO|BSQ]] you want to burn.
# '''Step 5:''' Publish the Burn [[BSQ]] transaction.
# '''Step 6:''' After blockchain confirmation your reputation will become visible in your Bisq 2 profile.

'''Scoring Details:'''
* '''Initial Score:''' '''100 points''' per [[Introduction to the DAO|BSQ]] burned (Weight = 100).
* '''12-Month Bonus:''' The score '''doubles''' over the first year (increasing linearly from 100 to 200 points per [[Introduction to the DAO|BSQ]] burned). This rewards long-term sellers.
* '''Persistence:''' Reputation from burning [[Introduction to the DAO|BSQ]] is permanent for that profile (unless the profile is banned).
* '''Cumulative:''' You can burn [[Introduction to the DAO|BSQ]] multiple times; scores add up.
* '''Minimum Burn:''' 5.46 [[Introduction to the DAO|BSQ]] (dust limit).
* '''Oracle Publishing:''' Data about burned [[Introduction to the DAO|BSQ]] is automatically published by the [[Bisq 2 Roles|oracle]].

[[File:Burning-bsq-reputation.png|frame|left|Burning [[Introduction to the DAO|BSQ]] in [[Bisq 1]] requires your [[Bisq 2]] Profile ID as the 'pre-image'.]]
 

=== Method 2: Bonding BSQ ===

You lock up [[Introduction to the DAO|BSQ]] tokens for a set period (minimum ~1 year) to gain reputation. This is refundable, but shows commitment for the lock duration. Like burning, regular bonding can represent user activity. Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `DAO` > `BONDING` > `BONDED REPUTATION`. Paste the copied Profile ID into the '''`salt`''' field.
# '''Step 4:''' Enter the amount of [[Introduction to the DAO|BSQ]] you want to lock up and the lock time (minimum '''`50000`''' blocks).
# '''Step 5:''' Publish the lockup transaction.
# '''Step 6:''' After blockchain confirmation your reputation will become visible in your Bisq 2 profile.

'''Scoring Details:'''
* '''Initial Score:''' '''10 points''' per [[Introduction to the DAO|BSQ]] bonded (Weight = 10).
* '''12-Month Bonus:''' The score '''doubles''' over the first year (increasing linearly from 10 to 20 points per [[Introduction to the DAO|BSQ]] bonded during the lock period).
* '''Persistence:''' Reputation lasts only '''while the [[Introduction to the DAO|BSQ]] remains bonded'''. You lose these points when you unlock the bond.
* '''Cumulative:''' You can create multiple bonds; scores add up while active.
* '''Minimum Lock Time:''' 50,000 Bitcoin blocks (approximately 1 year).
* '''Confiscation Risk:''' In severe cases (like proven scamming), the Bisq [[Introduction to the DAO|DAO]] can vote to confiscate (destroy) a user's bond. Confiscating requires high voter turnout (quorum) in the [[Introduction to the DAO|DAO]], making it somewhat difficult but possible.
* '''Oracle Publishing:''' Data about bonded [[Introduction to the DAO|BSQ]] is automatically published by the [[Bisq 2 Roles|oracle]].

[[File:Bonding-bsq-reputation.png|frame|left|Bonding [[Introduction to the DAO|BSQ]] in [[Bisq 1]] uses your [[Bisq 2]] Profile ID as the 'salt'.]]
 

=== Method 3: Importing Bisq 1 Account Age ===

Leverage the history of your fiat accounts from [[Bisq 1]]. The older the account, the more trustworthy the user is assumed to be (though this is considered a weaker form of reputation). Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `ACCOUNT` > `NATIONAL CURRENCY ACCOUNTS`.
## Select the oldest account you wish to use.
## Click the button '''`EXPORT ACCOUNT AGE FOR BISQ 2`'''.
## This copies the required JSON data (containing the proof signed with your Bisq 2 Profile ID) to your clipboard.
# '''Step 4:''' Return to Bisq 2 and paste the JSON data from your clipboard into the text area provided ('Json data from Bisq 1').
# '''Step 5:''' Click the '''`Request authorization`''' button.

'''Scoring Details:'''
* '''Score:''' '''4 points''' per day of the account's age (Weight = 4).
* '''Maximum Age Counted:''' 2000 days.
* '''Maximum Score:''' Capped at '''8,000 points''' (4 points/day * 2000 days).
* '''Which Account:''' Uses the age of your single '''oldest''' [[Bisq 1]] fiat account. Scores from multiple accounts are '''not''' added together. Importing from an older account later can replace a previous score from this method.
* '''Limitation:''' Account age alone is usually '''not enough''' for significant reputation; combine with other methods.

[[File:Age-bsq-reputation.png|frame|left|Importing account age involves exporting proof from [[Bisq 1]].]]
 

=== Method 4: Importing Bisq 1 Signed Account Age ===

Leverage the history of fiat accounts that completed the older signing process in [[Bisq 1]]. The older the signed account, the more trustworthy the user is assumed to be (though still considered a weaker form of reputation than BSQ burn/bond). Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `ACCOUNT` > `NATIONAL CURRENCY ACCOUNTS`.
## Select the oldest ''signed'' account you wish to use.
## Click the button '''`EXPORT SIGNED WITNESS FOR BISQ 2`'''.
## This copies the required JSON data (containing the proof signed with your Bisq 2 Profile ID) to your clipboard.
# '''Step 4:''' Return to Bisq 2 and paste the JSON data from your clipboard into the text area provided ('Json data from Bisq 1').
# '''Step 5:''' Click the '''`Request authorization`''' button.

'''Scoring Details:'''
* '''Minimum Age Required:''' Signed account must be at least '''61 days''' old.
* '''Score:''' '''10 points''' per day of the signed account's age (Weight = 10).
* '''Maximum Age Counted:''' 2000 days.
* '''Maximum Score:''' Capped at '''20,000 points''' (10 points/day * 2000 days).
* '''Which Account:''' Uses the age of your single '''oldest''' [[Bisq 1]] ''signed'' fiat account. Scores are '''not''' cumulative across multiple signed accounts for this method. Importing from an older signed account later can replace a previous score from this method.
* '''Limitation:''' Signed account age alone may '''not be enough''' for higher reputation tiers; combine with other methods.

[[File:Signed-bsq-reputation.png|frame|left|Importing signed account age involves exporting proof from a signed [[Bisq 1]] account.]]
 

== Reputation Simulation Tool ==

Deciding how much [[Introduction to the DAO|BSQ]] to burn or bond can be complex. [[Bisq 2]] provides a simulation tool (visible on the 'SCORE' tab for Burning/Bonding/Import methods) to help sellers estimate the reputation score impact of these actions.

Find this tool within the '''`Reputation`''' section (accessible from the main left-hand menu). It helps visualize the immediate score increase and the potential score after the first year's doubling effect (for BSQ methods) or based on account age.

[[File:Burning-bsq-screen.png|400px|thumb|left|Simulating the reputation gained from burning [[Introduction to the DAO|BSQ]].]]
[[File:Bonding-bsq-screen.png|400px|thumb|right|Simulating the reputation gained from bonding [[Introduction to the DAO|BSQ]].]]
 

== What Happens if a Profile is Banned? ==

If a user's profile ID (which contains a public key hash tied to reputation) is banned by [[Bisq 2 Roles|moderators]] for severe or repeated violations of Bisq trade protocols, '''all reputation associated with that specific profile ID is permanently lost''' and becomes unusable. The reputation score will no longer be visible or count towards rankings. Banning may also trigger consequences in [[Bisq 1]] (e.g., [[Changing_your_onion_address|onion address]] ban, [[Introduction to the DAO|BSQ]] bond confiscation proposal via the [[Introduction to the DAO|DAO]]).

Reputation

2025-05-06T06:08:24Z

Strayorigin: Update Account Age & Signed Account Age import steps & scoring details to match current UI.

== Reputation in Bisq Easy ==

Reputation is a cornerstone of the security model in '''[[Bisq Easy]]''', a [[Bisq 2]] trade protocol. As buyers send their fiat payment ''before'' receiving Bitcoin, the seller's reputation provides the trust needed for the buyer to proceed confidently.

{{Admonition_Warn|'''Important Version Requirement:''' Please note that due to security updates, active trading on the Bisq network requires using software '''version 2.1.6 or higher'''. The reputation system described here applies to users on compatible versions participating in the [[Bisq Easy]] protocol.}}

[[File:Bisq2-build-reputation-screen.png|600px|thumb|left|The 'Build reputation' screen in Bisq 2, showing the four methods available.]] 

=== Why Reputation Matters ===

* '''For Buyers:''' Carefully review a seller's reputation (shown as stars) before accepting an offer. Choosing sellers with a higher reputation is crucial for minimizing trade risks.
* '''For Sellers:''' Building and maintaining a high reputation is essential. It increases buyer trust, makes your offers more attractive, helps you get more trades, and allows you to offer larger trade amounts. Maximizing reputation is key to success as a seller on [[Bisq Easy]]. There is expected to be competition among sellers to achieve higher reputation scores.

=== Reputation & Trade Rules (Version 2.1.1 and Later) ===

Starting with '''[[Bisq 2]] version 2.1.1''', several important rules link reputation directly to trading activity (within the currently required software version):

* '''Seller's Maximum Trade Amount:''' The maximum amount a seller can offer in a single trade now directly depends on their reputation score. Higher reputation allows sellers to create offers for larger amounts.
* '''System Trade Limits:''' While a seller's maximum depends on their reputation, the overall limits for ''any'' [[Bisq Easy]] trade are fixed between the fiat equivalent of '''6 USD''' (minimum) and '''600 USD''' (maximum). This avoids issues with Bitcoin price swings. (Note: Before v2.1.1, limits were 0.0001 - 0.01 BTC).
* '''Enhanced BSQ Value:''' To reward commitment and long-term participation, [[Introduction to the DAO|BSQ]] that is '''burned''' or '''bonded''' for reputation now contributes '''double its initial value''' to the score over the course of the first year (the score increases linearly during that year). This allows sellers to increase their eligible trade limits more quickly.
* '''Minimum Score Setting Removed:''' The previous option for buyers to set a specific minimum required reputation score for sellers (formerly defaulted to 30000) was removed in v2.1.1. The system now relies on the direct link between reputation and the allowed trade amount as a better way to handle risk.

[[File:Minimum-maximum-trade-amounts.png|400px|thumb|left|General [[Bisq Easy]] trade limits are 6 USD to 600 USD (or fiat equivalent). A seller's specific maximum offer size within this range depends on their reputation.]]
[[File:Minimum-required-reputation-score.png|400px|thumb|right|Previously, Bisq warned if trading below a set minimum score; this setting was removed in v2.1.1.]]
 

=== Understanding Reputation Stars ===

To make reputation easy to compare quickly, [[Bisq Easy]] displays scores using a simple '''0 to 5 star system'''.

[[File:Reputation-ranking-new.png|400px|thumb|left|The star system (0-5) provides an easy comparison of seller reputation based on their current rank among active users. 5 stars indicate the highest relative reputation.]]

* '''How it Works (Relative Ranking):''' Your star rating shows how your reputation '''compares to all other *active* users''' on the Bisq network at that moment. It's your current rank, not a fixed score. The highest-ranked active sellers get 5 stars, the lowest get 0 stars.
* '''Why Stars Change (Dynamic):''' Because it's a relative system based on active users, your star rating can change even if your score hasn't:
* '''User Inactivity:''' If a user is inactive for '''two weeks''', their profile is temporarily excluded from the ranking calculation. If a high-ranked user becomes inactive, others might see their star ratings go up.
* '''User Reactivation:''' When an inactive user returns, their reputation is factored back in, potentially shifting star ratings again.

'''In short:''' Stars give you a quick, dynamic view of a seller's current reputation rank compared to their active peers. The star display will change over time based on both your own score changes and the changing scores of other active users.
 

== How to Build Reputation ==

You can build your reputation score in [[Bisq Easy]] using four methods, accessed via `User Options` > `Reputation` in Bisq 2. Your '''total reputation score''' is calculated as the '''sum''' of the points gained from all methods you use. This total score determines your reputation rank (stars) and your maximum trade offer size.

Reputation scores can change over time: points from [[Introduction to the DAO|BSQ]] Bonds are lost when unlocked, but you can burn or bond [[Introduction to the DAO|BSQ]] repeatedly. You can also import account age or signed account age, potentially replacing previous imported scores if the new import source is older.

 

=== Method 1: Burning BSQ ===

You permanently '''burn''' [[Introduction to the DAO|BSQ]] tokens to gain reputation. This represents a strong, long-term commitment to the network, akin to a proof of work. Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `DAO` > `PROOF OF BURN`. Paste the copied Profile ID into the '''`pre-image`''' field.
# '''Step 4:''' Enter the amount of [[Introduction to the DAO|BSQ]] you want to burn.
# '''Step 5:''' Publish the Burn [[BSQ]] transaction.
# '''Step 6:''' After blockchain confirmation your reputation will become visible in your Bisq 2 profile.

'''Scoring Details:'''
* '''Initial Score:''' '''100 points''' per [[Introduction to the DAO|BSQ]] burned (Weight = 100).
* '''12-Month Bonus:''' The score '''doubles''' over the first year (increasing linearly from 100 to 200 points per [[Introduction to the DAO|BSQ]] burned). This rewards long-term sellers.
* '''Persistence:''' Reputation from burning [[Introduction to the DAO|BSQ]] is permanent for that profile (unless the profile is banned).
* '''Cumulative:''' You can burn [[Introduction to the DAO|BSQ]] multiple times; scores add up.
* '''Minimum Burn:''' 5.46 [[Introduction to the DAO|BSQ]] (dust limit).
* '''Oracle Publishing:''' Data about burned [[Introduction to the DAO|BSQ]] is automatically published by the [[Bisq 2 Roles|oracle]].

[[File:Burning-bsq-reputation.png|frame|left|Burning [[Introduction to the DAO|BSQ]] in [[Bisq 1]] requires your [[Bisq 2]] Profile ID as the 'pre-image'.]]
 

=== Method 2: Bonding BSQ ===

You lock up [[Introduction to the DAO|BSQ]] tokens for a set period (minimum ~1 year) to gain reputation. This is refundable, but shows commitment for the lock duration. Like burning, regular bonding can represent user activity. Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `DAO` > `BONDING` > `BONDED REPUTATION`. Paste the copied Profile ID into the '''`salt`''' field.
# '''Step 4:''' Enter the amount of [[Introduction to the DAO|BSQ]] you want to lock up and the lock time (minimum '''`50000`''' blocks).
# '''Step 5:''' Publish the lockup transaction.
# '''Step 6:''' After blockchain confirmation your reputation will become visible in your Bisq 2 profile.

'''Scoring Details:'''
* '''Initial Score:''' '''10 points''' per [[Introduction to the DAO|BSQ]] bonded (Weight = 10).
* '''12-Month Bonus:''' The score '''doubles''' over the first year (increasing linearly from 10 to 20 points per [[Introduction to the DAO|BSQ]] bonded during the lock period).
* '''Persistence:''' Reputation lasts only '''while the [[Introduction to the DAO|BSQ]] remains bonded'''. You lose these points when you unlock the bond.
* '''Cumulative:''' You can create multiple bonds; scores add up while active.
* '''Minimum Lock Time:''' 50,000 Bitcoin blocks (approximately 1 year).
* '''Confiscation Risk:''' In severe cases (like proven scamming), the Bisq [[Introduction to the DAO|DAO]] can vote to confiscate (destroy) a user's bond. Confiscating requires high voter turnout (quorum) in the [[Introduction to the DAO|DAO]], making it somewhat difficult but possible.
* '''Oracle Publishing:''' Data about bonded [[Introduction to the DAO|BSQ]] is automatically published by the [[Bisq 2 Roles|oracle]].

[[File:Bonding-bsq-reputation.png|frame|left|Bonding [[Introduction to the DAO|BSQ]] in [[Bisq 1]] uses your [[Bisq 2]] Profile ID as the 'salt'.]]
 

=== Method 3: Importing Bisq 1 Account Age ===

Leverage the history of your fiat accounts from [[Bisq 1]]. The older the account, the more trustworthy the user is assumed to be (though this is considered a weaker form of reputation). Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `ACCOUNT` > `NATIONAL CURRENCY ACCOUNTS`.
## Select the oldest account you wish to use.
## Click the button '''`EXPORT ACCOUNT AGE FOR BISQ 2`'''.
## This copies the required JSON data (containing the proof signed with your Bisq 2 Profile ID) to your clipboard.
# '''Step 4:''' Return to Bisq 2 and paste the JSON data from your clipboard into the text area provided ('Json data from Bisq 1').
# '''Step 5:''' Click the '''`Request authorization`''' button.

'''Scoring Details:'''
* '''Score:''' '''4 points''' per day of the account's age (Weight = 4).
* '''Maximum Age Counted:''' 2000 days.
* '''Maximum Score:''' Capped at '''8,000 points''' (4 points/day * 2000 days).
* '''Which Account:''' Uses the age of your single '''oldest''' [[Bisq 1]] fiat account. Scores from multiple accounts are '''not''' added together. Importing from an older account later can replace a previous score from this method.
* '''Limitation:''' Account age alone is usually '''not enough''' for significant reputation; combine with other methods.

[[File:Age-bsq-reputation.png|frame|left|Importing account age involves exporting proof from [[Bisq 1]].]]
 

=== Method 4: Importing Bisq 1 Signed Account Age ===

Leverage the history of fiat accounts that completed the older signing process in [[Bisq 1]]. The older the signed account, the more trustworthy the user is assumed to be (though still considered a weaker form of reputation than BSQ burn/bond). Follow the process displayed in the Bisq 2 Reputation section:

# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `ACCOUNT` > `NATIONAL CURRENCY ACCOUNTS`.
## Select the oldest ''signed'' account you wish to use.
## Click the button '''`EXPORT SIGNED WITNESS FOR BISQ 2`'''.
## This copies the required JSON data (containing the proof signed with your Bisq 2 Profile ID) to your clipboard.
# '''Step 4:''' Return to Bisq 2 and paste the JSON data from your clipboard into the text area provided ('Json data from Bisq 1').
# '''Step 5:''' Click the '''`Request authorization`''' button.

'''Scoring Details:'''
* '''Minimum Age Required:''' Signed account must be at least '''61 days''' old.
* '''Score:''' '''10 points''' per day of the signed account's age (Weight = 10).
* '''Maximum Age Counted:''' 2000 days.
* '''Maximum Score:''' Capped at '''20,000 points''' (10 points/day * 2000 days).
* '''Which Account:''' Uses the age of your single '''oldest''' [[Bisq 1]] ''signed'' fiat account. Scores are '''not''' cumulative across multiple signed accounts for this method. Importing from an older signed account later can replace a previous score from this method.
* '''Limitation:''' Signed account age alone may '''not be enough''' for higher reputation tiers; combine with other methods.

[[File:Signed-bsq-reputation.png|frame|left|Importing signed account age involves exporting proof from a signed [[Bisq 1]] account.]]
 

== Reputation Simulation Tool ==

Deciding how much [[Introduction to the DAO|BSQ]] to burn or bond can be complex. [[Bisq 2]] provides a simulation tool (visible on the 'SCORE' tab for Burning/Bonding/Import methods) to help sellers estimate the reputation score impact of these actions.

Find this tool within the 'Reputation' section ('User Options' > `Reputation`). It helps visualize the immediate score increase and the potential score after the first year's doubling effect (for BSQ methods) or based on account age.

[[File:Burning-bsq-screen.png|400px|thumb|left|Simulating the reputation gained from burning [[Introduction to the DAO|BSQ]].]]
[[File:Bonding-bsq-screen.png|400px|thumb|right|Simulating the reputation gained from bonding [[Introduction to the DAO|BSQ]].]]
 

== What Happens if a Profile is Banned? ==

If a user's profile ID (which contains a public key hash tied to reputation) is banned by [[Bisq 2 Roles|moderators]] for severe or repeated violations of Bisq trade protocols, '''all reputation associated with that specific profile ID is permanently lost''' and becomes unusable. The reputation score will no longer be visible or count towards rankings. Banning may also trigger consequences in [[Bisq 1]] (e.g., [[Changing_your_onion_address|onion address]] ban, [[Introduction to the DAO|BSQ]] bond confiscation proposal via the [[Introduction to the DAO|DAO]]).Update Account Age & Signed Account Age import steps & scoring details to match current UI.

2025-04-23T16:15:12Z

Strayorigin: Strayorigin moved page File:Bisq-v1-bsq-btc-offer-book.png to File:Bisq-v1-buy-bsq-offer-book.png

== Summary ==
Bisq v1 'Buy BSQ with BTC' offer book (BSQ Swaps). For [[Trading BSQ]] page.

File:Bisq-v1-bsq-btc-offer-book.png

2025-04-23T16:15:12Z

Strayorigin: Strayorigin moved page File:Bisq-v1-bsq-btc-offer-book.png to File:Bisq-v1-buy-bsq-offer-book.png

#REDIRECT [[File:Bisq-v1-buy-bsq-offer-book.png]]