2019-08-05 08:44:38 +00:00
|
|
|
{ config, lib, pkgs, ... }:
|
|
|
|
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
options.services.lnd = {
|
2021-12-14 18:51:23 +00:00
|
|
|
enable = mkEnableOption "Lightning Network daemon, a Lightning Network implementation in Go";
|
2021-01-14 12:24:03 +00:00
|
|
|
address = mkOption {
|
|
|
|
type = types.str;
|
2020-06-04 09:30:17 +00:00
|
|
|
default = "localhost";
|
2021-01-14 12:24:03 +00:00
|
|
|
description = "Address to listen for peer connections";
|
2020-06-04 09:30:17 +00:00
|
|
|
};
|
2021-01-14 12:24:03 +00:00
|
|
|
port = mkOption {
|
2020-08-04 07:45:02 +00:00
|
|
|
type = types.port;
|
|
|
|
default = 9735;
|
2021-01-14 12:24:03 +00:00
|
|
|
description = "Port to listen for peer connections";
|
2020-08-04 07:45:02 +00:00
|
|
|
};
|
2021-01-14 12:24:03 +00:00
|
|
|
rpcAddress = mkOption {
|
2020-10-29 20:20:33 +00:00
|
|
|
type = types.str;
|
|
|
|
default = "localhost";
|
2021-01-14 12:24:03 +00:00
|
|
|
description = "Address to listen for RPC connections.";
|
2020-06-04 09:30:17 +00:00
|
|
|
};
|
2021-01-14 12:24:03 +00:00
|
|
|
rpcPort = mkOption {
|
|
|
|
type = types.port;
|
|
|
|
default = 10009;
|
|
|
|
description = "Port to listen for gRPC connections.";
|
|
|
|
};
|
|
|
|
restAddress = mkOption {
|
2020-10-29 20:20:33 +00:00
|
|
|
type = types.str;
|
|
|
|
default = "localhost";
|
2021-09-16 10:48:21 +00:00
|
|
|
description = "Address to listen for REST connections.";
|
2020-06-04 09:30:17 +00:00
|
|
|
};
|
2020-06-02 13:20:04 +00:00
|
|
|
restPort = mkOption {
|
|
|
|
type = types.port;
|
|
|
|
default = 8080;
|
2021-01-14 12:24:03 +00:00
|
|
|
description = "Port to listen for REST connections.";
|
2020-06-02 13:20:04 +00:00
|
|
|
};
|
2021-09-16 10:48:21 +00:00
|
|
|
dataDir = mkOption {
|
|
|
|
type = types.path;
|
|
|
|
default = "/var/lib/lnd";
|
|
|
|
description = "The data directory for LND.";
|
|
|
|
};
|
|
|
|
networkDir = mkOption {
|
|
|
|
readOnly = true;
|
|
|
|
default = "${cfg.dataDir}/chain/bitcoin/${bitcoind.network}";
|
|
|
|
description = "The network data directory.";
|
|
|
|
};
|
2020-06-04 09:30:17 +00:00
|
|
|
tor-socks = mkOption {
|
|
|
|
type = types.nullOr types.str;
|
2021-11-28 20:24:49 +00:00
|
|
|
default = if cfg.tor.proxy then config.nix-bitcoin.torClientAddressWithPort else null;
|
2021-02-01 21:53:04 +00:00
|
|
|
description = "Socks proxy for connecting to Tor nodes";
|
2020-06-04 09:30:17 +00:00
|
|
|
};
|
2020-08-26 08:22:23 +00:00
|
|
|
macaroons = mkOption {
|
|
|
|
default = {};
|
|
|
|
type = with types; attrsOf (submodule {
|
|
|
|
options = {
|
|
|
|
user = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
description = "User who owns the macaroon.";
|
|
|
|
};
|
|
|
|
permissions = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
example = ''
|
|
|
|
{"entity":"info","action":"read"},{"entity":"onchain","action":"read"}
|
|
|
|
'';
|
|
|
|
description = "List of granted macaroon permissions.";
|
|
|
|
};
|
|
|
|
};
|
|
|
|
});
|
|
|
|
description = ''
|
|
|
|
Extra macaroon definitions.
|
|
|
|
'';
|
|
|
|
};
|
2019-08-05 08:44:38 +00:00
|
|
|
extraConfig = mkOption {
|
2020-03-09 08:22:00 +00:00
|
|
|
type = types.lines;
|
|
|
|
default = "";
|
|
|
|
example = ''
|
|
|
|
autopilot.active=1
|
|
|
|
'';
|
2021-02-01 21:53:11 +00:00
|
|
|
description = "Extra lines appended to <filename>lnd.conf</filename>.";
|
2020-03-09 08:22:00 +00:00
|
|
|
};
|
|
|
|
package = mkOption {
|
|
|
|
type = types.package;
|
2020-11-09 21:09:09 +00:00
|
|
|
default = config.nix-bitcoin.pkgs.lnd;
|
2021-12-08 03:07:28 +00:00
|
|
|
defaultText = "config.nix-bitcoin.pkgs.lnd";
|
2020-03-09 08:22:00 +00:00
|
|
|
description = "The package providing lnd binaries.";
|
|
|
|
};
|
2019-11-27 13:04:34 +00:00
|
|
|
cli = mkOption {
|
|
|
|
default = pkgs.writeScriptBin "lncli"
|
2021-09-16 10:48:21 +00:00
|
|
|
# Switch user because lnd makes datadir contents readable by user only
|
|
|
|
''
|
|
|
|
${runAsUser} ${cfg.user} ${cfg.package}/bin/lncli \
|
|
|
|
--rpcserver ${cfg.rpcAddress}:${toString cfg.rpcPort} \
|
|
|
|
--tlscertpath '${cfg.certPath}' \
|
|
|
|
--macaroonpath '${networkDir}/admin.macaroon' "$@"
|
|
|
|
'';
|
2021-12-08 03:07:28 +00:00
|
|
|
defaultText = "(See source)";
|
2019-11-27 13:04:34 +00:00
|
|
|
description = "Binary to connect with the lnd instance.";
|
|
|
|
};
|
2021-01-14 12:24:21 +00:00
|
|
|
getPublicAddressCmd = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
default = "";
|
|
|
|
description = ''
|
|
|
|
Bash expression which outputs the public service address to announce to peers.
|
|
|
|
If left empty, no address is announced.
|
|
|
|
'';
|
|
|
|
};
|
2021-02-16 16:50:39 +00:00
|
|
|
user = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
default = "lnd";
|
|
|
|
description = "The user as which to run LND.";
|
|
|
|
};
|
|
|
|
group = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
default = cfg.user;
|
|
|
|
description = "The group as which to run LND.";
|
|
|
|
};
|
2021-09-08 15:01:13 +00:00
|
|
|
certPath = mkOption {
|
|
|
|
readOnly = true;
|
|
|
|
default = "${secretsDir}/lnd-cert";
|
|
|
|
description = "LND TLS certificate path.";
|
|
|
|
};
|
2021-11-28 20:24:49 +00:00
|
|
|
tor = nbLib.tor;
|
2019-08-05 08:44:38 +00:00
|
|
|
};
|
|
|
|
|
2021-09-13 11:40:47 +00:00
|
|
|
cfg = config.services.lnd;
|
|
|
|
nbLib = config.nix-bitcoin.lib;
|
|
|
|
secretsDir = config.nix-bitcoin.secretsDir;
|
|
|
|
runAsUser = config.nix-bitcoin.runAsUserCmd;
|
2022-03-29 19:48:57 +00:00
|
|
|
lndinit = "${config.nix-bitcoin.pkgs.lndinit}/bin/lndinit";
|
2021-09-13 11:40:47 +00:00
|
|
|
|
|
|
|
bitcoind = config.services.bitcoind;
|
2021-09-13 11:40:49 +00:00
|
|
|
|
2021-10-01 09:51:57 +00:00
|
|
|
bitcoindRpcAddress = nbLib.address bitcoind.rpc.address;
|
2021-09-16 10:48:21 +00:00
|
|
|
networkDir = cfg.networkDir;
|
2021-09-13 11:40:47 +00:00
|
|
|
configFile = pkgs.writeText "lnd.conf" ''
|
|
|
|
datadir=${cfg.dataDir}
|
|
|
|
logdir=${cfg.dataDir}/logs
|
|
|
|
tlscertpath=${cfg.certPath}
|
|
|
|
tlskeypath=${secretsDir}/lnd-key
|
|
|
|
|
|
|
|
listen=${toString cfg.address}:${toString cfg.port}
|
|
|
|
rpclisten=${cfg.rpcAddress}:${toString cfg.rpcPort}
|
|
|
|
restlisten=${cfg.restAddress}:${toString cfg.restPort}
|
|
|
|
|
|
|
|
bitcoin.${bitcoind.network}=1
|
|
|
|
bitcoin.active=1
|
|
|
|
bitcoin.node=bitcoind
|
|
|
|
|
2021-11-28 20:24:49 +00:00
|
|
|
${optionalString (cfg.tor.proxy) "tor.active=true"}
|
2021-09-13 11:40:47 +00:00
|
|
|
${optionalString (cfg.tor-socks != null) "tor.socks=${cfg.tor-socks}"}
|
|
|
|
|
|
|
|
bitcoind.rpchost=${bitcoindRpcAddress}:${toString bitcoind.rpc.port}
|
|
|
|
bitcoind.rpcuser=${bitcoind.rpc.users.public.name}
|
|
|
|
bitcoind.zmqpubrawblock=${bitcoind.zmqpubrawblock}
|
|
|
|
bitcoind.zmqpubrawtx=${bitcoind.zmqpubrawtx}
|
|
|
|
|
|
|
|
${cfg.extraConfig}
|
|
|
|
'';
|
|
|
|
in {
|
|
|
|
|
|
|
|
inherit options;
|
|
|
|
|
2019-08-05 08:44:38 +00:00
|
|
|
config = mkIf cfg.enable {
|
2020-06-15 10:34:11 +00:00
|
|
|
assertions = [
|
2021-08-15 09:28:46 +00:00
|
|
|
{ assertion =
|
|
|
|
!(config.services ? clightning)
|
|
|
|
|| !config.services.clightning.enable
|
|
|
|
|| config.services.clightning.port != cfg.port;
|
|
|
|
message = ''
|
|
|
|
LND and clightning can't both bind to lightning port 9735. Either
|
|
|
|
disable LND/clightning or change services.clightning.port or
|
|
|
|
services.lnd.port to a port other than 9735.
|
|
|
|
'';
|
|
|
|
}
|
2020-06-15 10:34:11 +00:00
|
|
|
];
|
|
|
|
|
2021-01-14 12:24:32 +00:00
|
|
|
services.bitcoind = {
|
|
|
|
enable = true;
|
2021-02-01 21:53:22 +00:00
|
|
|
|
2021-01-14 12:24:32 +00:00
|
|
|
# Increase rpc thread count due to reports that lightning implementations fail
|
|
|
|
# under high bitcoind rpc load
|
|
|
|
rpc.threads = 16;
|
2021-02-01 21:53:22 +00:00
|
|
|
|
|
|
|
zmqpubrawblock = "tcp://${bitcoindRpcAddress}:28332";
|
|
|
|
zmqpubrawtx = "tcp://${bitcoindRpcAddress}:28333";
|
2021-01-14 12:24:32 +00:00
|
|
|
};
|
2020-10-18 12:49:20 +00:00
|
|
|
|
2020-04-07 20:47:45 +00:00
|
|
|
environment.systemPackages = [ cfg.package (hiPrio cfg.cli) ];
|
2020-05-05 14:28:30 +00:00
|
|
|
|
2020-05-06 10:43:57 +00:00
|
|
|
systemd.tmpfiles.rules = [
|
2021-02-16 16:50:39 +00:00
|
|
|
"d '${cfg.dataDir}' 0770 ${cfg.user} ${cfg.group} - -"
|
2020-05-06 10:43:57 +00:00
|
|
|
];
|
|
|
|
|
2019-08-05 08:44:38 +00:00
|
|
|
systemd.services.lnd = {
|
|
|
|
wantedBy = [ "multi-user.target" ];
|
2021-01-14 12:24:21 +00:00
|
|
|
requires = [ "bitcoind.service" ];
|
|
|
|
after = [ "bitcoind.service" ];
|
2019-08-05 08:44:38 +00:00
|
|
|
preStart = ''
|
2020-05-22 13:59:18 +00:00
|
|
|
install -m600 ${configFile} '${cfg.dataDir}/lnd.conf'
|
2021-01-14 12:24:21 +00:00
|
|
|
{
|
|
|
|
echo "bitcoind.rpcpass=$(cat ${secretsDir}/bitcoin-rpcpassword-public)"
|
|
|
|
${optionalString (cfg.getPublicAddressCmd != "") ''
|
|
|
|
echo "externalip=$(${cfg.getPublicAddressCmd})"
|
|
|
|
''}
|
|
|
|
} >> '${cfg.dataDir}/lnd.conf'
|
2022-03-29 19:48:57 +00:00
|
|
|
|
|
|
|
if [[ ! -f ${networkDir}/wallet.db ]]; then
|
|
|
|
mnemonic='${cfg.dataDir}/lnd-seed-mnemonic'
|
|
|
|
|
|
|
|
if [[ ! -f "$mnemonic" ]]; then
|
|
|
|
echo "Create lnd seed"
|
|
|
|
(umask u=r,go=; ${lndinit} gen-seed > "$mnemonic")
|
|
|
|
fi
|
|
|
|
|
|
|
|
echo "Create lnd wallet"
|
|
|
|
${lndinit} -v init-wallet \
|
|
|
|
--file.seed="$mnemonic" \
|
|
|
|
--file.wallet-password='${secretsDir}/lnd-wallet-password' \
|
|
|
|
--init-file.output-wallet-dir='${cfg.networkDir}'
|
|
|
|
fi
|
2019-08-05 08:44:38 +00:00
|
|
|
'';
|
2021-02-03 21:44:41 +00:00
|
|
|
serviceConfig = nbLib.defaultHardening // {
|
2022-01-14 14:32:08 +00:00
|
|
|
Type = "notify";
|
2020-08-26 08:22:23 +00:00
|
|
|
RuntimeDirectory = "lnd"; # Only used to store custom macaroons
|
|
|
|
RuntimeDirectoryMode = "711";
|
2022-01-14 14:32:08 +00:00
|
|
|
ExecStart = ''
|
|
|
|
${cfg.package}/bin/lnd \
|
|
|
|
--configfile="${cfg.dataDir}/lnd.conf" \
|
2022-03-29 19:48:57 +00:00
|
|
|
--wallet-unlock-password-file="${secretsDir}/lnd-wallet-password"
|
2022-01-14 14:32:08 +00:00
|
|
|
'';
|
2021-02-16 16:50:39 +00:00
|
|
|
User = cfg.user;
|
2021-10-12 19:56:15 +00:00
|
|
|
TimeoutSec = "15min";
|
2019-08-05 08:44:38 +00:00
|
|
|
Restart = "on-failure";
|
|
|
|
RestartSec = "10s";
|
2022-05-07 18:34:21 +00:00
|
|
|
ReadWritePaths = [ cfg.dataDir ];
|
2020-06-02 13:20:04 +00:00
|
|
|
ExecStartPost = let
|
2022-05-17 11:18:38 +00:00
|
|
|
curl = "${pkgs.curl}/bin/curl -fsS --cacert ${cfg.certPath}";
|
2021-10-01 09:51:57 +00:00
|
|
|
restUrl = "https://${nbLib.addressWithPort cfg.restAddress cfg.restPort}/v1";
|
2022-03-29 19:48:57 +00:00
|
|
|
in
|
2022-01-14 14:32:08 +00:00
|
|
|
# Setting macaroon permissions for other users needs root permissions
|
2022-03-29 19:48:57 +00:00
|
|
|
nbLib.rootScript "lnd-create-macaroons" ''
|
2020-08-26 08:22:23 +00:00
|
|
|
umask ug=r,o=
|
|
|
|
${lib.concatMapStrings (macaroon: ''
|
|
|
|
echo "Create custom macaroon ${macaroon}"
|
|
|
|
macaroonPath="$RUNTIME_DIRECTORY/${macaroon}.macaroon"
|
2021-03-16 11:45:22 +00:00
|
|
|
${curl} \
|
2020-10-16 15:43:07 +00:00
|
|
|
-H "Grpc-Metadata-macaroon: $(${pkgs.xxd}/bin/xxd -ps -u -c 99999 '${networkDir}/admin.macaroon')" \
|
2020-08-26 08:22:23 +00:00
|
|
|
-X POST \
|
|
|
|
-d '{"permissions":[${cfg.macaroons.${macaroon}.permissions}]}' \
|
2020-10-29 20:20:30 +00:00
|
|
|
${restUrl}/macaroon |\
|
2020-08-26 08:22:23 +00:00
|
|
|
${pkgs.jq}/bin/jq -c '.macaroon' | ${pkgs.xxd}/bin/xxd -p -r > "$macaroonPath"
|
|
|
|
chown ${cfg.macaroons.${macaroon}.user}: "$macaroonPath"
|
|
|
|
'') (attrNames cfg.macaroons)}
|
2022-03-29 19:48:57 +00:00
|
|
|
'';
|
2021-11-28 20:24:49 +00:00
|
|
|
} // nbLib.allowedIPAddresses cfg.tor.enforce;
|
2019-08-05 08:44:38 +00:00
|
|
|
};
|
2020-09-28 11:09:03 +00:00
|
|
|
|
2021-02-16 16:50:39 +00:00
|
|
|
users.users.${cfg.user} = {
|
2021-08-04 22:48:59 +00:00
|
|
|
isSystemUser = true;
|
2021-02-16 16:50:39 +00:00
|
|
|
group = cfg.group;
|
2021-02-18 10:42:21 +00:00
|
|
|
extraGroups = [ "bitcoinrpc-public" ];
|
2020-04-19 12:44:03 +00:00
|
|
|
home = cfg.dataDir; # lnd creates .lnd dir in HOME
|
2020-01-12 19:52:37 +00:00
|
|
|
};
|
2021-02-16 16:50:39 +00:00
|
|
|
users.groups.${cfg.group} = {};
|
2020-09-28 11:09:03 +00:00
|
|
|
nix-bitcoin.operator = {
|
2021-02-16 16:50:39 +00:00
|
|
|
groups = [ cfg.group ];
|
|
|
|
allowRunAsUsers = [ cfg.user ];
|
2020-09-28 11:09:03 +00:00
|
|
|
};
|
|
|
|
|
2020-01-12 19:52:38 +00:00
|
|
|
nix-bitcoin.secrets = {
|
2021-02-16 16:50:39 +00:00
|
|
|
lnd-wallet-password.user = cfg.user;
|
|
|
|
lnd-key.user = cfg.user;
|
|
|
|
lnd-cert.user = cfg.user;
|
2021-09-08 15:01:18 +00:00
|
|
|
lnd-cert.permissions = "444"; # world readable
|
2020-01-12 19:52:38 +00:00
|
|
|
};
|
2021-09-08 15:01:18 +00:00
|
|
|
# Advantages of manually pre-generating certs:
|
|
|
|
# - Reduces dynamic state
|
|
|
|
# - Enables deployment of a mesh of server plus client nodes with predefined certs
|
|
|
|
nix-bitcoin.generateSecretsCmds.lnd = ''
|
|
|
|
makePasswordSecret lnd-wallet-password
|
|
|
|
makeCert lnd '${optionalString (cfg.rpcAddress != "localhost") "IP:${cfg.rpcAddress}"}'
|
|
|
|
'';
|
2019-08-05 08:44:38 +00:00
|
|
|
};
|
|
|
|
}
|