Goal

Hyperledger Umbra (https://github.com/hyperledger-labs/umbra) is a project created during the 2019 mentorship period as a network simulation tool to run the blockchain environment. The plan for this year is to add network fuzzing capabilities such as packet drops, delay, loss, etc.

Proposed Timeline

Week 1 - 3 (June 1 - June 19)

• Understand blockchain, docker, containernet, SDN, etc concepts
• Setup and get familiar with the development environment - run tests, read logs, etc
• Get high level understanding of the current umbra code - advanced Python ramp-up
• From above learnings, improve umbra docs, setup scripts, etc if needed

Week 4 - 6 (June 22 - July 10)

• Pathfinding: ability to save and replay packet. E.g. each peer saves each packet sends so umbra-broker can instruct all the nodes to replay the packet
• Implement the ability to remove container(s), remove/update link behavior (bandwidth, delay, loss, etc), and change node resources (cpu/mem) in umbra-scenario component
• Test feature -  refer umbra/examples/fabric/build_configs.py

Week 7 - 9 (July 13 - July 31)

• Continue working on save/restore feature
• Add events to umbra-broker based on previous quarter link/node behavior changes in umbra-scenario
• Review implementation details with Umbra maintainer

Week 10 - 12 (Aug 3 - Aug 21)

• Add the ability in broker to parse events from config (e.g., event with “category” field set to “scenario”), containing the proper params to call the scenario modifications (e.g., node: name, operation: delete, etc)
• Generate a report for this fuzzing activity - list out all the events, status, etc
• Document and wrap-up work (scripts to automate stuff, etc)

Process

• Weekly meeting with mentor and other mentees that use Umbra. Other meetings scheduled as required
• Chat via Signal