sol-dbg 0.4.2 → 0.5.0

package/dist/debug/decoding/general.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../../src/debug/decoding/general.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,SAAS,EAET,QAAQ,EACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGH,QAAQ,EAIR,SAAS,EAEZ,MAAM,IAAI,CAAC;AAmDZ,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAO3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAqFnF"}
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../../src/debug/decoding/general.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,SAAS,EAGT,QAAQ,EACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGH,QAAQ,EAGR,SAAS,EAEZ,MAAM,IAAI,CAAC;AAoDZ,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAO3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAqFnF"}

package/dist/debug/decoding/general.js

@@ -6,6 +6,7 @@ const solc_typed_ast_1 = require("solc-typed-ast");
 const abi_1 = require("solc-typed-ast/dist/types/abi");
 const __1 = require("..");
 const __2 = require("../..");
+const transformers_1 = require("../tracers/transformers");
 const calldata_1 = require("./calldata");
 const memory_1 = require("./memory");
 const stack_1 = require("./stack");
@@ -26,7 +27,7 @@ function decodeValInt(typ, loc, state, infer) {
         return res === undefined ? res : res[0];
     }
     if (loc.kind === __1.DataLocationKind.CallData) {
-        const lastExtFrame = (0, __1.lastExternalFrame)(state.stack);
+        const lastExtFrame = (0, transformers_1.topExtFrame)(state.stack);
         let abiType;
         try {
             abiType = infer.toABIEncodedType(typ, abi_1.ABIEncoderVersion.V2);
@@ -69,7 +70,7 @@ function decodeValue(view, state, infer) {
         const kind = solLocToDataKind(typ.location);
         let pointedToLoc;
         if (isCalldataType2Slots(typ)) {
-            const lastExtFrame = (0, __1.lastExternalFrame)(state.stack);
+            const lastExtFrame = (0, transformers_1.topExtFrame)(state.stack);
             let abiType;
             try {
                 abiType = infer.toABIEncodedType(typ, abi_1.ABIEncoderVersion.V2);

package/dist/debug/decoding/general.js.map

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

package/dist/debug/index.d.ts

@@ -2,6 +2,6 @@ export * from "./abi";
 export * from "./artifact_manager";
 export * from "./decoding";
 export * from "./opcodes";
-export * from "./sol_debugger";
+export * from "./tracers";
 export * from "./types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/debug/index.js

@@ -18,6 +18,6 @@ __exportStar(require("./abi"), exports);
 __exportStar(require("./artifact_manager"), exports);
 __exportStar(require("./decoding"), exports);
 __exportStar(require("./opcodes"), exports);
-__exportStar(require("./sol_debugger"), exports);
+__exportStar(require("./tracers"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/debug/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,qDAAmC;AACnC,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,qDAAmC;AACnC,6CAA2B;AAC3B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB"}

package/dist/debug/tracers/base_tracer.d.ts

@@ -0,0 +1,30 @@
+import { Block } from "@ethereumjs/block";
+import { EVMStateManagerInterface } from "@ethereumjs/common";
+import { InterpreterStep } from "@ethereumjs/evm";
+import { TypedTransaction } from "@ethereumjs/tx";
+import { RunTxResult, VM } from "@ethereumjs/vm";
+import { IArtifactManager } from "../artifact_manager";
+export interface TracerOpts {
+    strict?: boolean;
+    foundryCheatcodes?: boolean;
+}
+export declare abstract class BaseSolTxTracer<State> {
+    artifactManager: IArtifactManager;
+    protected readonly strict: boolean;
+    protected readonly foundryCheatcodes: boolean;
+    constructor(artifactManager: IArtifactManager, opts?: TracerOpts);
+    private static getEVM;
+    /**
+     * Releases references to the EVM stored inside VM from the
+     * `interpRunListeners` map.  This avoids memory leaks when repeatedly
+     * calling the debugger on different transactions.  Should be called once
+     * for every vm created by `SolTxDebugger.createVm` after its done being
+     * used.
+     */
+    static releaseVM(vm: VM): void;
+    static createVm(stateManager: EVMStateManagerInterface | undefined, foundryCheatcodes: boolean): Promise<VM>;
+    abstract processRawTraceStep(vm: VM, step: InterpreterStep, trace: State[], tx: TypedTransaction): Promise<State>;
+    debugTx(tx: TypedTransaction, block: Block | undefined, // TODO: Make block required and add to processRawTraceStep
+    stateManager: EVMStateManagerInterface): Promise<[State[], RunTxResult]>;
+}
+//# sourceMappingURL=base_tracer.d.ts.map

package/dist/debug/tracers/base_tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_tracer.d.ts","sourceRoot":"","sources":["../../../src/debug/tracers/base_tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAiB,wBAAwB,EAAY,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAwB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AASvD,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAQD,8BAAsB,eAAe,CAAC,KAAK;IACvC,eAAe,EAAG,gBAAgB,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;gBAElC,eAAe,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU;mBAgB3C,MAAM;IA8B3B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;WAUjB,QAAQ,CACjB,YAAY,EAAE,wBAAwB,GAAG,SAAS,EAClD,iBAAiB,EAAE,OAAO,GAC3B,OAAO,CAAC,EAAE,CAAC;IA0Bd,QAAQ,CAAC,mBAAmB,CACxB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,KAAK,EAAE,EACd,EAAE,EAAE,gBAAgB,GACrB,OAAO,CAAC,KAAK,CAAC;IAEX,OAAO,CACT,EAAE,EAAE,gBAAgB,EACpB,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,2DAA2D;IACrF,YAAY,EAAE,wBAAwB,GACvC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;CA8BrC"}

package/dist/debug/tracers/base_tracer.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSolTxTracer = void 0;
+const blockchain_1 = require("@ethereumjs/blockchain");
+const common_1 = require("@ethereumjs/common");
+const evm_1 = require("@ethereumjs/evm");
+const statemanager_1 = require("@ethereumjs/statemanager");
+const vm_1 = require("@ethereumjs/vm");
+const solc_typed_ast_1 = require("solc-typed-ast");
+const foundry_cheatcodes_1 = require("../foundry_cheatcodes");
+const opcode_interposing_1 = require("../opcode_interposing");
+/**
+ * Private map tracking VM-to-EVM mapping, used when releasing EVMs from the
+ * global listener map for foundry cheatcodes.
+ */
+const vmToEVMMap = new Map();
+class BaseSolTxTracer {
+    constructor(artifactManager, opts) {
+        this.artifactManager = artifactManager;
+        this.strict = true;
+        this.foundryCheatcodes = false;
+        if (opts) {
+            this.strict = opts.strict !== undefined ? opts.strict : this.strict;
+            this.foundryCheatcodes =
+                opts.foundryCheatcodes !== undefined
+                    ? opts.foundryCheatcodes
+                    : this.foundryCheatcodes;
+        }
+    }
+    static async getEVM(opts, foundryCheatcodes) {
+        const tmpEvm = await evm_1.EVM.create(opts);
+        if (!foundryCheatcodes) {
+            return tmpEvm;
+        }
+        const opcodes = (0, evm_1.getOpcodesForHF)(tmpEvm.common);
+        const [precompile, foundryCtx] = (0, foundry_cheatcodes_1.makeFoundryCheatcodePrecompile)();
+        const optsCopy = {
+            ...opts,
+            customOpcodes: [
+                ...(opts.customOpcodes ? opts.customOpcodes : []),
+                ...(0, opcode_interposing_1.foundryInterposedOps)(opcodes, foundryCtx)
+            ],
+            customPrecompiles: [
+                ...(opts.customPrecompiles ? opts.customPrecompiles : []),
+                {
+                    address: foundry_cheatcodes_1.FoundryCheatcodesAddress,
+                    function: precompile
+                }
+            ]
+        };
+        const res = await evm_1.EVM.create(optsCopy);
+        foundry_cheatcodes_1.foundryCtxMap.set(res, foundryCtx);
+        return res;
+    }
+    /**
+     * Releases references to the EVM stored inside VM from the
+     * `interpRunListeners` map.  This avoids memory leaks when repeatedly
+     * calling the debugger on different transactions.  Should be called once
+     * for every vm created by `SolTxDebugger.createVm` after its done being
+     * used.
+     */
+    static releaseVM(vm) {
+        const evm = vmToEVMMap.get(vm);
+        if (evm) {
+            foundry_cheatcodes_1.foundryCtxMap.delete(evm);
+        }
+        vmToEVMMap.delete(vm);
+    }
+    static async createVm(stateManager, foundryCheatcodes) {
+        const common = new common_1.Common({ chain: common_1.Chain.Mainnet, hardfork: common_1.Hardfork.Shanghai });
+        const blockchain = await blockchain_1.Blockchain.create({ common });
+        if (!stateManager) {
+            stateManager = new statemanager_1.DefaultStateManager();
+        }
+        const evm = await BaseSolTxTracer.getEVM({ common, blockchain, stateManager, allowUnlimitedContractSize: true }, foundryCheatcodes);
+        const vm = await vm_1.VM.create({
+            common,
+            blockchain,
+            stateManager,
+            evm,
+            activatePrecompiles: true
+        });
+        vmToEVMMap.set(vm, evm);
+        return vm;
+    }
+    async debugTx(tx, block, // TODO: Make block required and add to processRawTraceStep
+    stateManager) {
+        const vm = await BaseSolTxTracer.createVm(stateManager.shallowCopy(true), this.foundryCheatcodes);
+        const trace = [];
+        (0, solc_typed_ast_1.assert)(vm.evm.events !== undefined, "Unable to access EVM events at this point");
+        vm.evm.events.on("step", async (step, next) => {
+            const curStep = await this.processRawTraceStep(vm, step, trace, tx);
+            trace.push(curStep);
+            next();
+        });
+        const txRes = await vm.runTx({
+            tx,
+            block,
+            skipBalance: true,
+            skipNonce: true,
+            skipBlockGasLimitValidation: true
+        });
+        BaseSolTxTracer.releaseVM(vm);
+        return [trace, txRes];
+    }
+}
+exports.BaseSolTxTracer = BaseSolTxTracer;
+//# sourceMappingURL=base_tracer.js.map

package/dist/debug/tracers/base_tracer.js.map

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

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

@@ -0,0 +1,4 @@
+export * from "./base_tracer";
+export * from "./sol_debugger";
+export * from "./transformers";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/debug/tracers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/debug/tracers/index.js

@@ -0,0 +1,20 @@
+"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("./base_tracer"), exports);
+__exportStar(require("./sol_debugger"), exports);
+__exportStar(require("./transformers"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/debug/tracers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,iDAA+B;AAC/B,iDAA+B"}

package/dist/debug/tracers/sol_debugger.d.ts

@@ -0,0 +1,9 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { TypedTransaction } from "@ethereumjs/tx";
+import { VM } from "@ethereumjs/vm";
+import { StepState } from "../types";
+import { BaseSolTxTracer } from "./base_tracer";
+export declare class SolTxDebugger extends BaseSolTxTracer<StepState> {
+    processRawTraceStep(vm: VM, step: InterpreterStep, trace: StepState[], tx: TypedTransaction): Promise<StepState>;
+}
+//# sourceMappingURL=sol_debugger.d.ts.map

package/dist/debug/tracers/sol_debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol_debugger.d.ts","sourceRoot":"","sources":["../../../src/debug/tracers/sol_debugger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOhD,qBAAa,aAAc,SAAQ,eAAe,CAAC,SAAS,CAAC;IACnD,mBAAmB,CACrB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,SAAS,EAAE,EAClB,EAAE,EAAE,gBAAgB,GACrB,OAAO,CAAC,SAAS,CAAC;CAyBxB"}

package/dist/debug/tracers/sol_debugger.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolTxDebugger = void 0;
+const base_tracer_1 = require("./base_tracer");
+const transformers_1 = require("./transformers");
+const events_1 = require("./transformers/events");
+const ext_stack_1 = require("./transformers/ext_stack");
+const int_stack_1 = require("./transformers/int_stack");
+const source_1 = require("./transformers/source");
+class SolTxDebugger extends base_tracer_1.BaseSolTxTracer {
+    async processRawTraceStep(vm, step, trace, tx) {
+        const opInfo = (0, transformers_1.addOpInfo)(vm, step, {});
+        const basicInfo = await (0, transformers_1.addBasicInfo)(vm, step, opInfo, trace);
+        const extFrameInfo = await (0, ext_stack_1.addExternalFrame)(vm, step, basicInfo, trace, this.artifactManager, tx);
+        const source = await (0, source_1.addSource)(vm, step, extFrameInfo);
+        const intStack = await (0, int_stack_1.addInternalFrame)(vm, step, source, trace, this.artifactManager, this.strict);
+        const events = await (0, events_1.addEventInfo)(vm, step, intStack);
+        return events;
+    }
+}
+exports.SolTxDebugger = SolTxDebugger;
+//# sourceMappingURL=sol_debugger.js.map

package/dist/debug/tracers/sol_debugger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol_debugger.js","sourceRoot":"","sources":["../../../src/debug/tracers/sol_debugger.ts"],"names":[],"mappings":";;;AAIA,+CAAgD;AAChD,iDAAyD;AACzD,kDAAqD;AACrD,wDAA4D;AAC5D,wDAA4D;AAC5D,kDAAkD;AAElD,MAAa,aAAc,SAAQ,6BAA0B;IACzD,KAAK,CAAC,mBAAmB,CACrB,EAAM,EACN,IAAqB,EACrB,KAAkB,EAClB,EAAoB;QAEpB,MAAM,MAAM,GAAG,IAAA,wBAAS,EAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,IAAA,2BAAY,EAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,MAAM,IAAA,4BAAgB,EACvC,EAAE,EACF,IAAI,EACJ,SAAS,EACT,KAAK,EACL,IAAI,CAAC,eAAe,EACpB,EAAE,CACL,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAS,EAAC,EAAE,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAgB,EACnC,EAAE,EACF,IAAI,EACJ,MAAM,EACN,KAAK,EACL,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,MAAM,CACd,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAY,EAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEtD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA/BD,sCA+BC"}

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

@@ -0,0 +1,23 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { Address } from "@ethereumjs/util";
+import { VM } from "@ethereumjs/vm";
+import { EVMOpInfo } from "../../opcodes";
+import { Memory, Stack, Storage } from "../../types";
+import { OpInfo } from "./op";
+export interface BasicStepInfo {
+    evmStack: Stack;
+    memory: Memory;
+    storage: Storage;
+    op: EVMOpInfo;
+    pc: number;
+    gasCost: bigint;
+    dynamicGasCost: bigint;
+    gas: bigint;
+    depth: number;
+    address: Address;
+}
+/**
+ * Adds cleaner typed version of the low-level debugging information
+ */
+export declare function addBasicInfo<T extends object & OpInfo>(vm: VM, step: InterpreterStep, state: T, trace: Array<T & BasicStepInfo>): Promise<T & BasicStepInfo>;
+//# sourceMappingURL=basic_info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic_info.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/basic_info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAiB,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAIpC,OAAO,EAAE,SAAS,EAA0B,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAiB9B,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACxD,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,aAAa,CAAC,GAChC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,CAgC5B"}

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addBasicInfo = addBasicInfo;
+const rlp_1 = require("@ethereumjs/rlp");
+const util_1 = require("@ethereumjs/util");
+const utils_1 = require("ethereum-cryptography/utils");
+const solc_typed_ast_1 = require("solc-typed-ast");
+const utils_2 = require("../../../utils");
+const opcodes_1 = require("../../opcodes");
+async function getStorage(manager, addr) {
+    const rawStorage = await manager.dumpStorage(addr);
+    const storageEntries = [];
+    for (const [keyStr, valStr] of Object.entries(rawStorage)) {
+        const decoded = rlp_1.RLP.decode((0, utils_1.hexToBytes)(valStr));
+        (0, solc_typed_ast_1.assert)(decoded instanceof Uint8Array, "");
+        const valBuf = (0, util_1.setLengthLeft)(decoded, 32);
+        storageEntries.push([BigInt(keyStr), valBuf]);
+    }
+    return utils_2.ImmMap.fromEntries(storageEntries);
+}
+/**
+ * Adds cleaner typed version of the low-level debugging information
+ */
+async function addBasicInfo(vm, step, state, trace) {
+    const evmStack = step.stack.map((word) => (0, utils_2.bigIntToBuf)(word, 32, "big"));
+    const lastStep = trace.length > 0 ? trace[trace.length - 1] : undefined;
+    const memory = lastStep === undefined || (0, opcodes_1.changesMemory)(lastStep.op)
+        ? new Uint8Array(step.memory)
+        : lastStep.memory;
+    let storage;
+    if (lastStep === undefined || lastStep.op.opcode === opcodes_1.OPCODES.SSTORE) {
+        storage = await getStorage(vm.stateManager, step.address);
+    }
+    else {
+        storage = lastStep.storage;
+    }
+    const gasCost = BigInt(step.opcode.fee);
+    const dynamicGasCost = step.opcode.dynamicFee === undefined ? gasCost : step.opcode.dynamicFee;
+    return {
+        evmStack,
+        memory,
+        storage,
+        ...state,
+        pc: step.pc,
+        gasCost,
+        dynamicGasCost,
+        gas: step.gasLeft,
+        depth: step.depth + 1,
+        address: step.address
+    };
+}
+//# sourceMappingURL=basic_info.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic_info.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/basic_info.ts"],"names":[],"mappings":";;AA2CA,oCAqCC;AA9ED,yCAAsC;AACtC,2CAA0D;AAE1D,uDAAyD;AACzD,mDAAwC;AACxC,0CAAqD;AACrD,2CAAkE;AAIlE,KAAK,UAAU,UAAU,CAAC,OAAiC,EAAE,IAAa;IACtE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,cAAc,GAAgC,EAAE,CAAC;IAEvD,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,SAAG,CAAC,MAAM,CAAC,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,IAAA,uBAAM,EAAC,OAAO,YAAY,UAAU,EAAE,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAE1C,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,cAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAeD;;GAEG;AACI,KAAK,UAAU,YAAY,CAC9B,EAAM,EACN,IAAqB,EACrB,KAAQ,EACR,KAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,MAAM,MAAM,GACR,QAAQ,KAAK,SAAS,IAAI,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAE1B,IAAI,OAAgB,CAAC;IAErB,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,MAAM,EAAE,CAAC;QAClE,OAAO,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAE/F,OAAO;QACH,QAAQ;QACR,MAAM;QACN,OAAO;QACP,GAAG,KAAK;QACR,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO;QACP,cAAc;QACd,GAAG,EAAE,IAAI,CAAC,OAAO;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,12 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { VM } from "@ethereumjs/vm";
+import { EventDesc } from "../../types";
+import { BasicStepInfo } from "./basic_info";
+export interface EventInfo {
+    emittedEvent: EventDesc | undefined;
+}
+/**
+ * Adds source info for each step (if available)
+ */
+export declare function addEventInfo<T extends object & BasicStepInfo>(vm: VM, step: InterpreterStep, state: T): Promise<T & EventInfo>;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,SAAS;IACtB,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,EAC/D,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAyBxB"}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addEventInfo = addEventInfo;
+const utils_1 = require("../../../utils");
+/**
+ * Adds source info for each step (if available)
+ */
+async function addEventInfo(vm, step, state) {
+    let emittedEvent = undefined;
+    // Finally check if an event is being emitted for this step
+    if (step.opcode.name.startsWith("LOG")) {
+        const stack = state.evmStack;
+        const off = (0, utils_1.bigEndianBufToNumber)(stack[stack.length - 1]);
+        const size = (0, utils_1.bigEndianBufToNumber)(stack[stack.length - 2]);
+        const nTopics = step.opcode.name[3] - "0";
+        const payload = state.memory.slice(off, off + size);
+        emittedEvent = {
+            payload,
+            topics: stack
+                .slice(stack.length - 2 - nTopics, stack.length - 2)
+                .reverse()
+                .map(utils_1.bigEndianBufToBigint)
+        };
+    }
+    return {
+        emittedEvent,
+        ...state
+    };
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/events.ts"],"names":[],"mappings":";;AAaA,oCA6BC;AAxCD,0CAA4E;AAQ5E;;GAEG;AACI,KAAK,UAAU,YAAY,CAC9B,EAAM,EACN,IAAqB,EACrB,KAAQ;IAER,IAAI,YAAY,GAA0B,SAAS,CAAC;IAEpD,2DAA2D;IAC3D,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAA,4BAAoB,EAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAS,GAAI,GAAW,CAAC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QAEpD,YAAY,GAAG;YACX,OAAO;YACP,MAAM,EAAE,KAAK;iBACR,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;iBACnD,OAAO,EAAE;iBACT,GAAG,CAAC,4BAAoB,CAAC;SACjC,CAAC;IACN,CAAC;IAED,OAAO;QACH,YAAY;QACZ,GAAG,KAAK;KACX,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,17 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { TypedTransaction } from "@ethereumjs/tx";
+import { VM } from "@ethereumjs/vm";
+import { ContractInfo, IArtifactManager } from "../../artifact_manager";
+import { ExternalFrame, Frame } from "../../types";
+import { BasicStepInfo } from "./basic_info";
+export interface ExternalFrameInfo {
+    stack: ExternalFrame[];
+}
+export declare function topExtFrame(arg: ExternalFrame[] | ExternalFrameInfo | Frame): ExternalFrame;
+export declare function getContractInfo(step: ExternalFrameInfo): ContractInfo | undefined;
+export declare function getCode(step: ExternalFrameInfo): Uint8Array;
+/**
+ * Adds external frame info for each step
+ */
+export declare function addExternalFrame<T extends object & BasicStepInfo>(vm: VM, step: InterpreterStep, state: T, trace: Array<T & ExternalFrameInfo>, artifactManager: IArtifactManager, tx: TypedTransaction): Promise<T & ExternalFrameInfo>;
+//# sourceMappingURL=ext_stack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ext_stack.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/ext_stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAUpC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAKH,aAAa,EACb,KAAK,EAGR,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,iBAAiB,GAAG,KAAK,GAAG,aAAa,CAW3F;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAEjF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAE3D;AAmJD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,EACnE,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,iBAAiB,CAAC,EACnC,eAAe,EAAE,gBAAgB,EACjC,EAAE,EAAE,gBAAgB,GACrB,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CA8GhC"}