# zkevm_getBatchByNumber

> For the complete documentation index, see [llms.txt](/docs/llms.txt).

POST https://polygonzkevm-mainnet.g.alchemy.com/v2/{apiKey}

Returns the details of a batch specified by its number or a special tag (`earliest`, `latest`). If `includeTransactions` is `true`, the full transaction objects are included; otherwise, only transaction hashes are returned.


Reference: https://www.alchemy.com/docs/chains/polygon-zkevm/polygon-zk-evm-api-endpoints/zkevm-get-batch-by-number

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| batchNumberOrTag | string or enum | Yes | The batch number or a tag (`earliest`, `latest`) to identify the batch. |
| includeTransactions | boolean | Yes | If `true`, returns full transaction objects; if `false`, returns only transaction hashes. |

## Result

**Batch** (object): The batch details corresponding to the given number or tag.

## Example

### Request

```json
{
  "jsonrpc": "2.0",
  "method": "zkevm_getBatchByNumber",
  "params": [
    "0x1",
    false
  ],
  "id": 1
}
```

### Response

```json
{
  "jsonrpc": "2.0",
  "result": {
    "number": "0x1",
    "coinbase": "0x0000000000000000000000000000000000000001",
    "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000001",
    "globalExitRoot": "0x0000000000000000000000000000000000000000000000000000000000000002",
    "mainnetExitRoot": "0x0000000000000000000000000000000000000000000000000000000000000003",
    "rollupExitRoot": "0x0000000000000000000000000000000000000000000000000000000000000004",
    "accInputHash": "0x0000000000000000000000000000000000000000000000000000000000000006",
    "timestamp": "0x642af31f",
    "sendSequencesTxHash": "0x0000000000000000000000000000000000000000000000000000000000000007",
    "verifyBatchTxHash": "0x0000000000000000000000000000000000000000000000000000000000000008",
    "transactions": [
      "0x0000000000000000000000000000000000000000000000000000000000000009",
      "0x0000000000000000000000000000000000000000000000000000000000000010",
      "0x0000000000000000000000000000000000000000000000000000000000000011"
    ]
  },
  "id": 1
}
```

## Code Examples

### cURL

```bash
curl --request POST \
  --url https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "zkevm_getBatchByNumber",
  "params": [
    "0x1",
    false
  ]
}'
```

### JavaScript

```javascript
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'zkevm_getBatchByNumber',
    params: ['0x1', false]
  })
};

fetch('https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "zkevm_getBatchByNumber",
    "params": ["0x1", False]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

### Go

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"zkevm_getBatchByNumber\",\n  \"params\": [\n    \"0x1\",\n    false\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

### Java

```java
HttpResponse<String> response = Unirest.post("https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"zkevm_getBatchByNumber\",\n  \"params\": [\n    \"0x1\",\n    false\n  ]\n}")
  .asString();
```

### C#

```csharp
using RestSharp;


var options = new RestClientOptions("https://polygonzkevm-mainnet.g.alchemy.com/v2/docs-demo");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"zkevm_getBatchByNumber\",\n  \"params\": [\n    \"0x1\",\n    false\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

```


## OpenRPC Method Specification

```yaml
name: zkevm_getBatchByNumber
summary: Retrieves a batch by its number or tag.
description: |
  Returns the details of a batch specified by its number or a special tag (`earliest`, `latest`). If `includeTransactions` is `true`, the full transaction objects are included; otherwise, only transaction hashes are returned.
params:
  - name: batchNumberOrTag
    required: true
    description: The batch number or a tag (`earliest`, `latest`) to identify the batch.
    schema:
      oneOf:
        - title: hex encoded unsigned integer
          type: string
          pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
        - title: BatchNumberTag
          type: string
          description: The optional batch height description
          enum:
            - earliest
            - latest
  - name: includeTransactions
    required: true
    description: If `true`, returns full transaction objects; if `false`, returns only transaction hashes.
    schema:
      type: boolean
