v1.9.2
A newer version is already available! Please don’t use this version anymore.
This is a hotfix release that adds the latest Tor version (v0.4.7.7) on top of v1.9.1 to improve connectivity caused by an ongoing DDoS attack on the Tor network.
For more details please see https://github.com/bisq-network/bisq/milestone/72.
Here are the release notes from v1.9.1:
Release notes
If you ever wanted to integrate Bisq into your project and/or to automate your most common use cases, now is the time to do it! This release ships an official API: a daemon (GRPC API endpoints) and a CLI. Please see the API section below for more details.
Aside from an API, we have simplified Bisq's navigation to make it easier to find what you are looking for:
- If you want to buy Bitcoin with EUR, just go to Buy > Bitcoin and select your preferred payment method
- If you want to buy BSQ, just go to Buy > BSQ
This approach gets rid of several intervening and (sometimes unintuitive) steps, so we hope it makes Bisq less mind-bending for new users.
And of course there are lots of bug fixes and improvements across the board.
Improvements
- Improve navigation structure
- Check failed trades for sensitive data purge
- Clarify that CBM / F2F not be used to advertise websites or contact info
- Clarify DAO status shown when in sync & peers have conflicts
- Editable account names
- IBAN validation for SEPA account
- Separate transaction details in funds views
- Dispute subsystem enhancements
- Add inbound Tor connectivity test
- Support Bitcoin Core v22 RPC for JSON export
- Add popup reminder to inform users of trading rules
Bug fixes
- Prevent multiple payout screens when agent repeat clicks on close ticket
- Prevent UI freeze in BSQ dashboard view
- Show correct buy BSQ state on activation for take offer
- Update trigger price validation
- Update currency related fields after switch of payment account
- Trigger price truncation of prompt text
- Fix corrupted MaxTradePeriod when offer payment method changed
- Fix the avatar trade count tag to include BSQ Swap trades
- Fix localization issue when accessing directories and JAR resource paths
- Fix fee request throttling
- Fix update number of open offers on change
Development & Documentation
- Add logo to README
- Fix permissions for build.yml
- API: Create API cli and daemon releases as zip archives
- API: Send pretty payment details to API clients
- API: Exclude persistedAccountName from API payment acct json forms
- API: Bug-fix for incorrect BsqSwap's OfferInfo.isActivated value
- API: Send meaningful io.grpc.Status.Code to gRPC clients
- API: Move get (cryptocurrency) offer filter to daemon
- API: Fix 3 misleading .proto TradeInfo field names
- API: Convert grpc.proto field names to snake_case
- API: Remove GetTradeStatistics service from grpc.proto
- API: Continue documenting grpc.proto for API reference site
- API: Clarify meaning of API/Offer related % fields
- API: Change TradeInfo proto's tradePrice & tradeVolume fields to string
- API: Change API OfferInfo volume/minVolume proto fields to string
- API: Change API grpc.proto triggerPrice field to string
- API: Change API's OfferInfo proto's price field to string
- API: Prepare API Offers .proto defs for significant changes
- API: Fix BSQ swap description of BTC price for 1 BSQ
- Bump actions/checkout from 3.0.0 to 3.0.1
- Bump actions/checkout from 2.4.0 to 3
- Bump actions/setup-java from 3.1.0 to 3.1.1
- Bump actions/setup-java from 2.5.0 to 3
New Assets
No new assets were added.
Verification
For a detailed description on how to verify your Bisq installer please have a look at our wiki: https://bisq.wiki/Downloading_and_installing#Verify_installer_file
Url of the signing key (Christoph Atteneder): https://bisq.network/pubkey/29CDFD3B.asc
Full fingerprint: CB36 D7D2 EBB2 E35D 9B75 500B CD5D C1C5 29CD FD3B
Import the key:
curl https://bisq.network/pubkey/29CDFD3B.asc | gpg --import
GPG prints a confusion warning: "This key is not certified with a trusted signature!" - See https://serverfault.com/questions/569911/how-to-verify-an-imported-gpg-key for background information what it means.
How to verify signatures?
gpg --digest-algo SHA256 --verify BINARY{.asc*,}
Replace BINARY with the file you downloaded (e.g. Bisq-1.9.2.dmg)
Verify jar file inside binary:
You can verify on OSX the jar file with:
shasum -a256 [PATH TO BISQ APP]/Bisq.app/Contents/app/desktop-1.9.2-all.jar
The output need to match the value from the Bisq-1.9.2.jar.txt file.
There are three hashes within the Bisq-1.9.2.jar.txt file (macOS, Windows, Linux).
If you want to reproduce and verify the hash of the jar file locally, you need to do so on Windows or Linux using Java 15.0.6 and the v1.9.2 release tag. Because of the signing and notarization process that requires the developer certificate used for the build on macOS it is not possible to create the same jar on macOS.
API
Starting with v1.9.0 you can use pre-built versions of the Bisq cli (bisq-cli-v1.9.2.zip) and Bisq daemon (bisq-daemon-v1.9.2.zip) to use Bisq without touching the user interface.
Just download the archives and extract them locally. You have to run the daemon to access the local Bisq daemon API endpoints.
To run daemon.jar on Mainnet:
$ java -jar daemon.jar --apiPassword=becareful
If you just want to control your headless daemon within your terminal you have to run the Bisq cli as well.
Again just download the bisq-cli archive and extract it locally.
To call getversion from cli.jar
$ java -jar cli.jar --password=becareful getversion
You can use the Bisq API to access local Bisq daemon API endpoints, which provide a subset of the Bisq Desktop application's feature set: check balances, transfer BTC and BSQ, create payment accounts, view offers, create and take offers, and execute trades.
The Bisq API is based on the gRPC framework, and any supported gRPC language binding can be used to call Bisq API endpoints.
You'll find in-depth documentation and examples under following link: https://bisq-network.github.io/slate/#introduction
Bisq gRPC API reference documentation example source code is hosted on GitHub at https://github.com/bisq-network/bisq-api-reference. Java and Python developers interested in bot development may find this Intellij project useful for running the existing examples, and writing their own bots.
For additional developer support please join Development - Bisq v1 on Matrix.
Known issues with installation
Windows:
There is a known issue with Anti Virus software. We got several reports from users running into different problems. Either the AV software blocks Bisq or Tor, delete files in the data directory [2] or app directory [1]) or cause such a long delay at startup that Tor gets terminated and a file remains locked which can cause that Bisq cannot be started afterwards. To resolve that you need to restart Windows then the lock get released. We are working on solutions to fix those issues.
If you use Crypto currencies on your Windows system be aware that Windows is much more vulnerable to malware than Linux or OSX. Consider to use a dedicated non-Windows system when dealing with cryptocurrencies.
[1] Application directory (contains application installation files):
C:\Users<username>\AppData\Local\Bisq
[2] Data directory (contains all Bisq data including wallet):
C:\Users<username>\AppData\Roaming\Bisq\btc_mainnet\tor (you can delete everything except the hiddenservice directory)
Linux:
Hint for Debian users:
If you have problems starting Bisq on Debian use: /opt/bisq/bin/Bisq
If your Linux distro does not support .deb files please follow this instruction:
cd ~/Downloads
mkdir tmp
cd tmp
ar x ../Bisq-64bit-1.9.2.deb
sudo tar Jxvf data.tar.xz
sudo cp -rp opt/Bisq /opt/
That instruction is not tested on many different distros. If you encounter problems please report it in a Github issue so we can improve it.
Credits
Thanks to everyone who directly contributed to this release:
- @Devils-Knight
- @ghubstan
- @jmacxx
- @MarnixCroes
- @ripcurlx
- @xyzmaker123
A special thanks to our first time contributors:
As well as to everyone that helped with translations on Transifex.