Suggested update to documentation

[neha]

In the “Connectors make swap atomic” section here:

Protocol - Second Technical Docs

It’s a little unclear what’s happening with the new on-chain transaction with W, X, Y, and Z and why an exit transaction mentioning A feeds into a Forfeit transaction mentioning D. My interpretation:

You’re showing an example where A, B, C, and D have all spent their VTXOs to W, X, Y, and Z. I think you’re trying to show A’s spend and A signing a forfeit transaction, which is why one of the inputs to the Forfeit is A’s exit transaction, but the actual transaction labeled “Forfeit” talks about D. I think you want to change that to “A” (and maybe add to the text saying this is showing A spending a VTXO to X or something).

Do I have that right or am I misunderstanding?

[steven]

You’re right. The output of the forfeit tx should be just S, because it’s spendable by the server. We’ll correct that. I created an issue on our docs repo for this

[neha]

Thanks!

Just in case anyone else reads this: I was right and wrong. Wrong about the correct version of the Forfeit transaction mentioning A at all, it should just spend to S (I got confused between the “forfeit clause” and the “forfeit transaction”).

[steven]

We fixed the graphics here: #53 - docs: Fix error on forfeit graph - ark-bitcoin/docs - Codeberg.org Thanks for noticing this!

[neha]

Another documentation nit: I think you have the amounts for the exit transactions A and B and the amounts for C and D swapped in this figure: