@dcl/protocol 1.0.0-4085424786.commit-91ebbbd → 1.0.0-4085628047.commit-0f6384e

package/out-ts/decentraland/kernel/apis/environment_api.gen.ts

@@ -1043,6 +1043,7 @@ export const EnvironmentApiServiceDefinition = {
   name: "EnvironmentApiService",
   fullName: "decentraland.kernel.apis.EnvironmentApiService",
   methods: {
+    /** @deprecated, only available for SDK6 compatibility */
     getBootstrapData: {
       name: "GetBootstrapData",
       requestType: GetBootstrapDataRequest,
@@ -1051,6 +1052,7 @@ export const EnvironmentApiServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility. Needs migration */
     isPreviewMode: {
       name: "IsPreviewMode",
       requestType: IsPreviewModeRequest,
@@ -1059,6 +1061,7 @@ export const EnvironmentApiServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     getPlatform: {
       name: "GetPlatform",
       requestType: GetPlatformRequest,
@@ -1067,6 +1070,7 @@ export const EnvironmentApiServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     areUnsafeRequestAllowed: {
       name: "AreUnsafeRequestAllowed",
       requestType: AreUnsafeRequestAllowedRequest,
@@ -1084,6 +1088,7 @@ export const EnvironmentApiServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     getExplorerConfiguration: {
       name: "GetExplorerConfiguration",
       requestType: GetExplorerConfigurationRequest,

package/out-ts/decentraland/kernel/apis/ethereum_controller.gen.ts

@@ -793,6 +793,10 @@ export const EthereumControllerServiceDefinition = {
   name: "EthereumControllerService",
   fullName: "decentraland.kernel.apis.EthereumControllerService",
   methods: {
+    /**
+     * @deprecated, only available for SDK6 compatibility. This was a low level API that can
+     * be replaced by any ethereum library on top of the provider
+     */
     requirePayment: {
       name: "RequirePayment",
       requestType: RequirePaymentRequest,
@@ -801,6 +805,10 @@ export const EthereumControllerServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * @deprecated, only available for SDK6 compatibility. This was a low level API that can
+     * be replaced by any ethereum library on top of the provider
+     */
     signMessage: {
       name: "SignMessage",
       requestType: SignMessageRequest,
@@ -809,6 +817,10 @@ export const EthereumControllerServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * @deprecated, only available for SDK6 compatibility. This was a low level API that can
+     * be replaced by any ethereum library on top of the provider
+     */
     convertMessageToObject: {
       name: "ConvertMessageToObject",
       requestType: ConvertMessageToObjectRequest,
@@ -825,6 +837,10 @@ export const EthereumControllerServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * @deprecated, only available for SDK6 compatibility. This was a low level API that can
+     * be replaced by any ethereum library on top of the provider
+     */
     getUserAccount: {
       name: "GetUserAccount",
       requestType: GetUserAccountRequest,

package/out-ts/decentraland/kernel/apis/parcel_identity.gen.ts

@@ -505,6 +505,7 @@ export const ParcelIdentityServiceDefinition = {
   name: "ParcelIdentityService",
   fullName: "decentraland.kernel.apis.ParcelIdentityService",
   methods: {
+    /** @deprecated, only available for SDK6 compatibility */
     getParcel: {
       name: "GetParcel",
       requestType: GetParcelRequest,
@@ -513,6 +514,7 @@ export const ParcelIdentityServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     getSceneId: {
       name: "GetSceneId",
       requestType: GetSceneIdRequest,
@@ -521,6 +523,7 @@ export const ParcelIdentityServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     getIsEmpty: {
       name: "GetIsEmpty",
       requestType: GetIsEmptyRequest,

package/out-ts/decentraland/kernel/apis/permissions.gen.ts

@@ -313,6 +313,7 @@ export const PermissionsServiceDefinition = {
   name: "PermissionsService",
   fullName: "decentraland.kernel.apis.PermissionsService",
   methods: {
+    /** @deprecated, only available for SDK6 compatibility */
     hasPermission: {
       name: "HasPermission",
       requestType: HasPermissionRequest,
@@ -321,6 +322,7 @@ export const PermissionsServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /** @deprecated, only available for SDK6 compatibility */
     hasManyPermissions: {
       name: "HasManyPermissions",
       requestType: HasManyPermissionRequest,

package/out-ts/decentraland/kernel/apis/players.gen.ts

@@ -325,6 +325,10 @@ export const PlayersServiceDefinition = {
   name: "PlayersService",
   fullName: "decentraland.kernel.apis.PlayersService",
   methods: {
+    /**
+     * Returns data about a specific player, by id
+     * NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
+     */
     getPlayerData: {
       name: "GetPlayerData",
       requestType: GetPlayerDataRequest,
@@ -333,6 +337,10 @@ export const PlayersServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Returns a list of all the ids of players who are currently standing within the parcels of the scene
+     * NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
+     */
     getPlayersInScene: {
       name: "GetPlayersInScene",
       requestType: GetPlayersInSceneRequest,
@@ -341,6 +349,10 @@ export const PlayersServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Returns a list of all the ids of players who are currently connected to the same server and grouped together
+     * NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
+     */
     getConnectedPlayers: {
       name: "GetConnectedPlayers",
       requestType: GetConnectedPlayersRequest,

package/out-ts/decentraland/kernel/apis/portable_experiences.gen.ts

@@ -509,6 +509,13 @@ export const PortableExperiencesServiceDefinition = {
   name: "PortableExperiencesService",
   fullName: "decentraland.kernel.apis.PortableExperiencesService",
   methods: {
+    /**
+     * Spawns a new portable experience that is detached from the current scene.
+     * Spawned portable experiences can only be controlled by 1) the user (from the UI)
+     * and 2) from the parent scene. If the parent scene gets unloaded i.e. by distance,
+     * once the player re-loads the parent it will inherit the children portable experiences
+     * to gain control over them.
+     */
     spawn: {
       name: "Spawn",
       requestType: SpawnRequest,
@@ -517,6 +524,10 @@ export const PortableExperiencesServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Kill a child portable experience, this method only works if the child was
+     * spawned by the same process trying to kill it.
+     */
     kill: {
       name: "Kill",
       requestType: KillRequest,
@@ -525,6 +536,10 @@ export const PortableExperiencesServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Kill the current scene if the current scene is a portable experience. Other
+     * kind of scenes are not allowed to finish their programs like portable experiences.
+     */
     exit: {
       name: "Exit",
       requestType: ExitRequest,
@@ -533,6 +548,10 @@ export const PortableExperiencesServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Gets a list of running portable experiences for the current user. Be mindful
+     * about the performance penalty of calling this function all frames.
+     */
     getPortableExperiencesLoaded: {
       name: "GetPortableExperiencesLoaded",
       requestType: GetPortableExperiencesLoadedRequest,

package/out-ts/decentraland/kernel/apis/runtime.gen.ts

@@ -8,6 +8,7 @@ export interface RealmInfo {
   realmName: string;
   networkId: number;
   commsAdapter: string;
+  isPreview: boolean;
 }
 
 export interface GetRealmResponse {
@@ -25,7 +26,7 @@ export interface GetWorldTimeRequest {
 }
 
 function createBaseRealmInfo(): RealmInfo {
-  return { baseUrl: "", realmName: "", networkId: 0, commsAdapter: "" };
+  return { baseUrl: "", realmName: "", networkId: 0, commsAdapter: "", isPreview: false };
 }
 
 export const RealmInfo = {
@@ -42,6 +43,9 @@ export const RealmInfo = {
     if (message.commsAdapter !== "") {
       writer.uint32(34).string(message.commsAdapter);
     }
+    if (message.isPreview === true) {
+      writer.uint32(40).bool(message.isPreview);
+    }
     return writer;
   },
 
@@ -64,6 +68,9 @@ export const RealmInfo = {
         case 4:
           message.commsAdapter = reader.string();
           break;
+        case 5:
+          message.isPreview = reader.bool();
+          break;
         default:
           reader.skipType(tag & 7);
           break;
@@ -78,6 +85,7 @@ export const RealmInfo = {
       realmName: isSet(object.realmName) ? String(object.realmName) : "",
       networkId: isSet(object.networkId) ? Number(object.networkId) : 0,
       commsAdapter: isSet(object.commsAdapter) ? String(object.commsAdapter) : "",
+      isPreview: isSet(object.isPreview) ? Boolean(object.isPreview) : false,
     };
   },
 
@@ -87,6 +95,7 @@ export const RealmInfo = {
     message.realmName !== undefined && (obj.realmName = message.realmName);
     message.networkId !== undefined && (obj.networkId = Math.round(message.networkId));
     message.commsAdapter !== undefined && (obj.commsAdapter = message.commsAdapter);
+    message.isPreview !== undefined && (obj.isPreview = message.isPreview);
     return obj;
   },
 
@@ -100,6 +109,7 @@ export const RealmInfo = {
     message.realmName = object.realmName ?? "";
     message.networkId = object.networkId ?? 0;
     message.commsAdapter = object.commsAdapter ?? "";
+    message.isPreview = object.isPreview ?? false;
     return message;
   },
 };
@@ -300,6 +310,7 @@ export const RuntimeServiceDefinition = {
   name: "RuntimeService",
   fullName: "decentraland.kernel.apis.RuntimeService",
   methods: {
+    /** Provides information about the current realm */
     getRealm: {
       name: "GetRealm",
       requestType: GetRealmRequest,
@@ -308,6 +319,10 @@ export const RuntimeServiceDefinition = {
       responseStream: false,
       options: {},
     },
+    /**
+     * Provides information about the Decentraland Time, which is coordinated
+     * across players.
+     */
     getWorldTime: {
       name: "GetWorldTime",
       requestType: GetWorldTimeRequest,

package/out-ts/decentraland/kernel/apis/scene.gen.ts

@@ -0,0 +1,174 @@
+/* eslint-disable */
+import _m0 from "protobufjs/minimal";
+import { ContentMapping } from "../../common/content_mapping.gen";
+
+export const protobufPackage = "decentraland.kernel.apis";
+
+export interface GetSceneRequest {
+}
+
+export interface GetSceneResponse {
+  cid: string;
+  metadata: string;
+  baseUrl: string;
+  contents: ContentMapping[];
+}
+
+function createBaseGetSceneRequest(): GetSceneRequest {
+  return {};
+}
+
+export const GetSceneRequest = {
+  encode(_: GetSceneRequest, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer {
+    return writer;
+  },
+
+  decode(input: _m0.Reader | Uint8Array, length?: number): GetSceneRequest {
+    const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input);
+    let end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBaseGetSceneRequest();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        default:
+          reader.skipType(tag & 7);
+          break;
+      }
+    }
+    return message;
+  },
+
+  fromJSON(_: any): GetSceneRequest {
+    return {};
+  },
+
+  toJSON(_: GetSceneRequest): unknown {
+    const obj: any = {};
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<GetSceneRequest>, I>>(base?: I): GetSceneRequest {
+    return GetSceneRequest.fromPartial(base ?? {});
+  },
+
+  fromPartial<I extends Exact<DeepPartial<GetSceneRequest>, I>>(_: I): GetSceneRequest {
+    const message = createBaseGetSceneRequest();
+    return message;
+  },
+};
+
+function createBaseGetSceneResponse(): GetSceneResponse {
+  return { cid: "", metadata: "", baseUrl: "", contents: [] };
+}
+
+export const GetSceneResponse = {
+  encode(message: GetSceneResponse, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer {
+    if (message.cid !== "") {
+      writer.uint32(10).string(message.cid);
+    }
+    if (message.metadata !== "") {
+      writer.uint32(18).string(message.metadata);
+    }
+    if (message.baseUrl !== "") {
+      writer.uint32(26).string(message.baseUrl);
+    }
+    for (const v of message.contents) {
+      ContentMapping.encode(v!, writer.uint32(34).fork()).ldelim();
+    }
+    return writer;
+  },
+
+  decode(input: _m0.Reader | Uint8Array, length?: number): GetSceneResponse {
+    const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input);
+    let end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBaseGetSceneResponse();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1:
+          message.cid = reader.string();
+          break;
+        case 2:
+          message.metadata = reader.string();
+          break;
+        case 3:
+          message.baseUrl = reader.string();
+          break;
+        case 4:
+          message.contents.push(ContentMapping.decode(reader, reader.uint32()));
+          break;
+        default:
+          reader.skipType(tag & 7);
+          break;
+      }
+    }
+    return message;
+  },
+
+  fromJSON(object: any): GetSceneResponse {
+    return {
+      cid: isSet(object.cid) ? String(object.cid) : "",
+      metadata: isSet(object.metadata) ? String(object.metadata) : "",
+      baseUrl: isSet(object.baseUrl) ? String(object.baseUrl) : "",
+      contents: Array.isArray(object?.contents) ? object.contents.map((e: any) => ContentMapping.fromJSON(e)) : [],
+    };
+  },
+
+  toJSON(message: GetSceneResponse): unknown {
+    const obj: any = {};
+    message.cid !== undefined && (obj.cid = message.cid);
+    message.metadata !== undefined && (obj.metadata = message.metadata);
+    message.baseUrl !== undefined && (obj.baseUrl = message.baseUrl);
+    if (message.contents) {
+      obj.contents = message.contents.map((e) => e ? ContentMapping.toJSON(e) : undefined);
+    } else {
+      obj.contents = [];
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<GetSceneResponse>, I>>(base?: I): GetSceneResponse {
+    return GetSceneResponse.fromPartial(base ?? {});
+  },
+
+  fromPartial<I extends Exact<DeepPartial<GetSceneResponse>, I>>(object: I): GetSceneResponse {
+    const message = createBaseGetSceneResponse();
+    message.cid = object.cid ?? "";
+    message.metadata = object.metadata ?? "";
+    message.baseUrl = object.baseUrl ?? "";
+    message.contents = object.contents?.map((e) => ContentMapping.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+export type SceneServiceDefinition = typeof SceneServiceDefinition;
+export const SceneServiceDefinition = {
+  name: "SceneService",
+  fullName: "decentraland.kernel.apis.SceneService",
+  methods: {
+    getSceneInfo: {
+      name: "GetSceneInfo",
+      requestType: GetSceneRequest,
+      requestStream: false,
+      responseType: GetSceneResponse,
+      responseStream: false,
+      options: {},
+    },
+  },
+} as const;
+
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+
+export type DeepPartial<T> = T extends Builtin ? T
+  : T extends Array<infer U> ? Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>>
+  : T extends { $case: string } ? { [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]> } & { $case: T["$case"] }
+  : T extends {} ? { [K in keyof T]?: DeepPartial<T[K]> }
+  : Partial<T>;
+
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P
+  : P & { [K in keyof P]: Exact<P[K], I[K]> } & { [K in Exclude<keyof I, KeysOfUnion<P>>]: never };
+
+function isSet(value: any): boolean {
+  return value !== null && value !== undefined;
+}

package/out-ts/decentraland/kernel/apis/signed_fetch.gen.ts

@@ -417,6 +417,10 @@ export const SignedFetchServiceDefinition = {
   name: "SignedFetchService",
   fullName: "decentraland.kernel.apis.SignedFetchService",
   methods: {
+    /**
+     * SignedFetch is used to authenticate JSON requests in name of the users,
+     * a special scoped signature is generated following the https://adr.decentraland.org/adr/ADR-44
+     */
     signedFetch: {
       name: "SignedFetch",
       requestType: SignedFetchRequest,

package/out-ts/decentraland/kernel/apis/social_controller.gen.ts

@@ -180,6 +180,11 @@ export const SocialControllerServiceDefinition = {
   name: "SocialControllerService",
   fullName: "decentraland.kernel.apis.SocialControllerService",
   methods: {
+    /**
+     * @deprecated, only available for SDK6 compatibility. This was a low level
+     * API used for the AvatarScene, it will be replaced by Foreign Entities in
+     * SDK7
+     */
     pullAvatarEvents: {
       name: "PullAvatarEvents",
       requestType: InitRequest,

package/out-ts/decentraland/kernel/apis/user_action_module.gen.ts

@@ -109,6 +109,7 @@ export const UserActionModuleServiceDefinition = {
   name: "UserActionModuleService",
   fullName: "decentraland.kernel.apis.UserActionModuleService",
   methods: {
+    /** @deprecated, only available for SDK6 compatibility. Use RestrictedActions/TeleportTo */
     requestTeleport: {
       name: "RequestTeleport",
       requestType: RequestTeleportRequest,

package/out-ts/decentraland/kernel/apis/user_identity.gen.ts

@@ -211,6 +211,7 @@ export const UserIdentityServiceDefinition = {
   name: "UserIdentityService",
   fullName: "decentraland.kernel.apis.UserIdentityService",
   methods: {
+    /** @deprecated, only available for SDK6 compatibility. UseGetUserData */
     getUserPublicKey: {
       name: "GetUserPublicKey",
       requestType: GetUserPublicKeyRequest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl/protocol",
-  "version": "1.0.0-4085424786.commit-91ebbbd",
+  "version": "1.0.0-4085628047.commit-0f6384e",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -26,5 +26,5 @@
     "out-js",
     "public"
   ],
-  "commit": "91ebbbd5b4171864be5756ba6ee1c64e545155f3"
+  "commit": "0f6384e27ccf5aad4100076aa4a219a5d04c9f67"
 }

package/proto/decentraland/kernel/apis/communications_controller.proto

@@ -8,5 +8,7 @@ message RealSendRequest {
 message RealSendResponse {}
 
 service CommunicationsControllerService {
+    // @deprecated - This API should use a bidirectional binary stream in sdk7
+    // https://github.com/decentraland/sdk/issues/582
     rpc Send(RealSendRequest) returns (RealSendResponse) {}
 }

package/proto/decentraland/kernel/apis/dev_tools.proto

@@ -8,6 +8,8 @@ message DevToolsBody {
 
 message EventResponse {}
 
+// @deprecated
 service DevToolsService {
+    // @deprecated
     rpc Event(DevToolsBody) returns (EventResponse) {}
 }

package/proto/decentraland/kernel/apis/engine_api.proto

@@ -199,8 +199,11 @@ message CrdtMessageFromRendererResponse {
 service EngineApiService {
   // support for legacy SDK events.
 
+  // @deprecated
   rpc SendBatch(ManyEntityAction) returns (SendBatchResponse) {}
+  // @deprecated
   rpc Subscribe(SubscribeRequest) returns (SubscribeResponse) {}
+  // @deprecated
   rpc Unsubscribe(UnsubscribeRequest) returns (UnsubscribeResponse) {}
 
   // send information of the CRDT messages to the renderer. It returns the CRDT changes back from the renderer

package/proto/decentraland/kernel/apis/environment_api.proto

@@ -59,12 +59,17 @@ message GetExplorerConfigurationRequest {}
 message GetDecentralandTimeRequest {}
 
 service EnvironmentApiService {
+  // @deprecated, only available for SDK6 compatibility
   rpc GetBootstrapData(GetBootstrapDataRequest) returns (BootstrapDataResponse) {}
+  // @deprecated, only available for SDK6 compatibility. Needs migration
   rpc IsPreviewMode(IsPreviewModeRequest) returns (PreviewModeResponse) {}
+  // @deprecated, only available for SDK6 compatibility
   rpc GetPlatform(GetPlatformRequest) returns (GetPlatformResponse) {}
+  // @deprecated, only available for SDK6 compatibility
   rpc AreUnsafeRequestAllowed(AreUnsafeRequestAllowedRequest) returns (AreUnsafeRequestAllowedResponse) {}
   // @deprecated, use GetCurrentRealm from runtime_api instead
   rpc GetCurrentRealm(GetCurrentRealmRequest) returns (GetCurrentRealmResponse) {}
+  // @deprecated, only available for SDK6 compatibility
   rpc GetExplorerConfiguration(GetExplorerConfigurationRequest) returns (GetExplorerConfigurationResponse) {}
   // @deprecated, use GetTime from runtime_api instead
   rpc GetDecentralandTime(GetDecentralandTimeRequest) returns (GetDecentralandTimeResponse) {}

package/proto/decentraland/kernel/apis/ethereum_controller.proto

@@ -46,9 +46,19 @@ message GetUserAccountResponse {
 }
 
 service EthereumControllerService {
+    // @deprecated, only available for SDK6 compatibility. This was a low level API that can
+    // be replaced by any ethereum library on top of the provider
     rpc RequirePayment(RequirePaymentRequest) returns (RequirePaymentResponse) {}
+    // @deprecated, only available for SDK6 compatibility. This was a low level API that can
+    // be replaced by any ethereum library on top of the provider
     rpc SignMessage(SignMessageRequest) returns (SignMessageResponse) {}
+    // @deprecated, only available for SDK6 compatibility. This was a low level API that can
+    // be replaced by any ethereum library on top of the provider
     rpc ConvertMessageToObject(ConvertMessageToObjectRequest) returns (ConvertMessageToObjectResponse) {}
+
     rpc SendAsync(SendAsyncRequest) returns (SendAsyncResponse) {}
+
+    // @deprecated, only available for SDK6 compatibility. This was a low level API that can
+    // be replaced by any ethereum library on top of the provider
     rpc GetUserAccount(GetUserAccountRequest) returns (GetUserAccountResponse) {}
 }

package/proto/decentraland/kernel/apis/parcel_identity.proto

@@ -34,7 +34,10 @@ message GetIsEmptyResponse {
 }
 
 service ParcelIdentityService {
+    // @deprecated, only available for SDK6 compatibility
     rpc GetParcel(GetParcelRequest) returns (GetParcelResponse) {}
+    // @deprecated, only available for SDK6 compatibility
     rpc GetSceneId(GetSceneIdRequest) returns (GetSceneIdResponse) {}
+    // @deprecated, only available for SDK6 compatibility
     rpc GetIsEmpty(GetIsEmptyRequest) returns (GetIsEmptyResponse) {}
 }

package/proto/decentraland/kernel/apis/permissions.proto

@@ -27,6 +27,8 @@ message HasManyPermissionResponse {
 }
 
 service PermissionsService {
+  // @deprecated, only available for SDK6 compatibility
   rpc HasPermission(HasPermissionRequest) returns (PermissionResponse) {}
+  // @deprecated, only available for SDK6 compatibility
   rpc HasManyPermissions(HasManyPermissionRequest) returns (HasManyPermissionResponse) {}
 }

package/proto/decentraland/kernel/apis/players.proto

@@ -23,7 +23,13 @@ message GetPlayersInSceneRequest {}
 message GetConnectedPlayersRequest {}
 
 service PlayersService {
+    // Returns data about a specific player, by id
+    // NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
     rpc GetPlayerData(GetPlayerDataRequest) returns (PlayersGetUserDataResponse) {}
+    // Returns a list of all the ids of players who are currently standing within the parcels of the scene
+    // NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
     rpc GetPlayersInScene(GetPlayersInSceneRequest) returns (PlayerListResponse) {}
+    // Returns a list of all the ids of players who are currently connected to the same server and grouped together
+    // NOTE: To be deprecated after implementing foreign-entities and once the avatar scene uses SDK7
     rpc GetConnectedPlayers(GetConnectedPlayersRequest)  returns (PlayerListResponse) {}
 }

package/proto/decentraland/kernel/apis/portable_experiences.proto

@@ -34,8 +34,19 @@ message ExitResponse {
 }
 
 service PortableExperiencesService {
+    // Spawns a new portable experience that is detached from the current scene.
+    // Spawned portable experiences can only be controlled by 1) the user (from the UI)
+    // and 2) from the parent scene. If the parent scene gets unloaded i.e. by distance,
+    // once the player re-loads the parent it will inherit the children portable experiences
+    // to gain control over them.
     rpc Spawn(SpawnRequest) returns (SpawnResponse) {}
+    // Kill a child portable experience, this method only works if the child was
+    // spawned by the same process trying to kill it.
     rpc Kill(KillRequest) returns (KillResponse) {}
+    // Kill the current scene if the current scene is a portable experience. Other
+    // kind of scenes are not allowed to finish their programs like portable experiences.
     rpc Exit(ExitRequest) returns (ExitResponse) {}
+    // Gets a list of running portable experiences for the current user. Be mindful
+    // about the performance penalty of calling this function all frames.
     rpc GetPortableExperiencesLoaded(GetPortableExperiencesLoadedRequest) returns (GetPortableExperiencesLoadedResponse) {}
 }

package/proto/decentraland/kernel/apis/runtime.proto

@@ -10,6 +10,7 @@ message RealmInfo {
   string realm_name = 2;
   int32 network_id = 3;
   string comms_adapter = 4;
+  bool is_preview = 5;
 }
 
 message GetRealmResponse {
@@ -24,6 +25,9 @@ message GetRealmRequest {}
 message GetWorldTimeRequest {}
 
 service RuntimeService {
+  // Provides information about the current realm
   rpc GetRealm(GetRealmRequest) returns (GetRealmResponse) {}
+  // Provides information about the Decentraland Time, which is coordinated
+  // across players.
   rpc GetWorldTime(GetWorldTimeRequest) returns (GetWorldTimeResponse) {}
 }