sol-dbg 0.4.2 → 0.6.1

package/dist/debug/tracers/transformers/ext_stack.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.topExtFrame = topExtFrame;
+exports.getContractInfo = getContractInfo;
+exports.getCode = getCode;
+exports.addExternalFrame = addExternalFrame;
+const util_1 = require("@ethereumjs/util");
+const solc_typed_ast_1 = require("solc-typed-ast");
+const artifacts_1 = require("../../../artifacts");
+const utils_1 = require("../../../utils");
+const abi_1 = require("../../abi");
+const opcodes_1 = require("../../opcodes");
+const types_1 = require("../../types");
+function topExtFrame(arg) {
+    if ((0, types_1.isFrame)(arg)) {
+        return arg.kind === types_1.FrameKind.InternalCall ? arg.nearestExtFrame : arg;
+    }
+    if (!(arg instanceof Array)) {
+        arg = arg.stack;
+    }
+    (0, solc_typed_ast_1.assert)(arg.length > 0, `Empty stack!`);
+    return arg[arg.length - 1];
+}
+function getContractInfo(step) {
+    return topExtFrame(step).info;
+}
+function getCode(step) {
+    return topExtFrame(step).code;
+}
+/**
+ * Given a contract info and a function selector find the (potentially inherited) entry point (function or public var getter).
+ * @param info
+ * @param selector
+ * @returns
+ */
+function findEntryPoint(info, selector, artifactManager) {
+    if (info.ast === undefined) {
+        return undefined;
+    }
+    const contract = info.ast;
+    const infer = artifactManager.infer(info.artifact.compilerVersion);
+    return (0, abi_1.findMethodBySelector)(selector, contract, infer);
+}
+/**
+ * Build a `CallFrame` from the given `sender` address, `receiver` address, `data` `Uint8Array`, (msg.data) and the current trace step number.
+ */
+function makeCallFrame(sender, receiver, codeAddress, data, receiverCode, codeHash, step, artifactManager) {
+    const contractInfo = codeHash === undefined ? codeHash : artifactManager.getContractFromMDHash(codeHash);
+    const selector = (0, util_1.bytesToHex)(data.slice(0, 4)).slice(2);
+    let callee;
+    let args;
+    if (contractInfo && contractInfo.ast) {
+        const abiVersion = contractInfo.artifact.abiEncoderVersion;
+        const infer = artifactManager.infer(contractInfo.artifact.compilerVersion);
+        callee = findEntryPoint(contractInfo, selector, artifactManager);
+        if (callee !== undefined) {
+            try {
+                args = (0, abi_1.buildMsgDataViews)(callee, data, types_1.DataLocationKind.CallData, infer, abiVersion);
+            }
+            catch (e) {
+                args = undefined;
+            }
+        }
+    }
+    return {
+        kind: types_1.FrameKind.Call,
+        sender, // TODO: This should be Address
+        msgData: data,
+        receiver: receiver, // TODO: This should be Address
+        code: receiverCode,
+        info: contractInfo,
+        callee,
+        address: receiver,
+        startStep: step,
+        arguments: args,
+        codeMdHash: codeHash,
+        codeAddress,
+        internalFrames: []
+    };
+}
+/**
+ * Build a `CreationFrame` from the given `sender` address, `data` `Uint8Array`(msg.data) and the current trace step number.
+ */
+function makeCreationFrame(sender, data, step, artifactManager) {
+    const contractInfo = artifactManager.getContractFromCreationBytecode(data);
+    let args;
+    const callee = contractInfo && contractInfo.ast ? contractInfo.ast.vConstructor : undefined;
+    if (contractInfo && callee instanceof solc_typed_ast_1.FunctionDefinition) {
+        // TODO: Try and find the arguments inside the creation code and decode them
+    }
+    return {
+        kind: types_1.FrameKind.Creation,
+        sender,
+        msgData: data,
+        code: data,
+        info: contractInfo,
+        callee,
+        address: utils_1.ZERO_ADDRESS,
+        startStep: step,
+        arguments: args,
+        codeMdHash: (0, artifacts_1.getCreationCodeHash)(data),
+        internalFrames: []
+    };
+}
+/**
+ * Decode a *CALL* instruction. Computes:
+ * 1. The receiver address
+ * 2. The code address
+ * 3. The msg.data
+ * @param step
+ */
+function decodeCall(step) {
+    const op = step.op;
+    (0, solc_typed_ast_1.assert)(op.opcode === opcodes_1.OPCODES.CALL ||
+        op.opcode === opcodes_1.OPCODES.CALLCODE ||
+        op.opcode === opcodes_1.OPCODES.DELEGATECALL ||
+        op.opcode === opcodes_1.OPCODES.STATICCALL, `Unexpected call instruction {0}`, op.mnemonic);
+    const stackTop = step.evmStack.length - 1;
+    const argStackOff = op.opcode === opcodes_1.OPCODES.CALL || op.opcode === opcodes_1.OPCODES.CALLCODE ? 3 : 2;
+    const argSizeStackOff = argStackOff + 1;
+    const receiverArg = (0, utils_1.wordToAddress)(step.evmStack[stackTop - 1]);
+    const argOff = (0, utils_1.bigEndianBufToNumber)(step.evmStack[stackTop - argStackOff]);
+    const argSize = (0, utils_1.bigEndianBufToNumber)(step.evmStack[stackTop - argSizeStackOff]);
+    const receiver = op.opcode === opcodes_1.OPCODES.DELEGATECALL ? step.address : receiverArg;
+    const codeAddr = receiverArg;
+    const msgData = step.memory.slice(argOff, argOff + argSize);
+    return [receiver, codeAddr, msgData];
+}
+/**
+ * Adds external frame info for each step
+ */
+async function addExternalFrame(vm, step, state, trace, artifactManager, tx) {
+    let extFrame;
+    if (trace.length === 0) {
+        const sender = tx.getSenderAddress();
+        if (tx.to === undefined) {
+            extFrame = makeCreationFrame(sender, tx.data, 0, artifactManager);
+        }
+        else {
+            const code = await vm.stateManager.getContractCode(tx.to);
+            /// @todo remove - arbitrary restriction, only good for debugging
+            (0, solc_typed_ast_1.assert)(code.length > 0, "Missing code for address {0}", tx.to.toString());
+            const codeHash = (0, artifacts_1.getCodeHash)(code);
+            extFrame = makeCallFrame(sender, tx.to, tx.to, tx.data, code, codeHash, 0, artifactManager);
+        }
+        return {
+            stack: [extFrame],
+            ...state
+        };
+    }
+    const lastStep = trace[trace.length - 1];
+    if (lastStep.depth === state.depth) {
+        return {
+            stack: lastStep.stack,
+            ...state
+        };
+    }
+    const lastStackTop = lastStep.evmStack.length - 1;
+    const lastOp = lastStep.op;
+    if (state.depth > lastStep.depth) {
+        (0, solc_typed_ast_1.assert)(state.depth === lastStep.depth + 1, `Unexpected depth increase by more than 1 on step {0}`, trace.length);
+        (0, solc_typed_ast_1.assert)((0, opcodes_1.increasesDepth)(lastOp), `Unexpected depth increase on op ${lastOp.mnemonic}`);
+        if ((0, opcodes_1.createsContract)(lastOp)) {
+            // Contract creation call
+            const off = (0, utils_1.bigEndianBufToNumber)(lastStep.evmStack[lastStackTop - 1]);
+            const size = (0, utils_1.bigEndianBufToNumber)(lastStep.evmStack[lastStackTop - 2]);
+            const creationBytecode = lastStep.memory.slice(off, off + size);
+            extFrame = makeCreationFrame(lastStep.address, creationBytecode, trace.length, artifactManager);
+        }
+        else {
+            const [receiver, codeAddr, msgData] = decodeCall(lastStep);
+            const code = await vm.stateManager.getContractCode(codeAddr);
+            const codeHash = (0, artifacts_1.getCodeHash)(code);
+            extFrame = await makeCallFrame(lastStep.address, receiver, codeAddr, msgData, code, codeHash, trace.length, artifactManager);
+        }
+        return {
+            stack: [...lastStep.stack, extFrame],
+            ...state
+        };
+    }
+    else {
+        const stack = [...lastStep.stack];
+        // External return or exception
+        let nFramesPopped = lastStep.depth - state.depth;
+        // Pop as many external frames as neccessary to match the decrease in
+        // depth reported by web3. We need the loop since we don't count the internal frames as decreasing depth
+        while (nFramesPopped > 0 && stack.length > 0) {
+            const topFrame = stack[stack.length - 1];
+            if (topFrame.kind === types_1.FrameKind.Creation || topFrame.kind === types_1.FrameKind.Call) {
+                nFramesPopped--;
+            }
+            stack.pop();
+        }
+        return {
+            stack: stack,
+            ...state
+        };
+    }
+}
+//# sourceMappingURL=ext_stack.js.map

