gnoman 0.1.0

package/dist/backend/modules/sandbox/abiLoader.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireSafeAbi = exports.validateFunctionExists = exports.loadAbiFromFile = exports.parseAbi = exports.loadSafeAbi = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const ethers_1 = require("ethers");
+const SAFE_ABI_CANDIDATES = [
+    path_1.default.join(__dirname, 'safe.abi.json'),
+    path_1.default.join(process.cwd(), 'modules/sandbox/safe.abi.json')
+];
+const resolveSafeAbiPath = () => {
+    for (const candidate of SAFE_ABI_CANDIDATES) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
+    }
+    return SAFE_ABI_CANDIDATES[0];
+};
+const loadSafeAbi = () => {
+    const abiSource = (0, fs_1.readFileSync)(resolveSafeAbiPath(), 'utf8');
+    return (0, exports.parseAbi)({ abi: abiSource, name: 'Safe' });
+};
+exports.loadSafeAbi = loadSafeAbi;
+const parseAbi = ({ abi, name }) => {
+    const abiJson = typeof abi === 'string' ? JSON.parse(abi) : abi;
+    const iface = new ethers_1.Interface(abiJson);
+    const functionFragments = iface.fragments.filter((fragment) => fragment.type === 'function');
+    const functions = functionFragments.map((fn) => ({
+        name: fn.name,
+        stateMutability: fn.stateMutability,
+        inputs: fn.inputs.map(mapParam),
+        outputs: fn.outputs?.map(mapParam) ?? [],
+        payable: fn.payable,
+        constant: fn.constant ?? false
+    }));
+    return {
+        name: name ?? functionFragments[0]?.name ?? 'Contract',
+        abi: abiJson,
+        functions
+    };
+};
+exports.parseAbi = parseAbi;
+const mapParam = (fragment) => ({
+    name: fragment.name,
+    type: fragment.type,
+    internalType: fragment.internalType,
+    indexed: fragment.indexed === null
+        ? undefined
+        : fragment.indexed ?? undefined
+});
+const loadAbiFromFile = (filePath, name) => {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        throw new Error(`ABI file not found at ${filePath}`);
+    }
+    const raw = (0, fs_1.readFileSync)(filePath, 'utf8');
+    return (0, exports.parseAbi)({ abi: raw, name: name ?? path_1.default.basename(filePath) });
+};
+exports.loadAbiFromFile = loadAbiFromFile;
+const validateFunctionExists = (metadata, functionName) => {
+    const exists = metadata.functions.some((fn) => fn.name === functionName);
+    if (!exists) {
+        throw new Error(`Function ${functionName} not found in ABI ${metadata.name}`);
+    }
+};
+exports.validateFunctionExists = validateFunctionExists;
+const requireSafeAbi = () => {
+    const safePath = resolveSafeAbiPath();
+    if (!(0, fs_1.existsSync)(safePath)) {
+        throw new Error('Safe ABI definition missing');
+    }
+    const abiSource = (0, fs_1.readFileSync)(safePath, 'utf8');
+    return (0, exports.parseAbi)({ abi: abiSource, name: 'Safe' });
+};
+exports.requireSafeAbi = requireSafeAbi;
+//# sourceMappingURL=abiLoader.js.map

package/dist/backend/modules/sandbox/abiLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abiLoader.js","sourceRoot":"","sources":["../../../../modules/sandbox/abiLoader.ts"],"names":[],"mappings":"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"}

