Stub in esplora interface, pack derived settings via config initialize.

builds/cmake/CMakeLists.txt

@@ -61,7 +61,7 @@ project( libbitcoin-server
   LANGUAGES C CXX )
 
 
-set( repository_root_dir "${CMAKE_CURRENT_SOURCE_DIR}/../../" )
+set( repository_root_dir "${CMAKE_CURRENT_SOURCE_DIR}/../.." )
 
 if ( MSVC )
   set( CMAKE_STATIC_LIBRARY_PREFIX "lib" )

builds/gnu/Makefile.am

@@ -64,6 +64,7 @@ src_libbitcoin_server_la_SOURCES = \
     ${srcdir}/../../src/parsers/bitcoind_transaction.cpp \
     ${srcdir}/../../src/parsers/btcd_filter.cpp \
     ${srcdir}/../../src/parsers/electrum_request.cpp \
+    ${srcdir}/../../src/parsers/esplora_target.cpp \
     ${srcdir}/../../src/parsers/native_query.cpp \
     ${srcdir}/../../src/parsers/native_target.cpp \
     ${srcdir}/../../src/protocols/protocol.cpp \
@@ -187,6 +188,7 @@ include_bitcoin_server_interfaces_HEADERS = \
     ${srcdir}/../../include/bitcoin/server/interfaces/bitcoind_zmq.hpp \
     ${srcdir}/../../include/bitcoin/server/interfaces/btcd.hpp \
     ${srcdir}/../../include/bitcoin/server/interfaces/electrum.hpp \
+    ${srcdir}/../../include/bitcoin/server/interfaces/esplora.hpp \
     ${srcdir}/../../include/bitcoin/server/interfaces/interfaces.hpp \
     ${srcdir}/../../include/bitcoin/server/interfaces/native.hpp \
     ${srcdir}/../../include/bitcoin/server/interfaces/sparrow.hpp \
@@ -207,6 +209,7 @@ include_bitcoin_server_parsers_HEADERS = \
     ${srcdir}/../../include/bitcoin/server/parsers/bitcoind_transaction.hpp \
     ${srcdir}/../../include/bitcoin/server/parsers/btcd_filter.hpp \
     ${srcdir}/../../include/bitcoin/server/parsers/electrum_request.hpp \
+    ${srcdir}/../../include/bitcoin/server/parsers/esplora_target.hpp \
     ${srcdir}/../../include/bitcoin/server/parsers/native_query.hpp \
     ${srcdir}/../../include/bitcoin/server/parsers/native_target.hpp \
     ${srcdir}/../../include/bitcoin/server/parsers/parsers.hpp
@@ -312,6 +315,7 @@ test_libbitcoin_server_test_SOURCES = \
     ${srcdir}/../../test/parsers/admin_target.cpp \
     ${srcdir}/../../test/parsers/bitcoind_query.cpp \
     ${srcdir}/../../test/parsers/bitcoind_target.cpp \
+    ${srcdir}/../../test/parsers/esplora_target.cpp \
     ${srcdir}/../../test/parsers/native_query.cpp \
     ${srcdir}/../../test/parsers/native_target.cpp \
     ${srcdir}/../../test/protocols/admin/admin_diagnostics.cpp \

builds/gnu/configure.ac

@@ -68,7 +68,7 @@ AC_ARG_VAR([CC], "C compiler to use, such as gcc or clang")
 AC_ARG_VAR([CXX], "C++ compiler to use, such as g++ or clang++")
 AC_ARG_VAR([PKG_CONFIG_PATH], "Additional directories for package discovery.")
 
-repository_root_dir="@abs_top_srcdir@/../.."
+repository_root_dir=`cd "${srcdir}/../.." && pwd`
 
 # Check for baseline language coverage in the compiler for the C++20 standard.
 #------------------------------------------------------------------------------

builds/msvc/vs2022/libbitcoin-server-test/libbitcoin-server-test.vcxproj

@@ -128,6 +128,7 @@
     <ClCompile Include="..\..\..\..\test\parsers\admin_target.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_query.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_target.cpp" />
+    <ClCompile Include="..\..\..\..\test\parsers\esplora_target.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\native_query.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\native_target.cpp" />
     <ClCompile Include="..\..\..\..\test\protocols\admin\admin_diagnostics.cpp" />

builds/msvc/vs2022/libbitcoin-server-test/libbitcoin-server-test.vcxproj.filters

@@ -87,6 +87,9 @@
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_target.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\test\parsers\esplora_target.cpp">
+      <Filter>src\parsers</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\test\parsers\native_query.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>

builds/msvc/vs2022/libbitcoin-server/libbitcoin-server.vcxproj

