type TraceConfigType = {
  readonly disableStorage?: boolean;     // Don't track storage changes
  readonly disableStack?: boolean;       // Don't track stack
  readonly disableMemory?: boolean;      // Don't track memory
  readonly enableMemory?: boolean;       // Track memory
  readonly enableReturnData?: boolean;   // Track return data
  readonly tracer?: string;              // Tracer name
  readonly timeout?: string;             // Timeout (e.g., "5s")
  readonly tracerConfig?: Record<string, unknown>; // Tracer-specific config
};

import * as TraceConfig from '@tevm/primitives/TraceConfig';

// Minimal config for maximum performance
const minimalConfig = TraceConfig.from({
  disableStorage: true,
  disableMemory: true,
  disableStack: true,
});

// Full detail (slow but comprehensive)
const fullConfig = TraceConfig.from({
  enableMemory: true,
  enableReturnData: true,
});

// Use callTracer for call tree
const callConfig = TraceConfig.withTracer({}, "callTracer");

// callTracer with options
const topCallConfig = TraceConfig.withTracer(
  {},
  "callTracer",
  { onlyTopCall: true }
);

// Use prestateTracer for state access
const prestateConfig = TraceConfig.withTracer({}, "prestateTracer");

// Disable all tracking for fastest tracing
const fastConfig = TraceConfig.disableAll();

// Disable all but enable return data
const returnOnlyConfig = TraceConfig.disableAll({
  enableReturnData: true,
});

const config = TraceConfig.withTracer({}, "callTracer");
// Result: CallTrace with nested calls

const config = TraceConfig.withTracer({}, "prestateTracer");
// Result: Account balances, nonces, code, storage before execution

const config = TraceConfig.withTracer({}, "4byteTracer");
// Result: Map of selectors to call counts

const config = TraceConfig.from({}); // Default tracer
// Result: TraceResult with structLogs

// Debugging reverts (fast, minimal data)
const revertConfig = TraceConfig.from({
  disableStorage: true,
  disableMemory: true,
  enableReturnData: true,
});

// Gas optimization analysis (need full stack)
const gasConfig = TraceConfig.from({
  disableMemory: true,
});

// Security analysis (need everything)
const securityConfig = TraceConfig.from({
  enableMemory: true,
  enableReturnData: true,
});

// Call tree only (very fast)
const callTreeConfig = TraceConfig.withTracer(
  TraceConfig.disableAll(),
  "callTracer"
);

import * as TraceConfig from '@tevm/primitives/TraceConfig';

// Get revert reason from failed transaction
const config = TraceConfig.from({
  disableStorage: true,
  disableMemory: true,
  enableReturnData: true,
});

// Use with RPC: debug_traceTransaction(txHash, config)

// Trace all opcodes to find gas hotspots
const config = TraceConfig.from({
  disableMemory: true, // Memory not needed for gas analysis
});

// Analyze structLogs to find expensive operations

// Get complete call hierarchy
const config = TraceConfig.withTracer({}, "callTracer");

// Find nested call that failed
// Result.callTrace contains full tree with gas usage

// See what storage slots were read/written
const config = TraceConfig.withTracer({}, "prestateTracer");

// Useful for optimizing storage layout

debug_traceTransaction(txHash: string, config: TraceConfigType): TraceResult

debug_traceCall(call: TransactionRequest, blockNumber: string, config: TraceConfigType): TraceResult

debug_traceBlockByNumber(blockNumber: string, config: TraceConfigType): TraceResult[]

debug_traceBlockByHash(blockHash: string, config: TraceConfigType): TraceResult[]