sol-dbg 0.4.2 → 0.6.1

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

@@ -0,0 +1,33 @@
+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 interface FoundryTxResult extends RunTxResult {
+    failCalled: 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
+    stateBefore: EVMStateManagerInterface): Promise<[State[], FoundryTxResult, EVMStateManagerInterface]>;
+}
+//# 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;AAUvD,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAChD,UAAU,EAAE,OAAO,CAAC;CACvB;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,WAAW,EAAE,wBAAwB,GACtC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC;CAyCnE"}

package/dist/debug/tracers/base_tracer.js

@@ -0,0 +1,118 @@
+"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
+    stateBefore) {
+        const vm = await BaseSolTxTracer.createVm(stateBefore.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
+        });
+        const foundryCtx = (0, foundry_cheatcodes_1.getFoundryCtx)(vm.evm);
+        const foundryFailCalled = foundryCtx !== undefined ? foundryCtx.failCalled : false;
+        const stateAfter = vm.stateManager;
+        BaseSolTxTracer.releaseVM(vm);
+        return [
+            trace,
+            {
+                ...txRes,
+                failCalled: foundryFailCalled
+            },
+            stateAfter
+        ];
+    }
+}
+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,5 @@
+export * from "./base_tracer";
+export * from "./sol_debugger";
+export * from "./support_tracer";
+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,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/debug/tracers/index.js

@@ -0,0 +1,21 @@
+"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("./support_tracer"), 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,mDAAiC;AACjC,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/support_tracer.d.ts

@@ -0,0 +1,15 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { TypedTransaction } from "@ethereumjs/tx";
+import { VM } from "@ethereumjs/vm";
+import { BaseSolTxTracer } from "./base_tracer";
+import { BasicStepInfo, ContractLifeTimeInfo, ExternalFrameInfo, Keccak256InvertInfo } from "./transformers";
+export type SupportTracerStepInfo = BasicStepInfo & ExternalFrameInfo & ContractLifeTimeInfo & Keccak256InvertInfo;
+/**
+ * This tracer computes contract lifetime information and keccak256 pre-images for a TX.
+ * The information it collects supports the debugging for the main SolTxDebugger tracer.
+ * It is more-light weight and is ran by the TestRunner for all TXs, even if we are not going to debug them.
+ */
+export declare class SupportTracer extends BaseSolTxTracer<SupportTracerStepInfo> {
+    processRawTraceStep(vm: VM, step: InterpreterStep, trace: SupportTracerStepInfo[], tx: TypedTransaction): Promise<SupportTracerStepInfo>;
+}
+//# sourceMappingURL=support_tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support_tracer.d.ts","sourceRoot":"","sources":["../../../src/debug/tracers/support_tracer.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,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAMH,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAC7C,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,CAAC;AACxB;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,eAAe,CAAC,qBAAqB,CAAC;IAC/D,mBAAmB,CACrB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,qBAAqB,EAAE,EAC9B,EAAE,EAAE,gBAAgB,GACrB,OAAO,CAAC,qBAAqB,CAAC;CAgBpC"}

package/dist/debug/tracers/support_tracer.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupportTracer = void 0;
+const base_tracer_1 = require("./base_tracer");
+const transformers_1 = require("./transformers");
+/**
+ * This tracer computes contract lifetime information and keccak256 pre-images for a TX.
+ * The information it collects supports the debugging for the main SolTxDebugger tracer.
+ * It is more-light weight and is ran by the TestRunner for all TXs, even if we are not going to debug them.
+ */
+class SupportTracer 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, transformers_1.addExternalFrame)(vm, step, basicInfo, trace, this.artifactManager, tx);
+        const contracLifetimeInfo = (0, transformers_1.addContractLifetimeInfo)(vm, step, extFrameInfo, trace);
+        const keccakInfo = (0, transformers_1.addKeccakInvertInfo)(vm, step, contracLifetimeInfo, trace);
+        return keccakInfo;
+    }
+}
+exports.SupportTracer = SupportTracer;
+//# sourceMappingURL=support_tracer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support_tracer.js","sourceRoot":"","sources":["../../../src/debug/tracers/support_tracer.ts"],"names":[],"mappings":";;;AAGA,+CAAgD;AAChD,iDAUwB;AAMxB;;;;GAIG;AACH,MAAa,aAAc,SAAQ,6BAAsC;IACrE,KAAK,CAAC,mBAAmB,CACrB,EAAM,EACN,IAAqB,EACrB,KAA8B,EAC9B,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,+BAAgB,EACvC,EAAE,EACF,IAAI,EACJ,SAAS,EACT,KAAK,EACL,IAAI,CAAC,eAAe,EACpB,EAAE,CACL,CAAC;QACF,MAAM,mBAAmB,GAAG,IAAA,sCAAuB,EAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,IAAA,kCAAmB,EAAC,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAE7E,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ;AAtBD,sCAsBC"}

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