package/dist/backend/modules/sandbox/contractSimulator.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simulateOnFork = exports.simulateContractCall = exports.encodeParameters = exports.buildProvider = void 0;
+const ethers_1 = require("ethers");
+const crypto_1 = require("crypto");
+const TRACE_METHOD = 'debug_traceCall';
+const toHexValue = (value) => {
+    if (!value)
+        return undefined;
+    return (0, ethers_1.isHexString)(value) ? value : `0x${BigInt(value).toString(16)}`;
+};
+const buildProvider = async (rpcUrl) => {
+    const provider = new ethers_1.JsonRpcProvider(rpcUrl);
+    await provider.getNetwork();
+    return provider;
+};
+exports.buildProvider = buildProvider;
+const encodeParameters = (abiInterface, functionName, parameters) => {
+    const fragment = abiInterface.getFunction(functionName);
+    if (!fragment) {
+        throw new Error(`Function ${functionName} not found in ABI`);
+    }
+    const orderedArgs = fragment.inputs.map((input, index) => {
+        if (input.name && input.name in parameters) {
+            return parameters[input.name];
+        }
+        const fallbackKey = `arg_${index}`;
+        if (fallbackKey in parameters) {
+            return parameters[fallbackKey];
+        }
+        throw new Error(`Missing parameter ${input.name || fallbackKey}`);
+    });
+    return abiInterface.encodeFunctionData(functionName, orderedArgs);
+};
+exports.encodeParameters = encodeParameters;
+const decodeReturn = (abiInterface, functionName, data) => {
+    if (!data)
+        return null;
+    try {
+        return abiInterface.decodeFunctionResult(functionName, data);
+    }
+    catch (error) {
+        return { error: error.message };
+    }
+};
+const captureTrace = async (provider, request, callData, from) => {
+    try {
+        const trace = await provider.send(TRACE_METHOD, [
+            {
+                from,
+                to: request.contractAddress,
+                data: callData,
+                gas: request.gasLimit,
+                value: request.value ? toHexValue(request.value) : undefined
+            },
+            'latest',
+            {
+                enableMemory: true,
+                enableReturnData: true,
+                disableStack: false
+            }
+        ]);
+        return trace;
+    }
+    catch (error) {
+        return { error: error.message };
+    }
+};
+const runStaticCall = async (provider, abiInterface, request, callData, from) => {
+    try {
+        const result = await provider.call({
+            to: request.contractAddress,
+            data: callData,
+            from,
+            value: request.value ? toHexValue(request.value) : undefined
+        });
+        return { success: true, result };
+    }
+    catch (error) {
+        return { success: false, error: error };
+    }
+};
+const estimateGas = async (provider, request, callData, from) => {
+    try {
+        const estimate = await provider.estimateGas({
+            to: request.contractAddress,
+            data: callData,
+            from,
+            value: request.value ? toHexValue(request.value) : undefined,
+            gasLimit: request.gasLimit ? BigInt(request.gasLimit) : undefined
+        });
+        return estimate.toString();
+    }
+    catch (error) {
+        return undefined;
+    }
+};
+const simulateContractCall = async (metadata, request) => {
+    const provider = await (0, exports.buildProvider)(request.rpcUrl);
+    const network = await provider.getNetwork();
+    const abiInterface = new ethers_1.Interface(metadata.abi);
+    const contractAddress = (0, ethers_1.getAddress)(request.contractAddress);
+    const fromAddress = request.from ? (0, ethers_1.getAddress)(request.from) : ethers_1.ZeroAddress;
+    const callData = (0, exports.encodeParameters)(abiInterface, request.functionName, request.parameters);
+    const gasEstimate = await estimateGas(provider, { ...request, contractAddress }, callData, fromAddress);
+    const staticResult = await runStaticCall(provider, abiInterface, { ...request, contractAddress }, callData, fromAddress);
+    let decoded = null;
+    let revertReason;
+    if (staticResult.success) {
+        decoded = decodeReturn(abiInterface, request.functionName, staticResult.result);
+    }
+    else {
+        const error = staticResult.error;
+        revertReason = error.message;
+    }
+    const trace = await captureTrace(provider, { ...request, contractAddress }, callData, fromAddress);
+    const record = {
+        id: (0, crypto_1.randomUUID)(),
+        timestamp: new Date().toISOString(),
+        success: staticResult.success,
+        network: {
+            chainId: Number(network.chainId.toString()),
+            name: network.name
+        },
+        gasEstimate,
+        gasLimit: request.gasLimit,
+        returnData: staticResult.success ? staticResult.result : undefined,
+        decodedReturnData: decoded ?? undefined,
+        error: staticResult.success ? undefined : staticResult.error?.message,
+        revertReason,
+        trace,
+        callData,
+        functionName: request.functionName,
+        contractAddress,
+        parameters: request.parameters,
+        forkMode: Boolean(request.fork),
+        rpcUrl: request.rpcUrl,
+        value: request.value
+    };
+    return record;
+};
+exports.simulateContractCall = simulateContractCall;
+const simulateOnFork = async (metadata, request, forkRpcUrl) => {
+    const provider = await (0, exports.buildProvider)(forkRpcUrl);
+    const abiInterface = new ethers_1.Interface(metadata.abi);
+    const contractAddress = (0, ethers_1.getAddress)(request.contractAddress);
+    const callData = (0, exports.encodeParameters)(abiInterface, request.functionName, request.parameters);
+    const fromWallet = ethers_1.Wallet.createRandom().connect(provider);
+    const gasEstimate = await provider.estimateGas({
+        to: contractAddress,
+        data: callData,
+        value: request.value ? toHexValue(request.value) : undefined,
+        gasLimit: request.gasLimit ? BigInt(request.gasLimit) : undefined,
+        from: await fromWallet.getAddress()
+    });
+    try {
+        const response = await provider.call({
+            to: contractAddress,
+            data: callData,
+            from: await fromWallet.getAddress(),
+            value: request.value ? toHexValue(request.value) : undefined
+        });
+        return {
+            id: (0, crypto_1.randomUUID)(),
+            timestamp: new Date().toISOString(),
+            success: true,
+            network: {
+                chainId: Number((await provider.getNetwork()).chainId.toString()),
+                name: (await provider.getNetwork()).name
+            },
+            gasEstimate: gasEstimate.toString(),
+            returnData: response,
+            decodedReturnData: decodeReturn(abiInterface, request.functionName, response) ?? undefined,
+            callData,
+            functionName: request.functionName,
+            contractAddress,
+            parameters: request.parameters,
+            forkMode: true,
+            rpcUrl: forkRpcUrl,
+            value: request.value
+        };
+    }
+    catch (error) {
+        return {
+            id: (0, crypto_1.randomUUID)(),
+            timestamp: new Date().toISOString(),
+            success: false,
+            network: {
+                chainId: Number((await provider.getNetwork()).chainId.toString()),
+                name: (await provider.getNetwork()).name
+            },
+            gasEstimate: gasEstimate.toString(),
+            error: error.message,
+            callData,
+            functionName: request.functionName,
+            contractAddress,
+            parameters: request.parameters,
+            forkMode: true,
+            rpcUrl: forkRpcUrl,
+            value: request.value
+        };
+    }
+};
+exports.simulateOnFork = simulateOnFork;
+//# sourceMappingURL=contractSimulator.js.map

