Add eth_multicall , support array of eth_call for simulation across multiple blocks

src/eth/execute.yaml

@@ -54,3 +54,24 @@
         gasUsed:
           title: Gas used
           $ref: '#/components/schemas/uint'
+- name: eth_multicallV1
+  summary: Executes a sequence of message calls building on each other's state without creating transactions on the block chain, optionally overriding block and state data
+  params:
+    - name: Block state calls
+      schema:
+        title: Arguments for multi call
+        type: array
+        items:
+          $ref: '#/components/schemas/BlockStateCalls'
+    - name: Block tag
+      required: false
+      schema:
+        type: boolean
+    - name: Trace Transfers - Add ETH transfers as fake events to the event log response
+      required: false
+      schema:
+        $ref: '#/components/schemas/BlockNumberOrTagOrHash'
+  result:
+    name: Result of calls
+    schema:
+      $ref: '#/components/schemas/MultiCallResult'

src/schemas/base-types.yaml

@@ -47,6 +47,10 @@ uint256:
   title: hex encoded 256 bit unsigned integer
   type: string
   pattern: ^0x([1-9a-f]+[0-9a-f]{0,31})|0$
+int:
+  title: decimal signed integer
+  type: string
+  pattern: ^-?[0-9]+$
 hash32:
   title: 32 byte hex value
   type: string

src/schemas/execute.yaml

