@dcl/protocol 1.0.0-2861824890.commit-748eb8b → 1.0.0-28806326790.commit-6771b13

package/proto/decentraland/kernel/comms/v3/archipelago.proto

@@ -0,0 +1,86 @@
+syntax = "proto3";
+
+import "decentraland/common/vectors.proto";
+
+package decentraland.kernel.comms.v3;
+
+// Server->Client messsages
+message ChallengeResponseMessage {
+  string challenge_to_sign = 1;
+  bool already_connected = 2;
+}
+
+message WelcomeMessage {
+  string peer_id = 1;
+}
+
+message IslandChangedMessage {
+  string island_id = 1;
+  string conn_str = 2;
+  optional string from_island_id = 3;
+  map<string, decentraland.common.Position> peers = 4;
+}
+
+message LeftIslandMessage {
+  string island_id = 1;
+  string peer_id = 2;
+}
+
+message JoinIslandMessage {
+  string island_id = 1;
+  string peer_id = 2;
+}
+
+enum KickedReason {
+  KR_NEW_SESSION = 0;
+}
+
+message KickedMessage {
+  KickedReason reason = 1;
+}
+
+message ServerPacket {
+  oneof message {
+    ChallengeResponseMessage challenge_response = 1;
+    WelcomeMessage welcome = 2;
+    IslandChangedMessage island_changed = 3;
+    LeftIslandMessage  left_island = 4;
+    JoinIslandMessage join_island = 5;
+    KickedMessage kicked = 6;
+  }
+}
+
+// Client->Server messsages
+message ChallengeRequestMessage {
+  string address = 1;
+}
+
+message SignedChallengeMessage {
+  string auth_chain_json = 1;
+}
+
+message Heartbeat {
+  decentraland.common.Position position = 1;
+  optional string desired_room = 2;
+}
+
+message ClientPacket {
+  oneof message {
+    ChallengeRequestMessage challenge_request = 1;
+    SignedChallengeMessage signed_challenge = 2;
+    Heartbeat heartbeat = 3;
+  }
+}
+
+// Others
+message IslandData {
+  string id = 1;
+  repeated string peers = 2;
+  uint32 max_peers = 3;
+  decentraland.common.Position center = 4;
+  double radius = 5;
+}
+
+message IslandStatusMessage {
+  repeated IslandData data = 1;
+}

package/{kernel → proto/decentraland/kernel}/comms/v3/comms.proto

@@ -1,6 +1,6 @@
 syntax = "proto3";
 