package/dist/backend/modules/sandbox/contractSimulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractSimulator.js","sourceRoot":"","sources":["../../../../modules/sandbox/contractSimulator.ts"],"names":[],"mappings":"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"}

package/dist/backend/modules/sandbox/formBuilder.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildParameterFields = void 0;
+const buildParameterFields = (fn) => {
+    if (!fn)
+        return [];
+    return fn.inputs.map((input, index) => ({
+        name: input.name || `arg_${index}`,
+        type: input.type,
+        placeholder: input.type
+    }));
+};
+exports.buildParameterFields = buildParameterFields;
+//# sourceMappingURL=formBuilder.js.map

package/dist/backend/modules/sandbox/formBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formBuilder.js","sourceRoot":"","sources":["../../../../modules/sandbox/formBuilder.ts"],"names":[],"mappings":";;;AAQO,MAAM,oBAAoB,GAAG,CAAC,EAA2B,EAAoB,EAAE;IACpF,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,EAAE;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,IAAI;KACxB,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAPW,QAAA,oBAAoB,wBAO/B"}

package/dist/backend/modules/sandbox/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sandboxManager_1 = __importDefault(require("./sandboxManager"));
+const sandboxManager = new sandboxManager_1.default();
+exports.default = sandboxManager;
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/backend/modules/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../modules/sandbox/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,sEAA8C;AAE9C,MAAM,cAAc,GAAG,IAAI,wBAAc,EAAE,CAAC;AAE5C,kBAAe,cAAc,CAAC;AAC9B,0CAAwB"}