package/dist/debug/tracers/transformers/ext_stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext_stack.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/ext_stack.ts"],"names":[],"mappings":";;AA+BA,kCAWC;AAED,0CAEC;AAED,0BAEC;AAsJD,4CAqHC;AA3TD,2CAAuD;AAEvD,mDAAiF;AACjF,kDAK4B;AAC5B,0CAAmF;AACnF,mCAAoE;AAEpE,2CAAyE;AACzE,uCASqB;AAOrB,SAAgB,WAAW,CAAC,GAAgD;IACxE,IAAI,IAAA,eAAO,EAAC,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,IAAI,KAAK,iBAAS,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAA,uBAAM,EAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,eAAe,CAAC,IAAuB;IACnD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,SAAgB,OAAO,CAAC,IAAuB;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACnB,IAAkB,EAClB,QAA6B,EAC7B,eAAiC;IAEjC,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;IAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEnE,OAAO,IAAA,0BAAoB,EAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAClB,MAAe,EACf,QAAiB,EACjB,WAAoB,EACpB,IAAgB,EAChB,YAAwB,EACxB,QAA+B,EAC/B,IAAY,EACZ,eAAiC;IAEjC,MAAM,YAAY,GACd,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAExF,MAAM,QAAQ,GAAwB,IAAA,iBAAU,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5E,IAAI,MAA4D,CAAC;IACjE,IAAI,IAAuD,CAAC;IAE5D,IAAI,YAAY,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAE3E,MAAM,GAAG,cAAc,CAAC,YAAY,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAEjE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,IAAI,GAAG,IAAA,uBAAiB,EACpB,MAAM,EACN,IAAI,EACJ,wBAAgB,CAAC,QAAQ,EACzB,KAAK,EACL,UAAU,CACb,CAAC;YACN,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,GAAG,SAAS,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,EAAE,iBAAS,CAAC,IAAI;QACpB,MAAM,EAAE,+BAA+B;QACvC,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,QAAQ,EAAE,+BAA+B;QACnD,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,MAAM;QACN,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,QAAQ;QACpB,WAAW;QACX,cAAc,EAAE,EAAE;KACrB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACtB,MAAe,EACf,IAAgB,EAChB,IAAY,EACZ,eAAiC;IAEjC,MAAM,YAAY,GAAG,eAAe,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;IAC3E,IAAI,IAAuD,CAAC;IAC5D,MAAM,MAAM,GAAG,YAAY,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5F,IAAI,YAAY,IAAI,MAAM,YAAY,mCAAkB,EAAE,CAAC;QACvD,4EAA4E;IAChF,CAAC;IAED,OAAO;QACH,IAAI,EAAE,iBAAS,CAAC,QAAQ;QACxB,MAAM;QACN,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,YAAY;QAClB,MAAM;QACN,OAAO,EAAE,oBAAY;QACrB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAA,+BAAmB,EAAC,IAAI,CAAC;QACrC,cAAc,EAAE,EAAE;KACrB,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,IAAmB;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACnB,IAAA,uBAAM,EACF,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,IAAI;QACtB,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,QAAQ;QAC9B,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,YAAY;QAClC,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,UAAU,EACpC,iCAAiC,EACjC,EAAE,CAAC,QAAQ,CACd,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAA,4BAAoB,EAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAA,4BAAoB,EAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC;IAEhF,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IACjF,MAAM,QAAQ,GAAG,WAAW,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAE5D,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAClC,EAAM,EACN,IAAqB,EACrB,KAAQ,EACR,KAAmC,EACnC,eAAiC,EACjC,EAAoB;IAEpB,IAAI,QAAuB,CAAC;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;QAErC,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACtB,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAE1D,iEAAiE;YACjE,IAAA,uBAAM,EAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,8BAA8B,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YAE1E,MAAM,QAAQ,GAAG,IAAA,uBAAW,EAAC,IAAI,CAAC,CAAC;YAEnC,QAAQ,GAAG,aAAa,CACpB,MAAM,EACN,EAAE,CAAC,EAAE,EACL,EAAE,CAAC,EAAE,EACL,EAAE,CAAC,IAAI,EACP,IAAI,EACJ,QAAQ,EACR,CAAC,EACD,eAAe,CAClB,CAAC;QACN,CAAC;QAED,OAAO;YACH,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,GAAG,KAAK;SACX,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzC,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO;YACH,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,GAAG,KAAK;SACX,CAAC;IACN,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAA,uBAAM,EACF,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,EAClC,sDAAsD,EACtD,KAAK,CAAC,MAAM,CACf,CAAC;QACF,IAAA,uBAAM,EAAC,IAAA,wBAAc,EAAC,MAAM,CAAC,EAAE,mCAAmC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErF,IAAI,IAAA,yBAAe,EAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,yBAAyB;YACzB,MAAM,GAAG,GAAG,IAAA,4BAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;YACvE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;YAEhE,QAAQ,GAAG,iBAAiB,CACxB,QAAQ,CAAC,OAAO,EAChB,gBAAgB,EAChB,KAAK,CAAC,MAAM,EACZ,eAAe,CAClB,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAE3D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAA,uBAAW,EAAC,IAAI,CAAC,CAAC;YAEnC,QAAQ,GAAG,MAAM,aAAa,CAC1B,QAAQ,CAAC,OAAO,EAChB,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,KAAK,CAAC,MAAM,EACZ,eAAe,CAClB,CAAC;QACN,CAAC;QAED,OAAO;YACH,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;YACpC,GAAG,KAAK;SACX,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,+BAA+B;QAC/B,IAAI,aAAa,GAAG,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAEjD,qEAAqE;QACrE,wGAAwG;QACxG,OAAO,aAAa,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEzC,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAS,CAAC,IAAI,EAAE,CAAC;gBAC3E,aAAa,EAAE,CAAC;YACpB,CAAC;YAED,KAAK,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,OAAO;YACH,KAAK,EAAE,KAAK;YACZ,GAAG,KAAK;SACX,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/debug/tracers/transformers/index.d.ts

