Difference between revisions of "Reputation"

From Bisq Wiki
Jump to navigation Jump to search
(reworded for clarity and format)
m
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
The security model of [[Bisq Easy]] (a [[Bisq 2]] trade protocol) is based on the seller's reputation.
+
== Reputation in Bisq Easy ==
 
 
As the buyer needs to send the fiat payment first in the trade process, the seller needs to provide reputation so that the buyer can trust the seller to send the bitcoin.
 
 
 
Buyers should look to choose sellers with a high reputation for their trades.
 
  
Sellers should look at how to maximize their reputation to ensure they get more trades.
+
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.
  
From Bisq 2 version 2.1.1 the maximum recommended trade amount depends on the seller's reputation. The higher their reputation the higher the possible trade amount (up to a ceiling of the bitcoin amount equivalent to 600 USD). Version 2.1.1 also introduces a change in the reputation score calculation, so that burned BSQ and bonded BSQ get twice their value in the course of the first year.
+
{{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:Reputation-section-new.png|400px|thumb|left|The reputation section can be found on the left hand menu in Bisq 2]]
+
[[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.]] <br clear=all>
 
 
<br clear=all>
 
 
 
== Reputation in Bisq Easy ==
 
 
 
The security model of '''Bisq Easy''' (a [[Bisq 2]] trade protocol) is based on the '''seller's reputation'''.
 
  
 
=== Why Reputation Matters ===
 
=== Why Reputation Matters ===
In a typical Bisq Easy trade flow, the [[Buyer|buyer]] needs to send the fiat payment first. Therefore, the [[Seller|seller]] must provide sufficient reputation to build trust, assuring the buyer that the bitcoin will be sent after the fiat payment is confirmed.
 
 
=== Guidance for Buyers ===
 
Buyers should carefully review a seller's reputation score before accepting an offer. Choosing sellers with a higher reputation is recommended to minimize trade risks.
 
 
=== Guidance for Sellers ===
 
Sellers should focus on building and maintaining a high reputation score. A strong reputation increases buyer confidence, makes offers more competitive, and ultimately leads to more successful trades.
 
 
=== Reputation and Trade Limits (Version 2.1.1+) ===
 
Starting with Bisq 2 '''version 2.1.1''', the reputation system directly impacts trade parameters:
 
  
* '''Maximum Trade Amount:''' The recommended maximum trade size a seller can offer is linked to their reputation score. Higher reputation allows for larger trades.
+
* '''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.
* '''Trade Ceiling:''' There is an upper limit for trades, capped at the bitcoin amount equivalent to 600 USD.
+
* '''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.
* '''Enhanced BSQ Value:''' Version 2.1.1 introduced an update to the reputation score calculation. Both '''burned BSQ''' and '''bonded BSQ''' now contribute '''twice their value''' towards the reputation score during the first year after the burn or bond transaction. This allows sellers to increase their eligible trade limits more quickly.
 
  
== Minimum and Maximum Trade Amounts ==
+
=== Reputation & Trade Rules (Version 2.1.1 and Later) ===
  
Before '''v2.1.1''', the minimum and maximum trade amounts were defined in Bitcoin (BTC) terms, ranging from 0.0001 BTC to 0.01 BTC.
+
Starting with '''[[Bisq 2]] version 2.1.1''', several important rules link reputation directly to trading activity (within the currently required software version):
  
Starting with '''v2.1.1''', Bisq Easy uses fixed fiat amount limits to reduce the impact of BTC price volatility. The general range for trades is now between the equivalent of '''6 USD''' (minimum) and '''600 USD''' (maximum), automatically converted to your chosen fiat currency.
+
* '''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).
It's important to note that while the absolute maximum limit is 600 USD, the actual maximum amount for any specific trade also depends on the [[#Reputation and Trade Limits (Version 2.1.1+)|seller's reputation score]].
+
* '''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|The general minimum and maximum trade amounts for Bisq Easy are between the fiat equivalent of 6 USD and 600 USD.]]
 
  
 +