@@ -0,0 +1,25 @@
+import { EVMStateManagerInterface } from "@ethereumjs/common";
+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 declare function getStorage(manager: EVMStateManagerInterface, addr: Address): Promise<Storage>;
+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":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,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;AAE9B,wBAAsB,UAAU,CAC5B,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,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,CAiC5B"}

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStorage = getStorage;
+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) {
+        /** @todo the way we use getStorage we dont take advantage of ImmMap! This is inefficient */
+        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":";;AAYA,gCAgBC;AAkBD,oCAsCC;AAlFD,yCAAsC;AACtC,2CAA0D;AAE1D,uDAAyD;AACzD,mDAAwC;AACxC,0CAAqD;AACrD,2CAAkE;AAI3D,KAAK,UAAU,UAAU,CAC5B,OAAiC,EACjC,IAAa;IAEb,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,4FAA4F;QAC5F,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/contract_lifetime.d.ts

@@ -0,0 +1,21 @@
+import { InterpreterStep } from "@ethereumjs/evm";
+import { Address } from "@ethereumjs/util";
+import { RunTxResult, VM } from "@ethereumjs/vm";
+import { BasicStepInfo } from "./basic_info";
+import { ExternalFrameInfo } from "./ext_stack";
+export interface ContractLifeTimeInfo {
+    contractCreated?: Address;
+    contractKilled?: Address;
+}
+/**
+ * Given a trace of contract creation/deletion event compute a gen/kill set summary for the trace.
+ */
+export declare function getContractGenKillSet(trace: ContractLifeTimeInfo[], res?: RunTxResult): [Set<string>, Set<string>];
+/**
+ * Track contract creation/initialization/destruction. A contract is considered:
+ *
+ * 1. Created after its constructor returns successfully
+ * 2. Destroyed when SELFDESTRUCT is executed
+ */
+export declare function addContractLifetimeInfo<T extends object & BasicStepInfo & ExternalFrameInfo>(vm: VM, step: InterpreterStep, state: T, trace: Array<T & ContractLifeTimeInfo>): T & ContractLifeTimeInfo;
+//# sourceMappingURL=contract_lifetime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract_lifetime.d.ts","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/contract_lifetime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,oBAAoB,EAAE,EAC7B,GAAG,CAAC,EAAE,WAAW,GAClB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAgC5B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,GAAG,iBAAiB,EACxF,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,oBAAoB,CAAC,GACvC,CAAC,GAAG,oBAAoB,CA8B1B"}

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

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContractGenKillSet = getContractGenKillSet;
+exports.addContractLifetimeInfo = addContractLifetimeInfo;
+const opcodes_1 = require("../../opcodes");
+const types_1 = require("../../types");
+const ext_stack_1 = require("./ext_stack");
+/**
+ * Given a trace of contract creation/deletion event compute a gen/kill set summary for the trace.
+ */
+function getContractGenKillSet(trace, res) {
+    // Need to account for an entire transaction creating a contract potentially.
+    const [gen, kill] = trace.reduce(([gen, kill], info) => {
+        if (info.contractCreated) {
+            const strAddr = info.contractCreated.toString();
+            if (kill.has(strAddr)) {
+                kill.delete(strAddr);
+            }
+            else {
+                gen.add(info.contractCreated.toString());
+            }
+        }
+        if (info.contractKilled) {
+            const strAddr = info.contractKilled.toString();
+            if (gen.has(strAddr)) {
+                gen.delete(strAddr);
+            }
+            else {
+                kill.add(strAddr);
+            }
+        }
+        return [gen, kill];
+    }, [new Set(), new Set()]);
+    if (res && res.createdAddress !== undefined) {
+        gen.add(res.createdAddress.toString());
+    }
+    return [gen, kill];
+}
+/**
+ * Track contract creation/initialization/destruction. A contract is considered:
+ *
+ * 1. Created after its constructor returns successfully
+ * 2. Destroyed when SELFDESTRUCT is executed
+ */
+function addContractLifetimeInfo(vm, step, state, trace) {
+    // Case 1. Self-destruct
+    if (state.op.opcode === opcodes_1.OPCODES.SELFDESTRUCT) {
+        return {
+            contractKilled: state.address,
+            ...state
+        };
+    }
+    if (trace.length === 0) {
+        return state;
+    }
+    // Case 2: We return from a
+    const lastStep = trace[trace.length - 1];
+    const lastStepFrame = (0, ext_stack_1.topExtFrame)(lastStep.stack);
+    // Successful return from a creation frame
+    if (lastStep.depth === state.depth + 1 &&
+        lastStepFrame.kind === types_1.FrameKind.Creation &&
+        lastStep.op.opcode === opcodes_1.OPCODES.RETURN) {
+        return {
+            contractCreated: lastStep.address,
+            ...state
+        };
+    }
+    return state;
+}
+//# sourceMappingURL=contract_lifetime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract_lifetime.js","sourceRoot":"","sources":["../../../../src/debug/tracers/transformers/contract_lifetime.ts"],"names":[],"mappings":";;AAgBA,sDAmCC;AAQD,0DAmCC;AA3FD,2CAAwC;AACxC,uCAAwC;AAExC,2CAA6D;AAO7D;;GAEG;AACH,SAAgB,qBAAqB,CACjC,KAA6B,EAC7B,GAAiB;IAEjB,6EAA6E;IAC7E,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAC5B,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE;QAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAEhD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7C,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC,EACD,CAAC,IAAI,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CACzB,CAAC;IAEF,IAAI,GAAG,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACnC,EAAM,EACN,IAAqB,EACrB,KAAQ,EACR,KAAsC;IAEtC,wBAAwB;IACxB,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,OAAO;YACH,cAAc,EAAE,KAAK,CAAC,OAAO;YAC7B,GAAG,KAAK;SACX,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,IAAA,uBAAW,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,0CAA0C;IAC1C,IACI,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC;QAClC,aAAa,CAAC,IAAI,KAAK,iBAAS,CAAC,QAAQ;QACzC,QAAQ,CAAC,EAAE,CAAC,MAAM,KAAK,iBAAO,CAAC,MAAM,EACvC,CAAC;QACC,OAAO;YACH,eAAe,EAAE,QAAQ,CAAC,OAAO;YACjC,GAAG,KAAK;SACX,CAAC;IACN,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,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"}