mirror of
https://github.com/XRPLF/rippled.git
synced 2025-11-22 03:55:53 +00:00
The XRP Ledger utilizes an account model. Unlike systems based on a UTXO model, XRP Ledger accounts are first-class objects. This design choice allows the XRP Ledger to offer rich functionality, including the ability to own objects (offers, escrows, checks, signer lists) as well as other advanced features, such as key rotation and configurable multi-signing without needing to change a destination address. The trade-off is that accounts must be stored on ledger. The XRP Ledger applies reserve requirements, in XRP, to protect the shared global ledger from growing excessively large as the result of spam or malicious usage. Prior to this commit, accounts had been permanent objects; once created, they could never be deleted. This commit introduces a new amendment "DeletableAccounts" which, if enabled, will allow account objects to be deleted by executing the new "AccountDelete" transaction. Any funds remaining in the account will be transferred to an account specified in the deletion transaction. The amendment changes the mechanics of account creation; previously a new account would have an initial sequence number of 1. Accounts created after the amendment will have an initial sequence number that is equal to the ledger in which the account was created. Accounts can only be deleted if they are not associated with any obligations (like RippleStates, Escrows, or PayChannels) and if the current ledger sequence number exceeds the account's sequence number by at least 256 so that, if recreated, the account can be protected from transaction replay.
184 lines
6.7 KiB
C++
184 lines
6.7 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012, 2013 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.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#include <ripple/protocol/Feature.h>
|
|
#include <ripple/basics/contract.h>
|
|
#include <ripple/protocol/digest.h>
|
|
|
|
#include <cstring>
|
|
|
|
namespace ripple {
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
constexpr char const* const detail::FeatureCollections::featureNames[];
|
|
|
|
detail::FeatureCollections::FeatureCollections()
|
|
{
|
|
features.reserve(numFeatures());
|
|
featureToIndex.reserve(numFeatures());
|
|
nameToFeature.reserve(numFeatures());
|
|
|
|
for (std::size_t i = 0; i < numFeatures(); ++i)
|
|
{
|
|
auto const name = featureNames[i];
|
|
sha512_half_hasher h;
|
|
h (name, std::strlen (name));
|
|
auto const f = static_cast<uint256>(h);
|
|
|
|
features.push_back(f);
|
|
featureToIndex[f] = i;
|
|
nameToFeature[name] = f;
|
|
}
|
|
}
|
|
|
|
boost::optional<uint256>
|
|
detail::FeatureCollections::getRegisteredFeature(std::string const& name) const
|
|
{
|
|
auto const i = nameToFeature.find(name);
|
|
if (i == nameToFeature.end())
|
|
return boost::none;
|
|
return i->second;
|
|
}
|
|
|
|
size_t
|
|
detail::FeatureCollections::featureToBitsetIndex(uint256 const& f) const
|
|
{
|
|
auto const i = featureToIndex.find(f);
|
|
if (i == featureToIndex.end())
|
|
LogicError("Invalid Feature ID");
|
|
return i->second;
|
|
}
|
|
|
|
uint256 const&
|
|
detail::FeatureCollections::bitsetIndexToFeature(size_t i) const
|
|
{
|
|
if (i >= features.size())
|
|
LogicError("Invalid FeatureBitset index");
|
|
return features[i];
|
|
}
|
|
|
|
static detail::FeatureCollections const featureCollections;
|
|
|
|
/** Amendments that this server supports, but doesn't enable by default */
|
|
std::vector<std::string> const&
|
|
detail::supportedAmendments ()
|
|
{
|
|
// Commented out amendments will be supported in a future release (and
|
|
// uncommented at that time).
|
|
static std::vector<std::string> const supported
|
|
{
|
|
"MultiSign",
|
|
// "Tickets",
|
|
"TrustSetAuth",
|
|
"FeeEscalation", // Looks unused, but do not remove; Servers will be amendment blocked.
|
|
// "OwnerPaysFee",
|
|
"PayChan",
|
|
"Flow",
|
|
"CryptoConditions",
|
|
"TickSize",
|
|
"fix1368",
|
|
"Escrow",
|
|
"CryptoConditionsSuite",
|
|
"fix1373",
|
|
"EnforceInvariants",
|
|
"FlowCross",
|
|
"SortedDirectories",
|
|
"fix1201",
|
|
"fix1512",
|
|
"fix1513",
|
|
"fix1523",
|
|
"fix1528",
|
|
"DepositAuth",
|
|
"Checks",
|
|
"fix1571",
|
|
"fix1543",
|
|
"fix1623",
|
|
"DepositPreauth",
|
|
// Use liquidity from strands that consume max offers, but mark as dry
|
|
"fix1515",
|
|
"fix1578",
|
|
"MultiSignReserve",
|
|
"fixTakerDryOfferRemoval",
|
|
"fixMasterKeyAsRegularKey",
|
|
"fixCheckThreading",
|
|
"fixPayChanRecipientOwnerDir",
|
|
"DeletableAccounts",
|
|
};
|
|
return supported;
|
|
}
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
boost::optional<uint256>
|
|
getRegisteredFeature (std::string const& name)
|
|
{
|
|
return featureCollections.getRegisteredFeature(name);
|
|
}
|
|
|
|
size_t featureToBitsetIndex(uint256 const& f)
|
|
{
|
|
return featureCollections.featureToBitsetIndex(f);
|
|
}
|
|
|
|
uint256 bitsetIndexToFeature(size_t i)
|
|
{
|
|
return featureCollections.bitsetIndexToFeature(i);
|
|
}
|
|
|
|
|
|
uint256 const featureMultiSign = *getRegisteredFeature("MultiSign");
|
|
uint256 const featureTickets = *getRegisteredFeature("Tickets");
|
|
uint256 const featureTrustSetAuth = *getRegisteredFeature("TrustSetAuth");
|
|
uint256 const featureOwnerPaysFee = *getRegisteredFeature("OwnerPaysFee");
|
|
uint256 const featureCompareFlowV1V2 = *getRegisteredFeature("CompareFlowV1V2");
|
|
uint256 const featurePayChan = *getRegisteredFeature("PayChan");
|
|
uint256 const featureFlow = *getRegisteredFeature("Flow");
|
|
uint256 const featureCompareTakerFlowCross = *getRegisteredFeature("CompareTakerFlowCross");
|
|
uint256 const featureFlowCross = *getRegisteredFeature("FlowCross");
|
|
uint256 const featureCryptoConditions = *getRegisteredFeature("CryptoConditions");
|
|
uint256 const featureTickSize = *getRegisteredFeature("TickSize");
|
|
uint256 const fix1368 = *getRegisteredFeature("fix1368");
|
|
uint256 const featureEscrow = *getRegisteredFeature("Escrow");
|
|
uint256 const featureCryptoConditionsSuite = *getRegisteredFeature("CryptoConditionsSuite");
|
|
uint256 const fix1373 = *getRegisteredFeature("fix1373");
|
|
uint256 const featureEnforceInvariants = *getRegisteredFeature("EnforceInvariants");
|
|
uint256 const featureSortedDirectories = *getRegisteredFeature("SortedDirectories");
|
|
uint256 const fix1201 = *getRegisteredFeature("fix1201");
|
|
uint256 const fix1512 = *getRegisteredFeature("fix1512");
|
|
uint256 const fix1513 = *getRegisteredFeature("fix1513");
|
|
uint256 const fix1523 = *getRegisteredFeature("fix1523");
|
|
uint256 const fix1528 = *getRegisteredFeature("fix1528");
|
|
uint256 const featureDepositAuth = *getRegisteredFeature("DepositAuth");
|
|
uint256 const featureChecks = *getRegisteredFeature("Checks");
|
|
uint256 const fix1571 = *getRegisteredFeature("fix1571");
|
|
uint256 const fix1543 = *getRegisteredFeature("fix1543");
|
|
uint256 const fix1623 = *getRegisteredFeature("fix1623");
|
|
uint256 const featureDepositPreauth = *getRegisteredFeature("DepositPreauth");
|
|
uint256 const fix1515 = *getRegisteredFeature("fix1515");
|
|
uint256 const fix1578 = *getRegisteredFeature("fix1578");
|
|
uint256 const featureMultiSignReserve = *getRegisteredFeature("MultiSignReserve");
|
|
uint256 const fixTakerDryOfferRemoval = *getRegisteredFeature("fixTakerDryOfferRemoval");
|
|
uint256 const fixMasterKeyAsRegularKey = *getRegisteredFeature("fixMasterKeyAsRegularKey");
|
|
uint256 const fixCheckThreading = *getRegisteredFeature("fixCheckThreading");
|
|
uint256 const fixPayChanRecipientOwnerDir = *getRegisteredFeature("fixPayChanRecipientOwnerDir");
|
|
uint256 const featureDeletableAccounts = *getRegisteredFeature("DeletableAccounts");
|
|
|
|
} // ripple
|