cln-plugin 0.3.0

A CLN plugin library. Write your plugin in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

#ifndef LIGHTNING_PLUGINS_ESTABLISH_ONION_PATH_H
#define LIGHTNING_PLUGINS_ESTABLISH_ONION_PATH_H
#include "config.h"
#include <ccan/typesafe_cb/typesafe_cb.h>
#include <plugins/libplugin.h>

struct gossmap;

/**
 * establish_onion_path: derive (or connect) a path to this peer.
 * @cmd: the command context
 * @gossmap: a gossip map to do lookup in
 * @local_id: our own id
 * @dst: the destination node
 * @connect_disable: true if we cannot reach out to connect to nodes.
 * @success: the success callback
 * @fail: the failure callback
 * @arg: callback argument
 *
 * If it cannot find an onion-message-carrying path, will connect directly,
 * unless connect_disable is non-NULL.  First pubkey is always us.
 */
struct command_result *establish_onion_path_(struct command *cmd,
					     struct gossmap *gossmap,
					     const struct pubkey *local_id,
					     const struct pubkey *dst,
					     bool connect_disable,
					     struct command_result *(*success)(struct command *,
									   const struct pubkey *,
									   void *arg),
					     struct command_result *(*fail)(struct command *,
									const char *why,
									void *arg),
					     void *arg);

#define establish_onion_path(cmd, gossmap, local_id, id, disable, success, fail, arg) \
	establish_onion_path_((cmd), (gossmap), (local_id), (id), (disable), \
			      typesafe_cb_preargs(struct command_result *, void *, \
						  (success), (arg),	\
						  struct command *,	\
						  const struct pubkey *), \
			      typesafe_cb_preargs(struct command_result *, void *, \
						  (fail), (arg),	\
						  struct command *,	\
						  const char *),	\
			      (arg))

#endif /* LIGHTNING_PLUGINS_ESTABLISH_ONION_PATH_H */