[[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.]]
 
<br clear=all>
 
<br clear=all>
  
== Minimum required reputation score ==
+
=== Understanding Reputation Stars ===
  
Prior to v2.1.1 users could set a minimum required reputation score for sellers in the settings, or use the recommended default value (30000). This has been removed in v2.1.1. as the amount based approach is a better way to handle risk.
+
To make reputation easy to compare quickly, [[Bisq Easy]] displays scores using a simple '''0 to 5 star system'''.
  
[[File:Minimum-required-reputation-score.png|400px|thumb|left|Bisq will give you a warning if you try and trade with a user with less than the required reputation score.]]
+
[[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.]]
  
<br clear=all>
+
* '''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:
== Transition and backward compatibility with prior versions ==
+
:'''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.
As long there are users who run versions prior to v2.1.1. we need to deal with some backward compatibility cases.
 
 
 
An offer created by a version prior to 2.1.1 can be taken by users of v2.1.1 up to 25 USD even the reputation score is insufficient as we have for such relative small amounts the requirements relaxed. In case a maker who have set the min. required reputation score to a higher level as the taker of the offer has, can reject that trade without risking penalty. The mediator can assist in doubt.
 
 
 
Buy offers created with v2.1.1 have set the min. required reputation score to 30000 independent of the users setting (as that has been removed). Thus sellers still using a version lower than v2.1.1. need to have at least 30000 reputation score to take that buy offer.
 
 
 
 
 
== Understanding Reputation Stars ==
 
 
 
To quickly see how reputable a seller is, Bisq uses a simple '''0 to 5 star system''' instead of showing complex reputation scores. More stars mean a better reputation.
 
 
 