@@ -0,0 +1,12 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+export type TransformerF<T extends object, T1 extends T> = (vm: VM, step: InterpreterStep, state: T, trace: T1[]) => T1;
+export * from "./basic_info";
+export * from "./contract_lifetime";
+export * from "./events";
+export * from "./ext_stack";
+export * from "./int_stack";
+export * from "./keccak256_invert";
+export * from "./op";
+export * from "./source";
+//# sourceMappingURL=index.d.ts.map

package/dist/debug/tracers/transformers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,CAAC,IAAI,CACvD,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,EAAE,EAAE,KACV,EAAE,CAAC;AAER,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/dist/debug/tracers/transformers/index.js

@@ -0,0 +1,25 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./basic_info"), exports);
+__exportStar(require("./contract_lifetime"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./ext_stack"), exports);
+__exportStar(require("./int_stack"), exports);
+__exportStar(require("./keccak256_invert"), exports);
+__exportStar(require("./op"), exports);
+__exportStar(require("./source"), exports);
+//# sourceMappingURL=index.js.map

package/dist/debug/tracers/transformers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,+CAA6B;AAC7B,sDAAoC;AACpC,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,qDAAmC;AACnC,uCAAqB;AACrB,2CAAyB"}

package/dist/debug/tracers/transformers/int_stack.d.ts

@@ -0,0 +1,13 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+import { IArtifactManager } from "../../artifact_manager";
+import { ExternalFrame, Frame } from "../../types";
+import { BasicStepInfo } from "./basic_info";
+import { ExternalFrameInfo } from "./ext_stack";
+import { SourceInfo } from "./source";
+export declare function topFrame(stack: ExternalFrame[] | ExternalFrameInfo): Frame;
+/**
+ * Adds external frame info for each step
+ */
+export declare function addInternalFrame<T extends object & BasicStepInfo & ExternalFrameInfo & SourceInfo>(vm: VM, step: InterpreterStep, state: T, trace: T[], artifactManager: IArtifactManager, strict: boolean): Promise<T>;
+//# sourceMappingURL=int_stack.d.ts.map

package/dist/debug/tracers/transformers/int_stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"int_stack.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/int_stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAgB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAGH,aAAa,EACb,KAAK,EAIR,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,iBAAiB,GAAG,KAAK,CAQ1E;AA2DD;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,CAAC,SAAS,MAAM,GAAG,aAAa,GAAG,iBAAiB,GAAG,UAAU,EAEjE,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,CAAC,EAAE,EACV,eAAe,EAAE,gBAAgB,EACjC,MAAM,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC,CAkGZ"}

package/dist/debug/tracers/transformers/int_stack.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.topFrame = topFrame;
+exports.addInternalFrame = addInternalFrame;
+const solc_typed_ast_1 = require("solc-typed-ast");
+const decoding_1 = require("../../decoding");
+const types_1 = require("../../types");
+const ext_stack_1 = require("./ext_stack");
+function topFrame(stack) {
+    const topExt = (0, ext_stack_1.topExtFrame)(stack);
+    if (topExt.internalFrames === undefined || topExt.internalFrames.length === 0) {
+        return topExt;
+    }
+    return topExt.internalFrames[topExt.internalFrames.length - 1];
+}
+/**
+ * WIP: TODO document
+ */
+function buildFunArgViews(callee, stack, contractInfo, artifactManager) {
+    const res = [];
+    let formals;
+    const infer = artifactManager.infer(contractInfo.artifact.compilerVersion);
+    try {
+        formals =
+            callee instanceof solc_typed_ast_1.FunctionDefinition
+                ? callee.vParameters.vParameters.map((argDef) => [
+                    argDef.name,
+                    infer.variableDeclarationToTypeNode(argDef)
+                ])
+                : infer
+                    .getterArgsAndReturn(callee)[0]
+                    .map((typ, i) => [`ARG_${i}`, typ]);
+    }
+    catch (e) {
+        // `variableDeclarationToTypeNode` may fail when referencing structs/contracts that are defined
+        // in SourceUnits that are missing
+        return undefined;
+    }
+    let offsetFromTop = -1;
+    for (let i = formals.length - 1; i >= 0; i--) {
+        const [name, typ] = formals[i];
+        const stackSize = (0, decoding_1.isCalldataType2Slots)(typ) ? 2 : 1;
+        offsetFromTop += stackSize;
+        if (offsetFromTop > stack.length) {
+            // Stack underflow. Could be due to optimized code?
+            return undefined;
+        }
+        res.unshift([
+            name,
+            {
+                type: typ,
+                loc: {
+                    kind: types_1.DataLocationKind.Stack,
+                    offsetFromTop
+                }
+            }
+        ]);
+    }
+    return res;
+}
+/**
+ * Adds external frame info for each step
+ */
+async function addInternalFrame(vm, step, state, trace, artifactManager, strict) {
+    // No internal stack frame on first step of trace
+    if (trace.length === 0) {
+        return state;
+    }
+    const lastStep = trace[trace.length - 1];
+    // External call/return - no change to internal stack
+    if (lastStep.depth !== state.depth) {
+        return state;
+    }
+    // There are 2 ways to enter an internal function:
+    let enteringInternalFun = false;
+    //  1. Jumping into an internal function (the previous instruction is a JUMP with source map jump index i)
+    if (state.op.mnemonic === "JUMPDEST" &&
+        lastStep.op.mnemonic === "JUMP" &&
+        lastStep.src &&
+        lastStep.src.jump === "i") {
+        enteringInternalFun = true;
+    }
+    const ast = state.astNode;
+    const curExtFrame = (0, ext_stack_1.topExtFrame)(state.stack);
+    //  2. Fall-through (the previous instruction is literally the pervious instruction in the contract body,
+    //      AND the current JUMPDEST corresponds to a whole function, AND the pervious instructions' callee is different
+    //      from the current instruction's function.
+    if (!enteringInternalFun &&
+        state.op.mnemonic === "JUMPDEST" &&
+        (ast instanceof solc_typed_ast_1.FunctionDefinition ||
+            (ast instanceof solc_typed_ast_1.VariableDeclaration && ast.stateVariable)) &&
+        topFrame(lastStep.stack).callee !== ast) {
+        enteringInternalFun = true;
+    }
+    if (enteringInternalFun) {
+        let args;
+        if (ast instanceof solc_typed_ast_1.FunctionDefinition ||
+            (ast instanceof solc_typed_ast_1.VariableDeclaration && ast.stateVariable)) {
+            (0, solc_typed_ast_1.assert)(curExtFrame.info !== undefined, ``);
+            args = buildFunArgViews(ast, state.evmStack, curExtFrame.info, artifactManager);
+        }
+        const newFrame = {
+            kind: types_1.FrameKind.InternalCall,
+            nearestExtFrame: curExtFrame,
+            callee: ast,
+            offset: state.pc,
+            startStep: trace.length,
+            arguments: args
+        };
+        const newInternalFrames = [...curExtFrame.internalFrames, newFrame];
+        return {
+            ...state,
+            stack: [
+                ...state.stack.slice(0, -1),
+                { ...curExtFrame, internalFrames: newInternalFrames }
+            ]
+        };
+    }
+    // Returning from an internal function call
+    if (state.op.mnemonic === "JUMP" && state.src && state.src.jump === "o") {
+        const curFrame = topFrame(state.stack);
+        const newInternalFrames = curExtFrame.internalFrames.slice(0, -1);
+        if (strict) {
+            (0, solc_typed_ast_1.assert)(curFrame.kind === types_1.FrameKind.InternalCall, `Mismatched internal return from frame `, curFrame.kind);
+        }
+        else {
+            // @todo log an error somewhere
+        }
+        return {
+            ...state,
+            stack: [
+                ...state.stack.slice(0, -1),
+                { ...curExtFrame, internalFrames: newInternalFrames }
+            ]
+        };
+    }
+    return state;
+}
+//# sourceMappingURL=int_stack.js.map

package/dist/debug/tracers/transformers/int_stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"int_stack.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/int_stack.ts"],"names":[],"mappings":"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"}

