Merge fort-nix/nix-bitcoin#511: Minor improvements

84b69dfb46 versioning: improve description wording (Erik Arvstedt)
9d20837b90 flake: remove `rec` (Erik Arvstedt)
c82e0ee294 clightning/plugins: format plugin defs, order alphabetically (Erik Arvstedt)
9ac3d93b27 improve comments, descriptions (Erik Arvstedt)
97b1a1d353 operator: improve descriptions (Erik Arvstedt)
27dd31ead5 clightning/feeadjuster: fix typo (Erik Arvstedt)
df5abd5eab lnd: move `wallet-unlock-password-file` setting to config (Erik Arvstedt)

Pull request description:

ACKs for top commit:
  jonasnick:
    ACK 84b69dfb46

Tree-SHA512: e326ea37c4c4e766a634e90a069a441933dfac5a91e85c136e49dd17c16ee6e5e3fbfb15399f97321e412ab1624f1040116e2516e2635188f7e25454d5e9fe34

modules/clightning-plugins/feeadjuster.nix

@@ -10,7 +10,7 @@ let
         Enable feeaduster (clightning plugin).
         This plugin auto-updates channel fees to keep channels balanced.
 
-        See here for for all available options:
+        See here for all available options:
         https://github.com/lightningd/plugins/blob/master/feeadjuster/feeadjuster.py
         Extra options can be set via `services.clightning.extraConfig`.
       '';

modules/lnd.nix

@@ -178,6 +178,8 @@ let
     bitcoind.zmqpubrawblock=${bitcoind.zmqpubrawblock}
     bitcoind.zmqpubrawtx=${bitcoind.zmqpubrawtx}
 
+    wallet-unlock-password-file=${secretsDir}/lnd-wallet-password
+
     ${cfg.extraConfig}
   '';
 in {
@@ -249,11 +251,7 @@ in {
         Type = "notify";
         RuntimeDirectory = "lnd"; # Only used to store custom macaroons
         RuntimeDirectoryMode = "711";
-        ExecStart = ''
-          ${cfg.package}/bin/lnd \
-            --configfile="${cfg.dataDir}/lnd.conf" \
-            --wallet-unlock-password-file="${secretsDir}/lnd-wallet-password"
-        '';
+        ExecStart = "${cfg.package}/bin/lnd --configfile='${cfg.dataDir}/lnd.conf'";
         User = cfg.user;
         TimeoutSec = "15min";
         Restart = "on-failure";

modules/operator.nix

@@ -1,24 +1,29 @@
-# Define an operator user for convenient interactive access to nix-bitcoin
-# features and services.
-#
-# When using nix-bitcoin as part of a larger system config, set
-# `nix-bitcoin.operator.name` to your main user name.
-
 { config, lib, pkgs, ... }:
 
 with lib;
 let
   options.nix-bitcoin.operator = {
-    enable = mkEnableOption "operator user";
+    enable = mkOption {
+      type = types.bool;
+      default = false;
+      description = ''
+        Whether to define a user named `operator` for convenient interactive access
+        to nix-bitcoin features (like `bitcoin-cli`).
+
+        When using nix-bitcoin as part of a larger system config, it makes sense
+        to set your main system user as the operator, by setting option
+        `nix-bitcoin.operator.name = "<main user name>";`.
+      '';
+    };
     name = mkOption {
       type = types.str;
       default = "operator";
-      description = "User name.";
+      description = "Name of the operator user.";
     };
     groups = mkOption {
       type = with types; listOf str;
       default = [];
-      description = "Extra groups.";
+      description = "Extra groups of the operatur user.";
     };
     allowRunAsUsers = mkOption {
       type = with types; listOf str;

modules/presets/secure-node.nix

@@ -30,7 +30,7 @@ in {
       jq
     ];
 
-    # sshd
+    # Add a SSH onion service
     services.tor.relay.onionServices.sshd = nbLib.mkOnionService { port = 22; };
     nix-bitcoin.onionAddresses.access.${operatorName} = [ "sshd" ];
 

modules/versioning.nix

@@ -16,8 +16,8 @@ let
         compatible with.
 
         When upgrading to a backwards-incompatible release, nix-bitcoin will throw an
-        error during evaluation and provide hints for migrating your config to the
-        new release.
+        error during evaluation and provide instructions for migrating your config to
+        the new release.
       '';
     };
   };