mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-01-18 05:12:45 +01:00
98d994f930
This is where we expose the revocation preimages for the escape transactions. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
135 lines
4.3 KiB
C
135 lines
4.3 KiB
C
#ifndef LIGHTNING_PKT_H
|
|
#define LIGHTNING_PKT_H
|
|
/* Simple (non-threadsafe!) wrapper for protobufs.
|
|
*
|
|
* This could be a simple set of macros, if the protobuf-c people hadn't
|
|
* insisted on "prettifing" the names they generate into CamelCase.
|
|
*/
|
|
#include <ccan/endian/endian.h>
|
|
#include <ccan/short_types/short_types.h>
|
|
#include <ccan/tal/tal.h>
|
|
#include "lightning.pb-c.h"
|
|
|
|
/* A packet, ready to be de-protobuf'ed. */
|
|
struct pkt {
|
|
le32 len;
|
|
u8 data[];
|
|
};
|
|
|
|
/* Utility helper: dies if there's a problem. */
|
|
Pkt *pkt_from_file(const char *filename, Pkt__PktCase expect);
|
|
Pkt *any_pkt_from_file(const char *filename);
|
|
|
|
/* Total length of packet, including header. */
|
|
size_t pkt_totlen(const struct pkt *pkt);
|
|
|
|
struct sha256;
|
|
struct sha256_double;
|
|
struct bitcoin_compressed_pubkey;
|
|
struct signature;
|
|
struct pubkey;
|
|
|
|
/**
|
|
* openchannel_pkt - create an openchannel message
|
|
* @ctx: tal context to allocate off.
|
|
* @revocation_hash: first hash value generated from seed.
|
|
* @commit: the pubkey for commit transactions.
|
|
* @final: the pubkey for the commit transactions' output and escape input.
|
|
* @commitment_fee: the fee to use for commitment tx.
|
|
* @rel_locktime_seconds: relative seconds for commitment locktime.
|
|
* @anchor_txid: the anchor transaction ID.
|
|
* @anchor_amount: the anchor amount.
|
|
* @escape_hash: the hash whose preimage will revoke our escape txs.
|
|
* @min_confirms: how many confirms we want on anchor.
|
|
*/
|
|
struct pkt *openchannel_pkt(const tal_t *ctx,
|
|
const struct sha256 *revocation_hash,
|
|
const struct pubkey *commit,
|
|
const struct pubkey *final,
|
|
u64 commitment_fee,
|
|
u32 rel_locktime_seconds,
|
|
u64 anchor_amount,
|
|
const struct sha256 *escape_hash,
|
|
u32 min_confirms);
|
|
|
|
/**
|
|
* open_anchor_pkt - create an open_anchor_sig message
|
|
* @ctx: tal context to allocate off.
|
|
* @txid: the anchor's txid
|
|
* @index: the anchor's output to spend.
|
|
*/
|
|
struct pkt *open_anchor_pkt(const tal_t *ctx,
|
|
const struct sha256_double *txid, u32 index);
|
|
|
|
/**
|
|
* open_commit_sig_pkt - create an open_commit_sig message
|
|
* @ctx: tal context to allocate off.
|
|
* @sigs: two signatures for the commit transaction inputs
|
|
*/
|
|
struct pkt *open_commit_sig_pkt(const tal_t *ctx,
|
|
const struct signature *sigs);
|
|
|
|
/**
|
|
* open_complete_pkt - create an open_complete message
|
|
* @ctx: tal context to allocate off.
|
|
* @escape_preimage: preimage to revoke escape transactions.
|
|
*/
|
|
struct pkt *open_complete_pkt(const tal_t *ctx,
|
|
const struct sha256 *escape_preimage);
|
|
|
|
/**
|
|
* close_channel_pkt - create an close_channel message
|
|
* @ctx: tal context to allocate off.
|
|
* @sigs: two signatures for the close transaction inputs
|
|
*/
|
|
struct pkt *close_channel_pkt(const tal_t *ctx,
|
|
const struct signature *sigs);
|
|
|
|
/**
|
|
* close_channel_complete_pkt - create an close_channel_complete message
|
|
* @ctx: tal context to allocate off.
|
|
* @sigs: two signatures for the close transaction inputs
|
|
*/
|
|
struct pkt *close_channel_complete_pkt(const tal_t *ctx,
|
|
const struct signature *sigs);
|
|
|
|
|
|
/**
|
|
* update_pkt - create an update message
|
|
* @ctx: tal context to allocate off.
|
|
* @revocation_hash: the revocation hash for the next tx.
|
|
* @delta: the change in satoshis (to me).
|
|
*/
|
|
struct pkt *update_pkt(const tal_t *ctx,
|
|
const struct sha256 *revocation_hash,
|
|
s64 delta);
|
|
|
|
/**
|
|
* update_accept_pkt - create an update_accept message
|
|
* @ctx: tal context to allocate off.
|
|
* @sigs: two signatures for the commit transaction inputs
|
|
* @revocation_hash: hash to revoke the next tx.
|
|
*/
|
|
struct pkt *update_accept_pkt(const tal_t *ctx,
|
|
const struct signature *sigs,
|
|
const struct sha256 *revocation_hash);
|
|
|
|
/**
|
|
* update_signature_pkt - create an update_signature message
|
|
* @ctx: tal context to allocate off.
|
|
* @sigs: two signatures for the commit transaction inputs
|
|
* @revocation_preimage: preimage to revoke existing (now-obsolete) tx.
|
|
*/
|
|
struct pkt *update_signature_pkt(const tal_t *ctx,
|
|
const struct signature *sigs,
|
|
const struct sha256 *revocation_preimage);
|
|
/**
|
|
* update_complete_pkt - create an update_accept message
|
|
* @ctx: tal context to allocate off.
|
|
* @revocation_preimage: preimage to revoke existing (now-obsolete) tx.
|
|
*/
|
|
struct pkt *update_complete_pkt(const tal_t *ctx,
|
|
const struct sha256 *revocation_preimage);
|
|
|
|
#endif /* LIGHTNING_PKT_H */
|