package/dist/debug/tracers/transformers/keccak256_invert.d.ts

@@ -0,0 +1,29 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+import { BasicStepInfo } from "./basic_info";
+export type KeccakPreimageMap = Map<bigint, Uint8Array>;
+export interface Keccak256InvertInfo {
+    keccak?: {
+        from: Uint8Array;
+        to: bigint;
+    };
+}
+/**
+ * Given a trace of contract creation/deletion event compute a gen/kill set summary for the trace.
+ */
+export declare function getKeccakPreimages(trace: Keccak256InvertInfo[]): KeccakPreimageMap;
+/**
+ * A map index is computed by doing keccak(key . p) where p is the slot of the
+ * map and key is the original key. MapKeys is a map from p => [... [keyN,
+ * keccak(keyN . p)] ... ]
+ */
+export type MapKeys = Map<bigint, Array<[Uint8Array, bigint]>>;
+/**
+ * Build a `MapKeys` map from a KeccakPreimageMap
+ */
+export declare function getMapKeys(preImageMap: KeccakPreimageMap): MapKeys;
+/**
+ * Add keccak256 pre-image info. Note we add it on the next instruction after the keccak
+ */
+export declare function addKeccakInvertInfo<T extends object & BasicStepInfo>(vm: VM, step: InterpreterStep, state: T, trace: Array<T & Keccak256InvertInfo>): T & Keccak256InvertInfo;
+//# sourceMappingURL=keccak256_invert.d.ts.map

