Creating a Core Lightning channel funded by JoinMarket

Software Version

bitcoin core: 0.21.0
core lightning: 0.11.1
joinmarket: 0.9.6

Step 1:

Connect to the peer node:

lightning-cli connect 036g....(target_node_public_key)

Start the open channel negotiation with the peer node, and get the funding address

lightning-cli fundchannel_start 036g....(target_node_public_key) \
1000000(amount in satoshis) \
normal(fee_rate, can also be numbers like 3000, which means 3000 sats per kilobyte) \
true(public channel) \
return_address(pick an external address of joinmarket)

Result is something like this:

{
   "funding_address": "bc1qypf...",
   "scriptpubkey": "0020...",
   "close_to": "0014...",
   "warning_usage": "The funding transaction MUST NOT be broadcast until after channel establishment has been successfully completed by running `fundchannel_complete`"
}

[Optional] Set a label in JM for the return_address

Set a label for the return address so that you remember not to reuse that particular address:

python wallet-tool.py wallet.jmdat setlabel \
bc1qypf...(return_address) \
lightning-close-target(the label for the address in JM)

Step 2:

In joinmarket, create a PSBT that is funded by the joinmarket fund. Do Not Broadcast this transaction yet!

python sendpayment.py wallet.jmdat [-m 3](optional, the target mixdepth) \
-N 0 (no coinjoin, coinjoin isn't allowed when creating psbt tx in JM) \
--psbt 0.01 (The amount to send in Bitcoin, must be equal to the amount of step 1) \
bc1qypf...(The funding address returned in step 1)

The result should be similar to the following:

2022-08-20 16:45:29,576 [INFO]  Using a change value of: 0.xxxxxxxx BTC (xxx sat).
Completed PSBT created: 
{
    "psbt-version": 0,
...
}
2022-08-20 16:45:29,706 [INFO]  This PSBT is fully signed and can be sent externally for broadcasting:
2022-08-20 16:45:29,707 [INFO]  cHNidAbC......
done

Step 3:

Complete the open channel negotiation with the peer node, get them to sign the commitment transaction, so that the funding transaction would then be safe to be broadcasted.

lightning-cli fundchannel_complete 036g....(target_node_public_key) "cHNidAbC..."(The signed PSBT returned in Step 2)

Step 4:

Finalize the PSBT to a raw transaction so that it can be broadcasted.

bitcoin-cli finalizepsbt "cHNidAbC...."(The signed PSBT returned in Step 2)

Optional Step:

Decode the raw transaction, make sure the txid is consistent with the funding_txid that lightningd is expecting.

bitcoin-cli decoderawtransaction "020000000001018....." (The raw transaction returned in Step 4)
lightning-cli listpeers

Step 5:

All preparations are done, broadcast the transaction, wait for 3 confirmations, and the channel will be open. When the channel is closed, your own balance would be returned to the JoinMarket address you specified in Step 1. Using this process, all your on-chain balances can be kept inside JoinMarket, and you don't need to worry about transfering fund between your lightning node and your JoinMarket wallet.

bitcoin-cli sendrawtransaction "020000000001018....." (The raw transaction returned in Step 4)

BitcoinWukong/Fund c-lightning channel with JoinMarket.md