Code to simulate the security of routing Quorums under various conditions.
|MaidSafe website||SAFE Dev Forum||SAFE Network Forum|
Two probabilities are output: the probability that any group in the network is prevented from reaching the correct result via quorum, and the probability that any group is compromised (i.e. reaches the wrong result via quorum).
Three tools are available, calculating the output probabilities in different ways:
- DirectCalcTool — this assumes every group has the minimum size given and uses probability theory to calculate the result.
- SimStructureTool — this simulates the development of a network, then uses probability theory to calculate the result given these group sizes. Does not simulate node ageing.
- FullSimTool — this simulates the development of a network (only including the non-malicious nodes), then simulates an attack (where only malicious nodes are added), which may or may not result in lost quorum and compromised quorum. The simulation is then repeated many times (see -p parameter) to obtain a probability. Currently this always simulates relocation due to node ageing, regardless of quorum used.
Two types of quorum are implemented:
- SimpleQuorum — quorum is achieved when the given proportion of nodes send a response
- AgeQuorum — quorum requires both the given proportion of nodes and the given proportion of sum of the nodes ages.
The following strategies have been implemented. This is by no means an exhaustive list of all possible strategies!
- UntargettedAttack — malicious nodes never reset themselves
- SimpleTargettedAttack — malicious nodes choose a target group, and reset themselves as soon as they are not found in that group. This strategy is completely useless when an age-based quorum is used since malicious nodes do not get the chance to age!
- target, but only reset above some age to allow ageing first
- select some nodes for ageing and do not reset these (often), while using another set of nodes to age these via targetting (this strategy could be mitigated by applying churns to a different group than added to)
This SAFE Network repository is dual-licensed under the Modified BSD (LICENSE-BSD https://opensource.org/licenses/BSD-3-Clause) or the MIT license (LICENSE-MIT https://opensource.org/licenses/MIT) at your option.
Want to contribute? Great
There are many ways to give back to the project, whether it be writing new code, fixing bugs, or just reporting errors. All forms of contributions are encouraged!
For instructions on how to contribute, see our Guide to contributing.