package/dist/debug/tracers/transformers/keccak256_invert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keccak256_invert.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/keccak256_invert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACxD,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,EAAE;QACL,IAAI,EAAE,UAAU,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;KACd,CAAC;CACL;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,iBAAiB,CAOlF;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAuBlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,EAChE,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,mBAAmB,CAAC,GACtC,CAAC,GAAG,mBAAmB,CAyBzB"}

package/dist/debug/tracers/transformers/keccak256_invert.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKeccakPreimages = getKeccakPreimages;
+exports.getMapKeys = getMapKeys;
+exports.addKeccakInvertInfo = addKeccakInvertInfo;
+const utils_1 = require("../../../utils");
+const opcodes_1 = require("../../opcodes");
+/**
+ * Given a trace of contract creation/deletion event compute a gen/kill set summary for the trace.
+ */
+function getKeccakPreimages(trace) {
+    return trace.reduce((m, info) => {
+        if (info.keccak) {
+            m.set(info.keccak.to, info.keccak.from);
+        }
+        return m;
+    }, new Map());
+}
+/**
+ * Build a `MapKeys` map from a KeccakPreimageMap
+ */
+function getMapKeys(preImageMap) {
+    const res = new Map();
+    for (const [keccakVal, origKey] of preImageMap) {
+        // Since preimages for map indexing are a concatenation of the real key, and the 32bit
+        // storage slot, we don't care about any keccak operations not gerater than 32 bytes
+        if (origKey.length <= 32) {
+            continue;
+        }
+        const keySuffix = origKey.slice(-32);
+        const slot = (0, utils_1.bigEndianBufToBigint)(keySuffix);
+        if (!res.has(slot)) {
+            res.set(slot, []);
+        }
+        // Note we don't have to worry about duplicates. Values in KeccakPreimageMap are guaranteed to be unique due to the keys being
+        // their keccaks
+        res.get(slot).push([origKey.slice(0, -32), keccakVal]);
+    }
+    return res;
+}
+/**
+ * Add keccak256 pre-image info. Note we add it on the next instruction after the keccak
+ */
+function addKeccakInvertInfo(vm, step, state, trace) {
+    if (trace.length === 0) {
+        return state;
+    }
+    const lastStep = trace[trace.length - 1];
+    if (!(lastStep.op.opcode === opcodes_1.OPCODES.SHA3)) {
+        return state;
+    }
+    const res = (0, utils_1.bigEndianBufToBigint)(state.evmStack[state.evmStack.length - 1]);
+    const lastStepTop = lastStep.evmStack.length - 1;
+    const off = (0, utils_1.bigEndianBufToNumber)(lastStep.evmStack[lastStepTop]);
+    const size = (0, utils_1.bigEndianBufToNumber)(lastStep.evmStack[lastStepTop - 1]);
+    const preImage = lastStep.memory.slice(off, off + size);
+    return {
+        keccak: {
+            from: preImage,
+            to: res
+        },
+        ...state
+    };
+}
+//# sourceMappingURL=keccak256_invert.js.map

