Add serializable chain::outpoint.

Makefile.am

@@ -46,6 +46,7 @@ src_libbitcoin_system_la_SOURCES = \
     src/chain/header.cpp \
     src/chain/input.cpp \
     src/chain/operation.cpp \
+    src/chain/outpoint.cpp \
     src/chain/output.cpp \
     src/chain/point.cpp \
     src/chain/script.cpp \
@@ -234,6 +235,7 @@ test_libbitcoin_system_test_SOURCES = \
     test/chain/header.cpp \
     test/chain/input.cpp \
     test/chain/operation.cpp \
+    test/chain/outpoint.cpp \
     test/chain/output.cpp \
     test/chain/point.cpp \
     test/chain/satoshi_words.cpp \
@@ -482,6 +484,7 @@ include_bitcoin_system_chain_HEADERS = \
     include/bitcoin/system/chain/header.hpp \
     include/bitcoin/system/chain/input.hpp \
     include/bitcoin/system/chain/operation.hpp \
+    include/bitcoin/system/chain/outpoint.hpp \
     include/bitcoin/system/chain/output.hpp \
     include/bitcoin/system/chain/point.hpp \
     include/bitcoin/system/chain/prevout.hpp \

builds/cmake/CMakeLists.txt

@@ -479,6 +479,7 @@ add_library( ${CANONICAL_LIB_NAME}
     "../../src/chain/header.cpp"
     "../../src/chain/input.cpp"
     "../../src/chain/operation.cpp"
+    "../../src/chain/outpoint.cpp"
     "../../src/chain/output.cpp"
     "../../src/chain/point.cpp"
     "../../src/chain/script.cpp"
@@ -713,6 +714,7 @@ if (with-tests)
         "../../test/chain/header.cpp"
         "../../test/chain/input.cpp"
         "../../test/chain/operation.cpp"
+        "../../test/chain/outpoint.cpp"
         "../../test/chain/output.cpp"
         "../../test/chain/point.cpp"
         "../../test/chain/satoshi_words.cpp"

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

@@ -135,6 +135,7 @@
     <ClCompile Include="..\..\..\..\test\chain\header.cpp" />
     <ClCompile Include="..\..\..\..\test\chain\input.cpp" />
     <ClCompile Include="..\..\..\..\test\chain\operation.cpp" />
+    <ClCompile Include="..\..\..\..\test\chain\outpoint.cpp" />
     <ClCompile Include="..\..\..\..\test\chain\output.cpp" />
     <ClCompile Include="..\..\..\..\test\chain\point.cpp" />
     <ClCompile Include="..\..\..\..\test\chain\satoshi_words.cpp" />

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

@@ -147,6 +147,9 @@
     <ClCompile Include="..\..\..\..\test\chain\operation.cpp">
       <Filter>src\chain</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\test\chain\outpoint.cpp">
+      <Filter>src\chain</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\test\chain\output.cpp">
       <Filter>src\chain</Filter>
     </ClCompile>

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

@@ -138,6 +138,7 @@
       <ObjectFileName>$(IntDir)src_chain_input.obj</ObjectFileName>
     </ClCompile>
     <ClCompile Include="..\..\..\..\src\chain\operation.cpp" />
+    <ClCompile Include="..\..\..\..\src\chain\outpoint.cpp" />
     <ClCompile Include="..\..\..\..\src\chain\output.cpp">
       <ObjectFileName>$(IntDir)src_chain_output.obj</ObjectFileName>
     </ClCompile>
@@ -323,6 +324,7 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\header.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\input.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\operation.hpp" />
+    <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\outpoint.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\output.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\point.hpp" />
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\prevout.hpp" />

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

@@ -276,6 +276,9 @@
     <ClCompile Include="..\..\..\..\src\chain\operation.cpp">
       <Filter>src\chain</Filter>
     </ClCompile>
+    <ClCompile Include="..\..\..\..\src\chain\outpoint.cpp">
+      <Filter>src\chain</Filter>
+    </ClCompile>
     <ClCompile Include="..\..\..\..\src\chain\output.cpp">
       <Filter>src\chain</Filter>
     </ClCompile>
@@ -719,6 +722,9 @@
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\operation.hpp">
       <Filter>include\bitcoin\system\chain</Filter>
     </ClInclude>
+    <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\outpoint.hpp">
+      <Filter>include\bitcoin\system\chain</Filter>
+    </ClInclude>
     <ClInclude Include="..\..\..\..\include\bitcoin\system\chain\output.hpp">
       <Filter>include\bitcoin\system\chain</Filter>
     </ClInclude>

include/bitcoin/system.hpp

@@ -42,6 +42,7 @@
 #include <bitcoin/system/chain/header.hpp>
 #include <bitcoin/system/chain/input.hpp>
 #include <bitcoin/system/chain/operation.hpp>
+#include <bitcoin/system/chain/outpoint.hpp>
 #include <bitcoin/system/chain/output.hpp>
 #include <bitcoin/system/chain/point.hpp>
 #include <bitcoin/system/chain/prevout.hpp>

include/bitcoin/system/chain/chain.hpp

@@ -41,6 +41,7 @@
 #include <bitcoin/system/chain/input.hpp>
 #include <bitcoin/system/chain/operation.hpp>
 #include <bitcoin/system/chain/output.hpp>
+#include <bitcoin/system/chain/outpoint.hpp>
 #include <bitcoin/system/chain/point.hpp>
 #include <bitcoin/system/chain/prevout.hpp>
 #include <bitcoin/system/chain/script.hpp>

include/bitcoin/system/chain/outpoint.hpp

@@ -0,0 +1,123 @@
+/**
+ * Copyright (c) 2011-2025 libbitcoin developers (see AUTHORS)
+ *
+ * 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_SYSTEM_CHAIN_OUTPOINT_HPP
+#define LIBBITCOIN_SYSTEM_CHAIN_OUTPOINT_HPP
+
+#include <memory>
+#include <unordered_set>
+#include <bitcoin/system/chain/point.hpp>
+#include <bitcoin/system/data/data.hpp>
+#include <bitcoin/system/define.hpp>
+#include <bitcoin/system/hash/hash.hpp>
+#include <bitcoin/system/stream/stream.hpp>
+
+namespace libbitcoin {
+namespace system {
+namespace chain {
+
+class BC_API outpoint
+{
+public:
+    DEFAULT_COPY_MOVE_DESTRUCT(outpoint);
+
+    typedef std::shared_ptr<const outpoint> cptr;
+
+    static constexpr size_t serialized_size() NOEXCEPT
+    {
+        return point::serialized_size() + sizeof(uint32_t);
+    }
+
+    /// Constructors.
+    /// -----------------------------------------------------------------------
+
+    /// Default outpoint is an invalid null outpoint (null_hash/null_index/0).
+    outpoint() NOEXCEPT;
+
+    outpoint(chain::point&& point, uint64_t value) NOEXCEPT;
+    outpoint(const chain::point& point, uint64_t value) NOEXCEPT;
+
+    outpoint(const data_slice& data) NOEXCEPT;
+    outpoint(stream::in::fast& stream) NOEXCEPT;
+    outpoint(std::istream& stream) NOEXCEPT;
+    outpoint(reader& source) NOEXCEPT;
+
+    /// Operators.
+    /// -----------------------------------------------------------------------
+
+    bool operator==(const outpoint& other) const NOEXCEPT;
+    bool operator!=(const outpoint& other) const NOEXCEPT;
+
+    /// Serialization.
+    /// -----------------------------------------------------------------------
+
+    data_chunk to_data() const NOEXCEPT;
+    void to_data(std::ostream& stream) const NOEXCEPT;
+    void to_data(writer& sink) const NOEXCEPT;
+
+    /// Properties.
+    /// -----------------------------------------------------------------------
+
+    /// Native properties.
+    bool is_valid() const NOEXCEPT;
+    const chain::point& point() const NOEXCEPT;
+    uint64_t value() const NOEXCEPT;
+
+    /// Computed properties.
+    bool is_null() const NOEXCEPT;
+
+protected:
+    outpoint(stream::in::fast&& stream) NOEXCEPT;
+    outpoint(reader&& source) NOEXCEPT;
+    outpoint(chain::point&& point, uint64_t value, bool valid) NOEXCEPT;
+    outpoint(const chain::point& point, uint64_t value, bool valid) NOEXCEPT;
+
+private:
+    chain::point point_;
+    uint64_t value_;
+
+    // Cache.
+    bool valid_;
+};
+
+/// Arbitrary compare, for uniqueness sorting.
+bool operator<(const outpoint& left, const outpoint& right) NOEXCEPT;
+
+typedef std_vector<outpoint> outpoints;
+
+DECLARE_JSON_TAG_INVOKE(outpoint);
+DECLARE_JSON_TAG_INVOKE(outpoint::cptr);
+
+} // namespace chain
+} // namespace system
+} // namespace libbitcoin
+
+namespace std
+{
+template<>
+struct hash<bc::system::chain::outpoint>
+{
+    size_t operator()(const bc::system::chain::outpoint& value) const NOEXCEPT
+    {
+        // Value does not contribute to identity.
+        return std::hash<bc::system::chain::point>{}(value.point());
+    }
+};
+} // namespace std
+
+#endif

include/bitcoin/system/chain/output.hpp

@@ -20,6 +20,7 @@
 #define LIBBITCOIN_SYSTEM_CHAIN_OUTPUT_HPP
 
 #include <memory>
+#include <bitcoin/system/chain/point.hpp>
 #include <bitcoin/system/chain/script.hpp>
 #include <bitcoin/system/data/data.hpp>
 #include <bitcoin/system/define.hpp>