package/dist/backend/modules/sandbox/localFork.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const events_1 = require("events");
+const fs_1 = __importDefault(require("fs"));
+class LocalFork extends events_1.EventEmitter {
+    constructor(logsDir) {
+        super();
+        this.logsDir = logsDir;
+        this.process = null;
+        this.status = { active: false };
+        const fromEnv = process.env.GNOMAN_FORK_ALLOWLIST?.split(',').map((value) => value.trim()).filter(Boolean);
+        const defaults = ['anvil'];
+        if (fromEnv && fromEnv.length > 0) {
+            this.allowedCommands = new Set(fromEnv.map((command) => command.toLowerCase()));
+            defaults.forEach((command) => this.allowedCommands.add(command));
+        }
+        else {
+            this.allowedCommands = new Set(defaults.map((command) => command.toLowerCase()));
+        }
+    }
+    start(options) {
+        if (this.process) {
+            throw new Error('Fork already running');
+        }
+        const port = options.port ?? 8545;
+        const command = this.sanitizeCommand(options.command);
+        const args = ['--fork-url', options.rpcUrl, '--port', String(port)];
+        if (options.blockNumber !== undefined) {
+            args.push('--fork-block-number', String(options.blockNumber));
+        }
+        const forkWorkspace = options.workspace ?? process.cwd();
+        const logFile = path_1.default.join(this.logsDir, `fork-${Date.now()}.log`);
+        const outStream = fs_1.default.createWriteStream(logFile, { flags: 'a' });
+        const child = (0, child_process_1.spawn)(command, args, {
+            cwd: forkWorkspace,
+            stdio: 'pipe'
+        });
+        child.on('error', (error) => {
+            outStream.write(String(error));
+            this.status = { active: false, error: error.message };
+            this.emit('error', error.message);
+        });
+        child.stdout.on('data', (data) => {
+            outStream.write(data);
+            this.emit('log', data.toString());
+        });
+        child.stderr.on('data', (data) => {
+            outStream.write(data);
+            this.emit('error', data.toString());
+        });
+        child.on('close', (code) => {
+            outStream.close();
+            this.process = null;
+            this.status = { active: false, error: code ? `Fork exited with code ${code}` : undefined };
+            this.emit('stop', this.status);
+        });
+        this.process = child;
+        this.status = {
+            active: true,
+            port,
+            pid: child.pid ?? undefined,
+            startedAt: new Date().toISOString(),
+            rpcUrl: `http://127.0.0.1:${port}`,
+            blockNumber: options.blockNumber,
+            command
+        };
+        this.emit('start', this.status);
+        return this.status;
+    }
+    stop() {
+        if (!this.process) {
+            return this.status;
+        }
+        this.process.kill('SIGTERM');
+        this.process = null;
+        this.status = { active: false };
+        this.emit('stop', this.status);
+        return this.status;
+    }
+    getStatus() {
+        return this.status;
+    }
+    sanitizeCommand(command) {
+        const candidate = command?.trim() ?? 'anvil';
+        if (!/^[A-Za-z0-9._-]+$/.test(candidate)) {
+            throw new Error('Fork command contains unsupported characters');
+        }
+        if (candidate.includes('/') || candidate.includes('\\')) {
+            throw new Error('Fork command cannot include path separators');
+        }
+        if (!this.allowedCommands.has(candidate.toLowerCase())) {
+            throw new Error(`Fork command "${candidate}" is not permitted`);
+        }
+        return candidate;
+    }
+}
+exports.default = LocalFork;
+//# sourceMappingURL=localFork.js.map

package/dist/backend/modules/sandbox/localFork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localFork.js","sourceRoot":"","sources":["../../../../modules/sandbox/localFork.ts"],"names":[],"mappings":"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"}