package/dist/debug/tracers/transformers/keccak256_invert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keccak256_invert.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/keccak256_invert.ts"],"names":[],"mappings":";;AAiBA,gDAOC;AAYD,gCAuBC;AAKD,kDA8BC;AA5FD,0CAA4E;AAC5E,2CAAwC;AAWxC;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAA4B;IAC3D,OAAO,KAAK,CAAC,MAAM,CAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,CAAC;IACb,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;AAClB,CAAC;AASD;;GAEG;AACH,SAAgB,UAAU,CAAC,WAA8B;IACrD,MAAM,GAAG,GAAY,IAAI,GAAG,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAC7C,sFAAsF;QACtF,oFAAoF;QACpF,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvB,SAAS;QACb,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,CAAC;QAED,8HAA8H;QAC9H,gBAAgB;QACf,GAAG,CAAC,GAAG,CAAC,IAAI,CAAiC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAC/B,EAAM,EACN,IAAqB,EACrB,KAAQ,EACR,KAAqC;IAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,4BAAoB,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjD,MAAM,GAAG,GAAG,IAAA,4BAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;IAExD,OAAO;QACH,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,GAAG;SACV;QACD,GAAG,KAAK;KACX,CAAC;AACN,CAAC"}

package/dist/debug/tracers/transformers/op.d.ts

