nomos-specs/mixnet/v2/sim
Youngjoon Lee 1da5c710b0
generate cover messages to be not forward to the next mix
2024-05-17 19:05:09 +09:00
..
docs add input/output observation 2024-05-16 17:13:43 +09:00
README.md fix readme 2024-05-16 18:11:57 +09:00
adversary.py add scatterplot for node states 2024-05-17 16:49:13 +09:00
analysis.py add scatterplot for node states 2024-05-17 16:49:13 +09:00
config.py refactor: subclasses for Config 2024-05-17 15:58:29 +09:00
config.yaml refactor: subclasses for Config 2024-05-17 15:58:29 +09:00
main.py refactor adversary 2024-05-17 13:29:20 +09:00
node.py generate cover messages to be not forward to the next mix 2024-05-17 19:05:09 +09:00
p2p.py refactor: subclasses for Config 2024-05-17 15:58:29 +09:00
simulation.py refactor: subclasses for Config 2024-05-17 15:58:29 +09:00
sphinx.py add comment 2024-05-13 13:58:22 +09:00

README.md

Mixnet v2 Simulation

How to Run

First, make sure that all dependencies specified in the requirements.txt in the project root. Then, configure parameters in the config.yaml, and run the following command:

python main.py --config ./config.yaml

The simulation runs during a specified duration, prints the results to the console, and show some plots.

Time in simulation

The simulation is implemented based on SimPy which is discrete-event simulation framework. All events are processed sequentially by a single thread. However, multiple parallel events, which should be processed at the same time, can be also simulated by scheduling them at the same "time".

The simulation has the virtual time concept, which doesn't have the same scale as the real time. If the event A is scheduled to happen at time 10, and the event B is scheduled to happen at time 11, the simulation guarantees that the event B happens only after the event A happens. But, it doesn't mean that the event B happens exactly 1 second after the event A. It will be much shorter.

If two events are scheduled at the same time (e.g. 10), the simulation processes the one that is scheduled first and the other one next (FIFO). But, it is guarantees that those two event are processed before the events scheduled at time 11+.

Using this virtual time, complex distributed systems can be simulated in a simple way without worrying about the real-time synchronization. For more details, please see the Time and Scheduling section in the SimPy documentation.

Mixnet Functionalities

  • Modified Sphinx
    • Without encryption
    • With encryption
  • P2P Broadcasting
    • Naive 1-to-all
    • More realistic broadcasting (e.g. gossipsub)
  • Sending a real message to the mixnet at the promised interval
    • Each node has its own probability of sending a real message at each interval.
  • Cover traffic
    • All nodes have the same probability of sending a cover message at each interval.
  • Forwarding messages through mixes, and then broadcasting messages to all nodes if the message is real.
  • Mix delays
    • Naive random delays
    • More sophisticated delays (e.g. Poisson) if necessary

Adversary Models

  • Inspecting message sizes to analyze how far each message has traveled since emitted by the original sender.
    • Currently, all messages have the same size (including messages broadcasted after being fully unwrapped). Thus, the adversary can learn nothing.
             message_size
      count        1806.0
      mean         1937.0
      std             0.0
      min          1937.0
      25%          1937.0
      50%          1937.0
      75%          1937.0
      max          1937.0
      
  • Identifying nodes emitting messages around the promised interval.
    • As the GPA
    • With partial visibility
    • Quantifying how much the expected frequent senders are anonymized by cover traffic
  • Correlating senders-receivers based on timing
    • DRAFT
      • This can indicate whether a certain node has extremely few messages being mixed in the node. But, I don't think this is the best way to analyze the correlation. I think we need to try to simulate the actual timing attack.
  • Active attacks