@dcl/sdk-commands 7.31.1-40962203448.commit-c68a75f → 7.31.1-41472004640.commit-3147448

package/dist/commands/scene-insights/sign-in.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSession = getSession;
+exports.isLinkerOrigin = isLinkerOrigin;
+exports.setSignInRoutes = setSignInRoutes;
+const fp_future_1 = __importDefault(require("fp-future"));
+const crypto_1 = require("@dcl/crypto");
+const error_1 = require("../../logic/error");
+const routes_1 = require("../../linker-dapp/routes");
+const run_dapp_1 = require("../../run-dapp");
+const session_1 = require("./session");
+const session_store_1 = require("./session-store");
+/**
+ * Gets a session to sign requests with, in order:
+ * 1. `DCL_PRIVATE_KEY`, signed locally and never saved;
+ * 2. the saved session, while it is valid (unless `forceNew`);
+ * 3. a new browser signature through the linker dApp, which is then saved.
+ *
+ * @throws CliError `SCENE_INSIGHTS_SESSION_REQUIRED` when it would have to open the browser but
+ *   nobody is there to sign (an agent or script): `scene-insights login` has to be run first.
+ * @throws CliError `SCENE_INSIGHTS_UNSAFE_SESSION_FILE` when git tracks the session file, before
+ *   asking for a signature.
+ */
+async function getSession(components, label, options) {
+    if (process.env.DCL_PRIVATE_KEY) {
+        return { session: (0, session_1.createSessionFromPrivateKey)(process.env.DCL_PRIVATE_KEY), source: 'private-key' };
+    }
+    if (!options.forceNew) {
+        const saved = await (0, session_store_1.loadSession)(components, options.file);
+        if (saved)
+            return { session: saved.session, source: 'saved' };
+        if (!options.interactive) {
+            throw new error_1.CliError('SCENE_INSIGHTS_SESSION_REQUIRED', 'No signed-in session. Ask the user to run "sdk-commands scene-insights login" (it opens the browser to sign once, for 12 hours), or set DCL_PRIVATE_KEY');
+        }
+    }
+    // before the browser opens: nobody should sign a session that can't be saved
+    await (0, session_store_1.assertSessionFileIsNotTracked)(options.file);
+    const ephemeralIdentity = (0, session_1.createEphemeralIdentity)();
+    const expiration = new Date(Date.now() + session_1.SESSION_MINUTES * 60 * 1000);
+    const message = (0, session_1.getInsightsSessionMessage)(ephemeralIdentity.address, expiration);
+    const signed = (0, fp_future_1.default)();
+    const { router: commonRouter } = (0, routes_1.setRoutes)(components, {
+        rootCID: message,
+        baseParcel: label.parcel ?? '0,0',
+        parcels: [label.parcel ?? '0,0'],
+        skipValidations: true,
+        debug: !!process.env.DEBUG,
+        isWorld: !!label.world,
+        world: label.label,
+        targetUrl: options.targetUrl,
+        action: 'view-logs'
+    });
+    const router = setSignInRoutes(commonRouter, ephemeralIdentity.address, message, (chain) => signed.resolve(chain));
+    components.logger.info(`Sign read-only access to logs, metrics and executions for the next ${session_1.SESSION_MINUTES / 60} hours`);
+    components.logger.info('This credential works across Insights environments sharing the insights service identifier, including .org and .zone.');
+    const { program } = await (0, run_dapp_1.runDapp)(components, router, { ...options.linkOptions, uri: '/' });
+    let authChain;
+    try {
+        authChain = await signed;
+    }
+    finally {
+        void program.stop();
+    }
+    const validated = await crypto_1.Authenticator.validateSignature(ephemeralIdentity.address.toLowerCase(), authChain, null, Date.now(), { service: session_1.INSIGHTS_SERVICE });
+    if (!validated.ok || !validated.scope) {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_SIGNATURE', 'The wallet did not return a valid scoped insights login');
+    }
+    expiration.setTime(Math.min(expiration.getTime(), validated.scope.expiration));
+    await (0, session_store_1.saveSession)(components, options.file, ephemeralIdentity, expiration, authChain);
+    return { session: (0, session_1.createSessionFromChain)(ephemeralIdentity, expiration, authChain), source: 'signed' };
+}
+const LOOPBACK_HOSTNAMES = ['localhost', '127.0.0.1', '[::1]'];
+/**
+ * Whether a request comes from the linker dApp's own page. The browser sets Origin and Host, so
+ * another page open in it (or a rebinding domain) can't pass for the dApp.
+ */
+function isLinkerOrigin(origin, host) {
+    if (!origin || !host)
+        return false;
+    try {
+        const url = new URL(origin);
+        return url.host === host && LOOPBACK_HOSTNAMES.includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The linker dApp posts `view-logs` signatures to `/api/logs`. Only its own page is accepted: any
+ * other page could sign the message with its own wallet and sign the CLI in as that address.
+ */
+function setSignInRoutes(router, ephemeralAddress, message, onSigned) {
+    router.post('/api/logs', async (ctx) => {
+        if (!isLinkerOrigin(ctx.request.headers.get('origin'), ctx.request.headers.get('host'))) {
+            return { status: 403, body: { success: false, error: 'Sign from the page the CLI opened on localhost' } };
+        }
+        const value = (await ctx.request.json());
+        try {
+            if (!value.address || !Array.isArray(value.authChain)) {
+                throw new error_1.CliError('SCENE_INSIGHTS_INVALID_SIGNATURE', 'The wallet did not sign the insights session');
+            }
+            const delegation = await (0, session_1.delegationFromLinkerChain)(value.authChain, ephemeralAddress, message);
+            // answer the dApp before its server is stopped
+            setTimeout(() => onSigned(delegation), 100);
+            return { body: { success: true } };
+        }
+        catch (e) {
+            return { status: 400, body: { success: false, error: e.message } };
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=sign-in.js.map

package/dist/commands/scene-insights/sign-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-in.js","sourceRoot":"","sources":["../../../src/commands/scene-insights/sign-in.ts"],"names":[],"mappings":";;;;;AAoDA,gCAsEC;AAQD,wCAQC;AAMD,0CAwBC;AAxKD,0DAA8B;AAC9B,wCAAsD;AAItD,6CAA4C;AAC5C,qDAAoE;AACpE,6CAAqD;AACrD,uCASkB;AAClB,mDAAyF;AAuBzF;;;;;;;;;;GAUG;AACI,KAAK,UAAU,UAAU,CAC9B,UAAqE,EACrE,KAAkB,EAClB,OAAuB;IAEvB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAA,qCAA2B,EAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;IACrG,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,IAAA,2BAAW,EAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACzD,IAAI,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;QAE7D,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,gBAAQ,CAChB,iCAAiC,EACjC,yJAAyJ,CAC1J,CAAA;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,MAAM,IAAA,6CAA6B,EAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,iBAAiB,GAAG,IAAA,iCAAuB,GAAE,CAAA;IACnD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,yBAAe,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,IAAA,mCAAyB,EAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAEhF,MAAM,MAAM,GAAG,IAAA,mBAAM,GAAa,CAAA;IAClC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAA,kBAAS,EAAC,UAAU,EAAE;QACrD,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;QACjC,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;QAChC,eAAe,EAAE,IAAI;QACrB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK;QAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,WAAW;KACpB,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAElH,UAAU,CAAC,MAAM,CAAC,IAAI,CACpB,sEAAsE,yBAAe,GAAG,EAAE,QAAQ,CACnG,CAAA;IACD,UAAU,CAAC,MAAM,CAAC,IAAI,CACpB,uHAAuH,CACxH,CAAA;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,kBAAO,EAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;IAE3F,IAAI,SAAoB,CAAA;IACxB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,MAAM,CAAA;IAC1B,CAAC;YAAS,CAAC;QACT,KAAK,OAAO,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,sBAAa,CAAC,iBAAiB,CACrD,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,EACvC,SAAS,EACT,IAAI,EACJ,IAAI,CAAC,GAAG,EAAE,EACV,EAAE,OAAO,EAAE,0BAAgB,EAAE,CAC9B,CAAA;IACD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,IAAI,gBAAQ,CAAC,kCAAkC,EAAE,yDAAyD,CAAC,CAAA;IACnH,CAAC;IACD,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9E,MAAM,IAAA,2BAAW,EAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IACrF,OAAO,EAAE,OAAO,EAAE,IAAA,gCAAsB,EAAC,iBAAiB,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACxG,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;AAE9D;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAqB,EAAE,IAAmB;IACvE,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,MAAsB,EACtB,gBAAwB,EACxB,OAAe,EACf,QAAyC;IAEzC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACxF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gDAAgD,EAAE,EAAE,CAAA;QAC3G,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAmB,CAAA;QAC1D,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,gBAAQ,CAAC,kCAAkC,EAAE,8CAA8C,CAAC,CAAA;YACxG,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,IAAA,mCAAyB,EAAC,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAA;YAC9F,+CAA+C;YAC/C,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAA;YAC3C,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAA;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,CAAA;QAC/E,CAAC;IACH,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/commands/scene-insights/types.d.ts

@@ -0,0 +1,61 @@
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    source: 'scene' | 'engine' | 'stderr' | 'unknown';
+    executionId: string;
+    entityId: string;
+    message: string;
+    truncated: boolean;
+}
+export interface LogSearchResult {
+    sceneKey: string;
+    logs: LogEntry[];
+    nextCursor: string | null;
+    retentionStart: string;
+}
+export interface Execution {
+    executionId: string;
+    entityId: string;
+    firstSeen: string;
+    lastSeen: string;
+    instanceId: string;
+    logLines: number;
+}
+export interface ExecutionsResult {
+    sceneKey: string;
+    executions: Execution[];
+    retentionStart: string;
+}
+export interface MetricName {
+    name: string;
+    type: 'gauge' | 'sum';
+    unit: string;
+}
+export interface MetricNamesResult {
+    sceneKey: string;
+    from: string;
+    to: string;
+    metrics: MetricName[];
+}
+export interface GaugePoint {
+    t: string;
+    avg: number | null;
+    max: number | null;
+}
+export interface SumPoint {
+    t: string;
+    sum: number | null;
+    rate: number | null;
+}
+export interface MetricSeries {
+    sceneKey: string;
+    metric: string;
+    type: 'gauge' | 'sum' | null;
+    unit: string;
+    rateUnit?: string;
+    stepSeconds: number;
+    from: string;
+    to: string;
+    points: Array<GaugePoint | SumPoint>;
+}

package/dist/commands/scene-insights/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Response shapes of multiplayer-scenes-insights-service (its docs/openapi.yaml).
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/commands/scene-insights/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/scene-insights/types.ts"],"names":[],"mappings":";AAAA,kFAAkF"}

package/dist/commands/sdk-server-logs/index.d.ts

@@ -0,0 +1,24 @@
+import { Result } from 'arg';
+import { CliComponents } from '../../components';
+interface Options {
+    args: Result<typeof args>;
+    components: CliComponents;
+}
+export declare const args: {
+    '--help': BooleanConstructor;
+    '-h': string;
+    '--dir': StringConstructor;
+    '--world': StringConstructor;
+    '-w': string;
+    '--position': StringConstructor;
+    '--target': StringConstructor;
+    '-t': string;
+    '--port': NumberConstructor;
+    '-p': string;
+    '--https': BooleanConstructor;
+    '--no-browser': BooleanConstructor;
+    '-b': string;
+};
+export declare function help(options: Options): void;
+export declare function main(options: Options): Promise<void>;
+export {};

package/dist/commands/sdk-server-logs/index.js

@@ -0,0 +1,313 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.args = void 0;
+exports.help = help;
+exports.main = main;
+const path_1 = require("path");
+const fp_future_1 = __importDefault(require("fp-future"));
+const crypto_1 = require("@dcl/crypto");
+const crypto_2 = require("@dcl/crypto/dist/crypto");
+const eth_connect_1 = require("eth-connect");
+const args_1 = require("../../logic/args");
+const error_1 = require("../../logic/error");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const account_1 = require("../../logic/account");
+const auth_chain_headers_1 = require("../../logic/auth-chain-headers");
+const routes_1 = require("../../linker-dapp/routes");
+const run_dapp_1 = require("../../run-dapp");
+const workspace_validations_1 = require("../../logic/workspace-validations");
+const scene_validations_1 = require("../../logic/scene-validations");
+exports.args = (0, args_1.declareArgs)({
+    '--help': Boolean,
+    '-h': '--help',
+    '--dir': String,
+    '--world': String,
+    '-w': '--world',
+    '--position': String,
+    '--target': String,
+    '-t': '--target',
+    '--port': Number,
+    '-p': '--port',
+    '--https': Boolean,
+    '--no-browser': Boolean,
+    '-b': '--no-browser'
+});
+const DEFAULT_SERVER = 'https://multiplayer-server.decentraland.org';
+function help(options) {
+    options.components.logger.log(`
+  Usage: 'sdk-commands sdk-server-logs [options]'
+    Streams real-time logs from the multiplayer server.
+    Runs from any directory when --world and/or --position are provided.
+    Falls back to scene.json (worldConfiguration.name) when neither is passed.
+
+    Options:
+      -h, --help                Displays complete help
+      -w, --world       [name]  World name. When omitted, --position targets Genesis City.
+      --position        [x,y]   Parcel coordinates. Optional for worlds (selects a scene
+                                in a multi-scene world). Required for Genesis City.
+      -t, --target      [URL]   Target multiplayer server URL (default: ${DEFAULT_SERVER})
+      --dir             [path]  Path to the project directory (used with scene.json fallback)
+      -p, --port        [port]  Select a custom port for the linker dApp
+      -b, --no-browser          Do not open a new browser window
+      --https                   Use HTTPS for the linker dApp
+
+    Examples:
+    - View logs using the world in the current scene.json:
+      $ sdk-commands sdk-server-logs
+
+    - View logs for a world from any directory:
+      $ sdk-commands sdk-server-logs --world myworld.dcl.eth
+
+    - View logs for a specific scene in a multi-scene world:
+      $ sdk-commands sdk-server-logs --world myworld.dcl.eth --position 10,10
+
+    - View logs for a Genesis City scene (use =value form for negative coords):
+      $ sdk-commands sdk-server-logs --position=-125,-96
+
+    - Connect to a custom server:
+      $ sdk-commands sdk-server-logs --world myworld --target https://multiplayer-server.decentraland.zone
+
+    - Use private key for authentication (no browser):
+      $ DCL_PRIVATE_KEY=0x... sdk-commands sdk-server-logs --world myworld
+`);
+}
+function setServerLogsRoutes(router, components, awaitResponse, signCallback) {
+    const { logger } = components;
+    const resolveLinkerPromise = () => setTimeout(() => awaitResponse.resolve(), 100);
+    const rejectLinkerPromise = (e) => setTimeout(() => awaitResponse.reject(e), 100);
+    router.post('/api/logs', async (ctx) => {
+        const value = (await ctx.request.json());
+        if (!value.address || !value.authChain) {
+            const errorMessage = `Invalid payload: ${Object.keys(value).join(' - ')}`;
+            logger.error(errorMessage);
+            resolveLinkerPromise();
+            return { status: 400, body: { success: false, error: errorMessage } };
+        }
+        try {
+            await signCallback(value);
+            resolveLinkerPromise();
+            return { body: { success: true } };
+        }
+        catch (e) {
+            rejectLinkerPromise(e);
+            return { status: 400, body: { success: false, error: e.message } };
+        }
+    });
+    return router;
+}
+async function getAddressAndSignature(components, awaitResponse, payload, displayLabel, targetUrl, linkOptions, signCallback) {
+    // If DCL_PRIVATE_KEY is set, sign directly without the linker dapp
+    if (process.env.DCL_PRIVATE_KEY) {
+        const wallet = (0, account_1.createWallet)(process.env.DCL_PRIVATE_KEY);
+        const authChain = crypto_1.Authenticator.createSimpleAuthChain(payload, wallet.address, (0, crypto_2.ethSign)((0, eth_connect_1.hexToBytes)(wallet.privateKey), payload));
+        const linkerResponse = { authChain, address: wallet.address };
+        await signCallback(linkerResponse);
+        awaitResponse.resolve();
+        return {};
+    }
+    // Use linker dapp for signing - pass the payload as the rootCID
+    const { router: commonRouter } = (0, routes_1.setRoutes)(components, {
+        rootCID: payload,
+        baseParcel: '0,0',
+        parcels: ['0,0'],
+        skipValidations: true,
+        debug: !!process.env.DEBUG,
+        isWorld: true,
+        world: displayLabel,
+        targetUrl,
+        action: 'view-logs'
+    });
+    const router = setServerLogsRoutes(commonRouter, components, awaitResponse, signCallback);
+    components.logger.info('You need to sign to access server logs');
+    const { program } = await (0, run_dapp_1.runDapp)(components, router, { ...linkOptions, uri: `/` });
+    return { program };
+}
+async function streamLogs(components, logsUrl, authHeaders) {
+    const { logger, fetch: fetchComponent } = components;
+    logger.info('\nConnecting to server logs...');
+    try {
+        const response = await fetchComponent.fetch(logsUrl, {
+            method: 'GET',
+            headers: {
+                ...authHeaders,
+                Accept: 'text/event-stream'
+            }
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Server returned ${response.status}: ${errorText}`);
+        }
+        const contentType = response.headers.get('content-type') || '';
+        if (!contentType.includes('text/event-stream') && !contentType.includes('application/stream')) {
+            throw new Error('Server does not support SSE streaming');
+        }
+        logger.info('Streaming logs in real-time (press CTRL+C to stop)');
+        if (response.body) {
+            const decoder = new TextDecoder();
+            let buffer = '';
+            for await (const chunk of response.body) {
+                buffer += decoder.decode(chunk, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    if (line.trim()) {
+                        formatAndPrintLog(logger, line);
+                    }
+                }
+            }
+        }
+        logger.info('\n======================= End Scene Logs =======================');
+    }
+    catch (e) {
+        (0, beautiful_logs_1.printError)(logger, 'Failed to stream logs:', e);
+        process.exit(1);
+    }
+}
+function formatAndPrintLog(logger, log) {
+    // If log is a string, try to parse as JSON
+    let logObj = log;
+    if (typeof log === 'string') {
+        try {
+            logObj = JSON.parse(log);
+        }
+        catch {
+            // If not JSON, just print the string
+            logger.log(log);
+            return;
+        }
+    }
+    // Extract common log fields
+    const timestamp = logObj.timestamp || logObj.time || new Date().toISOString();
+    const level = (logObj.level || logObj.severity || 'INFO').toUpperCase();
+    const message = logObj.message || logObj.msg || JSON.stringify(logObj);
+    // Format timestamp
+    const date = new Date(timestamp);
+    const formattedTime = date.toISOString().replace('T', ' ').substring(0, 19);
+    // Format the log message with timestamp
+    const formattedMessage = `[${formattedTime}] [${level}] ${message}`;
+    // Map log levels to logger methods
+    const normalizedLevel = level.toLowerCase();
+    switch (normalizedLevel) {
+        case 'error':
+            logger.error(formattedMessage);
+            break;
+        case 'warn':
+        case 'warning':
+            logger.warn(formattedMessage);
+            break;
+        case 'debug':
+            logger.debug(formattedMessage);
+            break;
+        case 'info':
+        case 'trace':
+        default:
+            logger.info(formattedMessage);
+            break;
+    }
+    // If there are additional fields, print them
+    const additionalFields = Object.keys(logObj).filter((key) => !['timestamp', 'time', 'level', 'severity', 'message', 'msg'].includes(key));
+    if (additionalFields.length > 0) {
+        const additional = {};
+        additionalFields.forEach((key) => {
+            additional[key] = logObj[key];
+        });
+        logger.log(`  ${JSON.stringify(additional)}`);
+    }
+}
+function normalizePosition(raw) {
+    const match = raw.trim().match(/^(-?\d+)\s*,\s*(-?\d+)$/);
+    if (!match) {
+        throw new error_1.CliError('SERVER_LOGS_INVALID_POSITION', `Invalid --position "${raw}"; expected "x,y" with integer coordinates`);
+    }
+    return `${parseInt(match[1], 10)},${parseInt(match[2], 10)}`;
+}
+/**
+ * Build the HTTP request shape for the multiplayer-server `/logs` endpoint.
+ *
+ * Every call targets the same `/logs` route; the server picks the scene from
+ * the signed metadata:
+ *   - worlds  → `sceneId: "<world>.dcl.eth"` (+ `parcel` for multi-scene worlds)
+ *   - Genesis → `parcel: "x,y"` only
+ *
+ * `parcel` and `realmName` are always set. `realmName` defaults to `"main"` for
+ * Genesis, matching the convention used by other signed-fetch emitters
+ * (hammurabi worker, unity explorer, kernel).
+ */
+function buildLogsRequest(baseURL, world, position) {
+    const metadata = JSON.stringify({
+        parcel: position ?? '0,0',
+        realmName: world ? `${world}.dcl.eth` : 'main',
+        ...(world && { sceneId: `${world}.dcl.eth` })
+    });
+    return {
+        logsUrl: `${baseURL}/logs`,
+        pathname: '/logs',
+        metadata
+    };
+}
+async function main(options) {
+    const { logger } = options.components;
+    const projectRoot = (0, path_1.resolve)(process.cwd(), options.args['--dir'] || '.');
+    const positionArg = options.args['--position'];
+    const worldArg = options.args['--world'];
+    const position = positionArg ? normalizePosition(positionArg) : undefined;
+    let world;
+    if (worldArg) {
+        world = worldArg.replace(/\.dcl\.eth$/i, '');
+    }
+    else if (!position) {
+        // no --world nor --position: fall back to scene.json in the current directory
+        await (0, workspace_validations_1.getValidWorkspace)(options.components, projectRoot);
+        const sceneJson = await (0, scene_validations_1.getValidSceneJson)(options.components, projectRoot);
+        const worldName = sceneJson.worldConfiguration?.name;
+        if (!worldName) {
+            throw new error_1.CliError('SERVER_LOGS_MISSING_WORLD', 'Provide --world (with optional --position) for worlds, or --position alone for Genesis City scenes. ' +
+                'Alternatively, run from a project whose scene.json defines worldConfiguration.name.');
+        }
+        world = worldName.replace(/\.dcl\.eth$/i, '');
+    }
+    const displayLabel = world
+        ? position
+            ? `${world}.dcl.eth ${position}`
+            : `${world}.dcl.eth`
+        : `Genesis City ${position}`;
+    logger.info(`Viewing logs for ${displayLabel}`);
+    const baseURL = options.args['--target'] || DEFAULT_SERVER;
+    const { logsUrl, pathname, metadata } = buildLogsRequest(baseURL, world, position);
+    // Linker dApp options
+    const linkerPort = options.args['--port'];
+    const openBrowser = !options.args['--no-browser'];
+    const isHttps = !!options.args['--https'];
+    const linkOptions = { linkerPort, openBrowser, isHttps };
+    const awaitResponse = (0, fp_future_1.default)();
+    const timestamp = String(Date.now());
+    // Build the payload to sign: method:path:timestamp:metadata
+    const payload = ['get', pathname, timestamp, metadata].join(':').toLowerCase();
+    let authHeaders = {};
+    const { program } = await getAddressAndSignature(options.components, awaitResponse, payload, displayLabel, baseURL, linkOptions, async (linkerResponse) => {
+        authHeaders = (0, auth_chain_headers_1.createAuthChainHeaders)(linkerResponse.authChain, timestamp, metadata);
+    });
+    try {
+        await awaitResponse;
+        logger.info('Authentication successful!');
+        // Close the browser window
+        if (program) {
+            await program.stop();
+        }
+        // Start streaming logs
+        await streamLogs(options.components, logsUrl, authHeaders);
+    }
+    catch (e) {
+        (0, beautiful_logs_1.printError)(logger, 'Failed to authenticate:', e);
+        throw e;
+    }
+    finally {
+        if (program) {
+            void program.stop();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/sdk-server-logs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sdk-server-logs/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/start/dcl-env.d.ts

@@ -0,0 +1,16 @@
+export declare function webExplorerBaseUrl(dclenv: string): string;
+/** Extra query params for the web client under a non-default environment. */
+export declare function webExplorerEnvParams(dclenv: string): string;
+/**
+ * Environment args for the locally-spawned engine. `--base-domain` re-points every backend
+ * host the engine composes, Pulse included; the gatekeeper pin is the temporary exception.
+ */
+export declare function engineEnvArgs(dclenv: string): string[];
+/** Pulse endpoint for deep-linked native clients (ENet); undefined = the client's default. */
+export declare function pulseServerNative(dclenv: string): string | undefined;
+/**
+ * Pulse params for the mobile preview deep link: the LSD realm key — stated explicitly so a
+ * phone-side explorer can join the partition without re-deriving it — plus the environment's
+ * Pulse endpoint when it is not the production default.
+ */
+export declare function lsdDeepLinkPulseParams(projectRoot: string, dclenv: string): string;

package/dist/commands/start/dcl-env.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webExplorerBaseUrl = webExplorerBaseUrl;
+exports.webExplorerEnvParams = webExplorerEnvParams;
+exports.engineEnvArgs = engineEnvArgs;
+exports.pulseServerNative = pulseServerNative;
+exports.lsdDeepLinkPulseParams = lsdDeepLinkPulseParams;
+// Everything `--dclenv` selects for the preview lives here. The default (org) needs no
+// overrides. Zone runs its OWN Pulse server with identical realm names, so a zone preview
+// must land every party on it: the zone-hosted web client and a --base-domain zone engine
+// derive `pulse-server.decentraland.zone` themselves (bevy-explorer#1224); only parties
+// with no zone base domain — native clients launched by deep link — need it stated.
+const lsd_realm_1 = require("../../logic/lsd-realm");
+function webExplorerBaseUrl(dclenv) {
+    // bevy-web is deployed on decentraland.org and decentraland.zone only; the zone page
+    // resolves its base domain from its own host, which re-points its Pulse fallback too
+    return `https://decentraland.${dclenv === 'zone' ? 'zone' : 'org'}/bevy-web/`;
+}
+// TEMPORARY: the preview gatekeeper has no zone deployment yet, so zone launches pin that
+// one service back to org — server and web client alike — or scene-room minting fails.
+// Drop both pins once comms-gatekeeper-local is deployed on zone.
+const ORG_PREVIEW_GATEKEEPER = 'https://comms-gatekeeper-local.decentraland.org';
+/** Extra query params for the web client under a non-default environment. */
+function webExplorerEnvParams(dclenv) {
+    if (dclenv !== 'zone')
+        return '';
+    return `&previewGatekeeper=${encodeURIComponent(ORG_PREVIEW_GATEKEEPER)}`;
+}
+/**
+ * Environment args for the locally-spawned engine. `--base-domain` re-points every backend
+ * host the engine composes, Pulse included; the gatekeeper pin is the temporary exception.
+ */
+function engineEnvArgs(dclenv) {
+    if (dclenv !== 'zone')
+        return [];
+    return ['--base-domain=decentraland.zone', `--preview-gatekeeper=${ORG_PREVIEW_GATEKEEPER}`];
+}
+/** Pulse endpoint for deep-linked native clients (ENet); undefined = the client's default. */
+function pulseServerNative(dclenv) {
+    return dclenv === 'zone' ? 'pulse-server.decentraland.zone:7777' : undefined;
+}
+/**
+ * Pulse params for the mobile preview deep link: the LSD realm key — stated explicitly so a
+ * phone-side explorer can join the partition without re-deriving it — plus the environment's
+ * Pulse endpoint when it is not the production default.
+ */
+function lsdDeepLinkPulseParams(projectRoot, dclenv) {
+    const server = pulseServerNative(dclenv);
+    return `&pulse-realm=${encodeURIComponent((0, lsd_realm_1.lsdRealmKey)(projectRoot))}` + (server ? `&pulse-server=${server}` : '');
+}
+//# sourceMappingURL=dcl-env.js.map

package/dist/commands/start/dcl-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcl-env.js","sourceRoot":"","sources":["../../../src/commands/start/dcl-env.ts"],"names":[],"mappings":";;AAOA,gDAIC;AAQD,oDAGC;AAMD,sCAGC;AAGD,8CAEC;AAOD,wDAGC;AA9CD,uFAAuF;AACvF,0FAA0F;AAC1F,0FAA0F;AAC1F,wFAAwF;AACxF,oFAAoF;AACpF,qDAAmD;AAEnD,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,qFAAqF;IACrF,qFAAqF;IACrF,OAAO,wBAAwB,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,YAAY,CAAA;AAC/E,CAAC;AAED,0FAA0F;AAC1F,uFAAuF;AACvF,kEAAkE;AAClE,MAAM,sBAAsB,GAAG,iDAAiD,CAAA;AAEhF,6EAA6E;AAC7E,SAAgB,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,CAAA;IAChC,OAAO,sBAAsB,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,CAAA;AAC3E,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,CAAA;IAChC,OAAO,CAAC,iCAAiC,EAAE,wBAAwB,sBAAsB,EAAE,CAAC,CAAA;AAC9F,CAAC;AAED,8FAA8F;AAC9F,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9E,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,WAAmB,EAAE,MAAc;IACxE,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACxC,OAAO,gBAAgB,kBAAkB,CAAC,IAAA,uBAAW,EAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACnH,CAAC"}

package/dist/commands/start/index.d.ts

@@ -38,6 +38,7 @@ export declare const args: {
     '--multi-instance': BooleanConstructor;
     '--asset-bundles': BooleanConstructor;
     '--no-client': BooleanConstructor;
+    '--no-server': BooleanConstructor;
     '--mcp': BooleanConstructor;
     '--mcp-port': NumberConstructor;
 };