@feelyourprotocol/evm 8141.0.0

package/dist/esm/types.d.ts

@@ -0,0 +1,465 @@
+import type { BinaryTreeAccessWitnessInterface, Common, ParamsDict, StateManagerInterface } from '@feelyourprotocol/common';
+import type { Account, Address, BlockLevelAccessList, PrefixedHexString } from '@feelyourprotocol/util';
+import type { EventEmitter } from 'eventemitter3';
+import type { BinaryTreeAccessWitness } from './binaryTreeAccessWitness.ts';
+import type { EOFContainer } from './eof/container.ts';
+import type { EVMError } from './errors.ts';
+import type { FrameExecutionContext } from './frameContext.ts';
+import type { InterpreterStep, RunState } from './interpreter.ts';
+import type { Message } from './message.ts';
+import type { AsyncDynamicGasHandler, SyncDynamicGasHandler } from './opcodes/gas.ts';
+import type { OpHandler } from './opcodes/index.ts';
+import type { CustomPrecompile } from './precompiles/index.ts';
+import type { PrecompileFunc } from './precompiles/types.ts';
+export type DeleteOpcode = {
+    opcode: number;
+};
+export type AddOpcode = {
+    opcode: number;
+    opcodeName: string;
+    baseFee: number;
+    gasFunction?: AsyncDynamicGasHandler | SyncDynamicGasHandler;
+    logicFunction: OpHandler;
+};
+export type SelfdestructMap = Map<PrefixedHexString, PrefixedHexString>;
+export type CustomOpcode = AddOpcode | DeleteOpcode;
+export declare function isAddOpcode(customOpcode: CustomOpcode): customOpcode is AddOpcode;
+/**
+ * Base options for the `EVM.runCode()` / `EVM.runCall()` method.
+ */
+interface EVMRunOpts {
+    /**
+     * The `block` the `tx` belongs to. If omitted a default blank block will be used.
+     */
+    block?: Block;
+    /**
+     * The gas price for the call. Defaults to `0`
+     */
+    gasPrice?: bigint;
+    /**
+     * The address where the call originated from. Defaults to the zero address.
+     */
+    origin?: Address;
+    /**
+     * The address that ran this code (`msg.sender`). Defaults to the zero address.
+     */
+    caller?: Address;
+    /**
+     * The EVM code to run.
+     */
+    code?: Uint8Array;
+    /**
+     * The input data.
+     */
+    data?: Uint8Array;
+    /**
+     * The gas limit for the call. Defaults to `16777215` (`0xffffff`)
+     */
+    gasLimit?: bigint;
+    /**
+     * The value in ether that is being sent to `opts.address`. Defaults to `0`
+     */
+    value?: bigint;
+    /**
+     * The call depth. Defaults to `0`
+     */
+    depth?: number;
+    /**
+     * If the call should be executed statically. Defaults to false.
+     */
+    isStatic?: boolean;
+    /**
+     * Selfdestructed addresses mapped to their beneficiary. Defaults to the empty map.
+     */
+    selfdestruct?: SelfdestructMap;
+    /**
+     * The address of the account that is executing this code (`address(this)`). Defaults to the zero address.
+     */
+    to?: Address;
+    /**
+     * Versioned hashes for each blob in a blob transaction
+     */
+    blobVersionedHashes?: PrefixedHexString[];
+}
+export interface EVMRunCodeOpts extends EVMRunOpts {
+    pc?: number;
+}
+/**
+ * Options for running a call (or create) operation with `EVM.runCall()`
+ */
+export interface EVMRunCallOpts extends EVMRunOpts {
+    /**
+     * If the code location is a precompile.
+     */
+    isCompiled?: boolean;
+    /**
+     * An optional salt to pass to CREATE2.
+     */
+    salt?: Uint8Array;
+    /**
+     * Created addresses in current context. Used in EIP 6780
+     */
+    createdAddresses?: Set<PrefixedHexString>;
+    /**
+     * Skip balance checks if true. If caller balance is less than message value,
+     * sets balance to message value to ensure execution doesn't fail.
+     */
+    skipBalance?: boolean;
+    /**
+     * If the call is a DELEGATECALL. Defaults to false.
+     */
+    delegatecall?: boolean;
+    /**
+     * Refund counter. Defaults to `0`
+     */
+    gasRefund?: bigint;
+    /**
+     * Optionally pass in an already-built message.
+     */
+    message?: Message;
+    accessWitness?: BinaryTreeAccessWitnessInterface;
+}
+interface NewContractEvent {
+    address: Address;
+    code: Uint8Array;
+}
+export type EVMEvent = {
+    newContract: (data: NewContractEvent, resolve?: (result?: any) => void) => void;
+    beforeMessage: (data: Message, resolve?: (result?: any) => void) => void;
+    afterMessage: (data: EVMResult, resolve?: (result?: any) => void) => void;
+    step: (data: InterpreterStep, resolve?: (result?: any) => void) => void;
+};
+export interface EVMInterface {
+    common: Common;
+    journal: {
+        commit(): Promise<void>;
+        revert(): Promise<void>;
+        checkpoint(): Promise<void>;
+        cleanJournal(): void;
+        cleanup(): Promise<void>;
+        putAccount(address: Address, account: Account): Promise<void>;
+        deleteAccount(address: Address): Promise<void>;
+        accessList?: Map<string, Set<string>>;
+        preimages?: Map<PrefixedHexString, Uint8Array>;
+        addAlwaysWarmAddress(address: string, addToAccessList?: boolean): void;
+        addAlwaysWarmSlot(address: string, slot: string, addToAccessList?: boolean): void;
+        startReportingAccessList(): void;
+        startReportingPreimages?(): void;
+    };
+    stateManager: StateManagerInterface;
+    precompiles: Map<string, PrecompileFunc>;
+    getPrecompile?(address: Address | PrefixedHexString): PrecompileFunc | undefined;
+    runCall(opts: EVMRunCallOpts): Promise<EVMResult>;
+    runCode(opts: EVMRunCodeOpts): Promise<ExecResult>;
+    events?: EventEmitter<EVMEvent>;
+    binaryTreeAccessWitness?: BinaryTreeAccessWitness;
+    systemBinaryTreeAccessWitness?: BinaryTreeAccessWitness;
+    blockLevelAccessList?: BlockLevelAccessList;
+    frameExecutionContext?: FrameExecutionContext;
+}
+export type EVMProfilerOpts = {
+    enabled: boolean;
+};
+/**
+ * Options for instantiating a {@link EVM}.
+ */
+export interface EVMOpts {
+    /**
+     * Use a {@link Common} instance for EVM instantiation.
+     *
+     * ### Supported EIPs
+     *
+     * - [EIP-1153](https://eips.ethereum.org/EIPS/eip-1153) - Transient storage opcodes (Cancun)
+     * - [EIP-1559](https://eips.ethereum.org/EIPS/eip-1559) - Fee market change for ETH 1.0 chain
+     * - [EIP-2537](https://eips.ethereum.org/EIPS/eip-2537) - Precompile for BLS12-381 curve operations (Prague)
+     * - [EIP-2565](https://eips.ethereum.org/EIPS/eip-2565) - ModExp gas cost
+     * - [EIP-2718](https://eips.ethereum.org/EIPS/eip-2718) - Typed Transaction Envelope
+     * - [EIP-2935](https://eips.ethereum.org/EIPS/eip-2935) - Serve historical block hashes from state (Prague)
+     * - [EIP-2929](https://eips.ethereum.org/EIPS/eip-2929) - gas cost increases for state access opcodes
+     * - [EIP-2930](https://eips.ethereum.org/EIPS/eip-2930) - Optional access list tx type
+     * - [EIP-3074](https://eips.ethereum.org/EIPS/eip-3074) - AUTH and AUTHCALL opcodes
+     * - [EIP-3198](https://eips.ethereum.org/EIPS/eip-3198) - Base fee Opcode
+     * - [EIP-3529](https://eips.ethereum.org/EIPS/eip-3529) - Reduction in refunds
+     * - [EIP-3541](https://eips.ethereum.org/EIPS/eip-3541) - Reject new contracts starting with the 0xEF byte
+     * - [EIP-3554](https://eips.ethereum.org/EIPS/eip-3554) - Difficulty Bomb Delay to December 2021 (only PoW networks)
+     * - [EIP-3607](https://eips.ethereum.org/EIPS/eip-3607) - Reject transactions from senders with deployed code
+     * - [EIP-3651](https://eips.ethereum.org/EIPS/eip-3651) - Warm COINBASE (Shanghai)
+     * - [EIP-3675](https://eips.ethereum.org/EIPS/eip-3675) - Upgrade consensus to Proof-of-Stake
+     * - [EIP-3855](https://eips.ethereum.org/EIPS/eip-3855) - Push0 opcode (Shanghai)
+     * - [EIP-3860](https://eips.ethereum.org/EIPS/eip-3860) - Limit and meter initcode (Shanghai)
+     * - [EIP-4345](https://eips.ethereum.org/EIPS/eip-4345) - Difficulty Bomb Delay to June 2022
+     * - [EIP-4399](https://eips.ethereum.org/EIPS/eip-4399) - Supplant DIFFICULTY opcode with PREVRANDAO (Merge)
+     * - [EIP-4788](https://eips.ethereum.org/EIPS/eip-4788) - Beacon block root in the EVM (Cancun)
+     * - [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) - Shard Blob Transactions (Cancun)
+     * - [EIP-4895](https://eips.ethereum.org/EIPS/eip-4895) - Beacon chain push withdrawals as operations (Shanghai)
+     * - [EIP-5133](https://eips.ethereum.org/EIPS/eip-5133) - Delaying Difficulty Bomb to mid-September 2022 (Gray Glacier)
+     * - [EIP-5656](https://eips.ethereum.org/EIPS/eip-5656) - MCOPY - Memory copying instruction (Cancun)
+     * - [EIP-6110](https://eips.ethereum.org/EIPS/eip-6110) - Supply validator deposits on chain (Prague)
+     * - [EIP-6780](https://eips.ethereum.org/EIPS/eip-6780) - SELFDESTRUCT only in same transaction (Cancun)
+     * - [EIP-7002](https://eips.ethereum.org/EIPS/eip-7002) - Execution layer triggerable exits (Prague)
+     * - [EIP-7251](https://eips.ethereum.org/EIPS/eip-7251) - Increase the MAX_EFFECTIVE_BALANCE (Prague)
+     * - [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) - BLOBBASEFEE opcode (Cancun)
+     * - [EIP-7623](https://eips.ethereum.org/EIPS/eip-7623) - Increase calldata cost (Prague)
+     * - [EIP-7685](https://eips.ethereum.org/EIPS/eip-7685) - General purpose execution layer requests (Prague)
+     * - [EIP-7691](https://eips.ethereum.org/EIPS/eip-7691) - Blob throughput increase (Prague)
+     * - [EIP-7692](https://eips.ethereum.org/EIPS/eip-7692) - EVM Object Format (EOF) v1 (`experimental`)
+     * - [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) - Set EOA account code (Prague)
+     * - [EIP-7709](https://eips.ethereum.org/EIPS/eip-7709) - Read BLOCKHASH from storage and update cost (Verkle)
+     * - [EIP-7934](https://eips.ethereum.org/EIPS/eip-7934) - RLP Execution Block Size Limit
+     *
+     * *Annotations:*
+     *
+     * - `experimental`: behaviour can change on patch versions
+     */
+    common?: Common;
+    /**
+     * Allows unlimited contract sizes while debugging. By setting this to `true`, the check for
+     * contract size limit of 24KB (see [EIP-170](https://git.io/vxZkK)) is bypassed.
+     *
+     * Default: `false` [ONLY set to `true` during debugging]
+     */
+    allowUnlimitedContractSize?: boolean;
+    /**
+     * Allows unlimited contract code-size init while debugging. This (partially) disables EIP-3860.
+     * Gas cost for initcode size analysis will still be charged. Use with caution.
+     */
+    allowUnlimitedInitCodeSize?: boolean;
+    /**
+     * EVM parameters sorted by EIP can be found in the exported `paramsEVM` dictionary,
+     * which is internally passed to the associated `@feelyourprotocol/common` instance which
+     * manages parameter selection based on the hardfork and EIP settings.
+     *
+     * This option allows providing a custom set of parameters. Note that parameters
+     * get fully overwritten, so you need to extend the default parameter dict
+     * to provide the full parameter set.
+     *
+     * It is recommended to deep-clone the params object for this to avoid side effects:
+     *
+     * ```ts
+     * const params = JSON.parse(JSON.stringify(paramsEVM))
+     * params['1679']['bn254AddGas'] = 100 // 150
+     * ```
+     */
+    params?: ParamsDict;
+    /**
+     * Override or add custom opcodes to the EVM instruction set
+     * These custom opcodes are EIP-agnostic and are always statically added
+     * To delete an opcode, add an entry of format `{opcode: number}`. This will delete that opcode from the EVM.
+     * If this opcode is then used in the EVM, the `INVALID` opcode would instead be used.
+     * To add an opcode, add an entry of the following format:
+     * {
+     *    // The opcode number which will invoke the custom opcode logic
+     *    opcode: number
+     *    // The name of the opcode (as seen in the `step` event)
+     *    opcodeName: string
+     *    // The base fee of the opcode
+     *    baseFee: number
+     *    // If the opcode charges dynamic gas, add this here. To charge the gas, use the `i` methods of the BN, to update the charged gas
+     *    gasFunction?: function(runState: RunState, gas: BN, common: Common)
+     *    // The logic of the opcode which holds the logic of changing the current state
+     *    logicFunction: function(runState: RunState)
+     * }
+     * Note: gasFunction and logicFunction can both be async or synchronous functions
+     */
+    customOpcodes?: CustomOpcode[];
+    customPrecompiles?: CustomPrecompile[];
+    /**
+     * For the EIP-2537 BLS Precompiles, the native JS `ethereum-cryptography` (`@noble/curves`)
+     * https://github.com/ethereum/js-ethereum-cryptography BLS12-381 curve implementation
+     * is used (see `noble.ts` file in the `precompiles/bls12_381/` folder).
+     *
+     * To use an alternative implementation this option can be used by passing
+     * in a wrapper implementation integrating the desired library and adhering
+     * to the `EVMBLSInterface` specification.
+     *
+     * An interface for the MCL WASM implementation https://github.com/herumi/mcl-wasm
+     * is shipped with this library which can be used as follows (with `mcl-wasm` being
+     * explicitly added to the set of dependencies):
+     *
+     * ```ts
+     * import * as mcl from 'mcl-wasm'
+     *
+     * await mcl.init(mcl.BLS12_381)
+     * const evm = await createEVM({ bls: new MCLBLS(mcl) })
+     * ```
+     */
+    bls?: EVMBLSInterface;
+    /**
+     * For the EIP-196/EIP-197 BN254 (alt_BN128) EC precompiles, the native JS `ethereum-cryptography`
+     * (`@noble/curves`) https://github.com/ethereum/js-ethereum-cryptography BN254 curve implementation
+     * is used (see `noble.ts` file in the `precompiles/bn254/` folder).
+     *
+     * To use an alternative implementation this option can be used by passing
+     * in a wrapper implementation integrating the desired library and adhering
+     * to the `EVMBN254Interface` specification.
+     *
+     * An interface for a WASM wrapper https://github.com/ethereumjs/rustbn.js around the
+     * Parity fork of the Zcash bn pairing cryptography library is shipped with this library
+     * which can be used as follows (with `rustbn.js` being explicitly added to the set of
+     * dependencies):
+     *
+     * ```ts
+     * import { initRustBN } from 'rustbn-wasm'
+     *
+     * const bn254 = await initRustBN()
+     * const evm = await createEVM({ bn254: new RustBN254(bn254) })
+     * ```
+     */
+    bn254?: EVMBN254Interface;
+    stateManager?: StateManagerInterface;
+    /**
+     * The EVM comes with a basic mock blockchain interface and implementation for
+     * non-block containing use cases.
+     *
+     * For block-containing setups use the full blockchain implementation from the
+     * `@feelyourprotocol/blockchain package.
+     */
+    blockchain?: EVMMockBlockchainInterface;
+    /**
+     *
+     */
+    profiler?: EVMProfilerOpts;
+    /**
+     * If EIP-7928 is activated, a block-level access list can be provided here.
+     * If not provided, a new one will be created if EIP-7928 is activated
+     */
+    blockLevelAccessList?: BlockLevelAccessList;
+    /**
+     * When running the EVM with PoA consensus, the `cliqueSigner` function from the `@feelyourprotocol/block` class
+     * must be provided along with a `BlockHeader` so that the coinbase can be correctly retrieved when the
+     * `Interpreter.getBlockCoinbase` method is called.
+     */
+    cliqueSigner?: (header: Block['header']) => Address;
+}
+/**
+ * Result of executing a message via the {@link EVM}.
+ */
+export interface EVMResult {
+    /**
+     * Address of created account during transaction, if any
+     */
+    createdAddress?: Address;
+    /**
+     * Contains the results from running the code, if any, as described in {@link runCode}
+     */
+    execResult: ExecResult;
+}
+/**
+ * Result of executing a call via the {@link EVM}.
+ */
+export interface ExecResult {
+    runState?: RunState;
+    /**
+     * Description of the exception, if any occurred
+     */
+    exceptionError?: EVMError;
+    /**
+     * Amount of gas left
+     */
+    gas?: bigint;
+    /**
+     * Amount of gas the code used to run
+     */
+    executionGasUsed: bigint;
+    /**
+     * Return value from the contract
+     */
+    returnValue: Uint8Array;
+    /**
+     * Array of logs that the contract emitted
+     */
+    logs?: Log[];
+    /**
+     * Selfdestructed accounts mapped to their beneficiary
+     */
+    selfdestruct?: SelfdestructMap;
+    /**
+     * Map of addresses which were created (used in EIP 6780)
+     */
+    createdAddresses?: Set<PrefixedHexString>;
+    /**
+     * The gas refund counter
+     */
+    gasRefund?: bigint;
+    /**
+     * Amount of blob gas consumed by the transaction
+     */
+    blobGasUsed?: bigint;
+}
+/**
+ * High level wrapper for BLS libraries used
+ * for the BLS precompiles
+ */
+export type EVMBLSInterface = {
+    init?(): void;
+    addG1(input: Uint8Array): Uint8Array;
+    addG2(input: Uint8Array): Uint8Array;
+    mapFPtoG1(input: Uint8Array): Uint8Array;
+    mapFP2toG2(input: Uint8Array): Uint8Array;
+    msmG1(input: Uint8Array): Uint8Array;
+    msmG2(input: Uint8Array): Uint8Array;
+    pairingCheck(input: Uint8Array): Uint8Array;
+};
+/**
+ * High level wrapper for BN254 (alt_BN128) libraries
+ * used for the BN254 (alt_BN128) EC precompiles
+ */
+export type EVMBN254Interface = {
+    add: (input: Uint8Array) => Uint8Array;
+    mul: (input: Uint8Array) => Uint8Array;
+    pairing: (input: Uint8Array) => Uint8Array;
+};
+/**
+ * Log that the contract emits.
+ */
+export type Log = [address: Uint8Array, topics: Uint8Array[], data: Uint8Array];
+export type Block = {
+    header: {
+        number: bigint;
+        coinbase: Address;
+        timestamp: bigint;
+        difficulty: bigint;
+        prevRandao: Uint8Array;
+        gasLimit: bigint;
+        baseFeePerGas?: bigint;
+        slotNumber?: bigint;
+        getBlobGasPrice(): bigint | undefined;
+    };
+};
+export interface TransientStorageInterface {
+    get(addr: Address, key: Uint8Array): Uint8Array;
+    put(addr: Address, key: Uint8Array, value: Uint8Array): void;
+    commit(): void;
+    checkpoint(): void;
+    revert(): void;
+    toJSON(): {
+        [address: string]: {
+            [key: string]: string;
+        };
+    };
+    clear(): void;
+}
+export type EVMMockBlock = {
+    hash(): Uint8Array;
+};
+export interface EVMMockBlockchainInterface {
+    getBlock(blockId: number): Promise<EVMMockBlock>;
+    putBlock(block: EVMMockBlock): Promise<void>;
+    shallowCopy(): EVMMockBlockchainInterface;
+}
+export declare class EVMMockBlockchain implements EVMMockBlockchainInterface {
+    getBlock(): Promise<{
+        hash(): Uint8Array<ArrayBuffer>;
+    }>;
+    putBlock(): Promise<void>;
+    shallowCopy(): this;
+}
+export type EOFEnv = {
+    container: EOFContainer;
+    eofRunState: {
+        returnStack: number[];
+    };
+};
+export declare const DELEGATION_7702_FLAG: Uint8Array<ArrayBuffer>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/types.js

