core-lightning/common/permute_tx.h

#ifndef LIGHTNING_COMMON_PERMUTE_TX_H
#define LIGHTNING_COMMON_PERMUTE_TX_H
#include "config.h"
#include "bitcoin/tx.h"

struct htlc;

/**
 * permute_outputs: permute the transaction outputs into BIP69 + cltv order.
 * @tx: the transaction whose outputs are to be sorted (outputs must be tal_arr).
 * @cltvs: CLTV delays to use as a tie-breaker, or NULL.
 * @map: if non-NULL, pointers to be permuted the same as the outputs.
 *
 * So the caller initiates the map with which htlcs are used, it
 * can easily see which htlc (if any) is in output #0 with map[0].
 */
void permute_outputs(struct bitcoin_tx *tx, u32 *cltvs, const void **map);
#endif /* LIGHTNING_COMMON_PERMUTE_TX_H */
headers: fix up header idempotent lines. For future reference, done via: for f in `find wire/ bitcoin/ common/ lightningd -name '.h' ! -name 'gen'`; do ID=`echo -n LIGHTNING/$f \| tr 'a-z' 'A-Z' \| tr -cs 'A-Z0-9' _`; sed 's/^#\(ifndef\\|define\) ._H$/#\1 '$ID/ < $f \| sed 's,#endif /.._H ./$,#endif /* '$ID' */,' \| bagto $f; done Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-08-28 18:06:01 +02:00			`#ifndef LIGHTNING_COMMON_PERMUTE_TX_H`
			`#define LIGHTNING_COMMON_PERMUTE_TX_H`
header cleanup: sort include lines into alpha order, after config.h This makes merging easier in future. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2016-01-21 21:08:08 +01:00			`#include "config.h"`
Move bitcoin stuff into bitcoin subdir. It's not very interesting if you're looking for LN code. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2015-06-12 04:23:27 +02:00			`#include "bitcoin/tx.h"`
Rename perturb to permute. Perturb is a bit stretched for this, permute is better. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2015-05-29 05:29:09 +02:00
permute_tx: reintroduce permute map. We used to have a permutation map; this reintroduces a variant which uses the htlc pointers directly. We need this because we have to send the htlc-tx signatures in output order as part of the protocol: without two-stage HTLCs we only needed to wire them up in the unilateral spend case so we simply brute-forced the ordering. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-02-07 02:44:22 +01:00			`struct htlc;`

channeld: tiebreak identical HTLC outputs by CLTV. This was suggested by Pierre-Marie as the solution to the 'same HTLC, different CLTV' signature mismatch. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2018-10-22 06:21:05 +02:00			`/**`
			`* permute_outputs: permute the transaction outputs into BIP69 + cltv order.`
tx: Change permute_{inputs,outputs} to sort both old and new txs This is required in order for both old and new transactions to be identical. Signed-off-by: Christian Decker <decker.christian@gmail.com> 2019-03-14 17:47:13 +01:00			`* @tx: the transaction whose outputs are to be sorted (outputs must be tal_arr).`
channeld: tiebreak identical HTLC outputs by CLTV. This was suggested by Pierre-Marie as the solution to the 'same HTLC, different CLTV' signature mismatch. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2018-10-22 06:21:05 +02:00			`* @cltvs: CLTV delays to use as a tie-breaker, or NULL.`
			`* @map: if non-NULL, pointers to be permuted the same as the outputs.`
permute_tx: reintroduce permute map. We used to have a permutation map; this reintroduces a variant which uses the htlc pointers directly. We need this because we have to send the htlc-tx signatures in output order as part of the protocol: without two-stage HTLCs we only needed to wire them up in the unilateral spend case so we simply brute-forced the ordering. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-02-07 02:44:22 +01:00			`*`
permute_tx: generic pointer map. Turns out we want to permute transactions for the wallet too, so we use void rather than assume we're shuffling htlc (and do inputs, too!). Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-02-21 05:45:29 +01:00			`* So the caller initiates the map with which htlcs are used, it`
			`* can easily see which htlc (if any) is in output #0 with map[0].`
permute_tx: reintroduce permute map. We used to have a permutation map; this reintroduces a variant which uses the htlc pointers directly. We need this because we have to send the htlc-tx signatures in output order as part of the protocol: without two-stage HTLCs we only needed to wire them up in the unilateral spend case so we simply brute-forced the ordering. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-02-07 02:44:22 +01:00			`*/`
tx: Change permute_{inputs,outputs} to sort both old and new txs This is required in order for both old and new transactions to be identical. Signed-off-by: Christian Decker <decker.christian@gmail.com> 2019-03-14 17:47:13 +01:00			`void permute_outputs(struct bitcoin_tx tx, u32 cltvs, const void **map);`
headers: fix up header idempotent lines. For future reference, done via: for f in `find wire/ bitcoin/ common/ lightningd -name '.h' ! -name 'gen'`; do ID=`echo -n LIGHTNING/$f \| tr 'a-z' 'A-Z' \| tr -cs 'A-Z0-9' _`; sed 's/^#\(ifndef\\|define\) ._H$/#\1 '$ID/ < $f \| sed 's,#endif /.._H ./$,#endif /* '$ID' */,' \| bagto $f; done Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-08-28 18:06:01 +02:00			`#endif /* LIGHTNING_COMMON_PERMUTE_TX_H */`