chore: update README and add contributions of will-bitlightlabs

Author: dr-orlovsky

README.md

@@ -4,17 +4,25 @@
 ![Lints](https://github.com/BP-WG/bp-node/workflows/Lints/badge.svg)
 [![Apache-2 licensed](https://img.shields.io/crates/l/bp-node)](./LICENSE)
 
-Bitcoin blockchain indexing and wallet notification node. It may be considered Electrum server or
-Esplora replacement, being faster, providing modern binary API, supporting wallet descriptors,
-LN-specific queries, client-side-validation tech like RGB, modern publication-subscribe interfaces,
-Noise encryption in network connectivity, asymmetric cryptographic client authentication and many
-more.
-
-The node designed and implemented by [Dr Maxim Orlovsky](https://github.com/dr-orlovsky) as a part
-of [LNP/BP Labs](https://github.com/LNP-BP) effort in building the foundation for LNP/BP layer 2 and
-3 bitcoin application ecosystem. It is based on other LNP/BP projects such as [BP Core Lib],
-[BP Standard Lib], [BP Wallet Lib] and can be easily integrated with the rest of LNP/BP nodes like
-[LNP Node].
+Bitcoin blockchain indexing and wallet notification node.
+It may be considered Electrum server or Esplora replacement,
+being faster,
+providing modern binary API,
+supporting wallet descriptors,
+LN-specific queries,
+client-side-validation tech like RGB,
+modern publication-subscribe interfaces,
+Noise encryption in network connectivity,
+asymmetric cryptographic client authentication
+and many more.
+
+The node designed and implemented by
+[Dr Maxim Orlovsky](https://github.com/dr-orlovsky) from [Pandora Prime] and
+[@will-bitlightlabs](https://github.com/will-bitlightlabs) from [Bitlight Labs]
+as a part of [LNP/BP Labs](https://github.com/LNP-BP) effort
+on building the foundation for LNP/BP layer 2 and 3 bitcoin application ecosystem.
+It is based on other LNP/BP projects such as [BP Core Lib], [BP Standard Lib], [BP Wallet Lib]
+and can be easily integrated with the rest of LNP/BP nodes like [LNP Node].
 
 In the future it is planned to upgrade the node into a fully-validating bitcoin node by using
 [`bitcoinkernel`] library for validating blocks.
@@ -23,30 +31,31 @@ In the future it is planned to upgrade the node into a fully-validating bitcoin
 
 This repository contains the following crates:
 
-- `bp-node`: main indexing daemon, which can be used as an embedded multi-thread service, or
-  compiled into a standalone binary (`bpd`);
+- `bp-node`: main indexing daemon, which can be used as an embedded multi-thread service,
+  or compiled into a standalone binary (`bpd`);
 - `bp-client`: client to work with the daemon and a command-line utility `bp-cli`;
 - `bp-rpc`: a shared crate between `bp-node` and `bp-client`.
 
 ## Node Architecture
 
-The node operates as a set of threads, communicating through Crossbeam channels. It leverages
-[`microservices.rs`] and [`netservices.rs`] crates, which serves as the node non-blocking
-reactor-based (see [`io-reactor`]) microservice frameworks.
+The node operates as a set of threads, communicating through Crossbeam channels.
+It leverages [`microservices.rs`] and [`netservices.rs`] crates,
+which serves as the node non-blocking reactor-based (see [`io-reactor`]) microservice frameworks.
 
 The node daemon has the following components:
 
 - **Broker**, integrating all services and managing their communications;
-- **RPC**: reactor-based thread managing incoming client connections, notifying them about changes
-  to the subscribed information;
+- **RPC**: reactor-based thread managing incoming client connections,
+  notifying them about changes to the subscribed information;
 - **Persistence**, an embedded ReDB database;
-- **Block importer**: a client connecting an integration service (see below) to bitcoin blockchain
-  provider (Bitcoin Core, other Bitcoin nodes or indexers) receiving downloaded and new blocks and
-  adding them into the database;
+- **Block importer**: a client connecting an integration service (see below)
+  to bitcoin blockchain provider (Bitcoin Core, other Bitcoin nodes or indexers)
+  receiving downloaded and new blocks and adding them into the database;
 - **Query workers**, thread pool running queries for the client subscriptions in the database.
 
-In order to operate one also needs to provide a node with an interface to bitcoin blocks integrating
-it with either Bitcoin Core, or any other node or indexer.
+To operate, one also needs
+to provide the node with an interface to bitcoin blocks integrating it with either Bitcoin Core,
+or any other node or indexer.
 
 By default, the node exposes a binary RPC API over TCP, which can be exposed as more high-level APIs
 (HTTP REST, Websocket-based or JSON-RPC) using special adaptor services.
@@ -55,10 +64,8 @@ By default, the node exposes a binary RPC API over TCP, which can be exposed as
 
 ## OS Support
 
-The project currently supports only Linux and UNIX OSes. Support for macOS is currently broken due
-to use of a Rust language unstable feature on macOS platform by one of the project dependencies, and
-will be recovered soon. Windows support is a work-in-progress, requiring downstream [`io-reactor`]
-framework changes.
+The project currently supports Linux, macOS and UNIX.
+Windows support is a work-in-progress, requiring downstream [`io-reactor`] framework changes.
 
 [`bitcoinkernel`]: https://github.com/bitcoin/bitcoin/issues/27587
 
@@ -75,3 +82,7 @@ framework changes.
 [`microservices.rs`]: https://github.com/cyphernet-labs/microservices.rs
 
 [`netservices.rs`]: https://github.com/cyphernet-labs/netservices.rs
+
+[Pandora Prime]: https://pandoraprime.ch
+
+[Bitlight Labs]: https://bitlightlabs.com

src/blocks.rs

@@ -2,24 +2,22 @@
 //
 // SPDX-License-Identifier: Apache-2.0
 //
-// Written in 2020-2025 by
-//     Dr Maxim Orlovsky <[email protected]>
+// Designed & written in 2020-2025 by
+//     @will-bitlight <https://bitlightlabs.com>
 //
 // Copyright (C) 2020-2024 LNP/BP Standards Association. All rights reserved.
 // Copyright (C) 2025 LNP/BP Labs, InDCS, Switzerland. All rights reserved.
 // Copyright (C) 2020-2025 Dr Maxim Orlovsky. All rights reserved.
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+// in compliance with the License. You may obtain a copy of the License at
 //
-//     http://www.apache.org/licenses/LICENSE-2.0
+//        http://www.apache.org/licenses/LICENSE-2.0
 //
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing, software distributed under the License
+// is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+// or implied. See the License for the specific language governing permissions and limitations under
+// the License.
 
 //! Block importer interface organized into a reactor thread.
 

src/db.rs

@@ -2,24 +2,23 @@
 //
 // SPDX-License-Identifier: Apache-2.0
 //
-// Written in 2020-2025 by
+// Designed & written in 2020-2025 by
+//     @will-bitlight <https://bitlightlabs.com>
 //     Dr Maxim Orlovsky <[email protected]>
 //
 // Copyright (C) 2020-2024 LNP/BP Standards Association. All rights reserved.
 // Copyright (C) 2025 LNP/BP Labs, InDCS, Switzerland. All rights reserved.
 // Copyright (C) 2020-2025 Dr Maxim Orlovsky. All rights reserved.
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+// in compliance with the License. You may obtain a copy of the License at
 //
-//     http://www.apache.org/licenses/LICENSE-2.0
+//        http://www.apache.org/licenses/LICENSE-2.0
 //
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing, software distributed under the License
+// is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+// or implied. See the License for the specific language governing permissions and limitations under
+// the License.
 
 use std::cmp::Ordering;
 use std::ops::ControlFlow;