rippled
Config.h
1 //------------------------------------------------------------------------------
2 /*
3  This file is part of rippled: https://github.com/ripple/rippled
4  Copyright (c) 2012, 2013 Ripple Labs Inc.
5 
6  Permission to use, copy, modify, and/or distribute this software for any
7  purpose with or without fee is hereby granted, provided that the above
8  copyright notice and this permission notice appear in all copies.
9 
10  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 */
18 //==============================================================================
19 
20 #ifndef RIPPLE_CORE_CONFIG_H_INCLUDED
21 #define RIPPLE_CORE_CONFIG_H_INCLUDED
22 
23 #include <ripple/basics/BasicConfig.h>
24 #include <ripple/basics/FeeUnits.h>
25 #include <ripple/basics/base_uint.h>
26 #include <ripple/beast/net/IPEndpoint.h>
27 #include <ripple/beast/utility/Journal.h>
28 #include <ripple/protocol/SystemParameters.h> // VFALCO Breaks levelization
29 #include <boost/beast/core/string.hpp>
30 #include <boost/filesystem.hpp> // VFALCO FIX: This include should not be here
31 #include <boost/lexical_cast.hpp>
32 #include <boost/optional.hpp>
33 #include <algorithm>
34 #include <chrono>
35 #include <cstdint>
36 #include <map>
37 #include <string>
38 #include <type_traits>
39 #include <unordered_set>
40 #include <vector>
41 
42 namespace ripple {
43 
44 class Rules;
45 
46 //------------------------------------------------------------------------------
47 
48 enum class SizedItem : std::size_t {
49  sweepInterval = 0,
52  ledgerSize,
53  ledgerAge,
58  txnDBCache,
59  lgrDBCache,
61  burstSize
62 };
63 
64 // This entire derived class is deprecated.
65 // For new config information use the style implied
66 // in the base class. For existing config information
67 // try to refactor code to use the new style.
68 //
69 class Config : public BasicConfig
70 {
71 public:
72  // Settings related to the configuration file location and directories
73  static char const* const configFileName;
74  static char const* const databaseDirName;
75  static char const* const validatorsFileName;
76 
78  boost::filesystem::path
79  getDebugLogFile() const;
80 
81 private:
82  boost::filesystem::path CONFIG_FILE;
83 
84 public:
85  boost::filesystem::path CONFIG_DIR;
86 
87 private:
88  boost::filesystem::path DEBUG_LOGFILE;
89 
90  void
91  load();
93 
94  bool QUIET = false; // Minimize logging verbosity.
95  bool SILENT = false; // No output to console after startup.
105  bool RUN_STANDALONE = false;
106 
113  bool signingEnabled_ = false;
114 
115 public:
116  bool doImport = false;
117  bool nodeToShard = false;
118  bool ELB_SUPPORT = false;
119 
120  std::vector<std::string> IPS; // Peer IPs from rippled.cfg.
121  std::vector<std::string> IPS_FIXED; // Fixed Peer IPs from rippled.cfg.
122  std::vector<std::string> SNTP_SERVERS; // SNTP servers from rippled.cfg.
123 
126 
127  bool START_VALID = false;
128 
130 
131  // Network parameters
132 
133  // The number of fee units a reference transaction costs
134  static constexpr FeeUnit32 TRANSACTION_FEE_BASE{10};
135 
136  // Note: The following parameters do not relate to the UNL or trust at all
137  // Minimum number of nodes to consider the network present
139 
140  // Peer networking parameters
143 
144  // True to ask peers not to relay current IP.
145  bool PEER_PRIVATE = false;
146  // peers_max is a legacy configuration, which is going to be replaced
147  // with individual inbound peers peers_in_max and outbound peers
148  // peers_out_max configuration. for now we support both the legacy and
149  // the new configuration. if peers_max is configured then peers_in_max and
150  // peers_out_max are ignored.
154 
156 
157  // Path searching
159  int PATH_SEARCH = 7;
161  int PATH_SEARCH_MAX = 10;
162 
163  // Validation
164  boost::optional<std::size_t>
165  VALIDATION_QUORUM; // validations to consider ledger authoritative
166 
170 
171  // Node storage configuration
174 
176 
177  bool SSL_VERIFY = true;
180 
181  // Compression
182  bool COMPRESSION = false;
183 
184  // Work queue limits
185  int MAX_TRANSACTIONS = 250;
186  static constexpr int MAX_JOB_QUEUE_TX = 1000;
187  static constexpr int MIN_JOB_QUEUE_TX = 100;
188 
189  // Amendment majority time
191 
192  // Thread pool configuration
194 
195  // Reduce-relay - these parameters are experimental.
196  // Enable reduce-relay functionality
197  bool REDUCE_RELAY_ENABLE = false;
198  // Send squelch message to peers
199  bool REDUCE_RELAY_SQUELCH = false;
200 
201  // These override the command line client settings
202  boost::optional<beast::IP::Endpoint> rpc_ip;
203 
205 
207 
208  // How long can a peer remain in the "unknown" state
210 
211  // How long can a peer remain in the "diverged" state
213 
214 public:
216  {
217  }
218 
219  /* Be very careful to make sure these bool params
220  are in the right order. */
221  void
222  setup(
223  std::string const& strConf,
224  bool bQuiet,
225  bool bSilent,
226  bool bStandalone);
227  void
228  setupControl(bool bQuiet, bool bSilent, bool bStandalone);
229 
235  void
236  loadFromString(std::string const& fileContents);
237 
238  bool
239  quiet() const
240  {
241  return QUIET;
242  }
243  bool
244  silent() const
245  {
246  return SILENT;
247  }
248  bool
249  standalone() const
250  {
251  return RUN_STANDALONE;
252  }
253 
254  bool
255  canSign() const
256  {
257  return signingEnabled_;
258  }
259 
277  int
278  getValueFor(SizedItem item, boost::optional<std::size_t> node = boost::none)
279  const;
280 };
281 
282 } // namespace ripple
283 
284 #endif
ripple::SizedItem::openFinalLimit
@ openFinalLimit
ripple::Config::NORMAL
@ NORMAL
Definition: Config.h:124
std::string
STL class.
ripple::SizedItem
SizedItem
Definition: Config.h:48
ripple::Config::PATH_SEARCH
int PATH_SEARCH
Definition: Config.h:159
ripple::SizedItem::nodeCacheSize
@ nodeCacheSize
unordered_set
ripple::Config::Config
Config()
Definition: Config.h:215
ripple::Config::REDUCE_RELAY_ENABLE
bool REDUCE_RELAY_ENABLE
Definition: Config.h:197
ripple::Config::validatorsFileName
static char const *const validatorsFileName
Definition: Config.h:75
vector
ripple::Config::SSL_VERIFY_DIR
std::string SSL_VERIFY_DIR
Definition: Config.h:179
ripple::Config::getValueFor
int getValueFor(SizedItem item, boost::optional< std::size_t > node=boost::none) const
Retrieve the default value for the item at the specified node size.
Definition: Config.cpp:814
ripple::Config::CONFIG_FILE
boost::filesystem::path CONFIG_FILE
Definition: Config.h:82
std::chrono::seconds
ripple::Config::NODE_SIZE
std::size_t NODE_SIZE
Definition: Config.h:175
ripple::Config::PEER_PRIVATE
bool PEER_PRIVATE
Definition: Config.h:145
ripple::Config::DEBUG_LOGFILE
boost::filesystem::path DEBUG_LOGFILE
Definition: Config.h:88
ripple::Config::silent
bool silent() const
Definition: Config.h:244
ripple::Config::setupControl
void setupControl(bool bQuiet, bool bSilent, bool bStandalone)
Definition: Config.cpp:201
ripple::SizedItem::treeCacheAge
@ treeCacheAge
ripple::Config::LOAD
@ LOAD
Definition: Config.h:124
ripple::Config::StartUpType
StartUpType
Definition: Config.h:124
ripple::SizedItem::nodeCacheAge
@ nodeCacheAge
ripple::SizedItem::hashNodeDBCache
@ hashNodeDBCache
ripple::Config::MIN_JOB_QUEUE_TX
static constexpr int MIN_JOB_QUEUE_TX
Definition: Config.h:187
ripple::SizedItem::ledgerFetch
@ ledgerFetch
beast::Journal::getNullSink
static Sink & getNullSink()
Returns a Sink which does nothing.
Definition: beast_Journal.cpp:72
ripple::Config::MAX_TRANSACTIONS
int MAX_TRANSACTIONS
Definition: Config.h:185
ripple::Config::quiet
bool quiet() const
Definition: Config.h:239
ripple::Config::FETCH_DEPTH
std::uint32_t FETCH_DEPTH
Definition: Config.h:173
algorithm
ripple::Config::REDUCE_RELAY_SQUELCH
bool REDUCE_RELAY_SQUELCH
Definition: Config.h:199
ripple::Config::PATH_SEARCH_MAX
int PATH_SEARCH_MAX
Definition: Config.h:161
ripple::Config::RUN_STANDALONE
bool RUN_STANDALONE
Operate in stand-alone mode.
Definition: Config.h:105
ripple::Config::load
void load()
Definition: Config.cpp:317
ripple::Config::j_
const beast::Journal j_
Definition: Config.h:92
ripple::Config::SSL_VERIFY_FILE
std::string SSL_VERIFY_FILE
Definition: Config.h:178
ripple::Config::loadFromString
void loadFromString(std::string const &fileContents)
Load the config from the contents of the string.
Definition: Config.cpp:339
ripple::Config::VALIDATION_QUORUM
boost::optional< std::size_t > VALIDATION_QUORUM
Definition: Config.h:165
ripple::Config
Definition: Config.h:69
ripple::Config::TRANSACTION_FEE_BASE
static constexpr FeeUnit32 TRANSACTION_FEE_BASE
Definition: Config.h:134
chrono
ripple::Config::NETWORK
@ NETWORK
Definition: Config.h:124
ripple::Config::SNTP_SERVERS
std::vector< std::string > SNTP_SERVERS
Definition: Config.h:122
ripple::Config::WEBSOCKET_PING_FREQ
std::chrono::seconds WEBSOCKET_PING_FREQ
Definition: Config.h:155
ripple::Config::IPS_FIXED
std::vector< std::string > IPS_FIXED
Definition: Config.h:121
ripple::Config::FEE_OWNER_RESERVE
XRPAmount FEE_OWNER_RESERVE
Definition: Config.h:169
ripple::Config::standalone
bool standalone() const
Definition: Config.h:249
ripple::Config::SSL_VERIFY
bool SSL_VERIFY
Definition: Config.h:177
ripple::Config::RELAY_UNTRUSTED_PROPOSALS
bool RELAY_UNTRUSTED_PROPOSALS
Definition: Config.h:142
ripple::Config::FEE_ACCOUNT_RESERVE
XRPAmount FEE_ACCOUNT_RESERVE
Definition: Config.h:168
cstdint
ripple::Config::PEERS_OUT_MAX
std::size_t PEERS_OUT_MAX
Definition: Config.h:152
ripple::Config::START_UP
StartUpType START_UP
Definition: Config.h:125
ripple::Config::AMENDMENT_MAJORITY_TIME
std::chrono::seconds AMENDMENT_MAJORITY_TIME
Definition: Config.h:190
ripple::SizedItem::lgrDBCache
@ lgrDBCache
ripple::Config::MAX_JOB_QUEUE_TX
static constexpr int MAX_JOB_QUEUE_TX
Definition: Config.h:186
beast::Journal
A generic endpoint for log messages.
Definition: Journal.h:58
ripple::SizedItem::burstSize
@ burstSize
ripple::Config::nodeToShard
bool nodeToShard
Definition: Config.h:117
std::uint32_t
ripple::Config::canSign
bool canSign() const
Definition: Config.h:255
ripple::Config::PEERS_IN_MAX
std::size_t PEERS_IN_MAX
Definition: Config.h:153
ripple::Config::databaseDirName
static char const *const databaseDirName
Definition: Config.h:74
ripple::feeunit::TaggedFee
Definition: FeeUnits.h:70
ripple::Config::START_VALID
bool START_VALID
Definition: Config.h:127
map
ripple::SizedItem::txnDBCache
@ txnDBCache
ripple::Config::WORKERS
std::size_t WORKERS
Definition: Config.h:193
ripple::Config::PATH_SEARCH_OLD
int PATH_SEARCH_OLD
Definition: Config.h:158
ripple::Config::LEDGER_HISTORY
std::uint32_t LEDGER_HISTORY
Definition: Config.h:172
ripple::Config::NETWORK_QUORUM
std::size_t NETWORK_QUORUM
Definition: Config.h:138
ripple::DROPS_PER_XRP
constexpr XRPAmount DROPS_PER_XRP
Number of drops per 1 XRP.
Definition: XRPAmount.h:244
ripple::Config::CONFIG_DIR
boost::filesystem::path CONFIG_DIR
Definition: Config.h:85
ripple::Config::PEERS_MAX
std::size_t PEERS_MAX
Definition: Config.h:151
ripple::Config::FEE_DEFAULT
XRPAmount FEE_DEFAULT
Definition: Config.h:167
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: RCLCensorshipDetector.h:29
ripple::Config::FRESH
@ FRESH
Definition: Config.h:124
ripple::Config::features
std::unordered_set< uint256, beast::uhash<> > features
Definition: Config.h:204
ripple::Config::PATH_SEARCH_FAST
int PATH_SEARCH_FAST
Definition: Config.h:160
ripple::Config::setup
void setup(std::string const &strConf, bool bQuiet, bool bSilent, bool bStandalone)
Definition: Config.cpp:209
ripple::SizedItem::treeCacheSize
@ treeCacheSize
ripple::Config::SERVER_DOMAIN
std::string SERVER_DOMAIN
Definition: Config.h:206
ripple::Config::REPLAY
@ REPLAY
Definition: Config.h:124
ripple::Config::doImport
bool doImport
Definition: Config.h:116
ripple::SizedItem::sweepInterval
@ sweepInterval
ripple::Config::COMPRESSION
bool COMPRESSION
Definition: Config.h:182
ripple::defaultAmendmentMajorityTime
constexpr const std::chrono::seconds defaultAmendmentMajorityTime
The minimum amount of time an amendment must hold a majority.
Definition: SystemParameters.h:73
ripple::Config::RELAY_UNTRUSTED_VALIDATIONS
bool RELAY_UNTRUSTED_VALIDATIONS
Definition: Config.h:141
ripple::SizedItem::ledgerSize
@ ledgerSize
ripple::Config::IPS
std::vector< std::string > IPS
Definition: Config.h:120
ripple::Config::configFileName
static char const *const configFileName
Definition: Config.h:73
std::size_t
ripple::Config::QUIET
bool QUIET
Definition: Config.h:94
ripple::Config::SILENT
bool SILENT
Definition: Config.h:95
ripple::Config::getDebugLogFile
boost::filesystem::path getDebugLogFile() const
Returns the full path and filename of the debug log file.
Definition: Config.cpp:780
ripple::Config::signingEnabled_
bool signingEnabled_
Determines if the server will sign a tx, given an account's secret seed.
Definition: Config.h:113
ripple::Config::LOAD_FILE
@ LOAD_FILE
Definition: Config.h:124
ripple::Config::rpc_ip
boost::optional< beast::IP::Endpoint > rpc_ip
Definition: Config.h:202
ripple::Config::ELB_SUPPORT
bool ELB_SUPPORT
Definition: Config.h:118
type_traits
ripple::BasicConfig
Holds unparsed configuration information.
Definition: BasicConfig.h:178
ripple::Config::START_LEDGER
std::string START_LEDGER
Definition: Config.h:129
ripple::SizedItem::ledgerAge
@ ledgerAge
ripple::Config::MAX_UNKNOWN_TIME
std::chrono::seconds MAX_UNKNOWN_TIME
Definition: Config.h:209
ripple::XRPAmount
Definition: XRPAmount.h:46
ripple::Config::MAX_DIVERGED_TIME
std::chrono::seconds MAX_DIVERGED_TIME
Definition: Config.h:212
string