Please clarify "multifundchannel"

[hMsats]

The option multifundchannel is totally unclear (to me). I know it's still experimental, but still.

To use it:

"destinations is an array of objects, with the fields". What does an "array of objects" look like? I have no idea. PLEASE ADD AN EXAMPLE! For example, somewhere here.

Is it:

lightning-cli id=123 amount=100000 id=456 amount=150000 feerate=5000perkb

or something like this

lightning-cli destinations={123 100000 456 150000} feerate=5000perkb

Is it JSON related? A simple example would clear it all up.

Also, in the lightning-cli help add an example. The use of the "=" is also not obvious, could just as well have been a space. I know that now but in the past I had to find that out by googling.

Finally: thanks for all the hard work 😀

[manreo]

@rustyrussell

[manreo]

@ZmnSCPxj ?

[manreo]

Should look something like that:
#4100 (comment)
@cdecker

[hMsats]

Such an example is indispensable in: lightning-cli help multifundchannel

[manreo]

I agree..

[openoms]

My favourite format (also json autoformatting tools help - like CTRL+SHIFT+i in VSCode):

₿ lightning-cli multifundchannel '[
    {
        "id": "nodeID1",
        "amount": "amount_in_sats"
    },
    {
        "id": "nodeID2",
        "amount": "amount_in_sats"
    },
    {
        "id": "nodeID3",
        "amount": "amount_in_sats"
    },
    {
        "id": "nodeID4",
        "amount": "amount_in_sats",
    }
]' 1000perkb

Returned output:

{
    "tx": "RAW............TX",
    "txid": "TX................ID",
    "channel_ids": [
        {
            "id": "nodeID1",
            "channel_id": "CHANNEL_ID2",
            "outnum": 3
        },
        {
            "id": "nodeID2",
            "channel_id": "CHANNEL_ID1",
            "outnum": 4
        },
        {
            "id": "nodeID3",
            "channel_id": "CHANNEL_ID4",
            "outnum": 1
        },
        {
            "id": "nodeID4",
            "channel_id": "CHANNEL_ID3",
            "outnum": 2
        }
    ],
    "failed": []
}

[Donach]

This is still not clarified in the documentation...

[vincenzopalazzo]

I guess the docs is clear?

The multifundchannel RPC command opens multiple payment channels
with nodes by committing a single funding transaction to the blockchain
that is shared by all channels.

You can open N channel with a single funding transaction, we use this command inside the fundchannel, so you can consider it like a low level command

Closing this, because I think our docs is pretty clear