funder-liqudity-ads: support options + setliquidity ad

Implement support for liquidity ads in `funder` plugin. We set the command line options for the leases, as well as sending the updated ads to lightningd (who then passes them through to gossipd)
2024-11-19 09:54:16 +01:00 · 2021-05-26 18:13:08 -05:00 · 2021-05-26 18:13:08 -05:00 · 9387e4645b
commit 9387e4645b
parent 9431984cef
4 changed files with 380 additions and 47 deletions
--- a/plugins/Makefile
+++ b/plugins/Makefile
@ -118,6 +118,7 @@ PLUGIN_COMMON_OBJS :=				\
 	common/json_helpers.o			\
 	common/json_stream.o			\
 	common/json_tok.o			\
+	common/lease_rates.o			\
 	common/memleak.o			\
 	common/node_id.o			\
 	common/param.o				\
@ -151,7 +152,7 @@ plugins/bcli: bitcoin/chainparams.o $(PLUGIN_BCLI_OBJS) $(PLUGIN_LIB_OBJS) $(PLU
 plugins/keysend: bitcoin/chainparams.o wire/tlvstream.o wire/onion$(EXP)_wiregen.o $(PLUGIN_KEYSEND_OBJS) $(PLUGIN_LIB_OBJS) $(PLUGIN_PAY_LIB_OBJS) $(PLUGIN_COMMON_OBJS) $(JSMN_OBJS) $(CCAN_OBJS) common/gossmap.o common/fp16.o common/route.o common/dijkstra.o
 $(PLUGIN_KEYSEND_OBJS): $(PLUGIN_PAY_LIB_HEADER)

-plugins/spenderp: bitcoin/chainparams.o bitcoin/psbt.o common/psbt_open.o $(PLUGIN_SPENDER_OBJS) $(PLUGIN_LIB_OBJS) $(PLUGIN_COMMON_OBJS) $(JSMN_OBJS) $(CCAN_OBJS)
+plugins/spenderp: bitcoin/block.o bitcoin/chainparams.o bitcoin/preimage.o bitcoin/psbt.o common/psbt_open.o wire/peer${EXP}_wiregen.o $(PLUGIN_SPENDER_OBJS) $(PLUGIN_LIB_OBJS) $(PLUGIN_COMMON_OBJS) $(JSMN_OBJS) $(CCAN_OBJS)

 plugins/offers: bitcoin/chainparams.o $(PLUGIN_OFFERS_OBJS) $(PLUGIN_LIB_OBJS) $(PLUGIN_COMMON_OBJS) common/bolt12.o common/bolt12_merkle.o common/bolt11_json.o common/iso4217.o $(WIRE_OBJS) bitcoin/block.o common/channel_id.o bitcoin/preimage.o $(JSMN_OBJS) $(CCAN_OBJS)

--- a/plugins/funder.c
+++ b/plugins/funder.c
@ -10,18 +10,21 @@
 #include <bitcoin/feerate.h>
 #include <bitcoin/psbt.h>
 #include <ccan/array_size/array_size.h>
+#include <ccan/json_out/json_out.h>
 #include <ccan/list/list.h>
 #include <ccan/tal/str/str.h>
 #include <common/channel_id.h>
 #include <common/json.h>
 #include <common/json_helpers.h>
 #include <common/json_stream.h>
+#include <common/lease_rates.h>
 #include <common/node_id.h>
 #include <common/psbt_open.h>
 #include <common/type_to_string.h>
 #include <common/utils.h>
 #include <plugins/funder_policy.h>
 #include <plugins/libplugin.h>
+#include <wire/peer_wire.h>

 /* In-progress channel opens */
 static struct list_head pending_opens;
@ -679,7 +682,7 @@ static void json_channel_open_failed(struct command *cmd,
 		unreserve_psbt(open);
 }

-static void policy_to_json(struct json_stream *stream,
+static void json_add_policy(struct json_stream *stream,
 			    struct funder_policy *policy)
 {
 	json_add_string(stream, "summary",
@ -699,6 +702,9 @@ static void policy_to_json(struct json_stream *stream,
 				 policy->reserve_tank);
 	json_add_num(stream, "fuzz_percent", policy->fuzz_factor);
 	json_add_num(stream, "fund_probability", policy->fund_probability);
+
+	if (policy->rates)
+		json_add_lease_rates(stream, policy->rates);
 }

 static struct command_result *
@ -744,75 +750,252 @@ param_policy_mod(struct command *cmd, const char *name,
 	return NULL;
 }

+static struct command_result *
+parse_lease_rates(struct command *cmd, const char *buffer,
+		  const jsmntok_t *tok,
+		  struct funder_policy *policy,
+		  struct funder_policy *current_policy,
+		  u32 *lease_fee_basis,
+		  struct amount_sat *lease_fee_sats,
+		  u32 *funding_weight,
+		  u32 *chan_fee_ppt,
+		  struct amount_msat *chan_fee_msats)
+
+{
+	/* If there's already rates set, we start with those */
+	if (!lease_rates_empty(current_policy->rates))
+		policy->rates = tal_dup(policy, struct lease_rates,
+					current_policy->rates);
+	else if (lease_fee_basis
+		 || lease_fee_sats
+		 || funding_weight
+		 || chan_fee_ppt
+		 || chan_fee_msats)
+		policy->rates = default_lease_rates(policy);
+	else
+		policy->rates = NULL;
+
+
+	if (lease_fee_basis) {
+		policy->rates->lease_fee_basis = *lease_fee_basis;
+
+		/* Check for overflow */
+		if (policy->rates->lease_fee_basis != *lease_fee_basis)
+			return command_fail_badparam(cmd, "lease_fee_basis",
+						     buffer, tok, "overflow");
+	}
+
+	if (lease_fee_sats) {
+		policy->rates->lease_fee_base_sat
+			= lease_fee_sats->satoshis; /* Raw: conversion */
+		if (policy->rates->lease_fee_base_sat
+		    != lease_fee_sats->satoshis) /* Raw: comparison */
+			return command_fail_badparam(cmd, "lease_fee_base_msat",
+						     buffer, tok, "overflow");
+	}
+
+	if (funding_weight) {
+		policy->rates->funding_weight = *funding_weight;
+
+		/* Check for overflow */
+		if (policy->rates->funding_weight != *funding_weight)
+			return command_fail_badparam(cmd, "funding_weight",
+						     buffer, tok, "overflow");
+	}
+
+	if (chan_fee_ppt) {
+		policy->rates->channel_fee_max_proportional_thousandths
+			= *chan_fee_ppt;
+
+		/* Check for overflow */
+		if (policy->rates->channel_fee_max_proportional_thousandths
+				!= *chan_fee_ppt)
+			return command_fail_badparam(cmd, "channel_fee_max_proportional_thousandths",
+						     buffer, tok, "overflow");
+	}
+
+	if (chan_fee_msats) {
+		policy->rates->channel_fee_max_base_msat
+			= chan_fee_msats->millisatoshis; /* Raw: conversion */
+		if (policy->rates->channel_fee_max_base_msat
+		    != chan_fee_msats->millisatoshis) /* Raw: comparison */
+			return command_fail_badparam(cmd,
+						     "channel_fee_max_base_msat",
+						     buffer, tok, "overflow");
+	}
+
+	return NULL;
+}
+
+static struct command_result *
+leaserates_set(struct command *cmd, const char *buf,
+	       const jsmntok_t *result,
+	       struct funder_policy *policy)
+{
+	struct json_stream *res;
+
+	/* Ok, we updated lightningd with latest info */
+	res = jsonrpc_stream_success(cmd);
+	json_add_policy(res, policy);
+	return command_finished(cmd, res);
+}
+
 static struct command_result *
 json_funderupdate(struct command *cmd,
 		  const char *buf,
 		  const jsmntok_t *params)
 {
-	struct json_stream *res;
 	struct amount_sat *min_their_funding, *max_their_funding,
 			  *per_channel_min, *per_channel_max,
-			  *reserve_tank;
-	u32 *fuzz_factor, *fund_probability;
+			  *reserve_tank, *lease_fee_sats;
+	struct amount_msat *channel_fee_msats;
+	u32 *fuzz_factor, *fund_probability, *chan_fee_ppt,
+	    *lease_fee_basis, *funding_weight;
 	u64 *mod;
+	bool *leases_only;
 	enum funder_opt *opt;
+	const struct out_req *req;
 	const char *err;
-	struct funder_policy *policy = current_policy;
+	struct command_result *res;
+
+	struct funder_policy *policy = tal(tal_parent(current_policy),
+					   struct funder_policy);

 	if (!param(cmd, buf, params,
-		   p_opt("policy", param_funder_opt, &opt),
-		   p_opt("policy_mod", param_policy_mod, &mod),
-		   p_opt("min_their_funding", param_sat, &min_their_funding),
-		   p_opt("max_their_funding", param_sat, &max_their_funding),
-		   p_opt("per_channel_min", param_sat, &per_channel_min),
-		   p_opt("per_channel_max", param_sat, &per_channel_max),
-		   p_opt("reserve_tank", param_sat, &reserve_tank),
-		   p_opt("fuzz_percent", param_number, &fuzz_factor),
-		   p_opt("fund_probability", param_number, &fund_probability),
+		   p_opt_def("policy", param_funder_opt, &opt,
+			     current_policy->opt),
+		   p_opt_def("policy_mod", param_policy_mod, &mod,
+			     current_policy->mod),
+		   p_opt_def("leases_only", param_bool, &leases_only,
+			     current_policy->leases_only),
+		   p_opt_def("min_their_funding", param_sat,
+			     &min_their_funding,
+			     current_policy->min_their_funding),
+		   p_opt_def("max_their_funding", param_sat,
+			     &max_their_funding,
+			     current_policy->max_their_funding),
+		   p_opt_def("per_channel_min", param_sat,
+			     &per_channel_min,
+			     current_policy->per_channel_min),
+		   p_opt_def("per_channel_max", param_sat,
+			     &per_channel_max,
+			     current_policy->per_channel_max),
+		   p_opt_def("reserve_tank", param_sat, &reserve_tank,
+			     current_policy->reserve_tank),
+		   p_opt_def("fuzz_percent", param_number,
+			     &fuzz_factor,
+			     current_policy->fuzz_factor),
+		   p_opt_def("fund_probability", param_number,
+			     &fund_probability,
+			     current_policy->fund_probability),
+		   p_opt("lease_fee_base_msat", param_sat, &lease_fee_sats),
+		   p_opt("lease_fee_basis", param_number, &lease_fee_basis),
+		   p_opt("funding_weight", param_number, &funding_weight),
+		   p_opt("channel_fee_max_base_msat", param_msat,
+			 &channel_fee_msats),
+		   p_opt("channel_fee_max_proportional_thousandths",
+			 param_number, &chan_fee_ppt),
 		   NULL))
 		return command_param_failed();

-	if (opt)
 	policy->opt = *opt;
-	if (mod)
 	policy->mod = *mod;
-	if (min_their_funding)
 	policy->min_their_funding = *min_their_funding;
-	if (max_their_funding)
 	policy->max_their_funding = *max_their_funding;
-	if (per_channel_min)
 	policy->per_channel_min = *per_channel_min;
-	if (per_channel_max)
 	policy->per_channel_max = *per_channel_max;
-	if (reserve_tank)
 	policy->reserve_tank = *reserve_tank;
-	if (fuzz_factor)
 	policy->fuzz_factor = *fuzz_factor;
-	if (fund_probability)
 	policy->fund_probability = *fund_probability;
+	policy->leases_only = *leases_only;
+
+	res = parse_lease_rates(cmd, buf, params,
+				policy, current_policy,
+				lease_fee_basis,
+				lease_fee_sats,
+				funding_weight,
+				chan_fee_ppt,
+				channel_fee_msats);
+	if (res)
+		return res;

 	err = funder_check_policy(policy);
-	if (err)
+	if (err) {
+		tal_free(policy);
 		return command_done_err(cmd, JSONRPC2_INVALID_PARAMS,
 					err, NULL);
+	}

+	tal_free(current_policy);
 	current_policy = policy;
-	res = jsonrpc_stream_success(cmd);
-	policy_to_json(res, current_policy);
-	return command_finished(cmd, res);
+
+	/* Update lightningd, also */
+	req = jsonrpc_request_start(cmd->plugin, cmd,
+				    "setleaserates",
+				    &leaserates_set,
+				    &forward_error,
+				    current_policy);
+
+	if (current_policy->rates)
+		json_add_lease_rates(req->js, current_policy->rates);
+	else {
+		/* Add empty rates to turn off */
+		struct lease_rates rates;
+		memset(&rates, 0, sizeof(rates));
+		json_add_lease_rates(req->js, &rates);
+	}
+
+	return send_outreq(cmd->plugin, req);
 }

-static const struct plugin_command commands[] = { {
+static const struct plugin_command commands[] = {
+	{
 		"funderupdate",
-		"channels",
-		"Update configuration for dual-funding offer",
-		"Update current funder settings. Modifies how node"
-		" reacts to incoming channel open requests. Responds with list"
+		"liquidity",
+		"Configuration for dual-funding settings.",
+		"Update current settings. Modifies how node reacts to"
+		" incoming channel open requests. Responds with list"
 		" of current configs.",
 		json_funderupdate
-	}
+	},
 };

+static void tell_lightningd_lease_rates(struct plugin *p,
+					struct lease_rates *rates)
+{
+	struct json_out *jout;
+	struct amount_sat val;
+	struct amount_msat mval;
+
+	/* Tell lightningd with our lease rates*/
+	jout = json_out_new(NULL);
+	json_out_start(jout, NULL, '{');
+
+	val = amount_sat(rates->lease_fee_base_sat);
+	json_out_addstr(jout, "lease_fee_base_msat",
+			type_to_string(tmpctx, struct amount_sat, &val));
+	json_out_add(jout, "lease_fee_basis", false,
+		     "%d", rates->lease_fee_basis);
+
+	json_out_add(jout, "funding_weight", false,
+		     "%d", rates->funding_weight);
+
+	mval = amount_msat(rates->channel_fee_max_base_msat);
+	json_out_addstr(jout, "channel_fee_max_base_msat",
+			type_to_string(tmpctx, struct amount_msat, &mval));
+	json_out_add(jout, "channel_fee_max_proportional_thousandths", false,
+		     "%d", rates->channel_fee_max_proportional_thousandths);
+
+	json_out_end(jout, '}');
+	json_out_finished(jout);
+
+	rpc_scan(p, "setleaserates", take(jout),
+		 /* Unused */
+		 "{lease_fee_base_msat:%}",
+		 JSON_SCAN(json_to_sat, &val));
+
+}
+
 static const char *init(struct plugin *p, const char *b, const jsmntok_t *t)
 {
 	const char *err;
@ -823,6 +1006,9 @@ static const char *init(struct plugin *p, const char *b, const jsmntok_t *t)
 	if (err)
 		plugin_err(p, "Invalid parameter combination: %s", err);

+	if (current_policy->rates)
+		tell_lightningd_lease_rates(p, current_policy->rates);
+
 	return NULL;
 }

@ -856,6 +1042,33 @@ const struct plugin_notification notifs[] = {
 	},
 };

+static char *option_channel_base(const char *arg, struct funder_policy *policy)
+{
+	struct amount_msat amt;
+
+	if (!parse_amount_msat(&amt, arg, strlen(arg)))
+		return tal_fmt(NULL, "Unable to parse amount '%s'", arg);
+
+	if (!policy->rates)
+		policy->rates = default_lease_rates(policy);
+
+	policy->rates->channel_fee_max_base_msat = amt.millisatoshis; /* Raw: conversion */
+
+	if (policy->rates->channel_fee_max_base_msat != amt.millisatoshis) /* Raw: comparison */
+		return tal_fmt(NULL, "channel_fee_max_base_msat overflowed");
+
+	return NULL;
+}
+
+static char *
+option_channel_fee_proportional_thousandths_max(const char *arg,
+						struct funder_policy *policy)
+{
+	if (!policy->rates)
+		policy->rates = default_lease_rates(policy);
+	return u16_option(arg, &policy->rates->channel_fee_max_proportional_thousandths);
+}
+
 static char *amount_option(const char *arg, struct amount_sat *amt)
 {
 	if (!parse_amount_sat(amt, arg, strlen(arg)))
@ -864,6 +1077,41 @@ static char *amount_option(const char *arg, struct amount_sat *amt)
 	return NULL;
 }

+static char *option_lease_fee_base(const char *arg,
+				   struct funder_policy *policy)
+{
+	struct amount_sat amt;
+	char *err;
+	if (!policy->rates)
+		policy->rates = default_lease_rates(policy);
+
+	err = amount_option(arg, &amt);
+	if (err)
+		return err;
+
+	policy->rates->lease_fee_base_sat = amt.satoshis; /* Raw: conversion */
+	if (policy->rates->lease_fee_base_sat != amt.satoshis) /* Raw: comparison */
+		return tal_fmt(NULL, "lease_fee_base_sat overflowed");
+
+	return NULL;
+}
+
+static char *option_lease_fee_basis(const char *arg,
+				    struct funder_policy *policy)
+{
+	if (!policy->rates)
+		policy->rates = default_lease_rates(policy);
+	return u16_option(arg, &policy->rates->lease_fee_basis);
+}
+
+static char *option_lease_weight_max(const char *arg,
+				     struct funder_policy *policy)
+{
+	if (!policy->rates)
+		policy->rates = default_lease_rates(policy);
+	return u16_option(arg, &policy->rates->funding_weight);
+}
+
 static char *amount_sat_or_u64_option(const char *arg, u64 *amt)
 {
 	struct amount_sat sats;
@ -953,6 +1201,42 @@ int main(int argc, char **argv)
 				  " disable dual-funding",
 				  u32_option,
 				  &current_policy->fund_probability),
+		    plugin_option("funder-lease-requests-only",
+				  "bool",
+				  "Only fund lease requests. Defaults to"
+				  " true if channel lease rates are"
+				  " being advertised",
+				  bool_option,
+				  &current_policy->leases_only),
+		    plugin_option("lease-fee-base-msat",
+				  "string",
+				  "Channel lease rates, base fee for leased"
+				  " funds, in satoshi.",
+				  option_lease_fee_base, current_policy),
+		    plugin_option("lease-fee-basis",
+				  "int",
+				  "Channel lease rates, basis charged"
+				  " for leased funds (per 10,000 satoshi.)",
+				  option_lease_fee_basis, current_policy),
+		    plugin_option("lease-funding-weight",
+				  "int",
+				  "Channel lease rates, weight"
+				  " we'll ask opening peer to pay for in"
+				  " funding transaction",
+				  option_lease_weight_max, current_policy),
+		    plugin_option("channel-fee-max-base-msat",
+				  "string",
+				  "Channel lease rates, maximum channel"
+				  " fee base we'll charge for funds"
+				  " routed through a leased channel.",
+				  option_channel_base, current_policy),
+		    plugin_option("channel-fee-max-proportional-thousandths",
+				  "int",
+				  "Channel lease rates, maximum"
+				  " proportional fee (in thousandths, or ppt)"
+				  " we'll charge for funds routed through a"
+				  " leased channel. Note: 1ppt = 1,000ppm",
+				  option_channel_fee_proportional_thousandths_max, current_policy),
 		    NULL);

 	tal_free(owner);
--- a/plugins/funder_policy.c
+++ b/plugins/funder_policy.c
@ -1,5 +1,7 @@
 #include <assert.h>
+#include <bitcoin/script.h>
 #include <ccan/tal/str/str.h>
+#include <common/lease_rates.h>
 #include <common/node_id.h>
 #include <common/pseudorand.h>
 #include <common/type_to_string.h>
@ -59,7 +61,9 @@ new_funder_policy(const tal_t *ctx,
 		  struct amount_sat per_channel_max,
 		  u32 fuzz_factor,
 		  struct amount_sat reserve_tank,
-		  u32 fund_probability)
+		  u32 fund_probability,
+		  bool leases_only,
+		  struct lease_rates *rates)
 {
 	struct funder_policy *policy = tal(ctx, struct funder_policy);

@ -72,6 +76,8 @@ new_funder_policy(const tal_t *ctx,
 	policy->fuzz_factor = fuzz_factor;
 	policy->reserve_tank = reserve_tank;
 	policy->fund_probability = fund_probability;
+	policy->leases_only = leases_only;
+	policy->rates = rates;

 	return policy;
 }
@ -88,7 +94,34 @@ default_funder_policy(const tal_t *ctx,
 				 AMOUNT_SAT(UINT_MAX),
 				 0, 		/* fuzz_factor */
 				 AMOUNT_SAT(0), /* reserve_tank */
-				 100);
+				 100,
+				 /* Defaults to true iif we're advertising
+				  * offers */
+				 false,
+				 NULL);
+}
+
+struct lease_rates *
+default_lease_rates(const tal_t *ctx)
+{
+	struct lease_rates *rates = tal(ctx, struct lease_rates);
+
+	/* Default basis is .65%, (7.8% APR) */
+	rates->lease_fee_basis = 65;
+	/* 2000sat base rate */
+	rates->lease_fee_base_sat = 2000;
+	/* Max of 100,000ppm (10%) */
+	rates->channel_fee_max_proportional_thousandths = 100;
+	/* Max of 5000sat */
+	rates->channel_fee_max_base_msat = 5000000;
+
+	/* Let's set our default max weight to two inputs + an output
+	 * (use helpers b/c elements) */
+	rates->funding_weight
+		= 2 * bitcoin_tx_simple_input_weight(false)
+		+ bitcoin_tx_output_weight(BITCOIN_SCRIPTPUBKEY_P2WPKH_LEN);
+
+	return rates;
 }

 char *funder_check_policy(const struct funder_policy *policy)
