import { Provider } from 'ethers';
/**
  *  Options  for  inspecting  a  transaction
  */
export interface InspectorOptions {
    /**
    *  Custom  RPC  provider  URL.  If  not  provided,  will  attempt  to  auto-detect  from  chain  ID
    */
    rpcUrl?: string;
    /**
    *  Custom  ethers  provider  instance.  If  provided,  takes  precedence  over  rpcUrl
    */
    provider?: Provider;
    /**
    *  Chain  ID.  Used  for  auto-detecting  RPC  URL  and  block  explorer  API
    */
    chainId?: number;
    /**
    *  Block  explorer  API  key  (optional,  but  recommended  for  rate  limits)
    */
    apiKey?: string;
    /**
    *  Whether  to  include  gas  usage  details  in  the  output
    */
    includeGasDetails?: boolean;
    /**
    *  Whether  to  include  storage  changes  in  the  output
    */
    includeStorageChanges?: boolean;
    /**
    *  Custom  ABIs  to  use  for  specific  contract  addresses
    *  Format:  {  [address:  string]:  any[]  }
    */
    customABIs?: Record<string, any[]>;
    /**
    *  Whether  to  attempt  ABI  fetching  from  block  explorers
    */
    fetchABI?: boolean;
    /**
    *  Whether  to  use  4-byte  signature  database  for  function  inference
    */
    useSignatureDatabase?: boolean;
}
/**
  *  Decoded  function  call  information
  */
export interface DecodedCall {
    /**
    *  Contract  address  being  called
    */
    to: string;
    /**
    *  Function  name  (decoded  or  inferred)
    */
    functionName: string;
    /**
    *  Decoded  function  arguments
    */
    args: any[];
    /**
    *  Raw  calldata
    */
    calldata: string;
    /**
    *  Function  signature  (4-byte  selector)
    */
    signature: string;
    /**
    *  Whether  the  function  name  was  inferred  (not  from  official  ABI)
    */
    inferred?: boolean;
    /**
    *  Gas  used  for  this  call
    */
    gasUsed?: bigint;
    /**
    *  Value  sent  with  the  call  (in  wei)
    */
    value?: bigint;
    /**
    *  Nested  calls  made  within  this  call
    */
    calls?: DecodedCall[];
    /**
    *  Whether  this  call  reverted
    */
    reverted?: boolean;
    /**
    *  Revert  reason  if  the  call  failed
    */
    revertReason?: string;
}
/**
  *  Decoded  event  log  information
  */
export interface DecodedEvent {
    /**
    *  Contract  address  that  emitted  the  event
    */
    address: string;
    /**
    *  Event  name  (decoded  or  inferred)
    */
    eventName: string;
    /**
    *  Decoded  event  arguments
    */
    args: any[];
    /**
    *  Raw  event  data
    */
    data: string;
    /**
    *  Event  topics
    */
    topics: string[];
    /**
    *  Event  signature
    */
    signature: string;
    /**
    *  Whether  the  event  name  was  inferred
    */
    inferred?: boolean;
    /**
    *  Block  number
    */
    blockNumber: number;
    /**
    *  Transaction  index
    */
    transactionIndex: number;
    /**
    *  Log  index
    */
    logIndex: number;
}
/**
  *  Storage  change  information
  */
export interface StorageChange {
    /**
    *  Contract  address
    */
    address: string;
    /**
    *  Storage  slot
    */
    slot: string;
    /**
    *  Previous  value
    */
    previousValue: string;
    /**
    *  New  value
    */
    newValue: string;
}
/**
  *  Complete  transaction  inspection  report
  */
export interface TransactionReport {
    /**
    *  Transaction  hash
    */
    txHash: string;
    /**
    *  Block  number
    */
    blockNumber: number;
    /**
    *  Transaction  index  in  block
    */
    transactionIndex: number;
    /**
    *  From  address
    */
    from: string;
    /**
    *  To  address  (null  for  contract  creation)
    */
    to: string | null;
    /**
    *  Transaction  value  (in  wei)
    */
    value: bigint;
    /**
    *  Gas  price
    */
    gasPrice: bigint;
    /**
    *  Gas  limit
    */
    gasLimit: bigint;
    /**
    *  Gas  used
    */
    gasUsed: bigint;
    /**
    *  Transaction  status  (true  =  success,  false  =  reverted)
    */
    status: boolean;
    /**
    *  Decoded  call  stack  (hierarchical)
    */
    callStack: DecodedCall[];
    /**
    *  Decoded  event  logs
    */
    events: DecodedEvent[];
    /**
    *  Storage  changes  (if  enabled)
    */
    storageChanges?: StorageChange[];
    /**
    *  Revert  reason  if  transaction  failed
    */
    revertReason?: string;
    /**
    *  Error  message  if  transaction  failed
    */
    error?: string;
    /**
    *  Chain  ID
    */
    chainId: number;
    /**
    *  Timestamp  of  the  block
    */
    timestamp?: number;
}
/**
  *  Raw  trace  result  from  debug_traceTransaction
  */
export interface TraceResult {
    /**
    *  Gas  used
    */
    gas: string;
    /**
    *  Return  value
    */
    returnValue: string;
    /**
    *  Error  message  if  any
    */
    error?: string;
    /**
    *  Call  type
    */
    type: string;
    /**
    *  From  address
    */
    from: string;
    /**
    *  To  address
    */
    to: string;
    /**
    *  Input  data
    */
    input: string;
    /**
    *  Output  data
    */
    output: string;
    /**
    *  Value  transferred
    */
    value: string;
    /**
    *  Gas  used
    */
    gasUsed: string;
    /**
     * Nested calls
     */
    calls?: TraceResult[];
    /**
     * Logs emitted
     */
    logs?: Array<{
        address: string;
        topics: string[];
        data: string;
    }>;
}
/**
 * Network configuration for block explorer APIs
 */
export interface NetworkConfig {
    /**
     * Chain ID
     */
    chainId: number;
    /**
     * Network name
     */
    name: string;
    /**
     * Default RPC URL
     */
    rpcUrl: string;
    /**
     * Block explorer API base URL
     */
    explorerApiUrl: string;
    /**
     * Block explorer website URL
     */
    explorerUrl: string;
}
//# sourceMappingURL=types.d.ts.map