CTID.h

#pragma once
 
#include <boost/regex.hpp>
 
#include <optional>
#include <regex>
#include <sstream>
 
namespace xrpl {
 
namespace 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
{
    constexpr uint32_t maxLedgerSeq = 0x0FFF'FFFF;
    constexpr uint32_t maxTxnIndex = 0xFFFF;
    constexpr uint32_t maxNetworkID = 0xFFFF;
 
    if (ledgerSeq > maxLedgerSeq || txnIndex > maxTxnIndex || networkID > maxNetworkID)
        return std::nullopt;
 
    uint64_t 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 hexRegex("^[0-9A-Fa-f]{16}$");
        if (!boost::regex_match(ctidString, hexRegex))
            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.
    constexpr uint64_t ctidPrefixMask = 0xF000'0000'0000'0000ULL;
    constexpr uint64_t ctidPrefix = 0xC000'0000'0000'0000ULL;
    if ((ctidValue & ctidPrefixMask) != ctidPrefix)
        return std::nullopt;
 
    uint32_t ledgerSeq = static_cast<uint32_t>((ctidValue >> 32) & 0x0FFF'FFFF);
    uint16_t txnIndex = static_cast<uint16_t>((ctidValue >> 16) & 0xFFFF);
    uint16_t networkID = static_cast<uint16_t>(ctidValue & 0xFFFF);
 
    return std::make_tuple(ledgerSeq, txnIndex, networkID);
}
 
}  // namespace RPC
}  // namespace xrpl