[[File:Reputation-ranking-new.png|400px|thumb|left|Bisq's star system makes it easy to compare seller reputations at a glance. 5 stars indicate the highest-ranked active sellers.]]
 
 
 
=== How Star Ratings Work ===
 
 
 
Your star rating isn't fixed; it shows how your reputation '''compares to all other *active* users''' on the Bisq network right now.
 
 
 
* Sellers with the highest reputation compared to others currently active receive '''5 stars'''.
 
* Sellers with the lowest relative reputation receive '''0 stars'''.
 
 
 
=== Why Star Ratings Can Change ===
 
 
 
Because stars show your *relative ranking*, your star rating can change even if your own reputation score hasn't:
 
 
 
* '''Inactivity:''' User profiles are temporarily removed from the network rankings if they are inactive for '''two weeks'''. If a highly-rated user becomes inactive, their reputation is no longer part of the comparison, and other users might see their star rating increase as the rankings adjust.
 
* '''Reactivation:''' When an inactive user becomes active again, their reputation is added back into the network comparison, potentially causing the star ratings of others to shift again.
 
 
 
'''In short:''' The star system provides a dynamic snapshot of how a seller's reputation currently ranks among their active peers on the network.
 
  
 +
'''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.
 
<br clear=all>
 
<br clear=all>
  
== Why is Reputation important for sellers ==
+
== How to Build Reputation ==
 
 
Bitcoin buyers send the fiat payment to the sellers prior to receiving the bitcoin. Therefore it is important for bitcoin sellers to have a good reputation to help establish trust with their potential trade partners.
 
 
 
It is expected that users that want to gain reputation to be bitcoin sellers on Bisq Easy will be experienced Bisq users that can provide buyers with a positive experience.
 
 
 
Selling bitcoin on Bisq Easy is expected to be profitable for the sellers in that they will likely choose to sell bitcoin over market price.
 
 
 
== How to build reputation ==
 
 
 
There are currently 4 options for creating reputation:
 
 
 
* Burning BSQ
 
* Setting up a BSQ bond
 
* Importing the Account Age from Bisq 1
 
* Importing the Signed Account Age from Bisq 1
 
 
 
The total score is calculated as sum of the individual reputation sources/events. The reputation scores of users' will change over time due to:
 
 
 
* Reputation gained from bonding BSQ is lost when the bond is unlocked.
 
* Users can burn or bond BSQ repeatedly.
 
* Users can import signed accounts or aged accounts to replace previous gained reputation scores.
 
 
 
Also the representation of the reputation as stars next to the user profile will also change over time in respect of the score of other users profile IDs.
 
  
It is expected that there will be some competition between sellers to achieve higher reputation scores to get more trades from bitcoin buyers interested in trading with account with the most 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.
  
You can access all 4 methods of increasing your reputation from the Bisq 2 reputation section found in 'User Options' > 'Reputation'
+
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.
 
 
[[File:Reputation-section.png|frame|left]]
 
  
 
<br clear=all>
 
<br clear=all>
  
=== Burning BSQ ===
+
=== Method 1: Burning BSQ ===
 
 
 
 
A user who wants to improve their reputation on the Bisq Easy trade protocol can can burn BSQ.
 
 
 
The more BSQ that is burned the better the reputation score the user would get.
 
 
 
The minimum amount of BSQ that can be burnt is 5.46 BSQ (dust limit).
 
 
 
The reputation score achieved by burning BSQ increases linearly over the first twelve months. At the end of the 12 months the reputation score gained will be double what it was initially. This is to give an advantage to sellers over the long term.
 
 
 
The value gained by burning BSQ persists over time. Reputation scores achieved from burning BSQ is cumulative. It can be assumed that regular burning (e.g. each week or month) is a form of work and represents activity by the user resulting in a higher reputation score.
 
 
 
Data about the burned BSQ gets published automatically by the oracle node.
 
 
 
If a user gets banned by a moderator they will lose the reputation value that they gained from burning the BSQ as the reputation is linked to their profile and a banned profile cannot be used anymore.
 
  
'''Follow these steps to burn BSQ for reputation:'''
+
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:
  
# Select the user profile for which you want to attach the reputation
+
# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# Copy the "profile ID"
+
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# Open Bisq 1 and go to "DAO/PROOF OF BURN" and paste the copied value into the "pre-image" field
+
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `DAO` > `PROOF OF BURN`. Paste the copied Profile ID into the '''`pre-image`''' field.
# Enter the amount of BSQ you want to burn
+
# '''Step 4:''' Enter the amount of [[Introduction to the DAO|BSQ]] you want to burn.
# Publish the Burn BSQ transaction
+
# '''Step 5:''' Publish the Burn [[BSQ]] transaction.
# After blockchain confirmation your reputation will become visible in your profile
+
# '''Step 6:''' After blockchain confirmation your reputation will become visible in your Bisq 2 profile.
  
On the bisq 2 app you will find this same information under 'User Options' > 'Reputation'
+
'''Scoring Details:'''
 
+
* '''Initial Score:''' '''100 points''' per [[Introduction to the DAO|BSQ]] burned (Weight = 100).
[[File:Burning-bsq-reputation.png|frame|left]]
+
* '''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'.]]
 
<br clear=all>
 
<br clear=all>
  
<pre>
+
=== Method 2: Bonding BSQ ===
 
 
Burning BSQ has the highest impact on the reputation score.
 
 
 
For every BSQ burnt the user receives a reputation score of 100. This amount will increase linearly over the first twelve months until it doubles.
 
 
 
For example if a user burns 100 BSQ their reputation score will be increased by 10,000 immediately, and by the end of the 12 months it will have increased to 20,000.
 
 
 
Reputation obtained by burning will persist with that users profile.
 
  
To increase their reputation further a user can burn multiple times. The scores received are cumulative.
+
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:
  
</pre>
+
# '''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.
  
=== Setting up a BSQ bond ===
+
'''Scoring Details:'''
 
+
* '''Initial Score:''' '''10 points''' per [[Introduction to the DAO|BSQ]] bonded (Weight = 10).
Similar to Burn BSQ but using refundable BSQ bonds.
+
* '''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.
BSQ needs to be bonded for a minimum of 50,000 blocks (about 1 year). During this time the BSQ is unavailable to the user. After 50,000 blocks the bond can be unlocked and the BSQ is available again to the user.  
+
* '''Cumulative:''' You can create multiple bonds; scores add up while active.
 
+
* '''Minimum Lock Time:''' 50,000 Bitcoin blocks (approximately 1 year).
The reputation score achieved by bonding BSQ increases linearly over the first twelve months. At the end of the 12 months the reputation score gained will be double what it was initially. This is to give an advantage to sellers over the long term.
+
* '''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]].
The value gained by bonding BSQ persists until the time the bond is unlocked. Reputation scores achieved from bonding BSQ is cumulative. It can be assumed that regular bonding (e.g. each week or month) is a form of work and represents activity by the user resulting in a higher reputation score.
 
 
 
