Huey735: /* Warning */ Add link to guide to switch to a new data directory

2021-01-20T07:11:12Z

Warning: Add link to guide to switch to a new data directory

Huey735: /* What you need */ Correct the field name for the trader's private key

2021-01-20T07:08:38Z

What you need: Correct the field name for the trader's private key

Huey735: Create a guide on how to use the Emergency Multisig payout tool

2021-01-20T06:49:48Z

Create a guide on how to use the Emergency Multisig payout tool

New page

== Summary ==
This tool allows for a Mediator to create an unsigned transaction releasing the funds in the 2-of-2 multisig controlled by the traders and send it to each of them, have them sign it and return the signatures and have the the Mediator combine the three pieces (unsigned transaction and both signatures from the traders) to broadcast the transaction.

== Warning ==
In this process traders copy and paste their private keys from the Bisq software into a notepad. As a precaution it is advised they remove all of their funds from this wallet before starting this procedure and move on to a new wallet – directory change reference

== Precautions ==
The traders need to make sure the transaction details match the correct resolution before signing.

== What you need ==
As Mediator

{| class="wikitable"
|-
! fields !! description
|-
| depositTxId || ID for the transaction that sent both trader’s funds into the 2-of-2 multisig
|-
| amountInMultisig || Amount locked in the 2-of-2 multisig
|-
| buyerPayoutAmount || Amount to be released to the BTC buyer
|-
| sellerPayoutAmount || Amount to be released to the BTC seller
|-
| buyerPayoutAddress || Address onto which the BTC buyer should be paid
|-
| sellerPayoutAddress || Address onto which the BTC seller should be paid
|-
| buyerPubKeyAsHex || BTC buyer’s public key
|-
| sellerPubKeyAsHex || BTC seller’s public key
|}

As a trader (each one only needs their own private key)

{| class="wikitable"
|-
! fields !! description
|-
| buyerPrivKeyAsHex || BTC buyer’s private key
|-
| sellerPrivKeyAsHex || BTC seller’s private key
|}

Open a text editor where you can gather all this information.

== Get multisig public keys ==
Each trader involved can get their public keys and the other trader's in their trade JSON contract.
# Find your trade under PORTFOLIO.
# 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:

<nowiki>
BuyerMultiSigPubKeyHex: <hex value>
SellerMultiSigPubKeyHex: <hex value></nowiki>

== Get private keys ==
To access your Bisq wallet private key
# Press ctrl + j, alt +j or cmd + j.
# Check Include private keys and click COPY TO CLIPBOARD and paste it to a text editor.
# 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.
# When you've found this entry, select and copy the priv HEX=<hex value>. This value is the private key.
# 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 ==
Open the trade details and click on VIEW CONTRACT IN JSON FORMAT. At the end of the JSON contract file you can also find the intended payout address for each trader:
<nowiki>
makerPayoutAddressString: <address value>
takerPayoutAddressString: <address value> </nowiki>

== Create Transaction ==
# Press ctrl+g. Click INPUTS and fill in the fields.
# Once finished click EXPORT and copy the string you get, save it and share it with each trader. This is the unsigned transaction

== Sign Transaction ==
# Press ctrl+g and click IMPORT. Copy the string you got on step 2, paste it in the first field and press IMPORT FROM STRING. It should populate the view with the information about the payout transaction.
# Go to SIGN and paste your private key for this trade (priv HEX=) and click GENERATE SIGNATURE.
# Copy the signature hex that you get and share it with the mediator

== Broadcast The Transaction ==
# Press ctrl+g and click IMPORT. Copy the string you got on step 2, paste it in the first field and press IMPORT FROM STRING. It should populate the view with the info about the payout transaction.
# Click BUILD (to the let). Paste the Buyer's signature on the first field and the Seller's on the second field.
# Click the BUILD button bellow the field where you pasted the signatures and it should populate with the signed transaction. Save the resulting text just to be safe.
# Click BROADCAST.
# Verify on a block explorer that the transaction was indeed broadcast.

@@ Line 3: / Line 3: @@
 == Warning ==
-In this process traders copy and paste their private keys from the Bisq software into a notepad. As a precaution it is advised they remove all of their funds from this wallet before starting this procedure and move on to a new wallet – directory change reference
+In this process traders copy and paste their private keys from the Bisq software into a notepad. As a precaution it is advised they remove all of their funds from this wallet before starting this procedure and consider [[Switching to a new data directory|switching to a new data directory]] to get a new wallet.
 == Precautions ==

@@ Line 38: / Line 38: @@
 ! fields !! description
 |-
-| buyerPrivKeyAsHex || BTC buyer’s private key
+| privatekeyHex || your private key for this trade
 |}

Emergency Multisig payout tool - Revision history

Huey735: /* Warning */ Add link to guide to switch to a new data directory

Huey735: /* What you need */ Correct the field name for the trader's private key

Huey735: Create a guide on how to use the Emergency Multisig payout tool