Crate verbs_rs

VERBS

Ethereum agent based modelling library

Verbs is a library designed to aid the implementation of agent based models of the ethereum blockchain with a focus on performance and quick development of simulations.

Verbs is built around the revm implementation of the Ethereum virtual machine, agents interact directly with EVM, avoiding the overhead of messaging or multi-threading.

Loading Contracts

Verbs makes use of alloy_sol_types to convert ABI strings/files to Rust classes that can encode/decode function arguments etc.

An ABI rust representation can generated using the sol! macro, for example

use alloy_sol_types::sol;

sol!(
    ContractName,
    r#"[
        {
            "inputs": [],
            "name": "getValue",
            "outputs": [
                {
                    "internalType": "int256",
                    "name": "",
                    "type": "int256"
                }
            ],
            "stateMutability": "view",
            "type": "function"
        }
    ]"#
);

// Encodes call arguments
ContractName::getValueCall {};

Modules

• agent
  Agent traits and structures
• contract
  Contract data structures and utilities
• env
  Simulation environments
• sim_runner
  Simulation execution
• utils
  Numerical and Ethereum utilities

Structs

• ForkDb
  Database with ability to load data from a remote fork
• LocalDB
  Local in-memory EVm database
• RequestCache
  Cache of requests made by a super::ForkDb

Traits

• DB
  Combined Revm database trait with data export methods