@@ -0,0 +1,284 @@
+BlockStateCalls:
+  title: Array of calls to be executed at specific, optional block/state.
+  properties:
+    blockOverrides:
+      title: Block override. When overriding block number across multiple blocks, block number not decrease or remain the same between block overrides, but skipping block numbers is acceptable.
+      $ref: '#/components/schemas/BlockOverrides'
+    stateOverrides:
+      title: State overrides
+      $ref: '#/components/schemas/StateOverrides'
+    calls:
+      type: array
+      title: List of transactions to execute at this block/state
+      items:
+        $ref: '#/components/schemas/GenericCallTransaction'
+StateOverrides:
+  title: Accounts in state to be overridden
+  type: array
+  items:
+    $ref: '#/components/schemas/AccountOverride'
+AccountOverride:
+  title: Details of an account to be overridden
+  type: object
+  oneOf:
+    - $ref: '#/components/schemas/AccountOverrideState'
+    - $ref: '#/components/schemas/AccountOverrideStateDiff'
+AccountOverrideState:
+  title: Account override with whole storage replacement
+  required:
+    - state
+  properties:
+    address:
+      title: Address
+      $ref: '#/components/schemas/address'
+    nonce:
+      title: Nonce
+      $ref: '#/components/schemas/uint64'
+    balance:
+      title: Balance
+      $ref: '#/components/schemas/uint256'
+    code:
+      title: Code
+      $ref: '#/components/schemas/bytes'
+    moveToAddress:
+      title: MoveToAddress
+      $ref: '#/components/schemas/address'
+    state:
+      title: Storage
+      $ref: '#/components/schemas/AccountStorage'
+AccountOverrideStateDiff:
+  title: Account override with partial storage modification
+  required:
+    - stateDiff
+  properties:
+    address:
+      title: Address
+      $ref: '#/components/schemas/address'
+    nonce:
+      title: Nonce
+      $ref: '#/components/schemas/uint64'
+    balance:
+      title: Balance
+      $ref: '#/components/schemas/uint256'
+    code:
+      title: Code
+      $ref: '#/components/schemas/bytes'
+    moveToAddress:
+      title: MoveToAddress
+      $ref: '#/components/schemas/address'
+    stateDiff:
+      title: Storage difference
+      $ref: '#/components/schemas/AccountStorage'
+AccountStorage:
+  title: Storage slots for an account
+  type: object
+  additionalProperties:
+    - $ref: '#/components/schemas/hash32'
+BlockOverrides:
+  title: Context fields related to the block being executed
+  type: object
+  properties:
+    number:
+      title: Number
+      $ref: '#/components/schemas/uint256'
+    prevRandao:
+      title: Randomness beacon
+      $ref: '#/components/schemas/uint256'
+    time:
+      title: Time
+      $ref: '#/components/schemas/uint256'
+    gasLimit:
+      title: Gas limit
+      $ref: '#/components/schemas/uint64'
+    feeRecipient:
+      title: feeRecipient
+      $ref: '#/components/schemas/address'
+    baseFeePerGas:
+      title: Base fee per gas
+      $ref: '#/components/schemas/uint256'
+MultiCallResult:
+  title: Full results of multi call
+  type: array
+  items:
+    $ref: '#/components/schemas/MultiCallBlockResult'
+MultiCallBlockResult:
+  title: Result of multicall block-level, with array of calls
+  type: object
+  properties:
+    number:
+      title: Number
+      $ref: '#/components/schemas/uint256'
+    hash:
+      title: block hash
+      $ref: '#/components/schemas/hash32'
+    timestamp:
+      title: Time
+      $ref: '#/components/schemas/uint256'
+    gasLimit:
+      title: Gas limit
+      $ref: '#/components/schemas/uint64'
+    gasUsed:
+      title: Gas used
+      $ref: '#/components/schemas/uint64'
+    feeRecipient:
+      title: feeRecipient
+      $ref: '#/components/schemas/address'
+    baseFeePerGas:
+      title: Base fee
+      $ref: '#/components/schemas/uint256'
+    calls:
+      $ref: '#/components/schemas/CallResults'
+CallResults:
+  title: Results of multi call within block
+  type: array
+  items:
+    anyOf:
+      - $ref: '#/components/schemas/CallResultFailure'
+      - $ref: '#/components/schemas/CallResultSuccess'
+      - $ref: '#/components/schemas/CallResultInvalid'
+CallResultFailure:
+  title: Result of call failure
+  type: object
+  required:
+    - status
+    - returnData
+    - error
+    - gasUsed
+  properties:
+    status:
+      title: Call Status Failure
+      type: string
+      pattern: ^0x0$
+    returnData:
+      title: Return data
+      $ref: '#/components/schemas/bytes'
+    gasUsed:
+      title: Return gasUsed
+      $ref: '#/components/schemas/uint64'
+    error:
+      title: Error Object
+      type: object
+      properties:
+        code:
+          title: Error code
+          type: number
+          $ref: '#/components/schemas/int'
+        message:
+          title: Error Message (execution reverted, out of gas, etc)
+          type: string
+        data:
+          title: Reverted, with optional message
+          type: string
+CallResultSuccess:
+  title: Result of call success
+  type: object
+  required:
+    - status
+    - returnData
+    - gasUsed
+    - logs
+  properties:
+    status:
+      title: Call Status Success
+      type: string
+      pattern: ^0x1$
+    returnData:
+      title: Return data
+      $ref: '#/components/schemas/bytes'
+    gasUsed:
+      title: Return gasUsed
+      $ref: '#/components/schemas/uint64'
+    logs:
+      title: Return logs
+      type: array
+      items:
+        $ref: '#/components/schemas/CallResultLog'
+CallResultInvalid:
+  title: Result of call not being valid (nonce, baseFee, etc)
+  type: object
+  required:
+    - status
+    - error
+  properties:
+    status:
+      title: Call Status Invalid
+      type: string
+      pattern: ^0x2$
+    error:
+      title: Error Object
+      type: object
+      properties:
+        message:
+          title: Reason the transaction could not be included on-chain (baseFee, nonce too high, etc)
+          type: string
+        code:
+          type: number
+          $ref: '#/components/schemas/int'
+CallResultLog:
+  title: log
+  type: object
+  required:
+    - logIndex
+    - address
+  properties:
+    logIndex:
+      title: log index
+      $ref: '#/components/schemas/uint256'
+    blockHash:
+      title: block hash
+      $ref: '#/components/schemas/hash32'
+    blockNumber:
+      title: block number
+      $ref: '#/components/schemas/uint64'
+    address:
+      title: address
+      $ref: '#/components/schemas/address'
+    data:
+      title: data
+      $ref: '#/components/schemas/bytes'
+    topics:
+      title: topics
+      type: array
+      items:
+        $ref: '#/components/schemas/bytes32'
+GenericCallTransaction:
+  type: object
+  title: Transaction object type for call
+  properties:
+    type:
+      title: type
+      $ref: '#/components/schemas/byte'
+    nonce:
+      title: nonce
+      $ref: '#/components/schemas/uint64'
+    to:
+      title: to address
+      $ref: '#/components/schemas/address'
+    from:
+      title: from address
+      $ref: '#/components/schemas/address'
+    gas:
+      title: gas limit
+      $ref: '#/components/schemas/uint64'
+    value:
+      title: value
+      $ref: '#/components/schemas/uint256'
+    input:
+      title: input data
+      $ref: '#/components/schemas/bytes'
+    gasPrice:
+      title: gas price
+      description: The gas price willing to be paid by the sender in wei
+      $ref: '#/components/schemas/uint256'
+    maxPriorityFeePerGas:
+      title: max priority fee per gas
+      description: Maximum fee per gas the sender is willing to pay to miners in wei
+      $ref: '#/components/schemas/uint256'
+    maxFeePerGas:
+      title: max fee per gas
+      description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
+      $ref: '#/components/schemas/uint256'
+    accessList:
+      title: accessList
+      description: EIP-2930 access list
+      $ref: '#/components/schemas/AccessList'

