@gas-killer/analyzer-wasm 0.2.0 → 0.3.0

package/gas_killer_wasm.d.ts

@@ -10,6 +10,12 @@ export interface AnalyzeTraceResult {
     reentered: boolean;
 }
 
+export interface PrestateAnalysis {
+    eligible: boolean;
+    reason: string | null;
+    result: AnalyzeTraceResult | null;
+}
+
 export interface EncodeTraceResult {
     encoded_updates: string;
     state_update_count: number;
@@ -26,6 +32,22 @@ export interface EstimateGasResult {
 
 
 
+/**
+ * Analyze a transaction from its `prestateTracer` diff and `callTracer` frame instead of its
+ * struct-log trace, for calls that admit the prestate net form.
+ *
+ * `diff_json` is the `result` of `debug_traceTransaction` with
+ * `{"tracer":"prestateTracer","tracerConfig":{"diffMode":true}}`, and `call_frame_json` the
+ * `result` with `{"tracer":"callTracer","tracerConfig":{"withLog":true}}`.
+ *
+ * `consumer_address` is the transaction's target contract (its `to`). The other arguments are as
+ * for [`analyze_trace`].
+ *
+ * Returns a JS object with `eligible`, and either `result` (shaped like [`analyze_trace`]'s) or
+ * `reason`, why the call has no net form; analyze its struct-log trace with [`analyze_trace`] then.
+ */
+export function analyze_prestate(diff_json: string, call_frame_json: string, consumer_address: string, estimator_address: string, caller_address: string, estimate_state_changes_block_number?: bigint | null): any;
+
 /**
  * Analyze a Geth trace: parse state updates, ABI-encode them, and estimate gas.
  *
@@ -67,6 +89,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
   readonly memory: WebAssembly.Memory;
+  readonly analyze_prestate: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: bigint) => [number, number, number];
   readonly analyze_trace: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: bigint, i: number, j: number) => [number, number, number];
   readonly encode_trace: (a: number, b: number) => [number, number, number];
   readonly estimate_gas_heuristic: (a: number, b: number, c: number, d: number) => [number, number, number];

package/gas_killer_wasm.js

@@ -97,6 +97,45 @@ if (!('encodeInto' in cachedTextEncoder)) {
 
 let WASM_VECTOR_LEN = 0;
 
+/**
+ * Analyze a transaction from its `prestateTracer` diff and `callTracer` frame instead of its
+ * struct-log trace, for calls that admit the prestate net form.
+ *
+ * `diff_json` is the `result` of `debug_traceTransaction` with
+ * `{"tracer":"prestateTracer","tracerConfig":{"diffMode":true}}`, and `call_frame_json` the
+ * `result` with `{"tracer":"callTracer","tracerConfig":{"withLog":true}}`.
+ *
+ * `consumer_address` is the transaction's target contract (its `to`). The other arguments are as
+ * for [`analyze_trace`].
+ *
+ * Returns a JS object with `eligible`, and either `result` (shaped like [`analyze_trace`]'s) or
+ * `reason`, why the call has no net form; analyze its struct-log trace with [`analyze_trace`] then.
+ * @param {string} diff_json
+ * @param {string} call_frame_json
+ * @param {string} consumer_address
+ * @param {string} estimator_address
+ * @param {string} caller_address
+ * @param {bigint | null} [estimate_state_changes_block_number]
+ * @returns {any}
+ */
+export function analyze_prestate(diff_json, call_frame_json, consumer_address, estimator_address, caller_address, estimate_state_changes_block_number) {
+    const ptr0 = passStringToWasm0(diff_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(call_frame_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(consumer_address, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ptr3 = passStringToWasm0(estimator_address, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len3 = WASM_VECTOR_LEN;
+    const ptr4 = passStringToWasm0(caller_address, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len4 = WASM_VECTOR_LEN;
+    const ret = wasm.analyze_prestate(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, !isLikeNone(estimate_state_changes_block_number), isLikeNone(estimate_state_changes_block_number) ? BigInt(0) : estimate_state_changes_block_number);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Analyze a Geth trace: parse state updates, ABI-encode them, and estimate gas.
  *

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@gas-killer/analyzer-wasm",
   "type": "module",
-  "version": "0.2.0",
+  "description": "Gas Killer's WebAssembly gas analyzer: estimates a transaction's gas savings from its Geth trace in the browser",
+  "version": "0.3.0",
   "files": [
     "gas_killer_wasm_bg.wasm",
     "gas_killer_wasm.js",