CTID.h

#pragma once
 
#include <boost/regex.hpp>
 
#include <optional>
#include <regex>
#include <sstream>
 
namespace xrpl::RPC {
 
// CTID stands for Concise Transaction ID.
//
// The CTID comes from XLS-15d: Concise Transaction Identifier #34
//
//   https://github.com/XRPLF/XRPL-Standards/discussions/34
//
// The Concise Transaction ID provides a way to identify a transaction
// that includes which network the transaction was submitted to.

inline std::optional<std::string>
encodeCTID(uint32_t ledgerSeq, uint32_t txnIndex, uint32_t networkID) noexcept
{
    static constexpr uint32_t kMaxLedgerSeq = 0x0FFF'FFFF;
    static constexpr uint32_t kMaxTxnIndex = 0xFFFF;
    static constexpr uint32_t kMaxNetworkId = 0xFFFF;
 
    if (ledgerSeq > kMaxLedgerSeq || txnIndex > kMaxTxnIndex || networkID > kMaxNetworkId)
        return std::nullopt;
 
    uint64_t const ctidValue = ((0xC000'0000ULL + static_cast<uint64_t>(ledgerSeq)) << 32) |
        ((static_cast<uint64_t>(txnIndex) << 16) | networkID);
 
    std::stringstream buffer;
    buffer << std::hex << std::uppercase << std::setfill('0') << std::setw(16) << ctidValue;
    return buffer.str();
}

template <typename T>
inline std::optional<std::tuple<uint32_t, uint16_t, uint16_t>>
decodeCTID(T const ctid) noexcept
{
    uint64_t ctidValue = 0;
 
    if constexpr (
        std::is_same_v<T, std::string> || std::is_same_v<T, std::string_view> ||
        std::is_same_v<T, char*> || std::is_same_v<T, char const*>)
    {
        std::string const ctidString(ctid);
 
        if (ctidString.size() != 16)
            return std::nullopt;
 
        static boost::regex const kHexRegex("^[0-9A-Fa-f]{16}$");
        if (!boost::regex_match(ctidString, kHexRegex))
            return std::nullopt;
 
        try
        {
            ctidValue = std::stoull(ctidString, nullptr, 16);
        }
        // LCOV_EXCL_START
        catch (...)
        {
            // should be impossible to hit given the length/regex check
            return std::nullopt;
        }
        // LCOV_EXCL_STOP
    }
    else if constexpr (std::is_integral_v<T>)
    {
        ctidValue = static_cast<uint64_t>(ctid);
    }
    else
    {
        return std::nullopt;
    }
 
    // Validate CTID prefix.
    static constexpr uint64_t kCtidPrefixMask = 0xF000'0000'0000'0000ULL;
    static constexpr uint64_t kCtidPrefix = 0xC000'0000'0000'0000ULL;
    if ((ctidValue & kCtidPrefixMask) != kCtidPrefix)
        return std::nullopt;
 
    uint32_t const ledgerSeq = static_cast<uint32_t>((ctidValue >> 32) & 0x0FFF'FFFF);
    uint16_t const txnIndex = static_cast<uint16_t>((ctidValue >> 16) & 0xFFFF);
    uint16_t const networkID = static_cast<uint16_t>(ctidValue & 0xFFFF);
 
    return std::make_tuple(ledgerSeq, txnIndex, networkID);
}
 
}  // namespace xrpl::RPC