A bond can be confiscated (destroyed by a Bisq DAO vote). This would only be done if a bond holder was scamming users. To confiscate a scammers bond requires high quorum at DAO voting, thus its more risky that the confiscation might fail.
 
 
 
Data about bonded BSQ gets published automatically by the oracle node.
 
 
 
'''Follow these steps to bond BSQ for reputation:'''
 
 
 
# Select the user profile for which you want to attach the reputation
 
# Copy the "profile ID"
 
# Open Bisq 1 and go to "DAO/BONDING/BONDED REPUTATION" and paste the copied value into the "salt" field
 
# Enter the amount of BSQ you want to lockup and the lock time (50000 blocks)
 
# Publish the lockup transaction
 
# After blockchain confirmation your reputation will become visible in your profile
 
 
 
On the bisq 2 app you will find this same information under 'User Options' > 'Reputation'
 
 
 
[[File:Bonding-bsq-reputation.png|frame|left]]
 
  
 +
[[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'.]]
 
<br clear=all>
 
<br clear=all>
  
<pre>
+
=== Method 3: Importing Bisq 1 Account Age ===
  
Bonding BSQ has a high impact on the reputation score.
+
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:
  
For every BSQ bonded the user receives a reputation score of 10. This amount will increase linearly over the first twelve months until it doubles.
+
# '''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.
  
For example if a user bonds 1,000 BSQ their reputation score will be increased by 10,000 immediately, and by the end of the 12 months it will have increased to 20,000.
+
'''Scoring Details:'''
 
+
* '''Score:''' '''4 points''' per day of the account's age (Weight = 4).
Reputation obtained by burning will persist with that users profile.
+
* '''Maximum Age Counted:''' 2000 days.
 
+
* '''Maximum Score:''' Capped at '''8,000 points''' (4 points/day * 2000 days).
To increase their reputation further a user can bond multiple times. The scores received are cumulative.
+
* '''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.
Once the bond is unlocked the reputation score attributed to that bond is lost.
 
 
 
</pre>
 
 
 
=== Importing the Account Age from Bisq 1 ===
 
 
 
Users of Bisq 1 can gain reputation by importing their account age from Bisq 1 into Bisq 2.  
 
 
 
Accounts ages from Bisq 1 could include any of the following account types:
 
 
 
Any Fiat account can be used.
 
 
 
The older the user's account age the more trustworthy the user will be assumed to be.
 
 
 
In case of repeated registrations the oldest account will be used (as it has the highest value). Multiple accounts do not get accumulated.
 
 
 
'''Follow these steps to import your account age from Bisq 1 for reputation:'''
 
 
 
# Open the account age reputation section on Bisq 2
 
# Select the user profile for which you want to attach the reputation
 
# Copy the "profile ID" to paste on Bisq 1
 
# Open Bisq 1 and go to "ACCOUNT/NATIONAL CURRENCY ACCOUNTS"
 
# Select the oldest account and click 'Export Account'
 
# This will add a signed message with the Bisq 2 profile ID
 
# Paste the signature from Bisq 1 in the account age reputation section on Bisq 2
 
# Press 'Request authorization' button
 
 
 
On the bisq 2 app you will find this same information under 'User Options' > 'Reputation'
 
 
 
[[File:Age-bsq-reputation.png|frame|left]]
 
  
 +
[[File:Age-bsq-reputation.png|frame|left|Importing account age involves exporting proof from [[Bisq 1]].]]
 
<br clear=all>
 
<br clear=all>
  
<pre>
+
=== Method 4: Importing Bisq 1 Signed Account Age ===
Importing an account age from Bisq 1 the lowest impact on the reputation score.
 
 
 
For every day old the user's account is they will receive a reputation score of 2.5. For example if a user imports a 300 day old account from Bisq 1 their reputation score will be increased by 750. Reputation obtained from importing their account age will be cumulative with all other reputation scores the user obtains.
 
 
 
A user cannot obtain the minimum reputation score required from importing their account age alone, they would need to burn or bond BSQ to achieve this.
 
 
 
The maximum reputation score a user can achieve from importing an account age is 5,000. This can be achieved when importing accounts of 2,000 days old, or older.
 
</pre>
 
 
 
=== Importing the Signed Account Age from Bisq 1 ===
 
 
 
Users of Bisq 1 can gain reputation by importing their signed account age from Bisq 1 into Bisq 2.
 
 
 
Any signed account from Bisq 1 can be used.
 
 
 
The older the user's signed account age the more trustworthy the user will be assumed to be.
 
 
 
In case of repeated registrations the oldest signed account will be used (as it has the highest value). Multiple accounts do not get accumulated. account will be used (as it has the highest value). Multiple accounts do not get accumulated.
 
  
'''Follow these steps to import your signed account age from Bisq 1 for reputation:'''
+
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:
  
# Open the account signed account age witness reputation section on Bisq 2
+
# '''Step 1:''' Select the user profile in Bisq 2 for which you want to attach the reputation.
# Select the user profile for which you want to attach the reputation
+
# '''Step 2:''' Copy the '''Profile ID''' displayed. You will paste this into Bisq 1.
# Copy the "profile ID" to paste on Bisq 1
+
# '''Step 3:''' Open '''[[Bisq 1]]''' and go to `ACCOUNT` > `NATIONAL CURRENCY ACCOUNTS`.
# Open Bisq 1 and go to "ACCOUNT/NATIONAL CURRENCY ACCOUNTS"
+
## Select the oldest ''signed'' account you wish to use.
# Select the oldest signed account and click 'Export Account'
+
## Click the button '''`EXPORT SIGNED WITNESS FOR BISQ 2`'''.
# This will add a signed message with the Bisq 2 profile ID
+
## This copies the required JSON data (containing the proof signed with your Bisq 2 Profile ID) to your clipboard.
# Paste the signature from Bisq 1 in the signed account age witness reputation section on Bisq 2
+
# '''Step 4:''' Return to Bisq 2 and paste the JSON data from your clipboard into the text area provided ('Json data from Bisq 1').
# Press 'Request authorization' button
+
# '''Step 5:''' Click the '''`Request authorization`''' button.
  
On the Bisq 2 app you will find this same information under 'User Options' > 'Reputation'
+
'''Scoring Details:'''
 
+
* '''Minimum Age Required:''' Signed account must be at least '''61 days''' old.
[[File:Signed-bsq-reputation.png|frame|left]]
+
* '''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.]]
 
