aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRussell Yanofsky <russ@yanofsky.org>2017-03-27 16:55:24 -0400
committerRussell Yanofsky <russ@yanofsky.org>2018-04-03 11:52:21 -0400
commitea73b84d2ddde22487dee0f71d7a619051e067f2 (patch)
treefaff54b33ffba4d4ce5b3275c3546fcfedb1f6ed
parentad960f5771dc251c8e1198dd8a82e18df4562171 (diff)
Add src/interface/README.md
-rw-r--r--src/interface/README.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/src/interface/README.md b/src/interface/README.md
new file mode 100644
index 0000000000..e93b91d23c
--- /dev/null
+++ b/src/interface/README.md
@@ -0,0 +1,17 @@
+# Internal c++ interfaces
+
+The following interfaces are defined here:
+
+* [`Chain`](chain.h) — used by wallet to access blockchain and mempool state. Added in [#10973](https://github.com/bitcoin/bitcoin/pull/10973).
+
+* [`Chain::Client`](chain.h) — used by node to start & stop `Chain` clients. Added in [#10973](https://github.com/bitcoin/bitcoin/pull/10973).
+
+* [`Node`](node.h) — used by GUI to start & stop bitcoin node. Added in [#10244](https://github.com/bitcoin/bitcoin/pull/10244).
+
+* [`Wallet`](wallet.h) — used by GUI to access wallets. Added in [#10244](https://github.com/bitcoin/bitcoin/pull/10244).
+
+* [`Handler`](handler.h) — returned by `handleEvent` methods on interfaces above and used to manage lifetimes of event handlers.
+
+* [`Init`](init.h) — used by multiprocess code to access interfaces above on startup. Added in [#10102](https://github.com/bitcoin/bitcoin/pull/10102).
+
+The interfaces above define boundaries between major components of bitcoin code (node, wallet, and gui), making it possible for them to run in different processes, and be tested, developed, and understood independently. These interfaces are not currently designed to be stable or to be used externally.