mirror of
https://github.com/XRPLF/rippled.git
synced 2025-11-04 19:25:51 +00:00
3cbdf818a7
- Added a new Invariant: `ValidPseudoAccounts` which checks that all pseudo-accounts behave consistently through creation and updates, and that no "real" accounts look like pseudo-accounts (which means they don't have a 0 sequence).
- `to_short_string(base_uint)`. Like `to_string`, but only returns the first 8 characters. (Similar to how a git commit ID can be abbreviated.) Used as a wrapped sink to prefix most transaction-related messages. More can be added later.
- `XRPL_ASSERT_PARTS`. Convenience wrapper for `XRPL_ASSERT`, which takes the `function` and `description` as separate parameters.
- `SField::sMD_PseudoAccount`. Metadata option for `SField` definitions to indicate that the field, if set in an `AccountRoot` indicates that account is a pseudo-account. Removes the need for hard-coded field lists all over the place. Added the flag to `AMMID` and `VaultID`.
- Added functionality to `SField` ctor to detect both code and name collisions using asserts. And require all SFields to have a name
- Convenience type aliases `STLedgerEntry::const_pointer` and `STLedgerEntry::const_ref`. (`SLE` is an alias to `STLedgerEntry`.)
- Generalized `feeunit.h` (`TaggedFee`) into `unit.h` (`ValueUnit`) and added new "BIPS"-related tags for future use. Also refactored the type restrictions to use Concepts.
- Restructured `transactions.macro` to do two big things
1. Include the `#include` directives for transactor header files directly in the macro file. Removes the need to update `applySteps.cpp` and the resulting conflicts.
2. Added a `privileges` parameter to the `TRANSACTION` macro, which specifies some of the operations a transaction is allowed to do. These `privileges` are enforced by invariant checks. Again, removed the need to update scattered lists of transaction types in various checks.
- Unit tests:
1. Moved more helper functions into `TestHelpers.h` and `.cpp`.
2. Cleaned up the namespaces to prevent / mitigate random collisions and ambiguous symbols, particularly in unity builds.
3. Generalized `Env::balance` to add support for `MPTIssue` and `Asset`.
4. Added a set of helper classes to simplify `Env` transaction parameter classes: `JTxField`, `JTxFieldWrapper`, and a bunch of classes derived or aliased from it. For an example of how awesome it is, check the changes `src/test/jtx/escrow.h` for how much simpler the definitions are for `finish_time`, `cancel_time`, `condition`, and `fulfillment`.
5. Generalized several of the amount-related helper classes to understand `Asset`s.
6. `env.balance` for an MPT issuer will return a negative number (or 0) for consistency with IOUs.
184 lines
6.3 KiB
C++
184 lines
6.3 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.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#ifndef RIPPLE_PROTOCOL_PROTOCOL_H_INCLUDED
|
|
#define RIPPLE_PROTOCOL_PROTOCOL_H_INCLUDED
|
|
|
|
#include <xrpl/basics/ByteUtilities.h>
|
|
#include <xrpl/basics/base_uint.h>
|
|
|
|
#include <cstdint>
|
|
|
|
namespace ripple {
|
|
|
|
/** Protocol specific constants.
|
|
|
|
This information is, implicitly, part of the protocol.
|
|
|
|
@note Changing these values without adding code to the
|
|
server to detect "pre-change" and "post-change"
|
|
will result in a hard fork.
|
|
|
|
@ingroup protocol
|
|
*/
|
|
/** Smallest legal byte size of a transaction. */
|
|
std::size_t constexpr txMinSizeBytes = 32;
|
|
|
|
/** Largest legal byte size of a transaction. */
|
|
std::size_t constexpr txMaxSizeBytes = megabytes(1);
|
|
|
|
/** The maximum number of unfunded offers to delete at once */
|
|
std::size_t constexpr unfundedOfferRemoveLimit = 1000;
|
|
|
|
/** The maximum number of expired offers to delete at once */
|
|
std::size_t constexpr expiredOfferRemoveLimit = 256;
|
|
|
|
/** The maximum number of metadata entries allowed in one transaction */
|
|
std::size_t constexpr oversizeMetaDataCap = 5200;
|
|
|
|
/** The maximum number of entries per directory page */
|
|
std::size_t constexpr dirNodeMaxEntries = 32;
|
|
|
|
/** The maximum number of pages allowed in a directory */
|
|
std::uint64_t constexpr dirNodeMaxPages = 262144;
|
|
|
|
/** The maximum number of items in an NFT page */
|
|
std::size_t constexpr dirMaxTokensPerPage = 32;
|
|
|
|
/** The maximum number of owner directory entries for account to be deletable */
|
|
std::size_t constexpr maxDeletableDirEntries = 1000;
|
|
|
|
/** The maximum number of token offers that can be canceled at once */
|
|
std::size_t constexpr maxTokenOfferCancelCount = 500;
|
|
|
|
/** The maximum number of offers in an offer directory for NFT to be burnable */
|
|
std::size_t constexpr maxDeletableTokenOfferEntries = 500;
|
|
|
|
/** The maximum token transfer fee allowed.
|
|
|
|
Token transfer fees can range from 0% to 50% and are specified in tenths of
|
|
a basis point; that is a value of 1000 represents a transfer fee of 1% and
|
|
a value of 10000 represents a transfer fee of 10%.
|
|
|
|
Note that for extremely low transfer fees values, it is possible that the
|
|
calculated fee will be 0.
|
|
*/
|
|
std::uint16_t constexpr maxTransferFee = 50000;
|
|
|
|
/** The maximum length of a URI inside an NFT */
|
|
std::size_t constexpr maxTokenURILength = 256;
|
|
|
|
/** The maximum length of a Data element inside a DID */
|
|
std::size_t constexpr maxDIDDocumentLength = 256;
|
|
|
|
/** The maximum length of a URI inside a DID */
|
|
std::size_t constexpr maxDIDURILength = 256;
|
|
|
|
/** The maximum length of an Attestation inside a DID */
|
|
std::size_t constexpr maxDIDAttestationLength = 256;
|
|
|
|
/** The maximum length of a domain */
|
|
std::size_t constexpr maxDomainLength = 256;
|
|
|
|
/** The maximum length of a URI inside a Credential */
|
|
std::size_t constexpr maxCredentialURILength = 256;
|
|
|
|
/** The maximum length of a CredentialType inside a Credential */
|
|
std::size_t constexpr maxCredentialTypeLength = 64;
|
|
|
|
/** The maximum number of credentials can be passed in array */
|
|
std::size_t constexpr maxCredentialsArraySize = 8;
|
|
|
|
/** The maximum number of credentials can be passed in array for permissioned
|
|
* domain */
|
|
std::size_t constexpr maxPermissionedDomainCredentialsArraySize = 10;
|
|
|
|
/** The maximum length of MPTokenMetadata */
|
|
std::size_t constexpr maxMPTokenMetadataLength = 1024;
|
|
|
|
/** The maximum amount of MPTokenIssuance */
|
|
std::uint64_t constexpr maxMPTokenAmount = 0x7FFF'FFFF'FFFF'FFFFull;
|
|
|
|
/** The maximum length of Data payload */
|
|
std::size_t constexpr maxDataPayloadLength = 256;
|
|
|
|
/** Vault withdrawal policies */
|
|
std::uint8_t constexpr vaultStrategyFirstComeFirstServe = 1;
|
|
|
|
/** Default IOU scale factor for a Vault */
|
|
std::uint8_t constexpr vaultDefaultIOUScale = 6;
|
|
/** Maximum scale factor for a Vault. The number is chosen to ensure that
|
|
1 IOU can be always converted to shares.
|
|
10^19 > maxMPTokenAmount (2^64-1) > 10^18 */
|
|
std::uint8_t constexpr vaultMaximumIOUScale = 18;
|
|
|
|
/** Maximum recursion depth for vault shares being put as an asset inside
|
|
* another vault; counted from 0 */
|
|
std::uint8_t constexpr maxAssetCheckDepth = 5;
|
|
|
|
/** A ledger index. */
|
|
using LedgerIndex = std::uint32_t;
|
|
|
|
/** A transaction identifier.
|
|
The value is computed as the hash of the
|
|
canonicalized, serialized transaction object.
|
|
*/
|
|
using TxID = uint256;
|
|
|
|
/** The maximum number of trustlines to delete as part of AMM account
|
|
* deletion cleanup.
|
|
*/
|
|
std::uint16_t constexpr maxDeletableAMMTrustLines = 512;
|
|
|
|
/** The maximum length of a URI inside an Oracle */
|
|
std::size_t constexpr maxOracleURI = 256;
|
|
|
|
/** The maximum length of a Provider inside an Oracle */
|
|
std::size_t constexpr maxOracleProvider = 256;
|
|
|
|
/** The maximum size of a data series array inside an Oracle */
|
|
std::size_t constexpr maxOracleDataSeries = 10;
|
|
|
|
/** The maximum length of a SymbolClass inside an Oracle */
|
|
std::size_t constexpr maxOracleSymbolClass = 16;
|
|
|
|
/** The maximum allowed time difference between lastUpdateTime and the time
|
|
of the last closed ledger
|
|
*/
|
|
std::size_t constexpr maxLastUpdateTimeDelta = 300;
|
|
|
|
/** The maximum price scaling factor
|
|
*/
|
|
std::size_t constexpr maxPriceScale = 20;
|
|
|
|
/** The maximum percentage of outliers to trim
|
|
*/
|
|
std::size_t constexpr maxTrim = 25;
|
|
|
|
/** The maximum number of delegate permissions an account can grant
|
|
*/
|
|
std::size_t constexpr permissionMaxSize = 10;
|
|
|
|
/** The maximum number of transactions that can be in a batch. */
|
|
std::size_t constexpr maxBatchTxCount = 8;
|
|
|
|
} // namespace ripple
|
|
|
|
#endif
|