lightningd · chrisguida · Aug 7, 2025 · Jul 24, 2025 · Jul 23, 2025 · Jul 24, 2025
diff --git a/README.md b/README.md
@@ -26,6 +26,7 @@ Community curated plugins for Core-Lightning.
 | [feeadjuster][feeadjuster]           | Dynamic fees to keep your channels more balanced                                            | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Ffeeadjuster_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Ffeeadjuster_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Ffeeadjuster_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Ffeeadjuster_nightly.json) |
 | [go-lnmetrics.reporter][reporter]    | Collect and report of the lightning node metrics                                            | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgo-lnmetrics.reporter_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgo-lnmetrics.reporter_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgo-lnmetrics.reporter_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgo-lnmetrics.reporter_nightly.json) |
 | [graphql][graphql]                   | Exposes the Core-Lightning API over [graphql][graphql-spec]                                 | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgraphql_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgraphql_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgraphql_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fgraphql_nightly.json) |
+| [historian][historian]               | Gossip message archiver                                                                     | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhistorian_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhistorian_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhistorian_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhistorian_nightly.json) |
 | [hold][hold]                         | Hold invoices that do not require the preimage to be known when created                     | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhold_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhold_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhold_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fhold_nightly.json) |
 | [holdinvoice][holdinvoice]           | Holds htlcs for invoices until settle or cancel is called (aka Hodlinvoices) via RPC/GRPC   | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fholdinvoice_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fholdinvoice_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fholdinvoice_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2Fholdinvoice_nightly.json) |
 | [invoice-queue][Lightning-Invoice-Queue]       | Listen to lightning invoices from multiple nodes and send to a redis queue for processing   | ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2FLightning-Invoice-Queue_24.11.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2FLightning-Invoice-Queue_25.02.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2FLightning-Invoice-Queue_25.05.json) ![](https://img.shields.io/endpoint?url=https%3A%2F%2Flightningd.github.io%2Fplugins%2F.badges%2FLightning-Invoice-Queue_nightly.json) |
@@ -233,6 +234,7 @@ more detailed description (if any)
 [go-api]: https://github.com/niftynei/glightning
 [graphql]: https://github.com/nettijoe96/c-lightning-graphql
 [graphql-spec]: https://graphql.org/
+[historian]: https://github.com/lightningd/plugins/tree/master/historian
 [hold]: https://github.com/BoltzExchange/hold
 [holdinvoice]: https://github.com/daywalker90/holdinvoice
 [java-api]: https://github.com/clightning4j/JRPClightning

diff --git a/archived/historian/README.org → historian/README.md b/archived/historian/README.org → historian/README.md
diff --git a/archived/historian/cli/backup.py → historian/cli/backup.py b/archived/historian/cli/backup.py → historian/cli/backup.py
diff --git a/archived/historian/cli/common.py → historian/cli/common.py b/archived/historian/cli/common.py → historian/cli/common.py
diff --git a/archived/historian/cli/db.py → historian/cli/db.py b/archived/historian/cli/db.py → historian/cli/db.py
diff --git a/archived/historian/common.py → historian/common.py b/archived/historian/common.py → historian/common.py
diff --git a/archived/historian/gossipd.py → historian/gossipd.py b/archived/historian/gossipd.py → historian/gossipd.py
diff --git a/archived/historian/historian-cli → historian/historian-cli b/archived/historian/historian-cli → historian/historian-cli
diff --git a/archived/historian/historian.py → historian/historian.py b/archived/historian/historian.py → historian/historian.py
@@ -230,6 +230,7 @@ def rabbitmq_connect(self):
         params = pika.URLParameters(self.RABBITMQ_URL)
         self.connection = pika.BlockingConnection(params)  # default, localhost
         self.channel = self.connection.channel()
+        self.channel.exchange_declare(exchange='router.gossip', exchange_type='fanout')
         plugin.log(f"message queue connected to {params.host}:{params.port}")
 
     def run(self):

diff --git a/archived/historian/poetry.lock → historian/poetry.lock b/archived/historian/poetry.lock → historian/poetry.lock
diff --git a/archived/historian/pyproject.toml → historian/pyproject.toml b/archived/historian/pyproject.toml → historian/pyproject.toml
@@ -1,9 +1,28 @@
-[tool.poetry]
-name = "cln-historian"
+[project]
+name = "historian"
 version = "0.1.0"
 description = "A plugin to store historical Lightning Network gossip in a database."
-authors = ["Christian Decker <[email protected]>"]
+readme = "README.md"
+authors = [{name = "Christian Decker", email = "<[email protected]>"}]
 license = "MIT"
+requires-python = ">=3.9"
+dependencies = [
+    "inotify>=0.2.12",
+    "pika>=1.3.2",
+    "pyln-client>=24.2",
+    "python-dotenv>=1.1.0",
+    "sqlalchemy>=2.0.40",
+]
+
+[dependency-groups]
+dev = [
+    "pyln-testing>=24.2",
+    "pytest-rerunfailures>=10.3",
+    "pytest-timeout>=2.1.0",
+    "pytest-xdist>=3.1.0",
+]
+
+[tool.poetry]
 
 [tool.poetry.dependencies]
 python = "^3.9"

diff --git a/archived/historian/test_historian.py → historian/test_historian.py b/archived/historian/test_historian.py → historian/test_historian.py