From 37583d8c9ccfefed73b1f124d6ba551410e408f8 Mon Sep 17 00:00:00 2001
From: Colin <colin@uninsane.org>
Date: Sat, 6 Jan 2024 18:08:51 +0000
Subject: [PATCH] clightning: tune fees, logging

---
 .../services/cryptocurrencies/clightning.nix     | 16 +++++++++++++++-
 secrets/servo/lightning-config.bin               |  6 +++---
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/hosts/by-name/servo/services/cryptocurrencies/clightning.nix b/hosts/by-name/servo/services/cryptocurrencies/clightning.nix
index 36704a7d..78586749 100644
--- a/hosts/by-name/servo/services/cryptocurrencies/clightning.nix
+++ b/hosts/by-name/servo/services/cryptocurrencies/clightning.nix
@@ -8,6 +8,11 @@
 # - guide: <https://github.com/ElementsProject/lightning>
 # - `sudo -u clightning -g clightning lightning-cli help`
 #
+# debugging:
+# - `lightning-cli getlog debug`
+# - `lightning-cli listpays`  -> show payments this node sent
+# - `lightning-cli listinvoices`  -> show payments this node received
+#
 # first, acquire peers:
 # - `lightning-cli connect id@host`
 #   where `id` is the node's pubkey, and `host` is perhaps an ip:port tuple, or a hash.onion:port tuple.
@@ -29,6 +34,7 @@
 #   - <https://terminal.lightning.engineering/>
 #   - <https://1ml.com>
 #     - tor nodes: <https://1ml.com/node?order=capacity&iponionservice=true>
+#   - <https://lightningnetwork.plus>
 #   - <https://mempool.space/lightning>
 #   - <https://amboss.space>
 # - a few tor-capable nodes which allow channel creation:
@@ -38,9 +44,11 @@
 #   - <https://coincept.com/>
 # - more resources: <https://www.lopp.net/lightning-information.html>
 #   - node routability: https://hashxp.org/lightning/node/<id>
+# - especially, acquire inbound liquidity via lightningnetwork.plus's swap feature
+#   - most of the opportunities are gated behind a minimum connection or capacity requirement
 #
 # tune payment parameters
-# - `lightning-cli setchannel id [feebase] [feeppm] [htlcmin] [htlcmax] [enforcedelay] [ignorefeelimits]`
+# - `lightning-cli setchannel <id> [feebase] [feeppm] [htlcmin] [htlcmax] [enforcedelay] [ignorefeelimits]`
 #   - e.g. `lightning-cli setchannel all 0 10`
 #   - it's suggested that feebase=0 simplifies routing.
 #
@@ -52,6 +60,7 @@
 #
 # to receive a payment (do as `clightning` user):
 # - `lightning-cli invoice <amount in millisatoshi> <label> <description>`
+#   - specify amount as `any` if undetermined
 #   - then give the resulting bolt11 URI to the payer
 # to send a payment:
 # - `lightning-cli pay <bolt11 URI>`
@@ -100,7 +109,12 @@
   # - bitcoin-rpcpassword
   # - alias=nodename
   # - rgb=rrggbb
+  # - fee-base=<millisatoshi>
+  # - fee-per-satoshi=<ppm>
   # - feature configs (i.e. experimental-xyz options)