result:
  name: Batch
  description: The batch details corresponding to the given number or tag.
  schema:
    title: Batch
    type: object
    readOnly: true
    properties:
      number:
        title: hex encoded unsigned integer
        type: string
        pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
      globalExitRoot:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      mainnetExitRoot:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      rollupExitRoot:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      accInputHash:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      timestamp:
        title: hex encoded unsigned integer
        type: string
        pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
      sendSequencesTxHash:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      verifyBatchTxHash:
        title: 32 byte hex value
        type: string
        pattern: ^0x[0-9a-f]{64}$
      closed:
        title: closed
        type: boolean
        description: True if the batch is already closed, otherwise false
      blocks:
        title: blocksOrHashes
        description: Array of block objects, or 32 Bytes block hashes depending on the last given parameter
        type: array
        items:
          title: blockOrBlockHash
          oneOf:
            - title: Block object
              type: object
              required:
                - hash
                - parentHash
                - sha3Uncles
                - miner
                - stateRoot
                - transactionsRoot
                - receiptsRoot
                - logsBloom
                - number
                - gasLimit
                - gasUsed
                - timestamp
                - extraData
                - mixHash
                - nonce
                - size
                - transactions
                - uncles
              additionalProperties: false
              properties:
                hash:
                  title: Hash
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                parentHash:
                  title: Parent block hash
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                sha3Uncles:
                  title: Ommers hash
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                miner:
                  title: Coinbase
                  type: string
                  pattern: ^0x[0-9a-fA-F]{40}$
                stateRoot:
                  title: State root
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                transactionsRoot:
                  title: Transactions root
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                receiptsRoot:
                  title: Receipts root
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                logsBloom:
                  title: Bloom filter
                  type: string
                  pattern: ^0x[0-9a-f]{512}$
                difficulty:
                  title: Difficulty
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                number:
                  title: Number
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                gasLimit:
                  title: Gas limit
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                gasUsed:
                  title: Gas used
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                timestamp:
                  title: Timestamp
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                extraData:
                  title: Extra data
                  type: string
                  pattern: ^0x[0-9a-f]*$
                mixHash:
                  title: Mix hash
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                nonce:
                  title: Nonce
                  type: string
                  pattern: ^0x[0-9a-f]{16}$
                baseFeePerGas:
                  title: Base fee per gas
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                withdrawalsRoot:
                  title: Withdrawals root
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                blobGasUsed:
                  title: Blob gas used
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                excessBlobGas:
                  title: Excess blob gas
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                parentBeaconBlockRoot:
                  title: Parent Beacon Block Root
                  type: string
                  pattern: ^0x[0-9a-f]{64}$
                size:
                  title: Block size
                  type: string
                  pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                transactions:
                  anyOf:
                    - title: Transaction hashes
                      type: array
                      items:
                        title: 32 byte hex value
                        type: string
                        pattern: ^0x[0-9a-f]{64}$
                    - title: Full transactions
                      type: array
                      items:
                        type: object
                        title: Transaction information
                        required:
                          - blockHash
                          - blockNumber
                          - from
                          - hash
                          - transactionIndex
                        unevaluatedProperties: false
                        oneOf:
                          - title: Signed 4844 Transaction
                            type: object
                            required:
                              - accessList
                              - blobVersionedHashes
                              - chainId
                              - gas
                              - input
                              - maxFeePerBlobGas
                              - maxFeePerGas
                              - maxPriorityFeePerGas
                              - nonce
                              - r
                              - s
                              - to
                              - type
                              - value
                              - yParity
                            properties:
                              type:
                                title: type
                                type: string
                                pattern: ^0x([0-9a-fA-F]?){1,2}$
                              nonce:
                                title: nonce
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              to:
                                title: to address
                                type: string
                                pattern: ^0x[0-9a-fA-F]{40}$
                              gas:
                                title: gas limit
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              value:
                                title: value
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              input:
                                title: input data
                                type: string
                                pattern: ^0x[0-9a-f]*$
                              maxPriorityFeePerGas:
                                title: max priority fee per gas
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Maximum fee per gas the sender is willing to pay to miners in wei
                              maxFeePerGas:
                                title: max fee per gas
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
                              maxFeePerBlobGas:
                                title: max fee per blob gas
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The maximum total fee per gas the sender is willing to pay for blob gas in wei
                              accessList:
                                title: accessList
                                description: EIP-2930 access list
                                type: array
                                items:
                                  title: Access list entry
                                  type: object
                                  additionalProperties: false
                                  properties:
                                    address:
                                      title: hex encoded address
                                      type: string
                                      pattern: ^0x[0-9a-fA-F]{40}$
                                    storageKeys:
                                      type: array
                                      items:
                                        title: 32 byte hex value
                                        type: string
                                        pattern: ^0x[0-9a-f]{64}$
                              blobVersionedHashes:
                                title: blobVersionedHashes
                                description: List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.
                                type: array
                                items:
                                  title: 32 byte hex value
                                  type: string
                                  pattern: ^0x[0-9a-f]{64}$
                              chainId:
                                title: chainId
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Chain ID that this transaction is valid on.
                              yParity:
                                title: yParity
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
                              r:
                                title: r
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              s:
                                title: s
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                          - title: Signed 1559 Transaction
                            type: object
                            required:
                              - accessList
                              - chainId
                              - gas
                              - gasPrice
                              - input
                              - maxFeePerGas
                              - maxPriorityFeePerGas
                              - nonce
                              - r
                              - s
                              - type
                              - value
                              - yParity
                            properties:
                              type:
                                title: type
                                type: string
                                pattern: ^0x2$
                              nonce:
                                title: nonce
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              to:
                                title: to address
                                oneOf:
                                  - title: Contract Creation (null)
                                    type: 'null'
                                  - title: Address
                                    type: string
                                    pattern: ^0x[0-9a-fA-F]{40}$
                              gas:
                                title: gas limit
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              value:
                                title: value
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              input:
                                title: input data
                                type: string
                                pattern: ^0x[0-9a-f]*$
                              maxPriorityFeePerGas:
                                title: max priority fee per gas
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Maximum fee per gas the sender is willing to pay to miners in wei
                              maxFeePerGas:
                                title: max fee per gas
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
                              gasPrice:
                                title: gas price
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.
                              accessList:
                                title: accessList
                                description: EIP-2930 access list
                                type: array
                                items:
                                  title: Access list entry
                                  type: object
                                  additionalProperties: false
                                  properties:
                                    address:
                                      title: hex encoded address
                                      type: string
                                      pattern: ^0x[0-9a-fA-F]{40}$
                                    storageKeys:
                                      type: array
                                      items:
                                        title: 32 byte hex value
                                        type: string
                                        pattern: ^0x[0-9a-f]{64}$
                              chainId:
                                title: chainId
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Chain ID that this transaction is valid on.
                              yParity:
                                title: yParity
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
                              v:
                                title: v
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
                              r:
                                title: r
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              s:
                                title: s
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                          - title: Signed 2930 Transaction
                            type: object
                            required:
                              - accessList
                              - chainId
                              - gas
                              - gasPrice
                              - input
                              - nonce
                              - r
                              - s
                              - type
                              - value
                              - yParity
                            properties:
                              type:
                                title: type
                                type: string
                                pattern: ^0x1$
                              nonce:
                                title: nonce
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              to:
                                title: to address
                                oneOf:
                                  - title: Contract Creation (null)
                                    type: 'null'
                                  - title: Address
                                    type: string
                                    pattern: ^0x[0-9a-fA-F]{40}$
                              gas:
                                title: gas limit
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              value:
                                title: value
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              input:
                                title: input data
                                type: string
                                pattern: ^0x[0-9a-f]*$
                              gasPrice:
                                title: gas price
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The gas price willing to be paid by the sender in wei
                              accessList:
                                title: accessList
                                description: EIP-2930 access list
                                type: array
                                items:
                                  title: Access list entry
                                  type: object
                                  additionalProperties: false
                                  properties:
                                    address:
                                      title: hex encoded address
                                      type: string
                                      pattern: ^0x[0-9a-fA-F]{40}$
                                    storageKeys:
                                      type: array
                                      items:
                                        title: 32 byte hex value
                                        type: string
                                        pattern: ^0x[0-9a-f]{64}$
                              chainId:
                                title: chainId
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Chain ID that this transaction is valid on.
                              yParity:
                                title: yParity
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
                              v:
                                title: v
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
                              r:
                                title: r
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              s:
                                title: s
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                          - title: Signed Legacy Transaction
                            type: object
                            required:
                              - gas
                              - gasPrice
                              - input
                              - nonce
                              - r
                              - s
                              - type
                              - v
                              - value
                            properties:
                              type:
                                title: type
                                type: string
                                pattern: ^0x0$
                              nonce:
                                title: nonce
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              to:
                                title: to address
                                oneOf:
                                  - title: Contract Creation (null)
                                    type: 'null'
                                  - title: Address
                                    type: string
                                    pattern: ^0x[0-9a-fA-F]{40}$
                              gas:
                                title: gas limit
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              value:
                                title: value
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              input:
                                title: input data
                                type: string
                                pattern: ^0x[0-9a-f]*$
                              gasPrice:
                                title: gas price
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: The gas price willing to be paid by the sender in wei
                              chainId:
                                title: chainId
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                                description: Chain ID that this transaction is valid on.
                              v:
                                title: v
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              r:
                                title: r
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                              s:
                                title: s
                                type: string
                                pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                        properties:
                          blockHash:
                            title: block hash
                            type: string
                            pattern: ^0x[0-9a-f]{64}$
                          blockNumber:
                            title: block number
                            type: string
                            pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                          from:
                            title: from address
                            type: string
                            pattern: ^0x[0-9a-fA-F]{40}$
                          hash:
                            title: transaction hash
                            type: string
                            pattern: ^0x[0-9a-f]{64}$
                          transactionIndex:
                            title: transaction index
                            type: string
                            pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                withdrawals:
                  title: Withdrawals
                  type: array
                  items:
                    type: object
                    title: Validator withdrawal
                    required:
                      - index
                      - validatorIndex
                      - address
                      - amount
                    additionalProperties: false
                    properties:
                      index:
                        title: index of withdrawal
                        type: string
                        pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$
                      validatorIndex:
                        title: index of validator that generated withdrawal
                        type: string
                        pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$
                      address:
                        title: recipient address for withdrawal value
                        type: string
                        pattern: ^0x[0-9a-fA-F]{40}$
                      amount:
                        title: value contained in withdrawal
                        type: string
                        pattern: ^0x([1-9a-f]+[0-9a-f]{0,31})|0$
                uncles:
                  title: Uncles
                  type: array
                  items:
                    title: 32 byte hex value
                    type: string
                    pattern: ^0x[0-9a-f]{64}$
            - title: 32 byte hex value
              type: string
              pattern: ^0x[0-9a-f]{64}$
      transactions:
        title: transactionsOrHashes
        description: Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter
        type: array
        items:
          title: transactionOrTransactionHash
          oneOf:
            - type: object
              title: Transaction information
              required:
                - blockHash
                - blockNumber
                - from
                - hash
                - transactionIndex
              unevaluatedProperties: false
              oneOf:
                - title: Signed 4844 Transaction
                  type: object
                  required:
                    - accessList
                    - blobVersionedHashes
                    - chainId
                    - gas
                    - input
                    - maxFeePerBlobGas
                    - maxFeePerGas
                    - maxPriorityFeePerGas
                    - nonce
                    - r
                    - s
                    - to
                    - type
                    - value
                    - yParity
                  properties:
                    type:
                      title: type
                      type: string
                      pattern: ^0x([0-9a-fA-F]?){1,2}$
                    nonce:
                      title: nonce
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    to:
                      title: to address
                      type: string
                      pattern: ^0x[0-9a-fA-F]{40}$
                    gas:
                      title: gas limit
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    value:
                      title: value
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    input:
                      title: input data
                      type: string
                      pattern: ^0x[0-9a-f]*$
                    maxPriorityFeePerGas:
                      title: max priority fee per gas
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: Maximum fee per gas the sender is willing to pay to miners in wei
                    maxFeePerGas:
                      title: max fee per gas
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
                    maxFeePerBlobGas:
                      title: max fee per blob gas
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The maximum total fee per gas the sender is willing to pay for blob gas in wei
                    accessList:
                      title: accessList
                      description: EIP-2930 access list
                      type: array
                      items:
                        title: Access list entry
                        type: object
                        additionalProperties: false
                        properties:
                          address:
                            title: hex encoded address
                            type: string
                            pattern: ^0x[0-9a-fA-F]{40}$
                          storageKeys:
                            type: array
                            items:
                              title: 32 byte hex value
                              type: string
                              pattern: ^0x[0-9a-f]{64}$
                    blobVersionedHashes:
                      title: blobVersionedHashes
                      description: List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.
                      type: array
                      items:
                        title: 32 byte hex value
                        type: string
                        pattern: ^0x[0-9a-f]{64}$
                    chainId:
                      title: chainId
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: Chain ID that this transaction is valid on.
                    yParity:
                      title: yParity
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
                    r:
                      title: r
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    s:
                      title: s
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                - title: Signed 1559 Transaction
                  type: object
                  required:
                    - accessList
                    - chainId
                    - gas
                    - gasPrice
                    - input
                    - maxFeePerGas
                    - maxPriorityFeePerGas
                    - nonce
                    - r
                    - s
                    - type
                    - value
                    - yParity
                  properties:
                    type:
                      title: type
                      type: string
                      pattern: ^0x2$
                    nonce:
                      title: nonce
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    to:
                      title: to address
                      oneOf:
                        - title: Contract Creation (null)
                          type: 'null'
                        - title: Address
                          type: string
                          pattern: ^0x[0-9a-fA-F]{40}$
                    gas:
                      title: gas limit
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    value:
                      title: value
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    input:
                      title: input data
                      type: string
                      pattern: ^0x[0-9a-f]*$
                    maxPriorityFeePerGas:
                      title: max priority fee per gas
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: Maximum fee per gas the sender is willing to pay to miners in wei
                    maxFeePerGas:
                      title: max fee per gas
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
                    gasPrice:
                      title: gas price
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.
                    accessList:
                      title: accessList
                      description: EIP-2930 access list
                      type: array
                      items:
                        title: Access list entry
                        type: object
                        additionalProperties: false
                        properties:
                          address:
                            title: hex encoded address
                            type: string
                            pattern: ^0x[0-9a-fA-F]{40}$
                          storageKeys:
                            type: array
                            items:
                              title: 32 byte hex value
                              type: string
                              pattern: ^0x[0-9a-f]{64}$
                    chainId:
                      title: chainId
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: Chain ID that this transaction is valid on.
                    yParity:
                      title: yParity
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
                    v:
                      title: v
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
                    r:
                      title: r
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    s:
                      title: s
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                - title: Signed 2930 Transaction
                  type: object
                  required:
                    - accessList
                    - chainId
                    - gas
                    - gasPrice
                    - input
                    - nonce
                    - r
                    - s
                    - type
                    - value
                    - yParity
                  properties:
                    type:
                      title: type
                      type: string
                      pattern: ^0x1$
                    nonce:
                      title: nonce
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    to:
                      title: to address
                      oneOf:
                        - title: Contract Creation (null)
                          type: 'null'
                        - title: Address
                          type: string
                          pattern: ^0x[0-9a-fA-F]{40}$
                    gas:
                      title: gas limit
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    value:
                      title: value
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                    input:
                      title: input data
                      type: string
                      pattern: ^0x[0-9a-f]*$
                    gasPrice:
                      title: gas price
                      type: string
                      pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
                      description: The gas price willing to be paid by the sender in wei
                    accessList:
                      title: accessList
                      description: EIP-2930 access list
# ... truncated (8408 chars) to keep this page under agent context limits.
```
