mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-02-22 14:42:40 +01:00
4fdc74f100
Add a little bit of uncertainty to the local channels to avoid consuming precisely all spendable_msat on our side, which leads to temporary channel failure if the spendable_msat changes during the course of the payment. Signed-off-by: Lagrang3 <lagrang3@protonmail.com>
69 lines
2.6 KiB
C
69 lines
2.6 KiB
C
#ifndef LIGHTNING_PLUGINS_RENEPAY_UNCERTAINTY_H
|
|
#define LIGHTNING_PLUGINS_RENEPAY_UNCERTAINTY_H
|
|
#include "config.h"
|
|
#include <ccan/tal/tal.h>
|
|
#include <common/gossmap.h>
|
|
#include <plugins/renepay/chan_extra.h>
|
|
#include <plugins/renepay/route.h>
|
|
|
|
/* FIXME a hard coded constant to indicate a limit on any channel
|
|
capacity. Channels for which the capacity is unknown (because they are not
|
|
announced) use this value. It makes sense, because if we don't even know the
|
|
channel capacity the liquidity could be anything but it will never be greater
|
|
than the global number of msats.
|
|
It remains to be checked if this value does not lead to overflow somewhere in
|
|
the code. */
|
|
#define MAX_CAPACITY (AMOUNT_MSAT(21000000 * MSAT_PER_BTC))
|
|
|
|
struct uncertainty {
|
|
struct chan_extra_map *chan_extra_map;
|
|
};
|
|
|
|
/* FIXME: add bool return value and WARN_UNUSED_RESULT */
|
|
void uncertainty_route_success(struct uncertainty *uncertainty,
|
|
const struct route *route);
|
|
void uncertainty_remove_htlcs(struct uncertainty *uncertainty,
|
|
const struct route *route);
|
|
|
|
void uncertainty_commit_htlcs(struct uncertainty *uncertainty,
|
|
const struct route *route);
|
|
|
|
void uncertainty_channel_can_send(struct uncertainty *uncertainty,
|
|
struct short_channel_id scid, int direction);
|
|
|
|
void uncertainty_channel_cannot_send(struct uncertainty *uncertainty,
|
|
struct short_channel_id scid,
|
|
int direction);
|
|
|
|
WARN_UNUSED_RESULT int uncertainty_update(struct uncertainty *uncertainty,
|
|
struct gossmap *gossmap);
|
|
|
|
struct uncertainty *uncertainty_new(const tal_t *ctx);
|
|
|
|
struct chan_extra_map *
|
|
uncertainty_get_chan_extra_map(struct uncertainty *uncertainty);
|
|
|
|
const struct chan_extra *
|
|
uncertainty_add_channel(struct uncertainty *uncertainty,
|
|
const struct short_channel_id scid,
|
|
struct amount_msat capacity);
|
|
|
|
bool uncertainty_set_liquidity(struct uncertainty *uncertainty,
|
|
const struct short_channel_id_dir *scidd,
|
|
struct amount_msat min,
|
|
struct amount_msat max);
|
|
|
|
struct chan_extra *uncertainty_find_channel(struct uncertainty *uncertainty,
|
|
const struct short_channel_id scid);
|
|
|
|
/* Adds randomness to the current state simulating the natural evolution of the
|
|
* liquidity in the network. It should be a markovian process with the minimum
|
|
* requirement that the transition operator T satisfies:
|
|
* T(t1) T(t2) = T(t1+t2)
|
|
* i.e. the transition operator is a one parameter semigroup.
|
|
* For the moment we omit the continuous and linear aspects of the problem for a
|
|
* lack for formulation. */
|
|
enum renepay_errorcode uncertainty_relax(struct uncertainty *uncertainty,
|
|
double seconds);
|
|
|
|
#endif /* LIGHTNING_PLUGINS_RENEPAY_UNCERTAINTY_H */
|