@@ -0,0 +1,64 @@
2+title = "UF Apprenticeship Grant: Notifications Protocol"
6+grant_type = [ "Apprenticeship" ]
7+grant_category = [ "Core Dev" ]
11+description = "Build a new network protocol to Urbit to handle notifying subscribers when a new datum is published"
13+mentor = "~rovnys-ricfer"
18+https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0163&prefill_Grant+Name=Notifications%20Protocol"
22+### Project Description
24+This project adds a new network protocol to Urbit to handle notifying subscribers when a new datum is published. A rough spec can be found [here](https://gist.github.com/belisarius222/390daafc146f7c6ddd98836e61dc307f). Without this protocol, upcoming "solid-state subscriptions", which use the remote scry protocol, will have too much latency for chat.
26+Ideally this project would be done by two engineers, but one experienced C programmer could also do it. The apprentices will write this code themselves, not as part of a larger team. This work is entirely in Vere; any supporting work in the Arvo kernel will be handled by the mentor. ~rovnys-ricfer, who wrote the spec and a lot of the existing Urbit networking code, will mentor the engineers.
30+The major deliverable is a new Ames I/O driver in Vere that implements the notifications protocol.
34+- Live subscribers receive notifications promptly and handle them correctly.
35+- Sessions die and restart properly.
36+- Memory is freed on the publisher ship when a session dies.
37+- Heartbeat packets keep firewall pinholes open.
38+- Notifications are delivered reliably even when some packets get lost.
43+- Basic understanding of the Fine and Ames network protocols and packet formats
44+- The symmetric routing project (notifications use that routing scheme)
46+### Educational Outcomes for the Apprentice
48+The apprentice will learn about:
51+- Bit twiddling in Hoon and C
52+- The Arvo/Vere interface
54+### Responsibilities of the Mentor
56+- Clarify spec and implementation plan
57+- Answer questions about existing code
58+- Code review: style, correctness, performance, patterns and anti-patterns
59+- Help with testing and deployment strategies
61+### Duration and Compensation
63+Expected duration is two months.
64+1 star paid at completion of apprenticeship