tests/eth_multicall/multicall-account-add-state.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc":"2.0","id":1,"method":"eth_multicallV1","params":[[],"latest"]}
+<< {"jsonrpc":"2.0","id":1,"result":[]}

tests/eth_multicall/multicall-account-override-state.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc":"2.0","id":1,"method":"eth_multicallV1","params":[[{"stateOverrides":[{"nonce":"0x1", "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "balance": "0xde0b6b3a7640000", "state": {"0x2292f0db49e1af24fbcac7f32b7537f334244455ad0ed0b46a78202982e7b70d": "0xde0b6b3a7640000", "0x877bd4632ef8c8ddc43b67e5a4511d939eadb612553c8a060670e05ebb1bb83c": "0xde0b6b3a7640000"}}],"calls":[{"from":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","to":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","data":"0x18160ddd"}]}],"latest"]}
+<< {"jsonrpc":"2.0","id":1,"result":[{"status":"0x1","returnData":"0x0000000000000000000000000000000000000000000000000de0b6b3a7640000","gasUsed":"0x5338","logs":[]}]}

tests/eth_multicall/multicall-block-override.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc": "2.0", "id": 1, "method": "eth_multicallV1", "params": [ [ { "calls": [ { "to": "0x4B62D7C9C4e5c7150Eda45F7552a25C7Cd726bF6", "data": "0x42cbb15c" } ] }, { "blockOverrides": { "number": "0x4999999" }, "calls": [ { "to": "0x4B62D7C9C4e5c7150Eda45F7552a25C7Cd726bF6", "data": "0x42cbb15c" } ] } ], "latest" ] }
+<< {"jsonrpc":"2.0","id":1,"result":[{"status":"0x1","returnData":"0x0000000000000000000000000000000000000000000000000000000001031b64","gasUsed":"0x5338","logs":[]},{"status":"0x1","returnData":"0x0000000000000000000000000000000000000000000000000000000004999999","gasUsed":"0x5338","logs":[]}]}

tests/eth_multicall/multicall-empty.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc":"2.0","id":1,"method":"eth_multicallV1","params":[[],"latest", false]}
+<< {"jsonrpc":"2.0","id":1,"result":[]}

tests/eth_multicall/multicall-simple-error.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc":"2.0","id":1,"method":"eth_multicallV1","params":[[{"calls":[{"from":"0xde67356daf70aba7582d9b313d29de02681dfbd8","to":"0x5cd267914528e83422cafa6718153eafc67a9e6c","data":"0xef41d20800000000000000000000000000000000000000000000000000000000000000017691e8f7c821ff647ecb48aab3c593b316d7c705fa9ccc61778ceab57acd1bb200000000000000000000000000000000000000000000000000000002540be40000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000"}]}],"latest"]}
+<< {"jsonrpc":"2.0","id":1,"result":[{"status":"0x0","returnData":"0x0000000000000000000000000000000000000000000000000000000000000012","gasUsed":"0x5338","error":{"code":-32015,"message":"VM execution error.","data":"Reverted 0x5472616e7366657248656c7065723a3a7472616e7366657246726f6d3a207472616e7366657246726f6d206661696c6564"}}]}

tests/eth_multicall/multicall-simple.io

@@ -0,0 +1,2 @@
+>> {"jsonrpc":"2.0","id":1,"method":"eth_multicallV1","params":[[{"calls":[{"to":"0x6b175474e89094c44da98b954eedeac495271d0f","data":"0x313ce567"}]}],"latest"]}
+<< {"jsonrpc":"2.0","id":1,"result":[ { "number": "0x1", "hash": "0x2222222222222222222222222222222222222222222222222222222222222222", "timestamp": "0x929292", "gasLimit": "0x2000", "gasUsed": "0x1000", "feeRecipient": "0x1111111111111111111111111111111111111111", "baseFeePerGas": "0x827129", "calls": [ { "status": "0x1", "returnData": "0x0000000000000000000000000000000000000000000000000000000000000012", "gasUsed": "0x5338", "logs": [] } ] } ]}

wordlist.txt

@@ -57,3 +57,4 @@ randao
 src
 https
 forkchoiceupdatedresponsev
+feeRecipient