--- a/plugins/funder_policy.h
+++ b/plugins/funder_policy.h
@ -2,7 +2,9 @@
 #define LIGHTNING_PLUGINS_FUNDER_POLICY_H
 #include "config.h"
 #include <common/amount.h>
+#include <wire/peer_wire.h>

+struct lease_rates;
 struct node_id;

 /* Policy Options */
@ -53,6 +55,13 @@ struct funder_policy {

 	/* Percent of open offers we'll consider funding. */
 	u32 fund_probability;
+
+	/* If we're advertising liquidity, only
+	 * provide funds for lease requests */
+	bool leases_only;
+
+	/* Rates we're currently charging for channel leases */
+	struct lease_rates *rates;
 };

 struct funder_policy *
@ -65,7 +74,9 @@ new_funder_policy(const tal_t *ctx,
 		  struct amount_sat per_channel_max,
 		  u32 fuzz_factor,
 		  struct amount_sat reserve_tank,
-		  u32 fund_probability);
+		  u32 fund_probability,
+		  bool leases_only,
+		  struct lease_rates *rates);

 /* Get a new funder_policy, set to the defaults */
 struct funder_policy *
@ -73,6 +84,10 @@ default_funder_policy(const tal_t *ctx,
 		      enum funder_opt policy,
 		      u64 policy_mod);

+/* Defaults to use for the lease_rates */
+struct lease_rates *
+default_lease_rates(const tal_t *ctx);
+
 /* Given the policy and this request's details, figure
 * out how much we should contribute to this channel */
 const char *