<br clear=all>
 
<br clear=all>
 
<pre>
 
Importing a signed account age from Bisq 1  has a low impact on the reputation score.
 
 
For every day old the user's singed account is they will receive a reputation score of 5. For example if a user imports a 300 day old account from Bisq 1 their reputation score will be increased by 1500. Reputation obtained from importing their signed account age will be cumulative with all other reputation scores the user obtains.
 
 
A user cannot obtain the minimum reputation score required from importing their signed account age alone, they would need to burn or bond BSQ to achieve this.
 
 
The maximum reputation score a user can achieve from importing a signed account is 10,000. This can be achieved when importing accounts of 2,000 days old, or older.
 
</pre>
 
  
 
== Reputation Simulation Tool ==
 
== Reputation Simulation Tool ==
  
For bitcoin sellers it can get a little complicated to work out what the best way is to increase their reputation. To help make the decision process easier Bisq 2 provides a simulation tool for sellers to see what different actions they can take to increase their reputation.
+
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.
 
 
The simulation tool can be access from the reputation system. It can be used for both burning and bonding BSQ.
 
 
 
Here is an screenshot showing it in use for burning BSQ.
 
 
 
[[File:Burning-bsq-screen.png|400px|thumb|left|The tool allows you to see the reputation score you would get from Burning BSQ. Remember the score will increase linearly over the first 12 months. At the end of this period the reputation score will be double]]
 
 
 