package/dist/backend/modules/sandbox/sandboxManager.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ethers_1 = require("ethers");
+const abiLoader_1 = require("./abiLoader");
+const localFork_1 = __importDefault(require("./localFork"));
+const contractSimulator_1 = require("./contractSimulator");
+const LOG_DIRECTORY = path_1.default.join(__dirname, 'logs');
+const HISTORY_LIMIT = 100;
+class SandboxManager {
+    constructor(logDir = LOG_DIRECTORY) {
+        this.abiRegistry = new Map();
+        this.history = [];
+        this.logDirectory = logDir;
+        if (!fs_1.default.existsSync(this.logDirectory)) {
+            fs_1.default.mkdirSync(this.logDirectory, { recursive: true });
+        }
+        this.fork = new localFork_1.default(this.logDirectory);
+        this.bootstrapHistory();
+    }
+    bootstrapHistory() {
+        const files = fs_1.default
+            .readdirSync(this.logDirectory)
+            .filter((file) => file.endsWith('.json'))
+            .map((file) => path_1.default.join(this.logDirectory, file))
+            .sort();
+        files.slice(-HISTORY_LIMIT).forEach((file) => {
+            try {
+                const content = fs_1.default.readFileSync(file, 'utf8');
+                const parsed = JSON.parse(content);
+                this.history.push(parsed);
+            }
+            catch (error) {
+                console.error('Failed to parse sandbox log', error);
+            }
+        });
+    }
+    persist(result) {
+        const fileName = path_1.default.join(this.logDirectory, `${result.id}.json`);
+        const replacer = (_key, value) => (typeof value === 'bigint' ? value.toString() : value);
+        fs_1.default.writeFileSync(fileName, JSON.stringify(result, replacer, 2));
+    }
+    getHistory() {
+        return [...this.history].reverse();
+    }
+    clearHistory() {
+        this.history = [];
+        const files = fs_1.default.readdirSync(this.logDirectory).filter((file) => file.endsWith('.json'));
+        for (const file of files) {
+            fs_1.default.unlinkSync(path_1.default.join(this.logDirectory, file));
+        }
+    }
+    loadAbi(abi, name) {
+        const metadata = (0, abiLoader_1.parseAbi)({ abi, name });
+        this.abiRegistry.set(metadata.name, metadata);
+        return metadata;
+    }
+    getAbi(name) {
+        return this.abiRegistry.get(name);
+    }
+    listAbis() {
+        return Array.from(this.abiRegistry.values());
+    }
+    async simulate(metadata, request) {
+        (0, abiLoader_1.validateFunctionExists)(metadata, request.functionName);
+        const forkStatus = this.fork.getStatus();
+        const hasManagedFork = Boolean(forkStatus.active && forkStatus.rpcUrl);
+        const wantsFork = Boolean(request.fork);
+        const hasRemoteFork = Boolean(request.forkRpcUrl);
+        let runOnFork = false;
+        let executionRpcUrl = request.rpcUrl;
+        if (hasManagedFork && wantsFork) {
+            runOnFork = true;
+            executionRpcUrl = forkStatus.rpcUrl;
+        }
+        else if (!hasManagedFork && wantsFork && hasRemoteFork) {
+            runOnFork = true;
+            executionRpcUrl = request.forkRpcUrl;
+        }
+        const sanitized = {
+            ...request,
+            rpcUrl: executionRpcUrl,
+            fork: runOnFork,
+            contractAddress: (0, ethers_1.getAddress)(request.contractAddress)
+        };
+        const result = runOnFork
+            ? await (0, contractSimulator_1.simulateOnFork)(metadata, sanitized, executionRpcUrl)
+            : await (0, contractSimulator_1.simulateContractCall)(metadata, sanitized);
+        const entry = {
+            ...result
+        };
+        this.history.push(entry);
+        if (this.history.length > HISTORY_LIMIT) {
+            this.history = this.history.slice(-HISTORY_LIMIT);
+        }
+        this.persist(entry);
+        return result;
+    }
+    async simulateSafe(request) {
+        const safeAbi = (0, abiLoader_1.requireSafeAbi)();
+        const result = await this.simulate(safeAbi, {
+            rpcUrl: request.rpcUrl,
+            contractAddress: request.safeAddress,
+            functionName: request.functionName,
+            parameters: request.parameters,
+            value: request.value,
+            fork: request.fork,
+            forkBlockNumber: request.forkBlockNumber,
+            forkRpcUrl: request.forkRpcUrl,
+            gasLimit: request.gasLimit,
+            from: request.from
+        });
+        return result;
+    }
+    startFork(rpcUrl, blockNumber, port, command) {
+        return this.fork.start({ rpcUrl, blockNumber, port, command });
+    }
+    stopFork() {
+        return this.fork.stop();
+    }
+    forkStatus() {
+        return this.fork.getStatus();
+    }
+}
+exports.default = SandboxManager;
+//# sourceMappingURL=sandboxManager.js.map

package/dist/backend/modules/sandbox/sandboxManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandboxManager.js","sourceRoot":"","sources":["../../../../modules/sandbox/sandboxManager.ts"],"names":[],"mappings":"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"}

package/dist/backend/modules/sandbox/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/backend/modules/sandbox/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../modules/sandbox/types.ts"],"names":[],"mappings":""}