#pragma once #include #include #include #include #include namespace xrpl { /* Some fields have a different meaning for their default value versus not present. Example: QualityIn on a TrustLine */ //------------------------------------------------------------------------------ // Forwards class STAccount; class STAmount; class STIssue; class STBlob; template class STBitString; template class STInteger; class STNumber; class STXChainBridge; class STVector256; class STCurrency; // NOLINTBEGIN(readability-identifier-naming) #pragma push_macro("XMACRO") #undef XMACRO #define XMACRO(STYPE) \ /* special types */ \ STYPE(STI_UNKNOWN, -2) \ STYPE(STI_NOTPRESENT, 0) \ STYPE(STI_UINT16, 1) \ \ /* types (common) */ \ STYPE(STI_UINT32, 2) \ STYPE(STI_UINT64, 3) \ STYPE(STI_UINT128, 4) \ STYPE(STI_UINT256, 5) \ STYPE(STI_AMOUNT, 6) \ STYPE(STI_VL, 7) \ STYPE(STI_ACCOUNT, 8) \ STYPE(STI_NUMBER, 9) \ STYPE(STI_INT32, 10) \ STYPE(STI_INT64, 11) \ \ /* 12-13 are reserved */ \ STYPE(STI_OBJECT, 14) \ STYPE(STI_ARRAY, 15) \ \ /* types (uncommon) */ \ STYPE(STI_UINT8, 16) \ STYPE(STI_UINT160, 17) \ STYPE(STI_PATHSET, 18) \ STYPE(STI_VECTOR256, 19) \ STYPE(STI_UINT96, 20) \ STYPE(STI_UINT192, 21) \ STYPE(STI_UINT384, 22) \ STYPE(STI_UINT512, 23) \ STYPE(STI_ISSUE, 24) \ STYPE(STI_XCHAIN_BRIDGE, 25) \ STYPE(STI_CURRENCY, 26) \ \ /* high-level types */ \ /* cannot be serialized inside other types */ \ STYPE(STI_TRANSACTION, 10001) \ STYPE(STI_LEDGERENTRY, 10002) \ STYPE(STI_VALIDATION, 10003) \ STYPE(STI_METADATA, 10004) #pragma push_macro("TO_ENUM") #undef TO_ENUM #pragma push_macro("TO_MAP") #undef TO_MAP #define TO_ENUM(name, value) name = (value), #define TO_MAP(name, value) {#name, value}, // Protocol infrastructure, 39+ files // NOLINTNEXTLINE(cppcoreguidelines-use-enum-class) enum SerializedTypeID { XMACRO(TO_ENUM) }; static std::map const kS_TYPE_MAP = {XMACRO(TO_MAP)}; #undef XMACRO #undef TO_ENUM #pragma pop_macro("XMACRO") #pragma pop_macro("TO_ENUM") #pragma pop_macro("TO_MAP") // NOLINTEND(readability-identifier-naming) // constexpr inline int fieldCode(SerializedTypeID id, int index) { return (safeCast(id) << 16) | index; } // constexpr inline int fieldCode(int id, int index) { return (id << 16) | index; } /** Identifies fields. Fields are necessary to tag data in signed transactions so that the binary format of the transaction can be canonicalized. All SFields are created at compile time. Each SField, once constructed, lives until program termination, and there is only one instance per fieldType/fieldValue pair which serves the entire application. */ class SField { public: static constexpr auto kSMD_NEVER = 0x00; static constexpr auto kSMD_CHANGE_ORIG = 0x01; // original value when it changes static constexpr auto kSMD_CHANGE_NEW = 0x02; // new value when it changes static constexpr auto kSMD_DELETE_FINAL = 0x04; // final value when it is deleted static constexpr auto kSMD_CREATE = 0x08; // value when it's created static constexpr auto kSMD_ALWAYS = 0x10; // value when node containing it is affected at all static constexpr auto kSMD_BASE_TEN = 0x20; // value is treated as base 10, overriding behavior static constexpr auto kSMD_PSEUDO_ACCOUNT = 0x40; // if this field is set in an ACCOUNT_ROOT // _only_, then it is a pseudo-account static constexpr auto kSMD_NEEDS_ASSET = 0x80; // This field needs to be associated with an // asset before it is serialized as a ledger // object. Intended for STNumber. static constexpr auto kSMD_DEFAULT = kSMD_CHANGE_ORIG | kSMD_CHANGE_NEW | kSMD_DELETE_FINAL | kSMD_CREATE; enum class IsSigning : unsigned char { No, Yes }; static IsSigning const kNOT_SIGNING = IsSigning::No; int const fieldCodeMem; // (type<<16)|index // TODO: rename, clashes with function SerializedTypeID const fieldType; // STI_* int const fieldValue; // Code number for protocol std::string const fieldName; int const fieldMeta; int const fieldNum; IsSigning const signingField; json::StaticString const jsonName; SField(SField const&) = delete; SField& operator=(SField const&) = delete; SField(SField&&) = delete; SField& operator=(SField&&) = delete; public: struct PrivateAccessTagT; // public, but still an implementation detail // These constructors can only be called from SField.cpp SField( PrivateAccessTagT, SerializedTypeID tid, int fv, char const* fn, int meta = kSMD_DEFAULT, IsSigning signing = IsSigning::Yes); explicit SField(PrivateAccessTagT, int fc, char const* fn); static SField const& getField(int fieldCode); static SField const& getField(std::string const& fieldName); static SField const& getField(int type, int value) { return getField(fieldCode(type, value)); } static SField const& getField(SerializedTypeID type, int value) { return getField(fieldCode(type, value)); } [[nodiscard]] std::string const& getName() const { return fieldName; } [[nodiscard]] bool hasName() const { return fieldCodeMem > 0; } [[nodiscard]] json::StaticString const& getJsonName() const { return jsonName; } operator json::StaticString const&() const { return jsonName; } [[nodiscard]] bool isInvalid() const { return fieldCodeMem == -1; } [[nodiscard]] bool isUseful() const { return fieldCodeMem > 0; } [[nodiscard]] bool isBinary() const { return fieldValue < 256; } // A discardable field is one that cannot be serialized, and // should be discarded during serialization,like 'hash'. // You cannot serialize an object's hash inside that object, // but you can have it in the JSON representation. [[nodiscard]] bool isDiscardable() const { return fieldValue > 256; } [[nodiscard]] int getCode() const { return fieldCodeMem; } [[nodiscard]] int getNum() const { return fieldNum; } static int getNumFields() { return num; } [[nodiscard]] bool shouldMeta(int c) const { return (fieldMeta & c) != 0; } [[nodiscard]] bool shouldInclude(bool withSigningField) const { return (fieldValue < 256) && (withSigningField || (signingField == IsSigning::Yes)); } bool operator==(SField const& f) const { return fieldCodeMem == f.fieldCodeMem; } bool operator!=(SField const& f) const { return fieldCodeMem != f.fieldCodeMem; } static int compare(SField const& f1, SField const& f2); static std::unordered_map const& getKnownCodeToField() { return knownCodeToField; } private: static int num; static std::unordered_map knownCodeToField; static std::unordered_map knownNameToField; }; /** A field with a type known at compile time. */ template struct TypedField : SField { using type = T; template explicit TypedField(PrivateAccessTagT pat, Args&&... args); }; /** Indicate std::optional field semantics. */ template struct OptionaledField { TypedField const* f; explicit OptionaledField(TypedField const& f) : f(&f) { } }; template inline OptionaledField operator~(TypedField const& f) { return OptionaledField(f); } //------------------------------------------------------------------------------ //------------------------------------------------------------------------------ using SF_UINT8 = TypedField>; using SF_UINT16 = TypedField>; using SF_UINT32 = TypedField>; using SF_UINT64 = TypedField>; using SF_UINT96 = TypedField>; using SF_UINT128 = TypedField>; using SF_UINT160 = TypedField>; using SF_UINT192 = TypedField>; using SF_UINT256 = TypedField>; using SF_UINT384 = TypedField>; using SF_UINT512 = TypedField>; using SF_INT32 = TypedField>; using SF_INT64 = TypedField>; using SF_ACCOUNT = TypedField; using SF_AMOUNT = TypedField; using SF_ISSUE = TypedField; using SF_CURRENCY = TypedField; using SF_NUMBER = TypedField; using SF_VL = TypedField; using SF_VECTOR256 = TypedField; using SF_XCHAIN_BRIDGE = TypedField; //------------------------------------------------------------------------------ // Use macros for most SField construction to enforce naming conventions. #pragma push_macro("UNTYPED_SFIELD") #undef UNTYPED_SFIELD #pragma push_macro("TYPED_SFIELD") #undef TYPED_SFIELD #define UNTYPED_SFIELD(sfName, stiSuffix, fieldValue, ...) extern SField const sfName; #define TYPED_SFIELD(sfName, stiSuffix, fieldValue, ...) extern SF_##stiSuffix const sfName; extern SField const kSF_INVALID; extern SField const kSF_GENERIC; #include #undef TYPED_SFIELD #pragma pop_macro("TYPED_SFIELD") #undef UNTYPED_SFIELD #pragma pop_macro("UNTYPED_SFIELD") } // namespace xrpl