Difference between revisions of "Manual payout"
Line 29: | Line 29: | ||
You will need to use the Emergy multisig payout tool (Ctrl+g) to release the funds. | You will need to use the Emergy multisig payout tool (Ctrl+g) to release the funds. | ||
− | 1 | + | |
− | 2 | + | # 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> | <unsigend transaction string> |
Revision as of 23:34, 4 January 2021
Contents
- 1 Warning
- 2 Precautions
- 3 What you need
- 4 Using Bisq's Manual Payout tool
- 5 Get multisig public keys
- 6 Get private keys
- 7 Get payout addresses
- 8 Recreating Redeem script
- 9 Creating transaction
- 10 Verify transaction
- 11 Sign transaction
- 12 Second signature and broadcast
- 13 Verify transaction before broadcasting
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 ofpriv 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.
Tools you need:
- Bisq software
- Blockstream's block explorer
- Coinbin web wallet
- Tor browser
Using Bisq's Manual Payout tool
Please press Ctrl+J and check the include private keys, click 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: ...
You will need 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 your mediator.
Get multisig public keys
Each trader involved can get their public keys and the other trader's public keys in their trade JSON contract.
- Find your trade under
PORTFOLIO
. - Click the
i
icon next to the trade ID, and at the bottom clickVIEW 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
- Press
Ctrl + j
,alt +j
orcmd + j
. - Check
Include private keys
and clickCOPY TO CLIPBOARD
. - 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 WIF=<hex value>
value that immediately follows the pub 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
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.
- Go to the Coinbin web wallet:
- At the top click
New
and from the dropdown menu chooseMultiSig Address
- Paste the three public keys in the following order 1) SellerMultiSigPubKeyHex, 2) BuyerMultiSigPubKeyHex
- 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. - Copy and save the Redeem Script.
Creating transaction
- Again, click
New
at the top, but this time chooseTransaction
from the dropdown menu. - 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. - For the first input fill in an address from
makerPayoutAddressString
and the respective trade amount. - Add a new output by clicking the
+
sign next to theamount
field. For this second output paste the address that belongs totakerPayoutAddressString
and the respective trade amount. - Copy and save the transaction.
- 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
- Click
Sign
at the top of the page and paste your WIF private key in thePrivate key
text field and the encoded transaction in the text field below. - Click
Submit
to get a new encoded transaction string. - 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
- 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, clickSign
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. - Click
Submit
to get a new encoded transaction string. - Copy and save it.
Verify transaction before broadcasting
- Confirm everything is correct and click
Broadcast
at the top of the page. - After you have signed the transaction paste the encoded transaction string and click
Submit
. - When complete, delete the
bisqWallet.txt
file created in step 1.