-package protocol;
+package decentraland.kernel.comms.v3;
 
 message Position {
     double time = 2;
@@ -17,8 +17,8 @@ message Profile {
     double time = 2;
     string profile_version = 3;
     enum ProfileType {
-        LOCAL = 0;
-        DEPLOYED = 1;
+        PT_LOCAL = 0;
+        PT_DEPLOYED = 1;
     }
     ProfileType profile_type = 4;
 }

package/proto/decentraland/pulse/pulse_client.proto

@@ -0,0 +1,79 @@
+syntax = "proto3";
+
+package decentraland.pulse;
+
+import "decentraland/pulse/pulse_shared.proto";
+import "decentraland/common/options.proto";
+
+message HandshakeRequest {
+	bytes auth_chain = 1;
+  int32 profile_version = 2;
+  optional PlayerInitialState initial_state = 3;
+}
+
+// Describes the initial state of the player if (re-)connected in the middle of the session
+message PlayerInitialState {
+  PlayerState state = 1;
+  optional string emote_id = 2;
+  optional uint32 emote_duration_ms = 3;
+  // Indicates how many milliseconds ago the emote was started
+  optional uint32 emote_start_offset_ms = 4;
+  // Non-empty realm identifier. Rejected if empty.
+  string realm = 5;
+  optional int32 emote_mask = 6;
+}
+
+// Similarly to the LiveKit pipeline, a peer announces the version of its profile but
+// it only does it when it's changed as it's sent reliably and stored on the server for other peers
+message ProfileVersionAnnouncement {
+  int32 version = 1;
+}
+
+// Since the server doesn't simulate the scenes state, it trusts the values from the client
+message PlayerStateInput {
+  PlayerState state = 1;
+}
+
+// Client sends resync request if it has a gap in the known sequences and, thus, can't apply a delta.
+// It's sent reliably to prevent further desynchronization
+message ResyncRequest {
+  uint32 subject_id = 1;
+  // highest seq the client actually has for this subject
+  uint32 known_seq = 2;
+}
+
+// Client → Server. Client requests to start an emote.
+message EmoteStart {
+  string emote_id = 1;
+  optional uint32 duration_ms = 2;
+  PlayerState player_state = 3;
+  optional int32 mask = 4;
+}
+
+// Client → Server. Client requests to stop a looping emote.
+// One-shot emotes are terminated by the server timer.
+message EmoteStop {
+}
+
+// Client → Server. Also announces the peer's realm; peers in different realms never see each
+// other. Must be the first gameplay message after handshake. Same-realm re-teleports are valid.
+message TeleportRequest {
+  int32 parcel_index = 1;
+  uint32 position_x = 2 [(decentraland.common.quantized) = { min: 0, max: 16, bits: 8 }];
+  uint32 position_y = 3 [(decentraland.common.quantized) = { min: 0, max: 200, bits: 13 }];
+  uint32 position_z = 4 [(decentraland.common.quantized) = { min: 0, max: 16, bits: 8 }];
+  // Non-empty realm identifier. Rejected if empty.
+  string realm = 5;
+}
+
+message ClientMessage {
+  oneof message {
+    HandshakeRequest handshake = 1;
+    PlayerStateInput input = 2;
+    ResyncRequest resync = 3;
+    ProfileVersionAnnouncement profile_announcement = 4;
+    EmoteStart emote_start = 5;
+    EmoteStop emote_stop = 6;
+    TeleportRequest teleport = 7;
+  }
+}

package/proto/decentraland/pulse/pulse_server.proto

@@ -0,0 +1,142 @@
+syntax = "proto3";
+
+package decentraland.pulse;
+
+import "decentraland/common/options.proto";
+import "decentraland/pulse/pulse_shared.proto";
+
+message HandshakeResponse {
+  bool success = 1;
+  optional string error = 2;
+}
+
+message PlayerProfileVersionsAnnounced {
+  uint32 subject_id = 1;
+  int32 version = 2;
+}
+
+message PlayerStateDeltaTier0 {
+  uint32 subject_id = 1;
+
+  // Between two consecutive server simulation ticks, the subject may have sent multiple inputs, each incrementing Seq by 1. So
+  // the delta's NewSeq will naturally jump by more than 1 compared to the previous delta — even with zero packet loss.
+  // Without the "BaselineSeq" the client has no way to detect the package loss
+  uint32 baseline_seq = 2;
+  uint32 new_seq = 3;
+  uint32 server_tick = 4;
+
+  // While the player doesn't cross the parcel, this field is omitted from diff
+  optional int32 parcel_index = 5;
+
+  // X position inside the parcel
+  optional uint32 position_x = 6 [(decentraland.common.quantized) = { min:  0,  max:   16, bits: 8 }];
+
+  // Y position
+  optional uint32 position_y = 7 [(decentraland.common.quantized) = { min:  0,  max:   200, bits: 13 }];
+
+  // Z position inside the parcel
+  optional uint32 position_z = 8 [(decentraland.common.quantized) = { min:  0,  max:   16, bits: 8 }];
+
+  // Power-law quantized: a sign bit + 7-bit magnitude curve over [-50, 50]. Zero is exactly
+  // representable (a stopped peer reports an exact 0 instead of the linear quantizer's ±0.196
+  // residual that drove foreign-avatar drift), and pow=2 concentrates resolution at the low speeds
+  // where avatars actually move, leaving only the visually-irrelevant extremes coarse.
+  optional uint32 velocity_x = 9 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+  optional uint32 velocity_y = 10 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+  optional uint32 velocity_z = 11 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+
+  optional uint32 rotation_y = 12 [(decentraland.common.quantized) = { min:  0,  max:   360.0, bits: 7 }];
+  optional uint32 movement_blend = 13 [(decentraland.common.quantized) = { min:  0,  max:   3, bits: 5 }];
+  optional uint32 slide_blend = 14 [(decentraland.common.quantized) = { min:  0,  max:   1, bits: 4 }];
+  optional uint32 head_yaw = 15 [(decentraland.common.quantized) = { min:  0,  max:   360.0, bits: 7 }];
+  optional uint32 head_pitch = 16 [(decentraland.common.quantized) = { min:  0,  max:   360.0, bits: 7 }];
+
+  optional uint32 state_flags = 17;
+  optional GlideState glide_state = 18;
+
+  optional int32 jump_count = 19;
+
+  // Absolute world hit position the player is pointing at.
+  // Only meaningful when POINTING_AT is set in `state_flags`.
+  //
+  // X/Z use 17 bits over the world span (~±3000m, covers GenesisCity + border +
+  // raycast cutoff) which yields ~0.046m steps — at least as fine as the player's
+  // own parcel_index + position_x/z combined precision (0.0625m), so no separate
+  // parcel index is needed for point-at.
+  //
+  // Y uses 7 bits over the player altitude range (matches position_y), step ~1.6m.
+  // Point At is not supposed to change frequently so the wire overhead should be minimal
+  optional uint32 point_at_x = 20 [(decentraland.common.quantized) = { min: -3000.0, max: 3000.0, bits: 17 }];
+  optional uint32 point_at_y = 21 [(decentraland.common.quantized) = { min:     0.0, max:  200.0, bits:  7 }];
+  optional uint32 point_at_z = 22 [(decentraland.common.quantized) = { min: -3000.0, max: 3000.0, bits: 17 }];
+}
+
+// Full State is sent to the client when it is out of sync, and can't recover with a diff only
+message PlayerStateFull {
+  uint32 subject_id = 1;
+  uint32 sequence = 2;
+  uint32 server_tick = 3;
+  PlayerState state = 4;
+}
+
+// Notification to the client, that a peer has joined, it can mean connection or entering the area of interest, it's up to the server to decide
+message PlayerJoined {
+  string user_id = 1;
+  int32 profile_version = 2;
+  PlayerStateFull state = 3;
+}
+
+// Notification to the client, that a peer has left, it can mean disconnection or leaving the area of interest
+message PlayerLeft {
+  uint32 subject_id = 1;
+}
+
+enum EmoteStopReason {
+  COMPLETED = 0;  // one-shot timer expired on the server
+  CANCELLED = 1;  // client sent EmoteStop (looping emotes)
+}
+
+// Server → All Observers
+// Full player state is piggybacked to ensure the emote is played in the right place.
+// Observers use server_tick to scrub animation forward by transit latency.
+message EmoteStarted {
+  uint32 subject_id = 1;
+  uint32 sequence = 2;
+  uint32 server_tick = 3;
+  string emote_id = 4;
+  PlayerState player_state = 5;
+  optional int32 mask = 6;
+}
+
+// Server → All Observers
+// Client resumes MovementInput only after receiving this.
+// Carries full PlayerState so the client can snap to the correct position on resume.
+message EmoteStopped {
+  uint32 subject_id = 1;
+  uint32 server_tick = 2;
+  EmoteStopReason reason = 3;
+  uint32 sequence = 4;
+  PlayerState player_state = 5;
+}
+
+// Server → All Observers
+message TeleportPerformed {
+  uint32 subject_id = 1;
+  uint32 sequence = 2;
+  uint32 server_tick = 3;
+  PlayerState state = 4;
+}
+
+message ServerMessage {
+  oneof message {
+      HandshakeResponse handshake = 1;
+      PlayerStateFull player_state_full = 2;
+      PlayerStateDeltaTier0 player_state_delta = 3;
+      PlayerJoined player_joined = 4;
+      PlayerLeft player_left = 5;
+      PlayerProfileVersionsAnnounced player_profile_version_announced = 6;
+      EmoteStarted emote_started = 7;
+      EmoteStopped emote_stopped = 8;
+      TeleportPerformed teleported = 9;
+  }
+}

package/proto/decentraland/pulse/pulse_shared.proto

@@ -0,0 +1,57 @@
+syntax = "proto3";
+
+package decentraland.pulse;
+
+import "decentraland/common/options.proto";
+
+enum PlayerAnimationFlags {
+  NONE = 0;
+  GROUNDED = 1;
+  LONG_JUMP = 2;
+  LONG_FALL = 4;
+  FALLING = 8;
+  STUNNED = 16;
+  HEAD_YAW = 32;
+  HEAD_PITCH = 64;
+  POINTING_AT = 128;
+}
+
+enum GlideState {
+  PROP_CLOSED = 0;
+  OPENING_PROP = 1;
+  GLIDING = 2;
+  CLOSING_PROP = 3;
+}
+
+// Quantized identically to PlayerStateDeltaTier0 so a full state and a stream of deltas land on the same grid.
+message PlayerState {
+  int32 parcel_index = 1;
+
+  // Position inside the parcel (X/Z) and world altitude (Y).
+  uint32 position_x = 2 [(decentraland.common.quantized) = { min: 0, max: 16, bits: 8 }];
+  uint32 position_y = 3 [(decentraland.common.quantized) = { min: 0, max: 200, bits: 13 }];
+  uint32 position_z = 4 [(decentraland.common.quantized) = { min: 0, max: 16, bits: 8 }];
+
+  uint32 velocity_x = 5 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+  uint32 velocity_y = 6 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+  uint32 velocity_z = 7 [(decentraland.common.quantized_power) = { max: 50, pow: 2, bits: 8 }];
+
+  uint32 rotation_y = 8 [(decentraland.common.quantized) = { min: 0, max: 360.0, bits: 7 }];
+
+  uint32 movement_blend = 9 [(decentraland.common.quantized) = { min: 0, max: 3, bits: 5 }];
+  uint32 slide_blend = 10 [(decentraland.common.quantized) = { min: 0, max: 1, bits: 4 }];
+
+  optional uint32 head_yaw = 11 [(decentraland.common.quantized) = { min: 0, max: 360.0, bits: 7 }];
+  optional uint32 head_pitch = 12 [(decentraland.common.quantized) = { min: 0, max: 360.0, bits: 7 }];
+
+  uint32 state_flags = 13;
+  GlideState glide_state = 14;
+
+  int32 jump_count = 15;
+
+  // Absolute world hit position the player is pointing at.
+  // Only meaningful when POINTING_AT is set in `state_flags`.
+  optional uint32 point_at_x = 16 [(decentraland.common.quantized) = { min: -3000.0, max: 3000.0, bits: 17 }];
+  optional uint32 point_at_y = 17 [(decentraland.common.quantized) = { min:     0.0, max:  200.0, bits:  7 }];
+  optional uint32 point_at_z = 18 [(decentraland.common.quantized) = { min: -3000.0, max: 3000.0, bits: 17 }];
+}

package/proto/decentraland/quests/definitions.proto

@@ -0,0 +1,185 @@
+syntax = "proto3";
+package decentraland.quests;
+
+import "google/protobuf/empty.proto";
+
+// Errors 
+message InvalidQuest {}
+
+message NotUUID {}
+
+message InternalServerError {}
+
+message NotFoundQuestInstance {}
+
+message QuestAlreadyStarted {}
+
+message NotOwner {}
+
+message IgnoredEvent {}
+
+message StartQuestRequest {
+  string quest_id = 1;
+}
+
+message StartQuestResponse {
+  /* There are a few valid reasons to not be accepted:
+  *  - Quest is not found
+  *  - Quest is deactivated (the owner deleted it)
+  *  - User already started the quest
+  *  - Internal errors (DB connection failed or something like that) */
+  message Accepted {}
+  oneof response {
+    Accepted accepted = 1;
+    InvalidQuest invalid_quest = 2;
+    NotUUID not_uuid_error = 3;
+    InternalServerError internal_server_error = 4;
+    QuestAlreadyStarted quest_already_started = 5;
+  }
+}
+
+message AbortQuestRequest {
+  string quest_instance_id = 1;
+}
+
+message AbortQuestResponse {
+  /* There are a few valid reasons to not be accepted:
+  *  - Quest instance is not found
+  *  - Quest instance is from another user 
+  *  - Quest instance already aborted
+  *  - Internal errors (DB connection failed or something like that) */
+  message Accepted {}
+  oneof response {
+    Accepted accepted = 1;
+    NotFoundQuestInstance not_found_quest_instance = 2;
+    NotUUID not_uuid_error = 3;
+    NotOwner not_owner = 4;
+    InternalServerError internal_server_error = 5;
+  }
+}
+
+message Event {
+  string id = 1;
+  string address = 2;
+  Action action = 3;
+}
+
+message EventRequest {
+  Action action = 1;
+}
+
+message EventResponse {
+  oneof response {
+    string accepted_event_id = 1;
+    IgnoredEvent ignored_event = 2;
+    InternalServerError internal_server_error = 3;
+  }
+}
+
+message QuestDefinition {
+  repeated Step steps = 1;
+  repeated Connection connections = 2;
+}
+
+message Connection {
+  string step_from = 1;
+  string step_to = 2;
+}
+
+message Step {
+  string id = 1;
+  string description = 2;
+  repeated Task tasks = 3;
+}
+
+message Action {
+  string type = 1;
+  map<string, string> parameters = 2;
+}
+
+message Task {
+  string id = 1;
+  string description = 2;
+  repeated Action action_items = 3;
+}
+
+message StepContent {
+  repeated Task to_dos = 1;
+  repeated Task tasks_completed = 2;
+}
+
+message QuestState {
+  map<string, StepContent> current_steps = 2;
+  fixed32 steps_left = 3;
+  repeated string steps_completed = 4;
+  repeated string required_steps = 5;
+}
+
+message Quest {
+  string id = 1;
+  string name = 2;
+  string description = 3;
+  QuestDefinition definition = 4;
+  string creator_address = 5;
+  string image_url = 6;
+  bool active = 7;
+  fixed32 created_at = 8;
+}
+
+message QuestInstance {
+  string id = 1;
+  Quest quest = 2;
+  QuestState state = 3;
+}
+
+message QuestStateUpdate {
+  string instance_id = 1;
+  QuestState quest_state = 2;
+  string event_id = 3;
+}
+
+message UserUpdate {
+  oneof message {
+    bool subscribed = 1;
+    QuestStateUpdate quest_state_update = 2;
+    QuestInstance new_quest_started = 3;
+    string event_ignored = 4;
+  }
+  string user_address = 5;
+}
+
+message Quests {
+  repeated QuestInstance instances = 1;
+}
+
+message GetAllQuestsResponse {
+  oneof response {
+    Quests quests = 1;
+    InternalServerError internal_server_error = 2;
+  }
+}
+
+message GetQuestDefinitionRequest {
+  string quest_id = 1;
+}
+
+message GetQuestDefinitionResponse {
+  oneof response {
+    Quest quest = 1;
+    InternalServerError internal_server_error = 2;
+  }
+}
+
+service QuestsService {
+  // User actions
+  rpc StartQuest(StartQuestRequest) returns (StartQuestResponse) {}
+  rpc AbortQuest(AbortQuestRequest) returns (AbortQuestResponse) {}
+  rpc SendEvent(EventRequest) returns (EventResponse) {}
+
+  // Listen to changes in quest states and event processing updates
+  rpc Subscribe(google.protobuf.Empty) returns (stream UserUpdate) {}
+
+  // Query quest information
+  rpc GetAllQuests(google.protobuf.Empty) returns (GetAllQuestsResponse) {}
+  rpc GetQuestDefinition(GetQuestDefinitionRequest) returns (GetQuestDefinitionResponse) {}
+}

package/proto/decentraland/realm/about.proto

@@ -0,0 +1,138 @@
+syntax = "proto3";
+package decentraland.realm;
+
+import "decentraland/common/border_rect.proto";
+import "decentraland/common/vectors.proto";
+
+message AboutResponse {
+  bool healthy = 1;
+  AboutConfiguration configurations = 2;
+  ContentInfo content = 3;
+  CommsInfo comms = 4;
+  LambdasInfo lambdas = 5;
+  optional BffInfo bff = 6;
+  bool accepting_users = 7;
+
+  // @deprecated This message was never used but it's still here for compatibility reasons
+  // The reserved keyword is not working for all the toolset we have, so in the meanwhile it keeps commented
+  message MinimapConfiguration {
+    reserved 1;
+    // reserved "enabled";
+    reserved 2;
+    // reserved "data_image";
+    reserved 3;
+    // reserved "estate_image";
+  }
+
+  message MapConfiguration {
+    // whether the minimap should be rendered
+    bool minimap_enabled = 1;
+  
+    // the union of all rects here represents the places where that MAY have scenes
+    //  - all the other parcels are considered as empty, up to the explorer to decide if they're walkable or not
+    //  - the contained square is determined by points: 
+    //    - top-left      with  minX, maxY 
+    //    - bottom-left   with  minX, minY
+    //    - top-right     with  maxX, maxY 
+    //    - bottom-right  with  maxX, maxY 
+    //  Note: the coordinate system used is the Cartesian coordinate system, where the y-axis increases upwards, 
+    //    not the screen coordinate system, where the origin is at the top-left corner and the y-axis increases downwards.
+    repeated decentraland.common.BorderRect sizes = 2; 
+  
+    // ImageViewWithZoomLevel uses a description to render the minimap
+    //  using different images with different zoom levels.
+    // When `version='v1'`:
+    // - The description allows the explorer to form the URL:
+    //  url(x,y,zoom_level) = `{base_url}/{zoom_level}/{x},{y}{suffix_url}`
+    // - The given URL is for an image where the pixel `0,0` for the image `0,0` always
+    //    points to the top-left contained square.
+    // - The `zoom_level=1` is to a ratio of 3.2 pixel per parcel, this means in a 32x32 pixel square
+    //    you get 10x10 parcels. 
+    // - Each increase of zoom level, double the ratio pixel per parcels. 
+    message ImageViewWithZoomLevel {
+      // options: ['v1']
+      string version = 1; 
+      optional string base_url = 2;
+      optional string suffix_url = 3;
+      optional decentraland.common.Vector2 top_left_offset = 4;
+    }
+  
+    // ParcelView uses a description to render the minimap
+    //  using a image where each pixel is a parcel and each pixel
+    //  has the metadata to make a representation (using a shader or image-generation client-side)
+    // When `version='v1'`:
+    //  - The pixel `0,0` is the top-left contained square
+    //  - The image has to be at least of contained square pixels size
+    //  - The metadata inside each pixel follows the generated with the atlas server https://github.com/decentraland/atlas-server/blob/af371f2a59745a1f50b0b0b2382984288c4ae891/src/adapters/mini-map-renderer.ts#L27
+    message ParcelView {
+      // options: `v1`
+      string version = 1; 
+      optional string image_url = 2;
+    }
+  
+    optional ImageViewWithZoomLevel satellite_view = 5;
+    optional ParcelView parcel_view = 6;
+    optional ImageViewWithZoomLevel thumbnail_view = 7;
+  }
+
+  message SkyboxConfiguration {
+    // only one value at a time
+    optional float fixed_hour = 1;
+  }
+
+  message AboutConfiguration {
+    optional string realm_name = 1;
+    uint32 network_id = 2;
+    repeated string global_scenes_urn = 3;
+    repeated string scenes_urn = 4;
+
+    // The name "minimap" can't be used in this message
+    // The reserved keyword is not working for all the toolset we have, so in the meanwhile it keeps commented
+    reserved 5;
+    // reserved "minimap";
+
+    optional SkyboxConfiguration skybox = 6;
+
+    // A content server to be used to load the parcels around the user. Uses the POST /entities/active endpoint
+    // to continously fetch the parcels around the users. if null, then the default content server will be used
+    // if == "" then the city_loader will be disabled and the scenes_urn will be used to load the world
+    optional string city_loader_content_server = 7;
+    optional MapConfiguration map = 8;
+  }
+
+  message ContentInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+  }
+  message LambdasInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+  }
+  message CommsInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    optional string public_url = 4;
+    // specific properties
+    string protocol = 50;
+    optional int32 users_count = 51;
+    optional string fixed_adapter = 52;
+  }
+  message BffInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+    // specific properties
+    optional int32 user_count = 51;
+    optional string protocol_version = 52;
+  }
+}