@@ -14,10 +14,10 @@ Head to [BFTE's Radicle site][bfte-radicle] for an up to date version.
1414## Introduction
1515
1616BFTE in its current form is a research project on alternative
17- design/implementation of a Fedimint-like system. While th * very-long*
17+ design/implementation of a Fedimint-like system. While the * very-long*
1818term goals and supported use-cases could be similar to [ Fedimint] [ fedimint ] ,
1919it has a luxury of not worrying about immediate practical application,
20- and enabling focus on parts and goals that the author (dpc)
20+ enabling focus on parts and goals that the author (dpc)
2121finds most promising and interesting.
2222
2323[ fedimint ] : http://github.com/fedimint/fedimint
@@ -27,7 +27,7 @@ where it seems to make sense.
2727
2828Fedimint started as a Bitcoin Ecash Mint solution, with a side-goal/need
2929of building a general purpose consensus engine. BFTE stars with
30- a goal of researching a good general purpose consensus engine first, with
30+ a goal of building as good as possible general purpose consensus engine first, with
3131an ability to support Bitcoin/cryptography applications like Ecash Mints "maybe one
3232day".
3333
@@ -36,15 +36,15 @@ in itself, with large and complex integrations and ever evolving ecosystem, with
3636expectations on stability and robustness.
3737
3838BFTE can just let Fedimint chart these difficult waters, while only
39- worrying about the general architecture eventually be able to support
39+ worrying about the general architecture, which could eventually be able to support
4040what Fedimint can already do, while focusing on less mission-critical applications,
4141like:
4242
4343* CI system coordination,
4444* review systems,
4545* etc.
4646
47- Basically - things that could benefit from a BFT Consensus.
47+ basically - things that could benefit from a BFT Consensus.
4848
4949Similarly, Fedimint's ambition was always reaching broad end user appeal.
5050This requires a lot of effort: building end user clients including web and
@@ -53,16 +53,20 @@ compatibility etc.
5353
5454By ignoring all these ambitions, BFTE can focus first on honing the primary
5555goal: becoming good general purpose modular consensus engine, and be ambitious
56- about other aspects of the design places and implementation.
56+ about other aspects of the design space and implementation.
5757
5858## Status
5959
60- As of last update the project has most of the core pieces in a working state:
60+ As of last update the project has most of the core pieces in a working state.
6161
62- * Simplex Consensu algorithm is implemented,
63- * has a usable web UI,
64- * Consensus Control Mode allows adding and removing peers from the consensus,
65- * Metadata Module is a first simple showcase module.
62+ Implemented:
63+
64+ * Simplex BFT consensu algorithm,
65+ * web UI,
66+ * consensus membership changes,
67+ * core consensus and module consensus versioning and upgrades,
68+ * consensus control module,
69+ * metadata module (first simple example module),
6670
6771## Running
6872
@@ -72,8 +76,25 @@ and run it. Using the provided Nix Flake Dev Shell is recommend.
7276If you're a Nix user (which you should be), you can easily give it a try:
7377
7478```
75- nix run git+https://radicle.dpc.pw/zii8qFzZhN3vigh8BuxGCuEEp6z4.git
79+ nix run git+https://radicle.dpc.pw/zii8qFzZhN3vigh8BuxGCuEEp6z4.git -- --help
80+ ```
81+
82+ eg.
83+
7684```
85+ > nix run git+https://radicle.dpc.pw/zii8qFzZhN3vigh8BuxGCuEEp6z4.git -- gen-secret > /tmp/secret
86+ PeerId: nk2tb7xtkw5uqyxj65w0fhd3nqdhm7ztbs2uysxrgv3yfc5dbbn1
87+
88+
89+ This mnemonic is irrecoverable if lost. Please make a back up before using it!
90+
91+ > nix run git+https://radicle.dpc.pw/zii8qFzZhN3vigh8BuxGCuEEp6z4.git -- run --secret-path /tmp/secret --data-dir /tmp/
92+ 2025-06-13T05:03:19.622758Z INFO bfte::node: Opening redb database… path=/tmp/bfte.redb
93+ 2025-06-13T05:03:19.626664Z INFO bfte::node: Iroh endpoint initialized endpoint=a182558e0be2a4c145ad60a5e92fd11356c2d441b43e7925e27b3964ca72ca43 bound_ipv4=0.0.0.0:35687 bound_ipv6=[::]:35688
94+ 2025-06-13T05:03:19.626707Z WARN bfte::node: Temporary UI password pass=GYBJQPbFhk
95+ 2025-06-13T05:03:19.626858Z INFO bfte::node: Waiting for consensus initialization via web UI
96+ 2025-06-13T05:03:19.626905Z INFO bfte::node::ui: Starting web UI server... addr=[::1]:6910
97+ `
7798
7899## Links
79100
0 commit comments