Manual payout

From Bisq Wiki
Revision as of 23:31, 4 January 2021 by Leo816 (talk | contribs)
Jump to navigation Jump to search

Warning

In this process you copy and paste your private keys from the Bisq software into a web browser. As a precaution it is advised you remove all of your funds from this wallet before starting this procedure.

Precautions

This method is only necessary in extreme occasions where one of the traders may not be available. Therefore it is important to make sure that the person who constructs the transaction does not defraud the other signers.

What you need

This document uses open source tools (other than Bisq) to create, sign and broadcast transactions of funds locked in multisig transactions. To spend out of a multisig, two things are needed:

  • A redeem script.
  • Enough private keys to meet the minimum multisig threshold. Use the string in priv WIF= instead of priv HEX=.


Bisq does not provide the Redeem Script for the multisig, but we can recreate it with all the public keys involved in the multisig.

Using Bisq's Manual Payout tool

Please press Ctrl+J and check the include private keys, clickl COPY TO CLIPBOARD and paste on a notepad. Search on that file for your public key. In the same line there's also a priv HEX=. BuyerMultiSigPubKeyHex: ... SellerMultiSigPubKeyHex: ...

The BTC seller encountered a bug and lost access to its information. I'll need you to use the Emergy multisig payout tool (Ctrl+g) to release the funds. 1. Open the tool with Ctrl+G. 2. Click import and paste the following text in the first field and click IMPORT FROM STRING. It should populate the view with the info about the payout transaction.

<unsigend transaction string>

3. Go to SIGN and paste your private key for this trade (priv HEX=) and click GENERATE SIGNATURE. 4. Copy the signature hex that you get and share it with me.

Tools you need:

Get multisig public keys

Each trader involved can get their public keys and the other trader's public keys in their trade JSON contract.

  1. Find your trade under PORTFOLIO.
  2. Click the i icon next to the trade ID, and at the bottom click VIEW CONTRACT IN JSON FORMAT. At the end, you see the Buyer and Seller public keys:
BuyerMultiSigPubKeyHex: <hex value>
SellerMultiSigPubKeyHex: <hex value>

Get private keys

To access your Bisq wallet private key

  1. Press Ctrl + j, alt +j or cmd + j.
  2. Check Include private keys and click COPY TO CLIPBOARD.
  3. In the text editor, search for the public key value. You are looking for an entry that reads DeterministicKey{pub HEX=<hex value> where <hex value> is the public key.
  4. When you've found this entry, select and copy the priv WIF=<hex value> value that immediately follows the pub HEX value. This value is the private key.
  5. Copy, paste and save that information in a bisqWallet.txt file.

Note: If your wallet uses a password, you will need to remove the password to view the private keys in wallet data.

Get payout addresses

At the end of the JSON contract file you can also find the intended payout address for each trader:

makerPayoutAddressString: <address value>
takerPayoutAddressString: <address value>

Recreating Redeem script

For all the web interactions use the Tor browser.

  1. Go to the Coinbin web wallet:
  2. At the top click New and from the dropdown menu choose MultiSig Address
  3. Paste the three public keys in the following order 1) SellerMultiSigPubKeyHex, 2) BuyerMultiSigPubKeyHex
  4. Click submit to see an address and a Redeem Script. Make sure the address matches the multisig address for the trade. If not, try to change the order of the public keys.
  5. Copy and save the Redeem Script.

Creating transaction

  1. Again, click New at the top, but this time choose Transaction from the dropdown menu.
  2. Paste the Redeem Script in the text field at the top and click Load. It should take a few seconds and then return the value locked in the multisig.
  3. For the first input fill in an address from makerPayoutAddressString and the respective trade amount.
  4. Add a new output by clicking the + sign next to the amount field. For this second output paste the address that belongs to takerPayoutAddressString and the respective trade amount.
  5. Copy and save the transaction.
  6. Click submit to obtain an encoded transaction string.

Verify transaction

Click Verify at the top and paste the encoded string obtained from the step 5.e. Verify it all is correct before moving to the next step.

Sign transaction

  1. Click Sign at the top of the page and paste your WIF private key in the Private key text field and the encoded transaction in the text field below.
  2. Click Submit to get a new encoded transaction string.
  3. Copy and save it and share it with the other parties of the multisig so they can sign and broadcast it.

Second signature and broadcast

  1. The second signer clicks Verify at the top of the Coinbin website and pastes the encoded string the previous signer shared with you. If you are ok with it, click Sign at the top of the page and paste your WIF private key text field and the encoded transaction shared with you in the text field below.
  2. Click Submit to get a new encoded transaction string.
  3. Copy and save it.

Verify transaction before broadcasting

  1. Confirm everything is correct and click Broadcast at the top of the page.
  2. After you have signed the transaction paste the encoded transaction string and click Submit.
  3. When complete, delete the bisqWallet.txt file created in step 1.