[bisq-network/bisq-desktop] Mobile notifications UI (#1622)

[Manfred Karrer]

I added a link for the docs page to give info about the mobile notifications app.
The redirect I want to use is: 
/mobile-notifications https://docs.bisq.network/mobile-notifications.html 302
@cbeams @m52go  Is that redirect ok for you?

@m52go Could you write up a text there? Should only explain basics what it is and how it works. I will post below some raw example content. We plan to release the next days, if you don't have time let me know then I will write it up, but my talent in writing is limited ;-).

We need to add the download links for iOS and Android apps to our download page as well.
I was considering to just add the classical download badges there below the normal download links.
If anybody can make a suggestion here would be cool. I am not good with HTML...

Suggestion for docs text:

With the Bisq mobile notifications app for Android and Iphone you can receive customized notifications from your Bisq desktop app. You have to install the mobile app from the Apple App Store or Google Play store and after that pair it with your Bisq app. In Bisq you need to go to the Account/Notifications screen and click on the "Open Webcam" button. Then click on "Pair" on your mobile app and scan the QR code with your computers webcam. In case you don't have a webcam you can send the pairing string by email to your computer and then copy paste it into the text field (click the "I don't have a webcam" button). After pairing is successful you get a success message on your phone and can move on to the notifications screen.

In Bisq you can define if you want to get notifications or trade activities, offers you are interested in and price alerts as well as set if you want to get the notifications with sound or without.

Open offers:
You will receive a notification if one of your open offers get taken.

Trade alerts:
If you are in the trade process you will receive a notification if any activity from your side is required. E.g. after the block confirmation when you are the BTC buyer and need to send the Fiat or altcoin, if you are the BTC seller after the peer has send you the Fiat or altcoin to check if you received it and the buyer will receive a notification after the trade is completed. 

Disputes:
You will receive a message for any new dispute message, but you will not see the content of the dispute message. 

Please don't rely only on the mobile notifications app to receive those messages, it is a new feature and there might be bugs. So please continue to check on your Bisq app for trade state and disputes! 

Offer alerts:
Here you can select for which offers you would like to receive notifications. First you need to select the payment account. Then i you are interested in buy or sell offers. If you want to sell BTC you are interested in buy offers as the peer who made the offer is the buyer. Then select the % distance from the market price for which you want to get a notification triggered. With a price distance set, you will only receive an alert when an offer that meets (or exceeds) your requirements is published. Example: you want to sell BTC, but you will only sell at a 2% premium to the current market price. Setting this field to 2% will ensure you only receive alerts for offers with prices that are 2% (or more) above the current market price.

You can see all set up alerts when you click "Manage offer alerts" and remove them from the list.

Price alerts: 
You can select a currency and the upper and lower price limits when you want to receive a price alert. E.g. If the price alert is set for EUR with upper limit to 6000 and lower limit to 5500 and current market price is 5800, then you will get a notification once the market price goes over 6000 or below 5500 BTC/EUR. Once it gets triggered the price alert gets deleted automatically (otherwise you would get repeated notifications).

Technical details/Privacy:
The content of the notifications is encrypted by a key generated on the mobile phone. 
The mobile ID and a that secret key is passed over to the Bisq app with the QR code scanning (pairing). The Bisq app sends to a Relay node a message over Tor containing the encrypted payload as well as the mobile ID. When the relay node receives that message it knows only the mobile ID but no IP address as it received the message over Tor. It forwards that message to the Apple or Google push notifications server which pushes it to the mobile phone using the mobile ID as identifier. Apple or Google learn about a mobile ID is interested in Bisq notifications but cannot read any content as it is encrypted (they learn about that already when you install the mobile app). The push notifications mechanism does not allow a more privacy protection way to do that, but I think for most users that is acceptable. If not simply don't use that feature, it is completely optional.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/bisq-network/bisq-desktop/issues/1622#issuecomment-413169865
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bisq.network/pipermail/bisq-github/attachments/20180815/ca01f6cf/attachment-0001.html>