mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-02-22 22:45:27 +01:00
8a8dabaa58
This adds a `state_change` 'cause' to a channel. A 'cause' is some initial 'reason' a channel was created or closed by: /* Anything other than the reasons below. Should not happen. */ REASON_UNKNOWN, /* Unconscious internal reasons, e.g. dev fail of a channel. */ REASON_LOCAL, /* The operator or a plugin opened or closed a channel by intention. */ REASON_USER, /* The remote closed or funded a channel with us by intention. */ REASON_REMOTE, /* E.g. We need to close a channel because of bad signatures and such. */ REASON_PROTOCOL, /* A channel was closed onchain, while we were offline. */ /* Note: This is very likely a conscious remote decision. */ REASON_ONCHAIN If a 'cause' is known and a subsequent state change is made with `REASON_UNKNOWN` the preceding cause will be used as reason, since a lot (all `REASON_UNKNOWN`) state changes are a subsequent consequences of a prior cause: local, user, remote, protocol or onchain. Changelog-Added: Plugins: Channel closure resaon/cause to channel_state_changed notification
57 lines
1.4 KiB
C
57 lines
1.4 KiB
C
#ifndef LIGHTNING_LIGHTNINGD_CHANNEL_STATE_H
|
|
#define LIGHTNING_LIGHTNINGD_CHANNEL_STATE_H
|
|
#include "config.h"
|
|
|
|
/* These are in the database, so don't renumber them! */
|
|
enum channel_state {
|
|
/* In channeld, still waiting for lockin. */
|
|
CHANNELD_AWAITING_LOCKIN = 2,
|
|
|
|
/* Normal operating state. */
|
|
CHANNELD_NORMAL,
|
|
|
|
/* We are closing, pending HTLC resolution. */
|
|
CHANNELD_SHUTTING_DOWN,
|
|
|
|
/* Exchanging signatures on closing tx. */
|
|
CLOSINGD_SIGEXCHANGE,
|
|
|
|
/* Waiting for onchain event. */
|
|
CLOSINGD_COMPLETE,
|
|
|
|
/* Waiting for unilateral close to hit blockchain. */
|
|
AWAITING_UNILATERAL,
|
|
|
|
/* We've seen the funding spent, we're waiting for onchaind. */
|
|
FUNDING_SPEND_SEEN,
|
|
|
|
/* On chain */
|
|
ONCHAIN,
|
|
|
|
/* Final state after we have fully settled on-chain */
|
|
CLOSED
|
|
};
|
|
#define CHANNEL_STATE_MAX CLOSED
|
|
|
|
enum state_change {
|
|
/* Anything other than the reasons below. Should not happen. */
|
|
REASON_UNKNOWN,
|
|
|
|
/* Unconscious internal reasons, e.g. dev fail of a channel. */
|
|
REASON_LOCAL,
|
|
|
|
/* The operator or a plugin opened or closed a channel by intention. */
|
|
REASON_USER,
|
|
|
|
/* The remote closed or funded a channel with us by intention. */
|
|
REASON_REMOTE,
|
|
|
|
/* E.g. We need to close a channel because of bad signatures and such. */
|
|
REASON_PROTOCOL,
|
|
|
|
/* A channel was closed onchain, while we were offline. */
|
|
/* Note: This is very likely a conscious remote decision. */
|
|
REASON_ONCHAIN
|
|
};
|
|
|
|
#endif /* LIGHTNING_LIGHTNINGD_CHANNEL_STATE_H */
|