@dcl/protocol 1.0.0-29286492043.commit-0010e70 → 1.0.0-29287211316.commit-e44c721

package/out-ts/decentraland/kernel/comms/rfc4/comms.gen.ts

@@ -137,6 +137,36 @@ export interface PlayerEmote {
   incrementalId: number;
   urn: string;
   timestamp: number;
+  /** true means the emote has been stopped in the sender's client */
+  isStopping?:
+    | boolean
+    | undefined;
+  /** true when it is not the first time the looping animation plays */
+  isRepeating?:
+    | boolean
+    | undefined;
+  /** identifies an interaction univocaly, established when the start animation is triggered */
+  interactionId?:
+    | number
+    | undefined;
+  /** -1 means it does not use an outcome animation */
+  socialEmoteOutcome?:
+    | number
+    | undefined;
+  /** to a social emote started by other user */
+  isReacting?:
+    | boolean
+    | undefined;
+  /** wallet address of the user that initiated social emote */
+  socialEmoteInitiator?:
+    | string
+    | undefined;
+  /** wallet address of the user whose avatar is the target of a directed emote */
+  targetAvatar?:
+    | string
+    | undefined;
+  /** mask for which bones an animation applies to. */
+  mask?: number | undefined;
 }
 
 export interface SceneEmote {
@@ -161,6 +191,11 @@ export interface ProfileResponse {
 export interface Chat {
   message: string;
   timestamp: number;
+  /**
+   * Extension: optional forwarded_from to identify the original sender when
+   * messages are forwarded through an SFU
+   */
+  forwardedFrom?: string | undefined;
 }
 
 export interface Scene {
@@ -1287,7 +1322,19 @@ export namespace MovementCompressed {
 }
 
 function createBasePlayerEmote(): PlayerEmote {
-  return { incrementalId: 0, urn: "", timestamp: 0 };
+  return {
+    incrementalId: 0,
+    urn: "",
+    timestamp: 0,
+    isStopping: undefined,
+    isRepeating: undefined,
+    interactionId: undefined,
+    socialEmoteOutcome: undefined,
+    isReacting: undefined,
+    socialEmoteInitiator: undefined,
+    targetAvatar: undefined,
+    mask: undefined,
+  };
 }
 
 export namespace PlayerEmote {
@@ -1301,6 +1348,30 @@ export namespace PlayerEmote {
     if (message.timestamp !== 0) {
       writer.uint32(29).float(message.timestamp);
     }
+    if (message.isStopping !== undefined) {
+      writer.uint32(32).bool(message.isStopping);
+    }
+    if (message.isRepeating !== undefined) {
+      writer.uint32(40).bool(message.isRepeating);
+    }
+    if (message.interactionId !== undefined) {
+      writer.uint32(48).int32(message.interactionId);
+    }
+    if (message.socialEmoteOutcome !== undefined) {
+      writer.uint32(56).int32(message.socialEmoteOutcome);
+    }
+    if (message.isReacting !== undefined) {
+      writer.uint32(64).bool(message.isReacting);
+    }
+    if (message.socialEmoteInitiator !== undefined) {
+      writer.uint32(74).string(message.socialEmoteInitiator);
+    }
+    if (message.targetAvatar !== undefined) {
+      writer.uint32(82).string(message.targetAvatar);
+    }
+    if (message.mask !== undefined) {
+      writer.uint32(88).uint32(message.mask);
+    }
     return writer;
   }
 
@@ -1332,6 +1403,62 @@ export namespace PlayerEmote {
 
           message.timestamp = reader.float();
           continue;
+        case 4:
+          if (tag !== 32) {
+            break;
+          }
+
+          message.isStopping = reader.bool();
+          continue;
+        case 5:
+          if (tag !== 40) {
+            break;
+          }
+
+          message.isRepeating = reader.bool();
+          continue;
+        case 6:
+          if (tag !== 48) {
+            break;
+          }
+
+          message.interactionId = reader.int32();
+          continue;
+        case 7:
+          if (tag !== 56) {
+            break;
+          }
+
+          message.socialEmoteOutcome = reader.int32();
+          continue;
+        case 8:
+          if (tag !== 64) {
+            break;
+          }
+
+          message.isReacting = reader.bool();
+          continue;
+        case 9:
+          if (tag !== 74) {
+            break;
+          }
+
+          message.socialEmoteInitiator = reader.string();
+          continue;
+        case 10:
+          if (tag !== 82) {
+            break;
+          }
+
+          message.targetAvatar = reader.string();
+          continue;
+        case 11:
+          if (tag !== 88) {
+            break;
+          }
+
+          message.mask = reader.uint32();
+          continue;
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -1346,6 +1473,14 @@ export namespace PlayerEmote {
       incrementalId: isSet(object.incrementalId) ? Number(object.incrementalId) : 0,
       urn: isSet(object.urn) ? String(object.urn) : "",
       timestamp: isSet(object.timestamp) ? Number(object.timestamp) : 0,
+      isStopping: isSet(object.isStopping) ? Boolean(object.isStopping) : undefined,
+      isRepeating: isSet(object.isRepeating) ? Boolean(object.isRepeating) : undefined,
+      interactionId: isSet(object.interactionId) ? Number(object.interactionId) : undefined,
+      socialEmoteOutcome: isSet(object.socialEmoteOutcome) ? Number(object.socialEmoteOutcome) : undefined,
+      isReacting: isSet(object.isReacting) ? Boolean(object.isReacting) : undefined,
+      socialEmoteInitiator: isSet(object.socialEmoteInitiator) ? String(object.socialEmoteInitiator) : undefined,
+      targetAvatar: isSet(object.targetAvatar) ? String(object.targetAvatar) : undefined,
+      mask: isSet(object.mask) ? Number(object.mask) : undefined,
     };
   }
 
@@ -1354,6 +1489,14 @@ export namespace PlayerEmote {
     message.incrementalId !== undefined && (obj.incrementalId = Math.round(message.incrementalId));
     message.urn !== undefined && (obj.urn = message.urn);
     message.timestamp !== undefined && (obj.timestamp = message.timestamp);
+    message.isStopping !== undefined && (obj.isStopping = message.isStopping);
+    message.isRepeating !== undefined && (obj.isRepeating = message.isRepeating);
+    message.interactionId !== undefined && (obj.interactionId = Math.round(message.interactionId));
+    message.socialEmoteOutcome !== undefined && (obj.socialEmoteOutcome = Math.round(message.socialEmoteOutcome));
+    message.isReacting !== undefined && (obj.isReacting = message.isReacting);
+    message.socialEmoteInitiator !== undefined && (obj.socialEmoteInitiator = message.socialEmoteInitiator);
+    message.targetAvatar !== undefined && (obj.targetAvatar = message.targetAvatar);
+    message.mask !== undefined && (obj.mask = Math.round(message.mask));
     return obj;
   }
 
@@ -1366,6 +1509,14 @@ export namespace PlayerEmote {
     message.incrementalId = object.incrementalId ?? 0;
     message.urn = object.urn ?? "";
     message.timestamp = object.timestamp ?? 0;
+    message.isStopping = object.isStopping ?? undefined;
+    message.isRepeating = object.isRepeating ?? undefined;
+    message.interactionId = object.interactionId ?? undefined;
+    message.socialEmoteOutcome = object.socialEmoteOutcome ?? undefined;
+    message.isReacting = object.isReacting ?? undefined;
+    message.socialEmoteInitiator = object.socialEmoteInitiator ?? undefined;
+    message.targetAvatar = object.targetAvatar ?? undefined;
+    message.mask = object.mask ?? undefined;
     return message;
   }
 }
@@ -1642,7 +1793,7 @@ export namespace ProfileResponse {
 }
 
 function createBaseChat(): Chat {
-  return { message: "", timestamp: 0 };
+  return { message: "", timestamp: 0, forwardedFrom: undefined };
 }
 
 export namespace Chat {
@@ -1653,6 +1804,9 @@ export namespace Chat {
     if (message.timestamp !== 0) {
       writer.uint32(17).double(message.timestamp);
     }
+    if (message.forwardedFrom !== undefined) {
+      writer.uint32(26).string(message.forwardedFrom);
+    }
     return writer;
   }
 
@@ -1677,6 +1831,13 @@ export namespace Chat {
 
           message.timestamp = reader.double();
           continue;
+        case 3:
+          if (tag !== 26) {
+            break;
+          }
+
+          message.forwardedFrom = reader.string();
+          continue;
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -1690,6 +1851,7 @@ export namespace Chat {
     return {
       message: isSet(object.message) ? String(object.message) : "",
       timestamp: isSet(object.timestamp) ? Number(object.timestamp) : 0,
+      forwardedFrom: isSet(object.forwardedFrom) ? String(object.forwardedFrom) : undefined,
     };
   }
 
@@ -1697,6 +1859,7 @@ export namespace Chat {
     const obj: any = {};
     message.message !== undefined && (obj.message = message.message);
     message.timestamp !== undefined && (obj.timestamp = message.timestamp);
+    message.forwardedFrom !== undefined && (obj.forwardedFrom = message.forwardedFrom);
     return obj;
   }
 
@@ -1708,6 +1871,7 @@ export namespace Chat {
     const message = createBaseChat();
     message.message = object.message ?? "";
     message.timestamp = object.timestamp ?? 0;
+    message.forwardedFrom = object.forwardedFrom ?? undefined;
     return message;
   }
 }

package/out-ts/decentraland/sdk/components/avatar_shape.gen.ts

@@ -5,6 +5,40 @@ import { Color3 } from "../../common/colors.gen";
 
 export const protobufPackage = "decentraland.sdk.components";
 
+/** Mask for which bones an animation applies to. */
+export enum AvatarEmoteMask {
+  AEM_FULL_BODY = 0,
+  AEM_UPPER_BODY = 1,
+  UNRECOGNIZED = -1,
+}
+
+export function avatarEmoteMaskFromJSON(object: any): AvatarEmoteMask {
+  switch (object) {
+    case 0:
+    case "AEM_FULL_BODY":
+      return AvatarEmoteMask.AEM_FULL_BODY;
+    case 1:
+    case "AEM_UPPER_BODY":
+      return AvatarEmoteMask.AEM_UPPER_BODY;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AvatarEmoteMask.UNRECOGNIZED;
+  }
+}
+
+export function avatarEmoteMaskToJSON(object: AvatarEmoteMask): string {
+  switch (object) {
+    case AvatarEmoteMask.AEM_FULL_BODY:
+      return "AEM_FULL_BODY";
+    case AvatarEmoteMask.AEM_UPPER_BODY:
+      return "AEM_UPPER_BODY";
+    case AvatarEmoteMask.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 /**
  * The AvatarShape component contains the information required to draw and animate avatar, acting as
  * a simplified GLTF container for this specific case.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl/protocol",
-  "version": "1.0.0-29286492043.commit-0010e70",
+  "version": "1.0.0-29287211316.commit-e44c721",
   "description": "",
   "repository": {
     "type": "git",
@@ -13,10 +13,11 @@
   "license": "Apache-2.0",
   "main": "index.js",
   "scripts": {
-    "test": "./scripts/check-proto-compabitility.sh"
+    "test": "./scripts/check-proto-compabitility.sh",
+    "gen:test": "node protoc-gen-bitwise/test/generator.test.js"
   },
   "devDependencies": {
-    "@protobuf-ts/protoc": "^2.8.1",
+    "@protobuf-ts/protoc": "^2.11.0",
     "proto-compatibility-tool": "^1.1.2-20220925163655.commit-25bd040",
     "typescript": "^5.0.4"
   },
@@ -28,10 +29,12 @@
     "protobufjs": "7.2.4"
   },
   "files": [
-    "proto",
+    "proto/decentraland",
     "out-ts",
     "out-js",
-    "public"
+    "public",
+    "protoc-gen-bitwise/*.js",
+    "protoc-gen-bitwise/runtime"
   ],
-  "commit": "0010e703bec8702bbe2d5e5282c619220c2c1ca6"
+  "commit": "e44c721a034709fc47b820be81b5c977f9085ae6"
 }

package/proto/decentraland/common/options.proto

@@ -0,0 +1,51 @@
+syntax = "proto3";
+
+package decentraland.common;
+
+import "google/protobuf/descriptor.proto";
+
+// Options for quantizing a float value stored as a uint32 field.
+// The float is clamped to [min, max] and uniformly quantized to N bits;
+// protobuf encodes the resulting uint32 as a varint on the wire.
+// The generator emits a float {Name}Quantized accessor in the partial class.
+message QuantizedFloatOptions {
+  float  min  = 1;
+  float  max  = 2;
+  uint32 bits = 3;
+}
+
+// Options for quantizing a signed float with a power-law curve, stored as a uint32 field.
+// The value is split into an (bits-1)-bit linear unorm magnitude `u in [0, 1]` plus a sign,
+// and reconstructed as `value = sign * max * u^pow`. Because `u = 0` maps to exactly `0`, zero is
+// representable (unlike the linear quantizer, whose codes straddle zero), and `pow > 1` concentrates
+// resolution near zero — useful for fields like velocity that need fine detail at low magnitudes and
+// only coarse detail near the extremes. The range is symmetric ([-max, max]); there is no `min`.
+// The encoded layout puts the magnitude in the high bits and the sign in the LSB
+// (`(magnitude << 1) | sign`), so the varint cost tracks magnitude, not direction: a small `|value|`
+// of either sign stays in one varint byte. Zero canonicalizes to `0`, so proto3 omits a stopped field.
+// The generator emits a float {Name}Quantized accessor, same as the linear option.
+message QuantizedPowerFloatOptions {
+  float  max  = 1;
+  float  pow  = 2;
+  uint32 bits = 3;
+}
+
+// Options for bit-packing an integer field into fewer than 32 bits.
+message BitPackedOptions {
+  uint32 bits = 1;
+}
+
+extend google.protobuf.FieldOptions {
+  // Apply to uint32 fields to enable quantized float encoding.
+  // Example: uint32 dx = 1 [(decentraland.common.quantized) = { min: -100.0, max: 100.0, bits: 16 }];
+  QuantizedFloatOptions quantized  = 50001;
+
+  // Apply to uint32 fields to pack into fewer bits.
+  // Example: uint32 entity_id = 4 [(decentraland.common.bit_packed) = { bits: 20 }];
+  BitPackedOptions      bit_packed = 50002;
+
+  // Apply to uint32 fields to enable power-law quantized float encoding (sign + magnitude curve).
+  // A field carries either `quantized` or `quantized_power`, not both.
+  // Example: uint32 velocity_x = 9 [(decentraland.common.quantized_power) = { max: 50.0, pow: 2.0, bits: 8 }];
+  QuantizedPowerFloatOptions quantized_power = 50003;
+}

package/proto/decentraland/common/quantization_example.proto

@@ -0,0 +1,164 @@
+syntax = "proto3";
+
+package decentraland.common;
+
+import "decentraland/common/options.proto";
+
+// High-frequency player state messages sent on Channel 1 (unreliable sequenced).
+//
+// Every message below uses the protoc-gen-bitwise annotations to minimise
+// wire size.  Wire costs are listed per-message so the trade-offs are clear.
+//
+// Annotation cheat-sheet:
+//   [(decentraland.common.quantized)  = { min: F, max: F, bits: N }]
+//       → stores a float as a uint32 quantized to N bits over [min, max].
+//       → protobuf encodes the uint32 as a varint: values ≤ 2^14-1 cost 2 bytes,
+//         values ≤ 2^21-1 cost 3 bytes; the generated partial class adds a
+//         float {Name}Quantized accessor that encodes/decodes transparently.
+//   [(decentraland.common.quantized_power) = { max: F, pow: F, bits: N }]
+//       → stores a signed float over [-max, max] as an (N-1)-bit linear unorm
+//         magnitude (high bits) plus a sign (LSB), reconstructed as sign·max·u^pow.
+//         Zero is exact, and pow>1 buys fine resolution near zero at the cost of
+//         coarse near ±max. Putting the sign in the LSB keeps a small |value| of
+//         either direction in one varint byte. Same generated float {Name}Quantized
+//         accessor as the linear option.
+//   [(decentraland.common.bit_packed) = { bits: N }]
+//       → documents that this uint32 uses at most N bits; protobuf encodes it
+//         as a varint (same savings, no generated accessor needed).
+//   (no annotation)
+//       → standard protobuf encoding (bool/double/etc. at natural width).
+//
+// Varint byte costs at worst-case (all bits set):
+//   ≤ 7 bits  → 1 byte   (max 127)
+//   ≤ 14 bits → 2 bytes  (max 16 383)
+//   ≤ 21 bits → 3 bytes  (max 2 097 151)
+// Proto3 omits fields equal to their default value (0), so average cost is lower.
+
+// ---------------------------------------------------------------------------
+// PositionDelta — Δ position relative to last acknowledged full snapshot.
+//
+// Sent every client tick (~10 Hz) on Channel 1.
+//
+//  Field       | Type   | Range          | Q bits | Wire worst-case
+//  ------------|--------|----------------|--------|-----------------------
+//  dx          | uint32 | [-100, 100]    |   16   | tag 1B + varint 3B = 4B
+//  dy          | uint32 | [-100, 100]    |   16   | tag 1B + varint 3B = 4B
+//  dz          | uint32 | [-100, 100]    |   16   | tag 1B + varint 3B = 4B
+//  entity_id   | uint32 | [0, 1 048 575] |   20   | tag 1B + varint 3B = 4B
+//  sequence    | uint32 | [0,     4 095] |   12   | tag 1B + varint 2B = 3B
+//  ---------------------------------------------------------------------------
+//  Worst-case: 19 B  (vs. 20 B raw: 3×float + 2×uint32)
+//  Step: dx/dy/dz ≈ 0.003 units
+// ---------------------------------------------------------------------------
+message PositionDelta {
+  uint32 dx        = 1 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+  uint32 dy        = 2 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+  uint32 dz        = 3 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+  uint32 entity_id = 4 [(decentraland.common.bit_packed) = { bits: 20 }];
+  uint32 sequence  = 5 [(decentraland.common.bit_packed) = { bits: 12 }];
+}
+
+// ---------------------------------------------------------------------------
+// PlayerInput — client input snapshot for server-side reconciliation.
+//
+// Sent every client frame (~30 Hz) on Channel 1.
+//
+//  Field       | Type   | Range          | Q bits | Wire worst-case
+//  ------------|--------|----------------|--------|-----------------------
+//  move_x      | uint32 | [-1, 1]        |    8   | tag 1B + varint 2B = 3B
+//  move_z      | uint32 | [-1, 1]        |    8   | tag 1B + varint 2B = 3B
+//  yaw         | uint32 | [-180, 180]    |   12   | tag 1B + varint 2B = 3B
+//  buttons     | uint32 | bitmask        |    8   | tag 1B + varint 2B = 3B
+//  sequence    | uint32 | [0, 4 095]     |   12   | tag 1B + varint 2B = 3B
+//  ---------------------------------------------------------------------------
+//  Worst-case: 15 B  (vs. 20 B raw: 3×float + 2×uint32)
+//  Step: move_x/move_z ≈ 0.008; yaw ≈ 0.088°
+// ---------------------------------------------------------------------------
+message PlayerInput {
+  // Normalised joystick axes in [-1, 1].
+  uint32 move_x   = 1 [(decentraland.common.quantized)  = { min: -1.0,   max: 1.0,   bits:  8 }];
+  uint32 move_z   = 2 [(decentraland.common.quantized)  = { min: -1.0,   max: 1.0,   bits:  8 }];
+
+  // Horizontal look direction in degrees.
+  uint32 yaw      = 3 [(decentraland.common.quantized)  = { min: -180.0, max: 180.0, bits: 12 }];
+
+  // Bitmask of active buttons (see ButtonFlags below).
+  uint32 buttons  = 4 [(decentraland.common.bit_packed) = { bits:  8 }];
+
+  // Rolling input sequence number used by the server for reconciliation.
+  uint32 sequence = 5 [(decentraland.common.bit_packed) = { bits: 12 }];
+}
+
+// ---------------------------------------------------------------------------
+// VelocityState — per-axis velocity, demonstrating the power-law quantizer.
+//
+// Velocity needs an exact zero (a stopped avatar must read 0, not a quantization
+// residual, or it drifts) and fine resolution at locomotion speeds, but only
+// coarse resolution near the ±50 m/s extremes. The linear quantizer can give
+// none of these from 8 bits: its codes straddle zero (±0.196) and spend uniform
+// resolution on speeds that never occur. quantized_power solves all three.
+//
+//  Field  | Type   | Range      | pow | bits | Wire worst-case
+//  -------|--------|------------|-----|------|-----------------------
+//  vx     | uint32 | [-50, 50]  |  2  |  8   | tag 1B + varint 1–2B = 2–3B
+//  vy     | uint32 | [-50, 50]  |  2  |  8   | tag 1B + varint 1–2B = 2–3B
+//  vz     | uint32 | [-50, 50]  |  2  |  8   | tag 1B + varint 1–2B = 2–3B
+//  ---------------------------------------------------------------------------
+//  Step: ≈ 0.003 m/s near zero, ≈ 0.78 m/s near ±50 (vs. 0.392 uniform linear)
+//  Wire: sign in the LSB, so |v| ≲ 12.5 m/s (magnitude code ≤ 63) costs a single
+//        varint byte regardless of direction; only faster axes spill to 2 bytes.
+// ---------------------------------------------------------------------------
+message VelocityState {
+  uint32 vx = 1 [(decentraland.common.quantized_power) = { max: 50.0, pow: 2.0, bits: 8 }];
+  uint32 vy = 2 [(decentraland.common.quantized_power) = { max: 50.0, pow: 2.0, bits: 8 }];
+  uint32 vz = 3 [(decentraland.common.quantized_power) = { max: 50.0, pow: 2.0, bits: 8 }];
+}
+
+// Bitmask values for PlayerInput.buttons.
+enum ButtonFlags {
+  BF_NONE      = 0;
+  BF_JUMP      = 1;   // bit 0
+  BF_SPRINT    = 2;   // bit 1
+  BF_INTERACT  = 4;   // bit 2
+  BF_EMOTE     = 8;   // bit 3
+  BF_CROUCH    = 16;  // bit 4
+  // bits 5-7 reserved
+}
+
+// ---------------------------------------------------------------------------
+// AvatarStateSnapshot — full authoritative state, sent on Channel 0 (reliable)
+// or on resync requests.  Demonstrates wider ranges and mixed encodings.
+//
+//  Field            | Type   | Range            | Q bits | Wire worst-case
+//  -----------------|--------|------------------|--------|-----------------------
+//  x                | uint32 | [-4096, 4096]    |   16   | tag 1B + varint 3B = 4B
+//  y                | uint32 | [-256,   256]    |   14   | tag 1B + varint 2B = 3B
+//  z                | uint32 | [-4096, 4096]    |   16   | tag 1B + varint 3B = 4B
+//  pitch            | uint32 | [-90,    90]     |   10   | tag 1B + varint 2B = 3B
+//  yaw              | uint32 | [-180,  180]     |   12   | tag 1B + varint 2B = 3B
+//  entity_id        | uint32 | [0, 1 048 575]   |   20   | tag 1B + varint 3B = 4B
+//  animation_state  | uint32 | [0,       63]    |    6   | tag 1B + varint 1B = 2B
+//  is_grounded      | bool   | —                |   —    | tag 1B + varint 1B = 2B
+//  timestamp        | double | —                |   —    | tag 1B + fixed64  8B = 9B
+//  ---------------------------------------------------------------------------
+//  Worst-case: 34 B  (vs. 45 B raw: 5×float + 2×uint32 + bool + double)
+//  Step: x/z ≈ 0.125 units; y ≈ 0.031 units; pitch ≈ 0.176°; yaw ≈ 0.088°
+// ---------------------------------------------------------------------------
+message AvatarStateSnapshot {
+  // World-space position.
+  uint32 x               = 1 [(decentraland.common.quantized)  = { min: -4096.0, max: 4096.0, bits: 16 }];
+  uint32 y               = 2 [(decentraland.common.quantized)  = { min:  -256.0, max:  256.0, bits: 14 }];
+  uint32 z               = 3 [(decentraland.common.quantized)  = { min: -4096.0, max: 4096.0, bits: 16 }];
+
+  // View angles.
+  uint32 pitch           = 4 [(decentraland.common.quantized)  = { min:  -90.0,  max:   90.0, bits: 10 }];
+  uint32 yaw             = 5 [(decentraland.common.quantized)  = { min: -180.0,  max:  180.0, bits: 12 }];
+
+  // Identity and animation state.
+  uint32 entity_id       = 6 [(decentraland.common.bit_packed) = { bits: 20 }];
+  uint32 animation_state = 7 [(decentraland.common.bit_packed) = { bits:  6 }];
+
+  // Un-annotated fields — encoded at their natural width.
+  bool   is_grounded     = 8;
+  double timestamp       = 9;   // server epoch milliseconds
+}

package/proto/decentraland/kernel/comms/rfc4/comms.proto

@@ -94,6 +94,14 @@ message PlayerEmote {
   uint32 incremental_id = 1;
   string urn = 2;
   float timestamp = 3;
+  optional bool is_stopping = 4; // true means the emote has been stopped in the sender's client
+  optional bool is_repeating = 5; // true when it is not the first time the looping animation plays
+  optional int32 interaction_id = 6; // identifies an interaction univocaly, established when the start animation is triggered
+  optional int32 social_emote_outcome = 7; // -1 means it does not use an outcome animation
+  optional bool is_reacting = 8; // to a social emote started by other user
+  optional string social_emote_initiator = 9; // wallet address of the user that initiated social emote
+  optional string target_avatar = 10; // wallet address of the user whose avatar is the target of a directed emote
+  optional uint32 mask = 11; // mask for which bones an animation applies to.
 }
 
 message SceneEmote {
@@ -126,6 +134,9 @@ message ProfileResponse {
 message Chat {
   string message = 1;
   double timestamp = 2;
+  // Extension: optional forwarded_from to identify the original sender when
+  // messages are forwarded through an SFU
+  optional string forwarded_from = 3;
 }
 
 message Scene {

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;
+  }
+}