@@ -0,0 +1,23 @@
+// Typeguard
+export function isAddOpcode(customOpcode) {
+    return ('opcode' in customOpcode &&
+        'opcodeName' in customOpcode &&
+        'baseFee' in customOpcode &&
+        'logicFunction' in customOpcode);
+}
+export class EVMMockBlockchain {
+    async getBlock() {
+        return {
+            hash() {
+                return new Uint8Array(32);
+            },
+        };
+    }
+    async putBlock() { }
+    shallowCopy() {
+        return this;
+    }
+}
+// EIP-7702 flag: if contract code starts with these 3 bytes, it is a 7702-delegated EOA
+export const DELEGATION_7702_FLAG = new Uint8Array([0xef, 0x01, 0x00]);
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAmCA,YAAY;AACZ,MAAM,UAAU,WAAW,CAAC,YAA0B;IACpD,OAAO,CACL,QAAQ,IAAI,YAAY;QACxB,YAAY,IAAI,YAAY;QAC5B,SAAS,IAAI,YAAY;QACzB,eAAe,IAAI,YAAY,CAChC,CAAA;AACH,CAAC;AAudD,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,QAAQ;QACZ,OAAO;YACL,IAAI;gBACF,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;YAC3B,CAAC;SACF,CAAA;IACH,CAAC;IACD,KAAK,CAAC,QAAQ,KAAI,CAAC;IACnB,WAAW;QACT,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAUD,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA"}