mirror of
https://github.com/XRPLF/rippled.git
synced 2025-12-06 17:27:55 +00:00
bc5a74057d
This is a substantial refactor of the consensus code and also introduces a basic consensus simulation and testing framework. The new generic/templated version is in src/ripple/consensus and documents the current type requirements. The version adapted for the RCL is in src/ripple/app/consensus. The testing framework is in src/test/csf. Minor behavioral changes/fixes include: * Adjust close time offset even when not validating. * Remove spurious proposing_ = false call at end of handleLCL. * Remove unused functionality provided by checkLastValidation. * Separate open and converge time * Don't send a bow out if we're not proposing * Prevent consensus stopping if NetworkOPs switches to disconnect mode while consensus accepts a ledger * Prevent a corner case in which Consensus::gotTxSet or Consensus::peerProposal has the potential to update internal state while an dispatched accept job is running. * Distinguish external and internal calls to startNewRound. Only external calls can reset the proposing_ state of consensus
105 lines
3.1 KiB
C++
105 lines
3.1 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012-2017 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_TEST_CSF_SIM_H_INCLUDED
|
|
#define RIPPLE_TEST_CSF_SIM_H_INCLUDED
|
|
|
|
#include <test/csf/UNL.h>
|
|
#include <test/csf/BasicNetwork.h>
|
|
|
|
namespace ripple {
|
|
namespace test {
|
|
namespace csf {
|
|
|
|
class Sim
|
|
{
|
|
public:
|
|
/** Create a simulator for the given trust graph and network topology.
|
|
|
|
Create a simulator for consensus over the given trust graph and connect
|
|
the network links between nodes based on the provided topology.
|
|
|
|
Topology is is a functor with signature
|
|
|
|
boost::optional<std::chrono::duration> (NodeId i, NodeId j)
|
|
|
|
that returns the delay sending messages from node i to node j.
|
|
|
|
In general, this network graph is distinct from the trust graph, but
|
|
users can use adaptors to present a TrustGraph as a Topology by
|
|
specifying the delay between nodes.
|
|
|
|
@param g The trust graph between peers.
|
|
@param top The network topology between peers.
|
|
|
|
*/
|
|
template <class Topology>
|
|
Sim(TrustGraph const & g, Topology const & top)
|
|
{
|
|
peers.reserve(g.numPeers());
|
|
for(int i = 0; i < g.numPeers(); ++i)
|
|
peers.emplace_back(i, net, g.unl(i));
|
|
|
|
for(int i = 0; i < peers.size(); ++i)
|
|
{
|
|
for(int j = 0; j < peers.size(); ++j)
|
|
{
|
|
if( i != j)
|
|
{
|
|
auto d = top(i,j);
|
|
if (d)
|
|
{
|
|
net.connect(&peers[i], &peers[j], *d);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Run consensus protocol to generate the provided number of ledgers.
|
|
|
|
Has each peer run consensus until it creates `ledgers` more ledgers.
|
|
|
|
@param ledgers The number of additional ledgers to create
|
|
*/
|
|
void
|
|
run(int ledgers)
|
|
{
|
|
for (auto & p : peers)
|
|
{
|
|
if(p.completedLedgers == 0)
|
|
p.relay(Validation{p.id, p.LCL(), p.LCL()});
|
|
p.targetLedgers = p.completedLedgers + ledgers;
|
|
p.start();
|
|
}
|
|
net.step();
|
|
}
|
|
|
|
std::vector<Peer> peers;
|
|
BasicNetwork<Peer*> net;
|
|
|
|
};
|
|
|
|
|
|
} // csf
|
|
} // test
|
|
} // ripple
|
|
|
|
#endif
|