# Network Protocol

## Common Structures

### Event

Representation of an event in the Event Graph.
This is either sent when a new event is created, or in response to `EventReq`.

| Description   | Data Type      	   | Comments           		    |
|-------------- | -------------------- | ------------------------------ |
| timestamp	  	| `u64`                | Timestamp of the event    	    |
| content	  	| `Vec<u8>`            | Content of the event    	    |
| parents	  	| `u64`                | Parent nodes in the event DAG  |

Receiving an event with missing parents, the node will issue `EventReq`
requesting the missing parent from a peer.

### Event ID

Is [blake3::Hash](https://docs.rs/blake3/latest/blake3/struct.Hash.html) 
of the event, we use those IDs to request and reply 
events and tips (tips being childless events in the graph).


## P2P Messages

### EventPut

This message serves as a container of the event being published on 
the network.

| Description   | Data Type      	   | Comments           		|
|-------------- | -------------------- | -------------------------- |
| EventPut	  	| `Event`              | Event data.         		|

### EventReq

Requests event data from a peer.

| Description   | Data Type      	   | Comments           		   |
|-------------- | -------------------- | ----------------------------- |
| EventReq	  	| `EventId`            | Request event using its ID.   |

### EventRep

Replys back the requested event's data.

| Description   | Data Type      	   | Comments           		|
|-------------- | -------------------- | -------------------------- |
| EventRep	  	| `Event`              | Reply event data.     		|

### TipReq

Requests tips from connected peers.
We use this message as first step into syncing asking connected peers 
for their DAG's tips.

### TipRep

Replys back our DAG tips' IDs.

| Description   | Data Type      	   | Comments      |
|-------------- | -------------------- | ------------- |
| TipRep	  	| `Vec<EventId>`       | Event IDs.    |