@feelyourprotocol/evm 8141.0.0

package/src/frameContext.ts

@@ -0,0 +1,56 @@
+/**
+ * EIP-8141 Frame Execution Context
+ *
+ * Holds a reference to the actual FrameEIP8141Tx plus mutable runtime
+ * state needed during frame execution. The EVM stores this as an
+ * optional property — set by the VM before the frame loop, cleared after.
+ */
+
+import type { FrameEIP8141Tx } from '@feelyourprotocol/tx'
+import type { Address, PrefixedHexString } from '@feelyourprotocol/util'
+
+export const FRAME_MODE = {
+  DEFAULT: 0,
+  VERIFY: 1,
+  SENDER: 2,
+} as const
+
+export const ENTRY_POINT_ADDRESS = '0x00000000000000000000000000000000000000aa' as PrefixedHexString
+
+export interface ParsedFrame {
+  mode: number
+  target: Address | null
+  gasLimit: bigint
+  data: Uint8Array
+}
+
+export interface FrameResult {
+  status: number
+  gasUsed: bigint
+  returnValue: Uint8Array
+}
+
+/**
+ * Mutable runtime state that evolves during frame execution.
+ * Separated from the immutable tx object for clarity.
+ */
+export interface FrameExecutionState {
+  parsedFrames: ParsedFrame[]
+  currentFrameIndex: number
+  senderApproved: boolean
+  payerApproved: boolean
+  payer?: Address
+  approveCalledInCurrentFrame: boolean
+  frameResults: FrameResult[]
+  totalGasCost: bigint
+  totalBlobGasCost: bigint
+}
+
+/**
+ * The frame execution context set on the EVM during EIP-8141 frame tx processing.
+ * Combines the immutable transaction with mutable execution state.
+ */
+export interface FrameExecutionContext {
+  tx: FrameEIP8141Tx
+  state: FrameExecutionState
+}

package/src/index.ts

@@ -0,0 +1,75 @@
+import { EOFContainer, validateEOF } from './eof/container.ts'
+import { EVMError } from './errors.ts'
+import { EVM } from './evm.ts'
+import { Message } from './message.ts'
+import { getOpcodesForHF } from './opcodes/index.ts'
+import {
+  type AddPrecompile,
+  type CustomPrecompile,
+  type DeletePrecompile,
+  MCLBLS,
+  NobleBLS,
+  NobleBN254,
+  type PrecompileFunc,
+  type PrecompileInput,
+  RustBN254,
+  getActivePrecompiles,
+} from './precompiles/index.ts'
+import { EVMMockBlockchain } from './types.ts'
+
+import type { InterpreterStep } from './interpreter.ts'
+import type {
+  EVMBLSInterface,
+  EVMBN254Interface,
+  EVMInterface,
+  EVMMockBlockchainInterface,
+  EVMOpts,
+  EVMResult,
+  EVMRunCallOpts,
+  EVMRunCodeOpts,
+  ExecResult,
+  Log,
+  SelfdestructMap,
+} from './types.ts'
+export * from './logger.ts'
+
+export type {
+  AddPrecompile,
+  CustomPrecompile,
+  DeletePrecompile,
+  EVMBLSInterface,
+  EVMBN254Interface,
+  EVMInterface,
+  EVMMockBlockchainInterface,
+  EVMOpts,
+  EVMResult,
+  EVMRunCallOpts,
+  EVMRunCodeOpts,
+  ExecResult,
+  InterpreterStep,
+  Log,
+  SelfdestructMap,
+  PrecompileFunc,
+  PrecompileInput,
+}
+
+export {
+  EOFContainer,
+  EVM,
+  EVMError,
+  EVMMockBlockchain,
+  getActivePrecompiles,
+  getOpcodesForHF,
+  MCLBLS,
+  Message,
+  NobleBLS,
+  NobleBN254,
+  RustBN254,
+  validateEOF,
+}
+
+export * from './binaryTreeAccessWitness.ts'
+export * from './constructors.ts'
+export * from './eip7708.ts'
+export * from './frameContext.ts'
+export * from './params.ts'