@@ -0,0 +1,11 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+import { EVMOpInfo } from "../../opcodes";
+export interface OpInfo {
+    op: EVMOpInfo;
+}
+/**
+ * Adds op info to each step
+ */
+export declare function addOpInfo<T extends object>(vm: VM, step: InterpreterStep, state: T): T & OpInfo;
+//# sourceMappingURL=op.d.ts.map

package/dist/debug/tracers/transformers/op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/op.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAa,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAE/F"}

package/dist/debug/tracers/transformers/op.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addOpInfo = addOpInfo;
+const opcodes_1 = require("../../opcodes");
+/**
+ * Adds op info to each step
+ */
+function addOpInfo(vm, step, state) {
+    return { op: (0, opcodes_1.getOpInfo)(step.opcode.name), ...state };
+}
+//# sourceMappingURL=op.js.map

package/dist/debug/tracers/transformers/op.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"op.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/op.ts"],"names":[],"mappings":";;AAWA,8BAEC;AAXD,2CAAqD;AAMrD;;GAEG;AACH,SAAgB,SAAS,CAAmB,EAAM,EAAE,IAAqB,EAAE,KAAQ;IAC/E,OAAO,EAAE,EAAE,EAAE,IAAA,mBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACzD,CAAC"}

package/dist/debug/tracers/transformers/source.d.ts