<br clear=all>
 
 
 
Here is an screenshot showing it in use for bonding BSQ.
 
  
[[File:Bonding-bsq-screen.png|400px|thumb|left|The tool allows you to see the reputation score you would get from Bonding BSQ. Remember the score will increase linearly over the first 12 months. At the end of this period the reputation score will be double]]
+
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]].]]
 
<br clear=all>
 
<br clear=all>
  
== What happens when a user profile ID is banned? ==
+
== What Happens if a Profile is Banned? ==
 
 
When a user profile ID is banned they lose all reputation associated with that profile ID.
 
 
 
The profile ID contains a pub key hash that is tied to a corresponding reputation score.
 
 
 
Once a user profile ID is banned their corresponding reputation score will no longer be visible.
 
  
Moderators will ensure that they only ban profile IDs that have severely, or repeatedly, violated Bisq trade protocols. Banned users might be impacted in Bisq 1 as well (e.g. their onion address will be banned, or a BSQ bond confiscation proposal is made, if applicable).
+
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]]).

Latest revision as of 06:22, 6 May 2025

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.

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

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 BSQ Bonds are lost when unlocked, but you can burn or bond 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 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:

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

Scoring Details:

  • Initial Score: 100 points per BSQ burned (Weight = 100).
  • 12-Month Bonus: The score doubles over the first year (increasing linearly from 100 to 200 points per BSQ burned). This rewards long-term sellers.
  • Persistence: Reputation from burning BSQ is permanent for that profile (unless the profile is banned).
  • Cumulative: You can burn BSQ multiple times; scores add up.
  • Minimum Burn: 5.46 BSQ (dust limit).
  • Oracle Publishing: Data about burned BSQ is automatically published by the oracle.
Burning BSQ in Bisq 1 requires your Bisq 2 Profile ID as the 'pre-image'.


Method 2: Bonding BSQ

You lock up 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:

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

Scoring Details:

  • Initial Score: 10 points per BSQ bonded (Weight = 10).
  • 12-Month Bonus: The score doubles over the first year (increasing linearly from 10 to 20 points per BSQ bonded during the lock period).
  • Persistence: Reputation lasts only while the 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 DAO can vote to confiscate (destroy) a user's bond. Confiscating requires high voter turnout (quorum) in the DAO, making it somewhat difficult but possible.
  • Oracle Publishing: Data about bonded BSQ is automatically published by the oracle.
Bonding 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:

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

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


Reputation Simulation Tool

Deciding how much 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.

Simulating the reputation gained from burning BSQ.
Simulating the reputation gained from bonding 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 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., onion address ban, BSQ bond confiscation proposal via the DAO).