Deployment Platform/Sneakernet/Packets format

Packets format

Packets are tarball files with .packet suffix.

On logic level, every packet consists of:

• one header, a dictionary of key-value pairs;
• records, a dictionary of key-value pairs and optional data depending on record type.

Header

Header is being stored in JSON notation in /header file in packet tarball.

• src, sender's GUID
• dst, optional destination GUID
• filename, suggested file name for packet file, it is assumed to be unique

Record types

• sn_push:

• cmd: sn_push
• src: sender's identity to push from
• [dst]: receiver's identity to push to, optional for packets from master
• sequence: Sequence associated with packet's payload

• ACK packet:

• type: ack
• src: master's identity
• dst: receiver's identity ack is intended for
• push_sequence: original PUSH packet's sequence
• pull_sequence: Sequence after merging original PUSH packet

• PULL packet:

• type: pull
• src: sender's identity to pull to
• dst: receiver's identity to pull from
• sequence: Sequence to pull for