Add JitAsm tool to be able to analyse the Jit output

.github/workflows/build-tools.yml

@@ -21,6 +21,7 @@ jobs:
           - Evm/Evm.slnx
           - HiveCompare/HiveCompare.slnx
           - HiveConsensusWorkflowGenerator/HiveConsensusWorkflowGenerator.slnx
+          - JitAsm/JitAsm.slnx
           - Kute/Kute.slnx
           # - SchemaGenerator/SchemaGenerator.slnx
           - SendBlobs/SendBlobs.slnx

.gitignore

@@ -358,6 +358,10 @@ paket-files/
 #tools/**
 #!tools/packages.config
 
+# JitAsm uops.info database (110MB, download separately)
+tools/JitAsm/instructions.xml
+tools/JitAsm/instructions.db
+
 # Tabs Studio
 *.tss
 

AGENTS.md

@@ -27,7 +27,7 @@ This guide helps to get started with the Nethermind Ethereum execution client re
 - Trust null annotations, do not add redundant null checks
 - Add tests to existing test files rather than creating new ones
 - Code comments must explain _why_, not _what_
-- Do not suggest using LINQ when a simple loop would suffice
+- **NEVER suggest using LINQ (`.Select()`, `.Where()`, `.Any()`, etc.) when a simple `foreach` or `for` loop would work.** LINQ has overhead and is less readable for simple iterations. Use LINQ only for complex queries where the declarative syntax significantly improves clarity.
 - Do not use the `#region` and `#endregion` pragmas
 - Do not alter anything in the [src/bench_precompiles](./src/bench_precompiles/) and [src/tests](./src/tests/) directories
 

cspell.json

@@ -35,11 +35,13 @@
     "adab",
     "addmod",
     "affinitize",
+    "agen",
     "akhunov",
     "alethia",
     "alexey",
     "analysed",
     "apikey",
+    "archs",
     "argjson",
     "asmv",
     "aspnet",
@@ -105,6 +107,7 @@
     "buildtransitive",
     "bulkset",
     "bursty",
+    "bword",
     "buterin",
     "bylica",
     "bytecodes",
@@ -115,17 +118,41 @@
     "callf",
     "callme",
     "callvalue",
+    "callvirt",
     "cand",
     "canonicality",
     "castagnoli",
+    "cctor",
+    "cctors",
     "chainid",
     "chainspec",
     "chiado",
     "cipherparams",
     "ciphertext",
     "ckzg",
+    "classinit",
     "cloneable",
     "cmix",
+    "cmov",
+    "cmova",
+    "cmovae",
+    "cmovb",
+    "cmovbe",
+    "cmove",
+    "cmovg",
+    "cmovge",
+    "cmovl",
+    "cmovle",
+    "cmovna",
+    "cmovnb",
+    "cmovnbe",
+    "cmovne",
+    "cmovng",
+    "cmovnge",
+    "cmovnl",
+    "cmovnle",
+    "cmovnz",
+    "cmovz",
     "codecopy",
     "codehash",
     "codesection",
@@ -142,6 +169,7 @@
     "containersection",
     "contentfiles",
     "corechart",
+    "corinfo",
     "cpufrequency",
     "crummey",
     "cryptosuite",
@@ -151,13 +179,15 @@
     "dataloadn",
     "datasection",
     "datasize",
+    "dasm",
     "dbdir",
     "dbsize",
     "deadlined",
     "deauthorized",
     "debhelper",
     "decommit",
     "decompiled",
+    "dedup",
     "decompiler",
     "deconfigure",
     "deconfigured's",
@@ -170,12 +200,15 @@
     "deserialised",
     "dests",
     "devirtualize",
+    "devirtualized",
     "devnet",
     "devnets",
     "devp2p",
     "diagnoser",
     "diagnosers",
+    "diffable",
     "disappearer's",
+    "disasm",
     "discontiguous",
     "discport",
     "discv",
@@ -190,11 +223,13 @@
     "dpapi",
     "dpkg",
     "dupn",
+    "dynamicclass",
     "ecies",
     "ecrec",
     "edgecase",
     "efbbbf",
     "eips",
+    "eliminable",
     "emojize",
     "emptish",
     "emptystep",
