mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-19 18:11:28 +01:00
9cb2b2f13a
This integrates them with configvars properly: they almost "just work" in listconfigs now, and we don't put them in a special sub-object under their plugin. Unfortunately, this means `listconfigs` now has a loose schema: any plugin can add something to it. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Changelog-Fixed: Plugins: reloaded plugins get passed any vars from configuration files. Changelog-Deprecated: Config: boolean plugin options set to `1` or `0` (use `true` and `false` like non-plugin options).
1103 lines
33 KiB
C
1103 lines
33 KiB
C
/* This plugin covers both sending and receiving offers */
|
|
#include "config.h"
|
|
#include <bitcoin/chainparams.h>
|
|
#include <ccan/array_size/array_size.h>
|
|
#include <ccan/cast/cast.h>
|
|
#include <ccan/rune/rune.h>
|
|
#include <ccan/tal/str/str.h>
|
|
#include <common/bech32.h>
|
|
#include <common/bolt11.h>
|
|
#include <common/bolt11_json.h>
|
|
#include <common/bolt12_merkle.h>
|
|
#include <common/invoice_path_id.h>
|
|
#include <common/iso4217.h>
|
|
#include <common/json_param.h>
|
|
#include <common/json_stream.h>
|
|
#include <plugins/offers.h>
|
|
#include <plugins/offers_inv_hook.h>
|
|
#include <plugins/offers_invreq_hook.h>
|
|
#include <plugins/offers_offer.h>
|
|
|
|
struct pubkey id;
|
|
u32 blockheight;
|
|
u16 cltv_final;
|
|
bool offers_enabled;
|
|
struct secret invoicesecret_base;
|
|
|
|
static struct command_result *finished(struct command *cmd,
|
|
const char *buf,
|
|
const jsmntok_t *result,
|
|
void *unused)
|
|
{
|
|
return command_hook_success(cmd);
|
|
}
|
|
|
|
static struct command_result *sendonionmessage_error(struct command *cmd,
|
|
const char *buf,
|
|
const jsmntok_t *err,
|
|
void *unused)
|
|
{
|
|
/* This can happen if the peer goes offline or wasn't directly
|
|
* connected: "Unknown first peer" */
|
|
plugin_log(cmd->plugin, LOG_DBG,
|
|
"sendonionmessage gave JSON error: %.*s",
|
|
json_tok_full_len(err),
|
|
json_tok_full(buf, err));
|
|
return command_hook_success(cmd);
|
|
}
|
|
|
|
struct command_result *
|
|
send_onion_reply(struct command *cmd,
|
|
struct blinded_path *reply_path,
|
|
struct tlv_onionmsg_tlv *payload)
|
|
{
|
|
struct out_req *req;
|
|
size_t nhops;
|
|
|
|
req = jsonrpc_request_start(cmd->plugin, cmd, "sendonionmessage",
|
|
finished, sendonionmessage_error, NULL);
|
|
|
|
json_add_pubkey(req->js, "first_id", &reply_path->first_node_id);
|
|
json_add_pubkey(req->js, "blinding", &reply_path->blinding);
|
|
json_array_start(req->js, "hops");
|
|
|
|
nhops = tal_count(reply_path->path);
|
|
for (size_t i = 0; i < nhops; i++) {
|
|
struct tlv_onionmsg_tlv *omp;
|
|
u8 *tlv;
|
|
|
|
json_object_start(req->js, NULL);
|
|
json_add_pubkey(req->js, "id", &reply_path->path[i]->blinded_node_id);
|
|
|
|
/* Put payload in last hop. */
|
|
if (i == nhops - 1)
|
|
omp = payload;
|
|
else
|
|
omp = tlv_onionmsg_tlv_new(tmpctx);
|
|
|
|
omp->encrypted_recipient_data = reply_path->path[i]->encrypted_recipient_data;
|
|
|
|
tlv = tal_arr(tmpctx, u8, 0);
|
|
towire_tlv_onionmsg_tlv(&tlv, omp);
|
|
json_add_hex_talarr(req->js, "tlv", tlv);
|
|
json_object_end(req->js);
|
|
}
|
|
json_array_end(req->js);
|
|
return send_outreq(cmd->plugin, req);
|
|
}
|
|
|
|
static struct command_result *onion_message_modern_call(struct command *cmd,
|
|
const char *buf,
|
|
const jsmntok_t *params)
|
|
{
|
|
const jsmntok_t *om, *replytok, *invreqtok, *invtok;
|
|
struct blinded_path *reply_path = NULL;
|
|
|
|
if (!offers_enabled)
|
|
return command_hook_success(cmd);
|
|
|
|
om = json_get_member(buf, params, "onion_message");
|
|
replytok = json_get_member(buf, om, "reply_blindedpath");
|
|
if (replytok) {
|
|
reply_path = json_to_blinded_path(cmd, buf, replytok);
|
|
if (!reply_path)
|
|
plugin_err(cmd->plugin, "Invalid reply path %.*s?",
|
|
json_tok_full_len(replytok),
|
|
json_tok_full(buf, replytok));
|
|
}
|
|
|
|
invreqtok = json_get_member(buf, om, "invoice_request");
|
|
if (invreqtok) {
|
|
const u8 *invreqbin = json_tok_bin_from_hex(tmpctx, buf, invreqtok);
|
|
if (reply_path)
|
|
return handle_invoice_request(cmd,
|
|
invreqbin,
|
|
reply_path);
|
|
else
|
|
plugin_log(cmd->plugin, LOG_DBG,
|
|
"invoice_request without reply_path");
|
|
}
|
|
|
|
invtok = json_get_member(buf, om, "invoice");
|
|
if (invtok) {
|
|
const u8 *invbin = json_tok_bin_from_hex(tmpctx, buf, invtok);
|
|
if (invbin)
|
|
return handle_invoice(cmd, invbin, reply_path);
|
|
}
|
|
|
|
return command_hook_success(cmd);
|
|
}
|
|
|
|
static const struct plugin_hook hooks[] = {
|
|
{
|
|
"onion_message_recv",
|
|
onion_message_modern_call
|
|
},
|
|
};
|
|
|
|
static struct command_result *block_added_notify(struct command *cmd,
|
|
const char *buf,
|
|
const jsmntok_t *params)
|
|
{
|
|
json_scan(cmd, buf, params, "{block:{height:%}}",
|
|
JSON_SCAN(json_to_u32, &blockheight));
|
|
return notification_handled(cmd);
|
|
}
|
|
|
|
static const struct plugin_notification notifications[] = {
|
|
{
|
|
"block_added",
|
|
block_added_notify,
|
|
},
|
|
};
|
|
|
|
|
|
struct decodable {
|
|
const char *type;
|
|
struct bolt11 *b11;
|
|
struct tlv_offer *offer;
|
|
struct tlv_invoice *invoice;
|
|
struct tlv_invoice_request *invreq;
|
|
struct rune *rune;
|
|
};
|
|
|
|
static struct command_result *param_decodable(struct command *cmd,
|
|
const char *name,
|
|
const char *buffer,
|
|
const jsmntok_t *token,
|
|
struct decodable *decodable)
|
|
{
|
|
char *likely_fail = NULL, *fail;
|
|
jsmntok_t tok;
|
|
|
|
/* BOLT #11:
|
|
*
|
|
* If a URI scheme is desired, the current recommendation is to either
|
|
* use 'lightning:' as a prefix before the BOLT-11 encoding
|
|
*/
|
|
tok = *token;
|
|
if (json_tok_startswith(buffer, &tok, "lightning:")
|
|
|| json_tok_startswith(buffer, &tok, "LIGHTNING:"))
|
|
tok.start += strlen("lightning:");
|
|
|
|
decodable->offer = offer_decode(cmd, buffer + tok.start,
|
|
tok.end - tok.start,
|
|
plugin_feature_set(cmd->plugin), NULL,
|
|
json_tok_startswith(buffer, &tok, "lno1")
|
|
? &likely_fail : &fail);
|
|
if (decodable->offer) {
|
|
decodable->type = "bolt12 offer";
|
|
return NULL;
|
|
}
|
|
|
|
decodable->invoice = invoice_decode(cmd, buffer + tok.start,
|
|
tok.end - tok.start,
|
|
plugin_feature_set(cmd->plugin),
|
|
NULL,
|
|
json_tok_startswith(buffer, &tok,
|
|
"lni1")
|
|
? &likely_fail : &fail);
|
|
if (decodable->invoice) {
|
|
decodable->type = "bolt12 invoice";
|
|
return NULL;
|
|
}
|
|
|
|
decodable->invreq = invrequest_decode(cmd, buffer + tok.start,
|
|
tok.end - tok.start,
|
|
plugin_feature_set(cmd->plugin),
|
|
NULL,
|
|
json_tok_startswith(buffer, &tok,
|
|
"lnr1")
|
|
? &likely_fail : &fail);
|
|
if (decodable->invreq) {
|
|
decodable->type = "bolt12 invoice_request";
|
|
return NULL;
|
|
}
|
|
|
|
/* If no other was likely, bolt11 decoder gives us failure string. */
|
|
decodable->b11 = bolt11_decode(cmd,
|
|
tal_strndup(tmpctx, buffer + tok.start,
|
|
tok.end - tok.start),
|
|
plugin_feature_set(cmd->plugin),
|
|
NULL, NULL,
|
|
likely_fail ? &fail : &likely_fail);
|
|
if (decodable->b11) {
|
|
decodable->type = "bolt11 invoice";
|
|
return NULL;
|
|
}
|
|
|
|
decodable->rune = rune_from_base64n(decodable, buffer + tok.start,
|
|
tok.end - tok.start);
|
|
if (decodable->rune) {
|
|
decodable->type = "rune";
|
|
return NULL;
|
|
}
|
|
|
|
/* Return failure message from most likely parsing candidate */
|
|
return command_fail_badparam(cmd, name, buffer, &tok, likely_fail);
|
|
}
|
|
|
|
static void json_add_chains(struct json_stream *js,
|
|
const char *fieldname,
|
|
const struct bitcoin_blkid *chains)
|
|
{
|
|
json_array_start(js, fieldname);
|
|
for (size_t i = 0; i < tal_count(chains); i++)
|
|
json_add_sha256(js, NULL, &chains[i].shad.sha);
|
|
json_array_end(js);
|
|
}
|
|
|
|
static void json_add_onionmsg_path(struct json_stream *js,
|
|
const char *fieldname,
|
|
const struct onionmsg_hop *hop)
|
|
{
|
|
json_object_start(js, fieldname);
|
|
json_add_pubkey(js, "blinded_node_id", &hop->blinded_node_id);
|
|
json_add_hex_talarr(js, "encrypted_recipient_data", hop->encrypted_recipient_data);
|
|
json_object_end(js);
|
|
}
|
|
|
|
/* Returns true if valid */
|
|
static bool json_add_blinded_paths(struct json_stream *js,
|
|
const char *fieldname,
|
|
struct blinded_path **paths,
|
|
struct blinded_payinfo **blindedpay)
|
|
{
|
|
json_array_start(js, fieldname);
|
|
for (size_t i = 0; i < tal_count(paths); i++) {
|
|
json_object_start(js, NULL);
|
|
json_add_pubkey(js, "first_node_id", &paths[i]->first_node_id);
|
|
json_add_pubkey(js, "blinding", &paths[i]->blinding);
|
|
|
|
/* Don't crash if we're short a payinfo! */
|
|
if (i < tal_count(blindedpay)) {
|
|
json_object_start(js, "payinfo");
|
|
json_add_amount_msat(js, "fee_base_msat",
|
|
amount_msat(blindedpay[i]->fee_base_msat));
|
|
json_add_u32(js, "fee_proportional_millionths",
|
|
blindedpay[i]->fee_proportional_millionths);
|
|
json_add_u32(js, "cltv_expiry_delta",
|
|
blindedpay[i]->cltv_expiry_delta);
|
|
json_add_hex_talarr(js, "features", blindedpay[i]->features);
|
|
json_object_end(js);
|
|
}
|
|
|
|
json_array_start(js, "path");
|
|
for (size_t j = 0; j < tal_count(paths[i]->path); j++) {
|
|
json_add_onionmsg_path(js, NULL, paths[i]->path[j]);
|
|
}
|
|
json_array_end(js);
|
|
json_object_end(js);
|
|
}
|
|
json_array_end(js);
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST reject the invoice if `invoice_blindedpay` does not contain
|
|
* exactly one `blinded_payinfo` per `invoice_paths`.`blinded_path`.
|
|
*/
|
|
if (blindedpay && tal_count(blindedpay) != tal_count(paths)) {
|
|
json_add_str_fmt(js, "warning_invalid_invoice_blindedpay",
|
|
"invoice has %zu blinded_payinfo but %zu paths",
|
|
tal_count(blindedpay), tal_count(paths));
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
static const char *recurrence_time_unit_name(u8 time_unit)
|
|
{
|
|
/* BOLT-offers-recurrence #12:
|
|
* `time_unit` defining 0 (seconds), 1 (days), 2 (months), 3 (years).
|
|
*/
|
|
switch (time_unit) {
|
|
case 0:
|
|
return "seconds";
|
|
case 1:
|
|
return "days";
|
|
case 2:
|
|
return "months";
|
|
case 3:
|
|
return "years";
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
static bool json_add_utf8(struct json_stream *js,
|
|
const char *fieldname,
|
|
const char *utf8str)
|
|
{
|
|
if (utf8_check(utf8str, tal_bytelen(utf8str))) {
|
|
json_add_stringn(js, fieldname, utf8str, tal_bytelen(utf8str));
|
|
return true;
|
|
}
|
|
json_add_string(js, tal_fmt(tmpctx, "warning_invalid_%s", fieldname),
|
|
"invalid UTF8");
|
|
return false;
|
|
}
|
|
|
|
static bool json_add_offer_fields(struct json_stream *js,
|
|
const struct bitcoin_blkid *offer_chains,
|
|
const u8 *offer_metadata,
|
|
const char *offer_currency,
|
|
const u64 *offer_amount,
|
|
const char *offer_description,
|
|
const u8 *offer_features,
|
|
const u64 *offer_absolute_expiry,
|
|
struct blinded_path **offer_paths,
|
|
const char *offer_issuer,
|
|
const u64 *offer_quantity_max,
|
|
const struct pubkey *offer_node_id,
|
|
const struct recurrence *offer_recurrence,
|
|
const struct recurrence_paywindow *offer_recurrence_paywindow,
|
|
const u32 *offer_recurrence_limit,
|
|
const struct recurrence_base *offer_recurrence_base)
|
|
{
|
|
bool valid = true;
|
|
|
|
if (offer_chains)
|
|
json_add_chains(js, "offer_chains", offer_chains);
|
|
if (offer_metadata)
|
|
json_add_hex_talarr(js, "offer_metadata", offer_metadata);
|
|
if (offer_currency) {
|
|
const struct iso4217_name_and_divisor *iso4217;
|
|
valid &= json_add_utf8(js, "offer_currency", offer_currency);
|
|
if (offer_amount)
|
|
json_add_u64(js, "offer_amount", *offer_amount);
|
|
iso4217 = find_iso4217(offer_currency,
|
|
tal_bytelen(offer_currency));
|
|
if (iso4217)
|
|
json_add_num(js, "currency_minor_unit", iso4217->minor_unit);
|
|
else
|
|
json_add_string(js, "warning_unknown_offer_currency",
|
|
"unknown currency code");
|
|
} else if (offer_amount)
|
|
json_add_amount_msat(js, "offer_amount_msat",
|
|
amount_msat(*offer_amount));
|
|
|
|
/* BOLT-offers #12:
|
|
* A reader of an offer:
|
|
*...
|
|
* - if `offer_description` is not set:
|
|
* - MUST NOT respond to the offer.
|
|
*/
|
|
if (offer_description)
|
|
valid &= json_add_utf8(js, "offer_description",
|
|
offer_description);
|
|
else {
|
|
json_add_string(js, "warning_missing_offer_description",
|
|
"offers without a description are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
if (offer_issuer)
|
|
valid &= json_add_utf8(js, "offer_issuer", offer_issuer);
|
|
if (offer_features)
|
|
json_add_hex_talarr(js, "offer_features", offer_features);
|
|
if (offer_absolute_expiry)
|
|
json_add_u64(js, "offer_absolute_expiry",
|
|
*offer_absolute_expiry);
|
|
if (offer_paths)
|
|
valid &= json_add_blinded_paths(js, "offer_paths",
|
|
offer_paths, NULL);
|
|
|
|
if (offer_quantity_max)
|
|
json_add_u64(js, "offer_quantity_max", *offer_quantity_max);
|
|
|
|
if (offer_recurrence) {
|
|
const char *name;
|
|
json_object_start(js, "offer_recurrence");
|
|
json_add_num(js, "time_unit", offer_recurrence->time_unit);
|
|
name = recurrence_time_unit_name(offer_recurrence->time_unit);
|
|
if (name)
|
|
json_add_string(js, "time_unit_name", name);
|
|
json_add_num(js, "period", offer_recurrence->period);
|
|
if (offer_recurrence_base) {
|
|
json_add_u64(js, "basetime",
|
|
offer_recurrence_base->basetime);
|
|
if (offer_recurrence_base->start_any_period)
|
|
json_add_bool(js, "start_any_period", true);
|
|
}
|
|
if (offer_recurrence_limit)
|
|
json_add_u32(js, "limit", *offer_recurrence_limit);
|
|
if (offer_recurrence_paywindow) {
|
|
json_object_start(js, "paywindow");
|
|
json_add_u32(js, "seconds_before",
|
|
offer_recurrence_paywindow->seconds_before);
|
|
json_add_u32(js, "seconds_after",
|
|
offer_recurrence_paywindow->seconds_after);
|
|
if (offer_recurrence_paywindow->proportional_amount)
|
|
json_add_bool(js, "proportional_amount", true);
|
|
json_object_end(js);
|
|
}
|
|
json_object_end(js);
|
|
}
|
|
|
|
/* Required for offers, *not* for others! */
|
|
if (offer_node_id)
|
|
json_add_pubkey(js, "offer_node_id", offer_node_id);
|
|
|
|
return valid;
|
|
}
|
|
|
|
static void json_add_extra_fields(struct json_stream *js,
|
|
const char *fieldname,
|
|
const struct tlv_field *fields)
|
|
{
|
|
bool have_extra = false;
|
|
|
|
for (size_t i = 0; i < tal_count(fields); i++) {
|
|
if (fields[i].meta)
|
|
continue;
|
|
if (!have_extra) {
|
|
json_array_start(js, fieldname);
|
|
have_extra = true;
|
|
}
|
|
json_object_start(js, NULL);
|
|
json_add_u64(js, "type", fields[i].numtype);
|
|
json_add_u64(js, "length", fields[i].length);
|
|
json_add_hex(js, "value",
|
|
fields[i].value, fields[i].length);
|
|
}
|
|
if (have_extra)
|
|
json_array_end(js);
|
|
}
|
|
|
|
static void json_add_offer(struct json_stream *js, const struct tlv_offer *offer)
|
|
{
|
|
struct sha256 offer_id;
|
|
bool valid = true;
|
|
|
|
offer_offer_id(offer, &offer_id);
|
|
json_add_sha256(js, "offer_id", &offer_id);
|
|
|
|
valid &= json_add_offer_fields(js,
|
|
offer->offer_chains,
|
|
offer->offer_metadata,
|
|
offer->offer_currency,
|
|
offer->offer_amount,
|
|
offer->offer_description,
|
|
offer->offer_features,
|
|
offer->offer_absolute_expiry,
|
|
offer->offer_paths,
|
|
offer->offer_issuer,
|
|
offer->offer_quantity_max,
|
|
offer->offer_node_id,
|
|
offer->offer_recurrence,
|
|
offer->offer_recurrence_paywindow,
|
|
offer->offer_recurrence_limit,
|
|
offer->offer_recurrence_base);
|
|
/* BOLT-offers #12:
|
|
* - if `offer_node_id` is not set:
|
|
* - MUST NOT respond to the offer.
|
|
*/
|
|
if (!offer->offer_node_id) {
|
|
json_add_string(js, "warning_missing_offer_node_id",
|
|
"offers without a node_id are invalid");
|
|
valid = false;
|
|
}
|
|
json_add_extra_fields(js, "unknown_offer_tlvs", offer->fields);
|
|
json_add_bool(js, "valid", valid);
|
|
}
|
|
|
|
static bool json_add_invreq_fields(struct json_stream *js,
|
|
const u8 *invreq_metadata,
|
|
const struct bitcoin_blkid *invreq_chain,
|
|
const u64 *invreq_amount,
|
|
const u8 *invreq_features,
|
|
const u64 *invreq_quantity,
|
|
const struct pubkey *invreq_payer_id,
|
|
const utf8 *invreq_payer_note,
|
|
const u32 *invreq_recurrence_counter,
|
|
const u32 *invreq_recurrence_start)
|
|
{
|
|
bool valid = true;
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST fail the request if `invreq_payer_id` or `invreq_metadata` are not present.
|
|
*/
|
|
if (invreq_metadata)
|
|
json_add_hex_talarr(js, "invreq_metadata",
|
|
invreq_metadata);
|
|
else {
|
|
json_add_string(js, "warning_missing_invreq_metadata",
|
|
"invreq_metadata required");
|
|
valid = false;
|
|
}
|
|
|
|
/* This can be missing for an invoice though! */
|
|
if (invreq_payer_id)
|
|
json_add_pubkey(js, "invreq_payer_id", invreq_payer_id);
|
|
|
|
if (invreq_chain)
|
|
json_add_sha256(js, "invreq_chain", &invreq_chain->shad.sha);
|
|
|
|
if (invreq_amount)
|
|
json_add_amount_msat(js, "invreq_amount_msat",
|
|
amount_msat(*invreq_amount));
|
|
if (invreq_features)
|
|
json_add_hex_talarr(js, "invreq_features", invreq_features);
|
|
if (invreq_quantity)
|
|
json_add_u64(js, "invreq_quantity", *invreq_quantity);
|
|
if (invreq_payer_note)
|
|
valid &= json_add_utf8(js, "invreq_payer_note", invreq_payer_note);
|
|
if (invreq_recurrence_counter) {
|
|
json_add_u32(js, "invreq_recurrence_counter",
|
|
*invreq_recurrence_counter);
|
|
if (invreq_recurrence_start)
|
|
json_add_u32(js, "invreq_recurrence_start",
|
|
*invreq_recurrence_start);
|
|
}
|
|
|
|
return valid;
|
|
}
|
|
|
|
/* Returns true if valid */
|
|
static bool json_add_fallback_address(struct json_stream *js,
|
|
const struct chainparams *chain,
|
|
u8 version, const u8 *address)
|
|
{
|
|
char out[73 + strlen(chain->onchain_hrp)];
|
|
|
|
/* Does extra checks, in particular checks v0 sizes */
|
|
if (segwit_addr_encode(out, chain->onchain_hrp, version,
|
|
address, tal_bytelen(address))) {
|
|
json_add_string(js, "address", out);
|
|
return true;
|
|
}
|
|
json_add_string(js,
|
|
"warning_invalid_invoice_fallbacks_address",
|
|
"invalid fallback address for this version");
|
|
return false;
|
|
}
|
|
|
|
/* Returns true if valid */
|
|
static bool json_add_fallbacks(struct json_stream *js,
|
|
const struct bitcoin_blkid *chains,
|
|
struct fallback_address **fallbacks)
|
|
{
|
|
const struct chainparams *chain;
|
|
bool valid = true;
|
|
|
|
/* Present address as first chain mentioned. */
|
|
if (tal_count(chains) != 0)
|
|
chain = chainparams_by_chainhash(&chains[0]);
|
|
else
|
|
chain = chainparams_for_network("bitcoin");
|
|
|
|
json_array_start(js, "invoice_fallbacks");
|
|
for (size_t i = 0; i < tal_count(fallbacks); i++) {
|
|
size_t addrlen = tal_bytelen(fallbacks[i]->address);
|
|
|
|
json_object_start(js, NULL);
|
|
json_add_u32(js, "version", fallbacks[i]->version);
|
|
json_add_hex_talarr(js, "hex", fallbacks[i]->address);
|
|
|
|
/* BOLT-offers #12:
|
|
* - for the bitcoin chain, if the invoice specifies `invoice_fallbacks`:
|
|
* - MUST ignore any `fallback_address` for which `version` is
|
|
* greater than 16.
|
|
* - MUST ignore any `fallback_address` for which `address` is
|
|
* less than 2 or greater than 40 bytes.
|
|
* - MUST ignore any `fallback_address` for which `address` does
|
|
* not meet known requirements for the given `version`
|
|
*/
|
|
if (fallbacks[i]->version > 16) {
|
|
json_add_string(js,
|
|
"warning_invalid_invoice_fallbacks_version",
|
|
"invoice fallback version > 16");
|
|
valid = false;
|
|
} else if (addrlen < 2 || addrlen > 40) {
|
|
json_add_string(js,
|
|
"warning_invalid_invoice_fallbacks_address",
|
|
"invoice fallback address bad length");
|
|
valid = false;
|
|
} else if (chain) {
|
|
valid &= json_add_fallback_address(js, chain,
|
|
fallbacks[i]->version,
|
|
fallbacks[i]->address);
|
|
}
|
|
json_object_end(js);
|
|
}
|
|
json_array_end(js);
|
|
|
|
return valid;
|
|
}
|
|
|
|
static void json_add_invoice_request(struct json_stream *js,
|
|
const struct tlv_invoice_request *invreq)
|
|
{
|
|
bool valid = true;
|
|
|
|
/* If there's an offer_node_id, then there's an offer. */
|
|
if (invreq->offer_node_id) {
|
|
struct sha256 offer_id;
|
|
|
|
invreq_offer_id(invreq, &offer_id);
|
|
json_add_sha256(js, "offer_id", &offer_id);
|
|
}
|
|
|
|
valid &= json_add_offer_fields(js,
|
|
invreq->offer_chains,
|
|
invreq->offer_metadata,
|
|
invreq->offer_currency,
|
|
invreq->offer_amount,
|
|
invreq->offer_description,
|
|
invreq->offer_features,
|
|
invreq->offer_absolute_expiry,
|
|
invreq->offer_paths,
|
|
invreq->offer_issuer,
|
|
invreq->offer_quantity_max,
|
|
invreq->offer_node_id,
|
|
invreq->offer_recurrence,
|
|
invreq->offer_recurrence_paywindow,
|
|
invreq->offer_recurrence_limit,
|
|
invreq->offer_recurrence_base);
|
|
valid &= json_add_invreq_fields(js,
|
|
invreq->invreq_metadata,
|
|
invreq->invreq_chain,
|
|
invreq->invreq_amount,
|
|
invreq->invreq_features,
|
|
invreq->invreq_quantity,
|
|
invreq->invreq_payer_id,
|
|
invreq->invreq_payer_note,
|
|
invreq->invreq_recurrence_counter,
|
|
invreq->invreq_recurrence_start);
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST fail the request if `invreq_payer_id` or `invreq_metadata` are not present.
|
|
*/
|
|
if (!invreq->invreq_payer_id) {
|
|
json_add_string(js, "warning_missing_invreq_payer_id",
|
|
"invreq_payer_id required");
|
|
valid = false;
|
|
}
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST fail the request if `signature` is not correct as detailed
|
|
* in [Signature Calculation](#signature-calculation) using the
|
|
* `invreq_payer_id`.
|
|
*/
|
|
if (invreq->signature) {
|
|
if (invreq->invreq_payer_id
|
|
&& !bolt12_check_signature(invreq->fields,
|
|
"invoice_request",
|
|
"signature",
|
|
invreq->invreq_payer_id,
|
|
invreq->signature)) {
|
|
json_add_string(js, "warning_invalid_invoice_request_signature",
|
|
"Bad signature");
|
|
valid = false;
|
|
} else {
|
|
json_add_bip340sig(js, "signature", invreq->signature);
|
|
}
|
|
} else {
|
|
json_add_string(js, "warning_missing_invoice_request_signature",
|
|
"Missing signature");
|
|
valid = false;
|
|
}
|
|
|
|
json_add_extra_fields(js, "unknown_invoice_request_tlvs", invreq->fields);
|
|
json_add_bool(js, "valid", valid);
|
|
}
|
|
|
|
static void json_add_b12_invoice(struct json_stream *js,
|
|
const struct tlv_invoice *invoice)
|
|
{
|
|
bool valid = true;
|
|
|
|
/* If there's an offer_node_id, then there's an offer. */
|
|
if (invoice->offer_node_id) {
|
|
struct sha256 offer_id;
|
|
|
|
invoice_offer_id(invoice, &offer_id);
|
|
json_add_sha256(js, "offer_id", &offer_id);
|
|
}
|
|
|
|
valid &= json_add_offer_fields(js,
|
|
invoice->offer_chains,
|
|
invoice->offer_metadata,
|
|
invoice->offer_currency,
|
|
invoice->offer_amount,
|
|
invoice->offer_description,
|
|
invoice->offer_features,
|
|
invoice->offer_absolute_expiry,
|
|
invoice->offer_paths,
|
|
invoice->offer_issuer,
|
|
invoice->offer_quantity_max,
|
|
invoice->offer_node_id,
|
|
invoice->offer_recurrence,
|
|
invoice->offer_recurrence_paywindow,
|
|
invoice->offer_recurrence_limit,
|
|
invoice->offer_recurrence_base);
|
|
valid &= json_add_invreq_fields(js,
|
|
invoice->invreq_metadata,
|
|
invoice->invreq_chain,
|
|
invoice->invreq_amount,
|
|
invoice->invreq_features,
|
|
invoice->invreq_quantity,
|
|
invoice->invreq_payer_id,
|
|
invoice->invreq_payer_note,
|
|
invoice->invreq_recurrence_counter,
|
|
invoice->invreq_recurrence_start);
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST reject the invoice if `invoice_paths` is not present
|
|
* or is empty.
|
|
* - MUST reject the invoice if `invoice_blindedpay` is not present.
|
|
* - MUST reject the invoice if `invoice_blindedpay` does not contain
|
|
* exactly one `blinded_payinfo` per `invoice_paths`.`blinded_path`.
|
|
*/
|
|
if (invoice->invoice_paths) {
|
|
if (!invoice->invoice_blindedpay) {
|
|
json_add_string(js, "warning_missing_invoice_blindedpay",
|
|
"invoices with paths without blindedpay are invalid");
|
|
valid = false;
|
|
}
|
|
valid &= json_add_blinded_paths(js, "invoice_paths",
|
|
invoice->invoice_paths,
|
|
invoice->invoice_blindedpay);
|
|
} else {
|
|
json_add_string(js, "warning_missing_invoice_paths",
|
|
"invoices without a invoice_paths are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
if (invoice->invoice_created_at) {
|
|
json_add_u64(js, "invoice_created_at", *invoice->invoice_created_at);
|
|
} else {
|
|
json_add_string(js, "warning_missing_invoice_created_at",
|
|
"invoices without created_at are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
/* BOLT-offers #12:
|
|
*
|
|
* - if `invoice_relative_expiry` is present:
|
|
* - MUST reject the invoice if the current time since 1970-01-01 UTC
|
|
* is greater than `invoice_created_at` plus `seconds_from_creation`.
|
|
* - otherwise:
|
|
* - MUST reject the invoice if the current time since 1970-01-01 UTC
|
|
* is greater than `invoice_created_at` plus 7200.
|
|
*/
|
|
if (invoice->invoice_relative_expiry)
|
|
json_add_u32(js, "invoice_relative_expiry", *invoice->invoice_relative_expiry);
|
|
else
|
|
json_add_u32(js, "invoice_relative_expiry", BOLT12_DEFAULT_REL_EXPIRY);
|
|
|
|
if (invoice->invoice_payment_hash)
|
|
json_add_sha256(js, "invoice_payment_hash", invoice->invoice_payment_hash);
|
|
else {
|
|
json_add_string(js, "warning_missing_invoice_payment_hash",
|
|
"invoices without a payment_hash are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
/* BOLT-offers #12:
|
|
* - MUST reject the invoice if `invoice_amount` is not present.
|
|
*/
|
|
if (invoice->invoice_amount)
|
|
json_add_amount_msat(js, "invoice_amount_msat",
|
|
amount_msat(*invoice->invoice_amount));
|
|
else {
|
|
json_add_string(js, "warning_missing_invoice_amount",
|
|
"invoices without an amount are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
if (invoice->invoice_fallbacks)
|
|
valid &= json_add_fallbacks(js,
|
|
invoice->invreq_chain,
|
|
invoice->invoice_fallbacks);
|
|
|
|
if (invoice->invoice_features)
|
|
json_add_hex_talarr(js, "features", invoice->invoice_features);
|
|
|
|
if (invoice->invoice_node_id)
|
|
json_add_pubkey(js, "invoice_node_id", invoice->invoice_node_id);
|
|
else {
|
|
json_add_string(js, "warning_missing_invoice_node_id",
|
|
"invoices without an invoice_node_id are invalid");
|
|
valid = false;
|
|
}
|
|
|
|
/* BOLT-offers-recurrence #12:
|
|
* - if the offer contained `recurrence`:
|
|
* - MUST reject the invoice if `recurrence_basetime` is not
|
|
* set.
|
|
*/
|
|
if (invoice->offer_recurrence) {
|
|
if (invoice->invoice_recurrence_basetime)
|
|
json_add_u64(js, "invoice_recurrence_basetime",
|
|
*invoice->invoice_recurrence_basetime);
|
|
else {
|
|
json_add_string(js, "warning_missing_invoice_recurrence_basetime",
|
|
"recurring invoices without a recurrence_basetime are invalid");
|
|
valid = false;
|
|
}
|
|
}
|
|
|
|
/* invoice_decode checked this */
|
|
json_add_bip340sig(js, "signature", invoice->signature);
|
|
|
|
json_add_extra_fields(js, "unknown_invoice_tlvs", invoice->fields);
|
|
json_add_bool(js, "valid", valid);
|
|
}
|
|
|
|
static void json_add_rune(struct command *cmd, struct json_stream *js, const struct rune *rune)
|
|
{
|
|
const char *string;
|
|
|
|
/* Simplest to check everything for UTF-8 compliance at once.
|
|
* Since separators are | and & (which cannot appear inside
|
|
* UTF-8 multichars), if the entire thing is valid UTF-8 then
|
|
* each part is. */
|
|
string = rune_to_string(tmpctx, rune);
|
|
if (!utf8_check(string, strlen(string))) {
|
|
json_add_hex(js, "hex", string, strlen(string));
|
|
json_add_string(js, "warning_rune_invalid_utf8",
|
|
"Rune contains invalid UTF-8 strings");
|
|
json_add_bool(js, "valid", false);
|
|
return;
|
|
}
|
|
|
|
if (rune->unique_id)
|
|
json_add_string(js, "unique_id", rune->unique_id);
|
|
if (rune->version)
|
|
json_add_string(js, "version", rune->version);
|
|
json_add_string(js, "string", take(string));
|
|
|
|
json_array_start(js, "restrictions");
|
|
for (size_t i = rune->unique_id ? 1 : 0; i < tal_count(rune->restrs); i++) {
|
|
const struct rune_restr *restr = rune->restrs[i];
|
|
char *summary = tal_strdup(tmpctx, "");
|
|
const char *sep = "";
|
|
|
|
json_object_start(js, NULL);
|
|
json_array_start(js, "alternatives");
|
|
for (size_t j = 0; j < tal_count(restr->alterns); j++) {
|
|
const struct rune_altern *alt = restr->alterns[j];
|
|
const char *annotation, *value;
|
|
bool int_val = false, time_val = false;
|
|
|
|
if (streq(alt->fieldname, "time")) {
|
|
annotation = "in seconds since 1970";
|
|
time_val = true;
|
|
} else if (streq(alt->fieldname, "id"))
|
|
annotation = "of commanding peer";
|
|
else if (streq(alt->fieldname, "method"))
|
|
annotation = "of command";
|
|
else if (streq(alt->fieldname, "pnum")) {
|
|
annotation = "number of command parameters";
|
|
int_val = true;
|
|
} else if (streq(alt->fieldname, "rate")) {
|
|
annotation = "max per minute";
|
|
int_val = true;
|
|
} else if (strstarts(alt->fieldname, "parr")) {
|
|
annotation = tal_fmt(tmpctx, "array parameter #%s", alt->fieldname+4);
|
|
} else if (strstarts(alt->fieldname, "pname"))
|
|
annotation = tal_fmt(tmpctx, "object parameter '%s'", alt->fieldname+5);
|
|
else
|
|
annotation = "unknown condition?";
|
|
|
|
tal_append_fmt(&summary, "%s", sep);
|
|
|
|
/* Where it's ambiguous, quote if it's not treated as an int */
|
|
if (int_val)
|
|
value = alt->value;
|
|
else if (time_val) {
|
|
u64 t = atol(alt->value);
|
|
|
|
if (t) {
|
|
u64 diff, now = time_now().ts.tv_sec;
|
|
/* Need a non-const during construction */
|
|
char *v;
|
|
|
|
if (now > t)
|
|
diff = now - t;
|
|
else
|
|
diff = t - now;
|
|
if (diff < 60)
|
|
v = tal_fmt(tmpctx, "%"PRIu64" seconds", diff);
|
|
else if (diff < 60 * 60)
|
|
v = tal_fmt(tmpctx, "%"PRIu64" minutes %"PRIu64" seconds",
|
|
diff / 60, diff % 60);
|
|
else {
|
|
v = tal_strdup(tmpctx, "approximately ");
|
|
/* diff is in minutes */
|
|
diff /= 60;
|
|
if (diff < 48 * 60)
|
|
tal_append_fmt(&v, "%"PRIu64" hours %"PRIu64" minutes",
|
|
diff / 60, diff % 60);
|
|
else {
|
|
/* hours */
|
|
diff /= 60;
|
|
if (diff < 60 * 24)
|
|
tal_append_fmt(&v, "%"PRIu64" days %"PRIu64" hours",
|
|
diff / 24, diff % 24);
|
|
else {
|
|
/* days */
|
|
diff /= 24;
|
|
if (diff < 365 * 2)
|
|
tal_append_fmt(&v, "%"PRIu64" months %"PRIu64" days",
|
|
diff / 30, diff % 30);
|
|
else {
|
|
/* months */
|
|
diff /= 30;
|
|
tal_append_fmt(&v, "%"PRIu64" years %"PRIu64" months",
|
|
diff / 12, diff % 12);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (now > t)
|
|
tal_append_fmt(&v, " ago");
|
|
else
|
|
tal_append_fmt(&v, " from now");
|
|
value = tal_fmt(tmpctx, "%s (%s)", alt->value, v);
|
|
} else
|
|
value = alt->value;
|
|
} else
|
|
value = tal_fmt(tmpctx, "'%s'", alt->value);
|
|
|
|
switch (alt->condition) {
|
|
case RUNE_COND_IF_MISSING:
|
|
tal_append_fmt(&summary, "%s (%s) is missing", alt->fieldname, annotation);
|
|
break;
|
|
case RUNE_COND_EQUAL:
|
|
tal_append_fmt(&summary, "%s (%s) equal to %s", alt->fieldname, annotation, value);
|
|
break;
|
|
case RUNE_COND_NOT_EQUAL:
|
|
tal_append_fmt(&summary, "%s (%s) unequal to %s", alt->fieldname, annotation, value);
|
|
break;
|
|
case RUNE_COND_BEGINS:
|
|
tal_append_fmt(&summary, "%s (%s) starts with '%s'", alt->fieldname, annotation, alt->value);
|
|
break;
|
|
case RUNE_COND_ENDS:
|
|
tal_append_fmt(&summary, "%s (%s) ends with '%s'", alt->fieldname, annotation, alt->value);
|
|
break;
|
|
case RUNE_COND_CONTAINS:
|
|
tal_append_fmt(&summary, "%s (%s) contains '%s'", alt->fieldname, annotation, alt->value);
|
|
break;
|
|
case RUNE_COND_INT_LESS:
|
|
tal_append_fmt(&summary, "%s (%s) less than %s", alt->fieldname, annotation,
|
|
time_val ? value : alt->value);
|
|
break;
|
|
case RUNE_COND_INT_GREATER:
|
|
tal_append_fmt(&summary, "%s (%s) greater than %s", alt->fieldname, annotation,
|
|
time_val ? value : alt->value);
|
|
break;
|
|
case RUNE_COND_LEXO_BEFORE:
|
|
tal_append_fmt(&summary, "%s (%s) sorts before '%s'", alt->fieldname, annotation, alt->value);
|
|
break;
|
|
case RUNE_COND_LEXO_AFTER:
|
|
tal_append_fmt(&summary, "%s (%s) sorts after '%s'", alt->fieldname, annotation, alt->value);
|
|
break;
|
|
case RUNE_COND_COMMENT:
|
|
tal_append_fmt(&summary, "[comment: %s%s]", alt->fieldname, alt->value);
|
|
break;
|
|
}
|
|
sep = " OR ";
|
|
json_add_str_fmt(js, NULL, "%s%c%s", alt->fieldname, alt->condition, alt->value);
|
|
}
|
|
json_array_end(js);
|
|
json_add_string(js, "summary", summary);
|
|
json_object_end(js);
|
|
}
|
|
json_array_end(js);
|
|
/* FIXME: do some sanity checks? */
|
|
json_add_bool(js, "valid", true);
|
|
}
|
|
|
|
static struct command_result *json_decode(struct command *cmd,
|
|
const char *buffer,
|
|
const jsmntok_t *params)
|
|
{
|
|
struct decodable *decodable = talz(cmd, struct decodable);
|
|
struct json_stream *response;
|
|
|
|
if (!param(cmd, buffer, params,
|
|
p_req("string", param_decodable, decodable),
|
|
NULL))
|
|
return command_param_failed();
|
|
|
|
response = jsonrpc_stream_success(cmd);
|
|
json_add_string(response, "type", decodable->type);
|
|
if (decodable->offer)
|
|
json_add_offer(response, decodable->offer);
|
|
if (decodable->invreq)
|
|
json_add_invoice_request(response, decodable->invreq);
|
|
if (decodable->invoice)
|
|
json_add_b12_invoice(response, decodable->invoice);
|
|
if (decodable->b11) {
|
|
/* The bolt11 decoder simply refuses to decode bad invs. */
|
|
json_add_bolt11(response, decodable->b11);
|
|
json_add_bool(response, "valid", true);
|
|
}
|
|
if (decodable->rune)
|
|
json_add_rune(cmd, response, decodable->rune);
|
|
return command_finished(cmd, response);
|
|
}
|
|
|
|
static const char *init(struct plugin *p,
|
|
const char *buf UNUSED,
|
|
const jsmntok_t *config UNUSED)
|
|
{
|
|
rpc_scan(p, "getinfo",
|
|
take(json_out_obj(NULL, NULL, NULL)),
|
|
"{id:%}", JSON_SCAN(json_to_pubkey, &id),
|
|
"{blockheight:%}", JSON_SCAN(json_to_u32, &blockheight));
|
|
|
|
rpc_scan(p, "listconfigs",
|
|
take(json_out_obj(NULL, NULL, NULL)),
|
|
"{configs:"
|
|
"{cltv-final:{value_int:%},"
|
|
"experimental-offers:{set:%}}}",
|
|
JSON_SCAN(json_to_u16, &cltv_final),
|
|
JSON_SCAN(json_to_bool, &offers_enabled));
|
|
|
|
rpc_scan(p, "makesecret",
|
|
take(json_out_obj(NULL, "string", INVOICE_PATH_BASE_STRING)),
|
|
"{secret:%}",
|
|
JSON_SCAN(json_to_secret, &invoicesecret_base));
|
|
|
|
return NULL;
|
|
}
|
|
|
|
static const struct plugin_command commands[] = {
|
|
{
|
|
"offer",
|
|
"payment",
|
|
"Create an offer to accept money",
|
|
"Create an offer for invoices of {amount} with {description}, optional {issuer}, internal {label}, {quantity_min}, {quantity_max}, {absolute_expiry}, {recurrence}, {recurrence_base}, {recurrence_paywindow}, {recurrence_limit} and {single_use}",
|
|
json_offer
|
|
},
|
|
{
|
|
"invoicerequest",
|
|
"payment",
|
|
"Create an invoice_request to send money",
|
|
"Create an invoice_request to pay invoices of {amount} with {description}, optional {issuer}, internal {label}, and {absolute_expiry}",
|
|
json_invoicerequest
|
|
},
|
|
{
|
|
"decode",
|
|
"utility",
|
|
"Decode {string} message, returning {type} and information.",
|
|
NULL,
|
|
json_decode,
|
|
},
|
|
};
|
|
|
|
int main(int argc, char *argv[])
|
|
{
|
|
setup_locale();
|
|
|
|
/* We deal in UTC; mktime() uses local time */
|
|
setenv("TZ", "", 1);
|
|
plugin_main(argv, init, PLUGIN_RESTARTABLE, true, NULL,
|
|
commands, ARRAY_SIZE(commands),
|
|
notifications, ARRAY_SIZE(notifications),
|
|
hooks, ARRAY_SIZE(hooks),
|
|
NULL, 0, NULL);
|
|
}
|