@@ -136,6 +136,7 @@
     <ClCompile Include="..\..\..\..\src\parsers\bitcoind_transaction.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\btcd_filter.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\electrum_request.cpp" />
+    <ClCompile Include="..\..\..\..\src\parsers\esplora_target.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\native_query.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\native_target.cpp" />
     <ClCompile Include="..\..\..\..\src\protocols\admin\protocol_admin.cpp" />
@@ -229,6 +230,7 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\bitcoind_zmq.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\btcd.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\electrum.hpp" />
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\esplora.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\interfaces.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\native.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\sparrow.hpp" />
@@ -245,6 +247,7 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\bitcoind_transaction.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\btcd_filter.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\electrum_request.hpp" />
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\esplora_target.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_query.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_target.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\parsers.hpp" />

builds/msvc/vs2022/libbitcoin-server/libbitcoin-server.vcxproj.filters

@@ -138,6 +138,9 @@
     <ClCompile Include="..\..\..\..\src\parsers\electrum_request.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\src\parsers\esplora_target.cpp">
+      <Filter>src\parsers</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\src\parsers\native_query.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
@@ -413,6 +416,9 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\electrum.hpp">
       <Filter>include\bitcoin\server\interfaces</Filter>
     </ClInclude>
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\esplora.hpp">
+      <Filter>include\bitcoin\server\interfaces</Filter>
+    </ClInclude>
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\interfaces.hpp">
       <Filter>include\bitcoin\server\interfaces</Filter>
     </ClInclude>
@@ -461,6 +467,9 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\electrum_request.hpp">
       <Filter>include\bitcoin\server\parsers</Filter>
     </ClInclude>
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\esplora_target.hpp">
+      <Filter>include\bitcoin\server\parsers</Filter>
+    </ClInclude>
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_query.hpp">
       <Filter>include\bitcoin\server\parsers</Filter>
     </ClInclude>

builds/msvc/vs2026/libbitcoin-server-test/libbitcoin-server-test.vcxproj

@@ -128,6 +128,7 @@
     <ClCompile Include="..\..\..\..\test\parsers\admin_target.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_query.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_target.cpp" />
+    <ClCompile Include="..\..\..\..\test\parsers\esplora_target.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\native_query.cpp" />
     <ClCompile Include="..\..\..\..\test\parsers\native_target.cpp" />
     <ClCompile Include="..\..\..\..\test\protocols\admin\admin_diagnostics.cpp" />

builds/msvc/vs2026/libbitcoin-server-test/libbitcoin-server-test.vcxproj.filters

@@ -87,6 +87,9 @@
     <ClCompile Include="..\..\..\..\test\parsers\bitcoind_target.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\test\parsers\esplora_target.cpp">
+      <Filter>src\parsers</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\test\parsers\native_query.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>

builds/msvc/vs2026/libbitcoin-server/libbitcoin-server.vcxproj

@@ -136,6 +136,7 @@
     <ClCompile Include="..\..\..\..\src\parsers\bitcoind_transaction.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\btcd_filter.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\electrum_request.cpp" />
+    <ClCompile Include="..\..\..\..\src\parsers\esplora_target.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\native_query.cpp" />
     <ClCompile Include="..\..\..\..\src\parsers\native_target.cpp" />
     <ClCompile Include="..\..\..\..\src\protocols\admin\protocol_admin.cpp" />
@@ -229,6 +230,7 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\bitcoind_zmq.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\btcd.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\electrum.hpp" />
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\esplora.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\interfaces.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\native.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\sparrow.hpp" />
@@ -245,6 +247,7 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\bitcoind_transaction.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\btcd_filter.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\electrum_request.hpp" />
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\esplora_target.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_query.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_target.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\parsers.hpp" />

builds/msvc/vs2026/libbitcoin-server/libbitcoin-server.vcxproj.filters

@@ -138,6 +138,9 @@
     <ClCompile Include="..\..\..\..\src\parsers\electrum_request.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\src\parsers\esplora_target.cpp">
+      <Filter>src\parsers</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\src\parsers\native_query.cpp">
       <Filter>src\parsers</Filter>
     </ClCompile>
@@ -413,6 +416,9 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\electrum.hpp">
       <Filter>include\bitcoin\server\interfaces</Filter>
     </ClInclude>
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\esplora.hpp">
+      <Filter>include\bitcoin\server\interfaces</Filter>
+    </ClInclude>
     <ClInclude Include="..\..\..\..\include\bitcoin\server\interfaces\interfaces.hpp">
       <Filter>include\bitcoin\server\interfaces</Filter>
     </ClInclude>