@@ -228,6 +263,7 @@
     "ethxx",
     "evmdis",
     "ewasm",
+    "evex",
     "extcall",
     "extcode",
     "extcodecopy",
@@ -254,17 +290,21 @@
     "forkhash",
     "forkid",
     "fusaka",
+    "fullopts",
     "gasrefund",
     "gbps",
+    "gcstatic",
     "gcdump",
     "geoff",
     "getblobs",
     "getnull",
     "getpayloadv",
     "getrlimit",
+    "getshared",
     "gettrie",
     "gopherium",
     "gwat",
+    "gword",
     "halfpath",
     "hardfork",
     "hardforks",
@@ -292,6 +332,7 @@
     "hostnames",
     "hotstuff",
     "hyperthreading",
+    "idiv",
     "idxs",
     "iface",
     "ikvp",
@@ -307,16 +348,21 @@
     "instart",
     "internaltype",
     "interp",
+    "interruptible",
     "invalidblockhash",
     "isnull",
     "iszero",
     "ivalidatorregistrycontract",
     "ivle",
     "jemalloc",
     "jimbojones",
+    "jitasm",
     "jitted",
     "jitting",
     "jmps",
+    "jnbe",
+    "jnge",
+    "jnle",
     "jsonrpcconfig",
     "jumpdest",
     "jumpdestpush",
@@ -396,13 +442,18 @@
     "merkleize",
     "merkleizer",
     "mgas",
+    "microarchitecture",
+    "microbenchmark",
+    "microbenchmarks",
     "microsecs",
     "midnib",
     "millis",
     "mingas",
     "minlevel",
+    "minopt",
     "mintable",
     "misbehaviour",
+    "mispredictions",
     "mklink",
     "mload",
     "mmap",
@@ -450,6 +501,7 @@
     "networkconfigmaxcandidatepeercount",
     "networkid",
     "newtonsoft",
+    "nint",
     "nito",
     "nlog",
     "nodedata",
@@ -458,6 +510,7 @@
     "nodetype",
     "nofile",
     "nonposdao",
+    "nongcstatic",
     "nonstring",
     "nops",
     "nostack",
@@ -466,6 +519,7 @@
     "npushes",
     "nsubstitute",
     "nugettest",
+    "nuint",
     "numfiles",
     "oand",
     "offchain",
@@ -551,6 +605,8 @@
     "redownloading",
     "reencoding",
     "refint",
+    "regs",
+    "relbr",
     "refstruct",
     "regenesis",
     "reitwiessner",
@@ -586,6 +642,7 @@
     "samplenewpayload",
     "sankey",
     "sbrk",
+    "sbyte",
     "scopable",
     "sdiv",
     "secp",
@@ -596,7 +653,23 @@
     "seqlock",
     "serialised",
     "setcode",
+    "setb",
+    "setbe",
     "sete",
+    "setg",
+    "setge",
+    "setl",
+    "setle",
+    "setna",
+    "setnb",
+    "setnbe",
+    "setne",
+    "setnge",
+    "setnl",
+    "setnle",
+    "setng",
+    "setnz",
+    "setz",
     "shamir",
     "shlibs",
     "shouldly",
@@ -607,6 +680,7 @@
     "signextend",
     "sizeinbase",
     "skiplastn",
+    "skylake",
     "slnx",
     "sload",
     "smod",
@@ -719,20 +793,24 @@
     "unsubscription",
     "unsynchronized",
     "unvote",
+    "uops",
     "upnp",
     "upto",
     "upvoting",
     "vbmi",
     "vitalik",
+    "vmovdqu",
     "vmovups",
     "vmtrace",
     "vote₁",
     "vote₂",
     "vote₃",
     "voteₙ",
+    "vpaddd",
     "vpcbr",
     "vpor",
     "vptest",
+    "vpxor",
     "vzeroupper",
     "wamp",
     "warmcoinbase",
@@ -751,6 +829,7 @@
     "wycheproof",
     "xdai",
     "xdcx",
+    "xmmword",
     "xmlstarlet",
     "xnpool",
     "yellowpaper",
@@ -759,6 +838,7 @@
     "zcompressor",
     "zdecompressor",
     "zhizhu",
+    "zmmword",
     "zstandard",
     "zstd",
     "zwcm"