mirror of
https://github.com/Xahau/xahaud.git
synced 2025-11-19 01:55:48 +00:00
e2eed966b0
Caching the base58check encoded version of an `AccountID` has performance advantages, because because of the computationally heavy cost associated with the conversion, which requires the application of SHA-256 twice. This commit makes the cache significantly more efficient in terms of memory used: it eliminates the map, using a vector with a size that is determined by the configured size of the node, and a hash function to directly map any given `AccountID` to a specific slot in the cache; the eviction policy is simple: in case of collision the existing entry is removed and replaced with the new data. Previously, use of the cache was optional and required additional effort by the programmer. Now the cache is automatic and does not require any additional work or information. The new cache also utilizes a 64-way spinlock, to help reduce any contention that the pressure on the cache would impose.
141 lines
3.8 KiB
C++
141 lines
3.8 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2014 Ripple Labs Inc.
|
|
|
|
Permission to use, copy, modify, and/or distribute this software for any
|
|
purpose with or without fee is hereby granted, provided that the above
|
|
copyright notice and this permission notice appear in all copies.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#ifndef RIPPLE_PROTOCOL_ACCOUNTID_H_INCLUDED
|
|
#define RIPPLE_PROTOCOL_ACCOUNTID_H_INCLUDED
|
|
|
|
#include <ripple/protocol/tokens.h>
|
|
// VFALCO Uncomment when the header issues are resolved
|
|
//#include <ripple/protocol/PublicKey.h>
|
|
#include <ripple/basics/UnorderedContainers.h>
|
|
#include <ripple/basics/base_uint.h>
|
|
#include <ripple/json/json_value.h>
|
|
#include <cstddef>
|
|
#include <mutex>
|
|
#include <optional>
|
|
#include <string>
|
|
|
|
namespace ripple {
|
|
|
|
namespace detail {
|
|
|
|
class AccountIDTag
|
|
{
|
|
public:
|
|
explicit AccountIDTag() = default;
|
|
};
|
|
|
|
} // namespace detail
|
|
|
|
/** A 160-bit unsigned that uniquely identifies an account. */
|
|
using AccountID = base_uint<160, detail::AccountIDTag>;
|
|
|
|
/** Convert AccountID to base58 checked string */
|
|
std::string
|
|
toBase58(AccountID const& v);
|
|
|
|
/** Parse AccountID from checked, base58 string.
|
|
@return std::nullopt if a parse error occurs
|
|
*/
|
|
template <>
|
|
std::optional<AccountID>
|
|
parseBase58(std::string const& s);
|
|
|
|
/** Compute AccountID from public key.
|
|
|
|
The account ID is computed as the 160-bit hash of the
|
|
public key data. This excludes the version byte and
|
|
guard bytes included in the base58 representation.
|
|
|
|
*/
|
|
// VFALCO In PublicKey.h for now
|
|
// AccountID
|
|
// calcAccountID (PublicKey const& pk);
|
|
|
|
/** A special account that's used as the "issuer" for XRP. */
|
|
AccountID const&
|
|
xrpAccount();
|
|
|
|
/** A placeholder for empty accounts. */
|
|
AccountID const&
|
|
noAccount();
|
|
|
|
/** Convert hex or base58 string to AccountID.
|
|
|
|
@return `true` if the parsing was successful.
|
|
*/
|
|
// DEPRECATED
|
|
bool
|
|
to_issuer(AccountID&, std::string const&);
|
|
|
|
// DEPRECATED Should be checking the currency or native flag
|
|
inline bool
|
|
isXRP(AccountID const& c)
|
|
{
|
|
return c == beast::zero;
|
|
}
|
|
|
|
// DEPRECATED
|
|
inline std::string
|
|
to_string(AccountID const& account)
|
|
{
|
|
return toBase58(account);
|
|
}
|
|
|
|
// DEPRECATED
|
|
inline std::ostream&
|
|
operator<<(std::ostream& os, AccountID const& x)
|
|
{
|
|
os << to_string(x);
|
|
return os;
|
|
}
|
|
|
|
/** Initialize the global cache used to map AccountID to base58 conversions.
|
|
|
|
The cache is optional and need not be initialized. But because conversion
|
|
is expensive (it requires a SHA-256 operation) in most cases the overhead
|
|
of the cache is worth the benefit.
|
|
|
|
@param count The number of entries the cache should accomodate. Zero will
|
|
disable the cache, releasing any memory associated with it.
|
|
|
|
@note The function will only initialize the cache the first time it is
|
|
invoked. Subsequent invocations do nothing.
|
|
*/
|
|
void
|
|
initAccountIdCache(std::size_t count);
|
|
|
|
} // namespace ripple
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
namespace std {
|
|
|
|
// DEPRECATED
|
|
// VFALCO Use beast::uhash or a hardened container
|
|
template <>
|
|
struct hash<ripple::AccountID> : ripple::AccountID::hasher
|
|
{
|
|
explicit hash() = default;
|
|
};
|
|
|
|
} // namespace std
|
|
|
|
#endif
|