@@ -461,6 +467,9 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\electrum_request.hpp">
       <Filter>include\bitcoin\server\parsers</Filter>
     </ClInclude>
+    <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\esplora_target.hpp">
+      <Filter>include\bitcoin\server\parsers</Filter>
+    </ClInclude>
     <ClInclude Include="..\..\..\..\include\bitcoin\server\parsers\native_query.hpp">
       <Filter>include\bitcoin\server\parsers</Filter>
     </ClInclude>

console/executor.cpp

@@ -44,9 +44,7 @@ std::optional<std::thread> executor::poller_thread_{};
 executor& executor::factory(parser& metadata, std::istream& input,
     std::ostream& output, std::ostream& error)
 {
-    // Pack creation settings, stored at store create and read at load.
-    metadata.configured.database.envelope = database::envelope{
-        metadata.configured.bitcoin, metadata.configured.database };
+    metadata.configured.initialize();
 
     // Suppress configured batch cache sizing when batching cannot run.
     if (!system::batched::accelerated())

include/bitcoin/server.hpp

@@ -51,6 +51,7 @@
 #include <bitcoin/server/interfaces/bitcoind_zmq.hpp>
 #include <bitcoin/server/interfaces/btcd.hpp>
 #include <bitcoin/server/interfaces/electrum.hpp>
+#include <bitcoin/server/interfaces/esplora.hpp>
 #include <bitcoin/server/interfaces/interfaces.hpp>
 #include <bitcoin/server/interfaces/native.hpp>
 #include <bitcoin/server/interfaces/sparrow.hpp>
@@ -66,6 +67,7 @@
 #include <bitcoin/server/parsers/bitcoind_transaction.hpp>
 #include <bitcoin/server/parsers/btcd_filter.hpp>
 #include <bitcoin/server/parsers/electrum_request.hpp>
+#include <bitcoin/server/parsers/esplora_target.hpp>
 #include <bitcoin/server/parsers/native_query.hpp>
 #include <bitcoin/server/parsers/native_target.hpp>
 #include <bitcoin/server/parsers/parsers.hpp>

include/bitcoin/server/interfaces/esplora.hpp

@@ -0,0 +1,160 @@
+/**
+ * Copyright (c) 2011-2026 libbitcoin developers
+ *
+ * This file is part of libbitcoin.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef LIBBITCOIN_SERVER_INTERFACES_ESPLORA_HPP
+#define LIBBITCOIN_SERVER_INTERFACES_ESPLORA_HPP
+
+#include <bitcoin/server/define.hpp>
+#include <bitcoin/server/interfaces/types.hpp>
+
+namespace libbitcoin {
+namespace server {
+namespace interface {
+
+struct esplora_methods
+{
+    // github.com/Blockstream/esplora/blob/master/API.md
+    static constexpr std::tuple methods
+    {
+        method<"tx", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"tx_status", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"tx_merkleblock_proof", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"tx_merkle_proof", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"tx_outspend", uint8_t, system::hash_cptr, uint32_t>{ "media", "hash", "index" },
+        method<"tx_outspends", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"broadcast", uint8_t, string_t>{ "media", "transaction" },
+        method<"broadcast_package", uint8_t, array_t>{ "media", "transactions" },
+
+        method<"address", uint8_t, nullable<system::hash_cptr>, nullable<string_t>>{ "media", "hash", "address" },
+        method<"address_txs", uint8_t, nullable<system::hash_cptr>, nullable<string_t>>{ "media", "hash", "address" },
+        method<"address_txs_chain", uint8_t, nullable<system::hash_cptr>, nullable<string_t>, nullable<system::hash_cptr>>{ "media", "hash", "address", "last_seen" },
+        method<"address_txs_mempool", uint8_t, nullable<system::hash_cptr>, nullable<string_t>>{ "media", "hash", "address" },
+        method<"address_utxo", uint8_t, nullable<system::hash_cptr>, nullable<string_t>>{ "media", "hash", "address" },
+
+        method<"block", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"block_header", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"block_status", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"block_txs", uint8_t, system::hash_cptr, optional<0_u32>>{ "media", "hash", "start" },
+        method<"block_txids", uint8_t, system::hash_cptr>{ "media", "hash" },
+        method<"block_txid", uint8_t, system::hash_cptr, uint32_t>{ "media", "hash", "index" },
+        method<"block_height", uint8_t, uint32_t>{ "media", "height" },
+        method<"blocks", uint8_t, nullable<uint32_t>>{ "media", "height" },
+        method<"tip_height", uint8_t>{ "media" },
+        method<"tip_hash", uint8_t>{ "media" },
+
+        method<"mempool", uint8_t>{ "media" },
+        method<"mempool_txids", uint8_t>{ "media" },
+        method<"mempool_recent", uint8_t>{ "media" },
+
+        method<"fee_estimates", uint8_t>{ "media" }
+    };
+
+    template <typename... Args>
+    using subscriber = network::unsubscriber<Args...>;
+
+    template <size_t Index>
+    using at = method_at<methods, Index>;
+
+    // Derive this from above in c++26 using reflection.
+
+    using tx = at<0>;
+    using tx_status = at<1>;
+    using tx_merkleblock_proof = at<2>;
+    using tx_merkle_proof = at<3>;
+    using tx_outspend = at<4>;
+    using tx_outspends = at<5>;
+    using broadcast = at<6>;
+    using broadcast_package = at<7>;
+
+    using address = at<8>;
+    using address_txs = at<9>;
+    using address_txs_chain = at<10>;
+    using address_txs_mempool = at<11>;
+    using address_utxo = at<12>;
+
+    using block = at<13>;
+    using block_header = at<14>;
+    using block_status = at<15>;
+    using block_txs = at<16>;
+    using block_txids = at<17>;
+    using block_txid = at<18>;
+    using block_height = at<19>;
+    using blocks = at<20>;
+    using tip_height = at<21>;
+    using tip_hash = at<22>;
+
+    using mempool = at<23>;
+    using mempool_txids = at<24>;
+    using mempool_recent = at<25>;
+
+    using fee_estimates = at<26>;
+};
+
+/// media is implied by the target (there is no format query string).
+/// ---------------------------------------------------------------------------
+
+/// /tx/[txhash] {1}
+/// /tx/[txhash]/hex {1, text}
+/// /tx/[txhash]/raw {1, data}
+/// /tx/[txhash]/status {1}
+/// /tx/[txhash]/merkleblock-proof {1, text}
+/// /tx/[txhash]/merkle-proof {1}
+/// /tx/[txhash]/outspend/[index] {1}
+/// /tx/[txhash]/outspends {all outputs in the tx}
+/// /tx {txhash, text} [post, body is transaction hex]
+/// /txs/package {all} [post, body is array of transaction hex]
+
+/// ---------------------------------------------------------------------------
+
+/// /address/[address] {1}
+/// /scripthash/[output-script-hash] {1}
+/// /address/[address]/txs {25 confirmed and 50 unconfirmed}
+/// /address/[address]/txs/chain {25 confirmed}
+/// /address/[address]/txs/chain/[last-seen-txhash] {25 confirmed}
+/// /address/[address]/txs/mempool {50 unconfirmed}
+/// /address/[address]/utxo {all}
+
+/// ---------------------------------------------------------------------------
+
+/// /block/[bkhash] {1}
+/// /block/[bkhash]/raw {1, data}
+/// /block/[bkhash]/header {1, text}
+/// /block/[bkhash]/status {1}
+/// /block/[bkhash]/txs {25 txs in the block}
+/// /block/[bkhash]/txs/[start-index] {25 txs in the block}
+/// /block/[bkhash]/txids {all txs in the block}
+/// /block/[bkhash]/txid/[index] {1, text}
+/// /block-height/[height] {bkhash, text}
+/// /blocks {10 from the top}
+/// /blocks/[height] {10 from the height}
+/// /blocks/tip/height {1, text}
+/// /blocks/tip/hash {1, text}
+
+/// ---------------------------------------------------------------------------
+
+/// /mempool {1}
+/// /mempool/txids {all}
+/// /mempool/recent {10}
+
+/// /fee-estimates {1}
+
+} // namespace interface
+} // namespace server
+} // namespace libbitcoin
+
+#endif

include/bitcoin/server/interfaces/interfaces.hpp

@@ -33,6 +33,7 @@
 #include <bitcoin/server/interfaces/bitcoind_wallet.hpp>
 #include <bitcoin/server/interfaces/btcd.hpp>
 #include <bitcoin/server/interfaces/electrum.hpp>
+#include <bitcoin/server/interfaces/esplora.hpp>
 #include <bitcoin/server/interfaces/native.hpp>
 #include <bitcoin/server/interfaces/sparrow.hpp>
 #include <bitcoin/server/interfaces/stratum_v1.hpp>
@@ -58,6 +59,7 @@ using bitcoind_zmq           = publish<bitcoind_zmq_methods>;
 using btcd                   = publish<btcd_methods>;
 using electrum               = publish<electrum_methods>;
 using electrum_handshake     = publish<electrum_handshake_methods>;
+using esplora                = publish<esplora_methods>;
 using native                 = publish<native_methods>;
 using sparrow                = publish<sparrow_methods>;
 using stratum_v1             = publish<stratum_v1_methods>;