+  sane.services.clightning.extraConfig = ''
+    log-level=debug:lightningd
+  '';
   sane.services.clightning.extraConfigFiles = [ config.sops.secrets."lightning-config".path ];
   sops.secrets."lightning-config" = {
     mode = "0600";
diff --git a/secrets/servo/lightning-config.bin b/secrets/servo/lightning-config.bin
index 335bdada..8685bdfb 100644
--- a/secrets/servo/lightning-config.bin
+++ b/secrets/servo/lightning-config.bin
@@ -1,5 +1,5 @@
 {
-	"data": "ENC[AES256_GCM,data:/LnUhUS9E/b81NypbsChOPBQvZvJshzSeKKFSV411o6b4d0YNYxpgDVM/m0hBJvbi1L5Ja7bBnZ/oQwfy4dNkRlCu5BvHb3WtGOXj4Pk/F3wqk8i4SRDtR1flwfXEMz18RAzgneUB6+xcWyNpTGIW3b8xCMBOyAyKldxyq8lIGBCd092HyNk+FmBkZGKUc5tpgMVYohOHQ7eEjmEtBAPySD/A1p81RkqR0CTlQH/o90nBpLTtWych7LEH156kLXoKuaNEXGn2N0iosgcxSwzUZmgEQ9wmXDm8KCmmWcCiQkBezEc9EmznVvto8ds5xDFwVF/+17g16fnHLNRydM5ihgL4KDDpK/e4Ib3/iAEQhK4p+Qzksw9uKBl593KwLWX/r0dEoqgeXuxtEHDt4W7cpgkRJANybc70bUgKEboe74908WEbT83wJO9A066bDUNAkBPhtvrQb2y+9KB9743lRPiwW/LyzZhX/7XSH/FGuQMVuvsfq3PbN2zSslW6XdK5oR4eUmu7OS69Pzo0r0fdCNXGJvKf3SZJjcjt1rbYfPG7imfOVRFxHowRAQC0E/jG5ebIOqGTqvrSBiMU3yQyYBa9NCFCTlESm7Gf0CudEsU+S/Sae6dp6nYB6Zq96H8MUcvH1kSC7US5LcPcCs41iCheizumvBkUqrM98/nuq+ZHdEuzK/gRZrC5vv437JLlnYw9monrviyFcEpWtnGPtvF0jLJlTa7hYvpUkHqzq2T9YmKi+g/6DCRDF9xjeEezbIqVAvOwOJ1AZkhkir9EGPdcczrBj8UQOyty8EXGm11nnA1Om0VsaDx4Er3PpX/lga1nimE1QWq1GNscEhylUxEM4c+9N+WMFR87d/m+zD66RmgTBoAMMR/JzA+POeTkki86SzWssEJFqoI+BGeDWIjyWLzy2tb2Y78rGmNZSxhK4ec9ke7J5Oa4KBWuZoCACGAwQEcykySoZowON6CT7bOcA7zbS4oMpLC3YVBF9dhf8xII1552rHDG6RFrA+kAotrCofXaLSmWO8KeXQoWzw8CvnfXULo+wvIB6NCmUbJxRM0l41IfXbQHC3Km/yozi3Ci+nUjHjmh4fjXSzqbxxjv8M1YJNrQPY66bZktZi46h91oj+d+de/2eMj6HK9CPBX4cefR3IQQgOP25JXSD5garHLNuDZwCeqgUujO7EcjnNaXIBvAS07pKh5UUz/V8z76WLmliINPB8L4h9OHut69YqDqkKC80FCoIIimbh9Q5g0xHffjw==,iv:C7QxsGTluOcnSqQ/qTXwYcqH0bUtjsu9LqdJtwH0SP0=,tag:c9Q/YEqPSz6iKnHsxkbOOg==,type:str]",
+	"data": "ENC[AES256_GCM,data:ShIGecNZYkjf13un+8A5vOdzr3rVm6jIYbEr9Jf9hcx2t4uibe0gWDm88Qb7D+vNtmJMnujUGOb7spv2Y62aMKp45zfyeMUqtwocCU/oCbqQoU9klTF64psJ/b99Et6JfBxxnAKGvfjfBuZHHF7g1r9AdFeMqHR4oWWxABWa4SBSztIzpZDlrB8TFZMSkjHxEqlIsMmioXVYoThzWO1T/eRc8IAVsBe9/sNl0h/HfjCDz/63XgDXDv7oFiZkzjCtHiBRcHjAmhn/1Tc/Ux+e5M5SqqOB1N73FhEvPvHEaEqz6H1DxI3Hnx0UOWLvxL5t9+RJEVmaaP+sM3jyqifXxhkuIoOLb435HLNGXy5Qzm3HdCdASL5B/hYR01GjW/ZiPENMq4IKnTSTvTq8HosevYOPCvKqMauEXeZ/90LS/ZdhmAHY2FV3eEeDv5JuFx9+nmY9MR2MKOIKW0HMez+NI+ia9cx1zYYW/2rrkBq5Fc+8TGyZqhuvKDXBDWIeLa92yP/fXnFjk/fPvByLmsL6kzthpYhqmqedtuaUydaFyDTKmAmRs5nteGDXnxzbrCZYtsWhE467qLRMfMZ8pd8qIonV3wHc7vipqKI/LGJ7VNc0uDhltphfhZurJR6mzw2JpS1J/huuPLKLlEmlvetOKkFEMgLj5dRNzUdXfBe3Rb+BcGoBB9xfNFCQhCpGx+PccEecPTIX9RCcbco8rAMeQvjEcpQZ7eilkr1dTA4yOorb2yHuzcZML/1eYl4ePun1RwrOM6O+HUAel+qP3vEHVctBKYZnwOv/vNJJ7kpqwE2dgemeR5QEuHRdg/J2u4DazQH8rVNP5UkfCX6u+JJlyfggyUvQXArzsEHGvPcrmBZrd/ISBvIEHh8NPSCXvz/qM3vj/QtQnBp7KgRPsm+pcWKshg2eERT/F0HMTFd+XCsBxtZdQtBlOIOkTHH8Td9WQFbpBIMv0HmP5htDKIBeCVseURDk/jujQRez2P/hLtHkgUORhIGBIabqEAPxDFB/kt2kJOORYO2D0UKTC3g8+FiJnXcrxY1v3U8tpcm3eDHj8MwILN4pBwEFqVs+pnFg4kIIZbwX+gC6VpDwGHnol6sBewPd1nKJyu6iMmYztkSe2/9FhSPav6kC1zmliJUBPlv02croOqILwuP6nAelvb7YFPaXHKRsjE5BLAaXsoO6QSi6G5589kqlWMJUCSgN0xOuag7RdwCTH//GXCQWUzhsIAqG41ABkd67LJVcd8UI0u479mdAQhpP618hwlbtrtN5RAEvm0U8NasrUDVUKDtwX4tpKy/DaWhiqm9I02TQfYrh8fZhSB2yrst8J6tHr5F6pY/JBKxFJ/u124CxncFqenAs5lTa3fdqX6jnM0qfw2zi6fhPozibsBq2Rqz7l+tnNXTt1O+zDo7YlXcnOHOmou4IJttgpHToGwbPmXDieg==,iv:0k8yTpL1/liIMec5PD4JxgHN3/mSTUFbF0PjbUt8kFc=,tag:gMAnVvModolveKfvcHVWkA==,type:str]",
 	"sops": {
 		"kms": null,
 		"gcp_kms": null,
@@ -23,8 +23,8 @@
 				"enc": "-----BEGIN AGE ENCRYPTED FILE-----\nYWdlLWVuY3J5cHRpb24ub3JnL3YxCi0+IFgyNTUxOSA2RGJJNlNUQTIzY0FyRVFY\nSm1zRmtpa20zaXRzZDIwR0FpK3VoT3FpL1ZZCnYrcEVZUHpVQnJmZ2d2WGdYdHNE\nQW0wOUlYeHpMRVo1TGdTRENITExxdncKLS0tIHFuMHIwNjdpVitSTEtsWkNiNjVH\nbGVRK1Racm93RVVnMkI1RThLS3Y3SGcKJVFfcTLMPu2GjkQhGm9gSS7eqzzAVW4e\nLoMh52PZog2/1NrT3KKEqxQ1/XyRcqv1T1oU/xvV6EE9+nj2LEuWog==\n-----END AGE ENCRYPTED FILE-----\n"
 			}
 		],
-		"lastmodified": "2024-01-06T09:10:21Z",
-		"mac": "ENC[AES256_GCM,data:BkBAeME8WJOKSyAkJCS5w2KLCYhX+9oglh/y2rYi34iZBB3Ugd/L786z5y/llfBj8blCuz20kTLmq4f2G695scxh9/Pq2AcJWpSvZTFzC7WlIiprIiRtKJ9DjAOUVnAJBBfY4/pv17XRSeo4KBE3AYn6IhKvu+JPt2tn9mpBCnk=,iv:iWj7OAw0ud1SrA2wG3CZxfkwqhn0z0w2jsCcFE7bWkQ=,tag:8nkfGgRrYt2U/cQr9Bn4dw==,type:str]",
+		"lastmodified": "2024-01-06T16:20:21Z",
+		"mac": "ENC[AES256_GCM,data:1uZmZ4dUduQwrEzfo7Cx8gJuBS+qi1yGqz9q7iZCttCOjcXMyEZWLRYoXQlVDKq84eDvIHnbQbZqyvUf/tPrZoRf/A/VzXuDxnoB0vJKJI5jeyciBX3hEX7hFUNo5cTJnz3hfSksZuwdH5Km95MeqhW86QXNtjIHuZDFPEBEkBs=,iv:LcKCYMWCMaQ0DyrIoYBDhiKCw/VCYV/ndbd8M701Wes=,tag:dQPVjW82H5HiqsaDb5QC+g==,type:str]",
 		"pgp": null,
 		"unencrypted_suffix": "_unencrypted",
 		"version": "3.8.1"