@@ -0,0 +1,26 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+import * as sol from "solc-typed-ast";
+import { ExternalFrame } from "../../types";
+import { BasicStepInfo } from "./basic_info";
+import { ExternalFrameInfo } from "./ext_stack";
+export interface SourceInfo {
+    src: sol.DecodedBytecodeSourceMapEntry | undefined;
+    astNode: sol.ASTNode | undefined;
+}
+/**
+ * Helper function to get the source information for the instruction at a given `instrOffset`,
+ * in the context of the external call `ctx`.
+ *
+ * There are several cases this handles:
+ *
+ * 1. If there is no debug info for the contract executing in `ctx` return undefined
+ * 2. If there is debug info, but no AST return only the decoded bytecode sourcemap entry
+ * 3. If there is both debug info and an AST return the decoded source location and any AST nodes that match this location
+ */
+export declare function decodeSourceLoc(instrOffset: number, ctx: ExternalFrame): [sol.DecodedBytecodeSourceMapEntry | undefined, sol.ASTNode | undefined];
+/**
+ * Adds source info for each step (if available)
+ */
+export declare function addSource<T extends object & BasicStepInfo & ExternalFrameInfo>(vm: VM, step: InterpreterStep, state: T): Promise<T & SourceInfo>;
+//# sourceMappingURL=source.d.ts.map

package/dist/debug/tracers/transformers/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAa,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,GAAG,CAAC,6BAA6B,GAAG,SAAS,CAAC;IACnD,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC3B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,aAAa,GACnB,CAAC,GAAG,CAAC,6BAA6B,GAAG,SAAS,EAAE,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAa1E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,GAAG,iBAAiB,EAChF,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAQzB"}

package/dist/debug/tracers/transformers/source.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeSourceLoc = decodeSourceLoc;
+exports.addSource = addSource;
+const artifact_manager_1 = require("../../artifact_manager");
+const types_1 = require("../../types");
+const ext_stack_1 = require("./ext_stack");
+/**
+ * Helper function to get the source information for the instruction at a given `instrOffset`,
+ * in the context of the external call `ctx`.
+ *
+ * There are several cases this handles:
+ *
+ * 1. If there is no debug info for the contract executing in `ctx` return undefined
+ * 2. If there is debug info, but no AST return only the decoded bytecode sourcemap entry
+ * 3. If there is both debug info and an AST return the decoded source location and any AST nodes that match this location
+ */
+function decodeSourceLoc(instrOffset, ctx) {
+    if (!ctx.info) {
+        return [undefined, undefined];
+    }
+    const bytecodeInfo = ctx.kind === types_1.FrameKind.Creation ? ctx.info.bytecode : ctx.info.deployedBytecode;
+    const src = (0, artifact_manager_1.getOffsetSrc)(instrOffset, bytecodeInfo);
+    const astNode = ctx.info.artifact.srcMap.get(`${src.start}:${src.length}:${src.sourceIndex}`);
+    return [src, astNode];
+}
+/**
+ * Adds source info for each step (if available)
+ */
+async function addSource(vm, step, state) {
+    const [src, astNode] = decodeSourceLoc(state.pc, (0, ext_stack_1.topExtFrame)(state.stack));
+    return {
+        src,
+        astNode,
+        ...state
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/debug/tracers/transformers/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/source.ts"],"names":[],"mappings":";;AAuBA,0CAgBC;AAKD,8BAYC;AArDD,6DAAsD;AACtD,uCAAuD;AAEvD,2CAA6D;AAO7D;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC3B,WAAmB,EACnB,GAAkB;IAElB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GACd,GAAG,CAAC,IAAI,KAAK,iBAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAEpF,MAAM,GAAG,GAAG,IAAA,+BAAY,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAE9F,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,SAAS,CAC3B,EAAM,EACN,IAAqB,EACrB,KAAQ;IAER,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,IAAA,uBAAW,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3E,OAAO;QACH,GAAG;QACH,OAAO;QACP,GAAG,KAAK;KACX,CAAC;AACN,CAAC"}