eth_fillTransaction

Fills in missing transaction fields to be signed and submitted.

Parameters (by position)

Transaction object required

Transaction object generic to all types

---

Show Transaction object

Transaction fields

• accessList array<object>

  EIP-2930 access list

  ---

  Show accessList object

  accessList fields

  EIP-2930 access list

  • address string required

    hex encoded address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • storageKeys array<string> required

    32 byte hex value

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • additionalProperties false

    ---

• authorizationList array<object>

  EIP-7702 authorization list

  ---

  Show authorizationList object

  authorizationList fields

  EIP-7702 authorization list

  • address string required

    hex encoded address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • chainId string required

    Chain ID on which this transaction is valid

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

    ---

  • yParity string required

    The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature

    Match pattern: ^0x[0-9a-f]{1,2}$

    ---

  • additionalProperties true

    ---

• blobVersionedHashes array<string>

  List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• blobs array<string>

  Raw blob data.

  Match pattern: ^0x[0-9a-f]*$

  ---

• chainId string

  Chain ID that this transaction is valid on.

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• commitments array<string>

  List of blob commitments as per EIP-4844.

  Match pattern: ^0x[0-9a-f]*$

  ---

• from string

  from address

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• gas string

  gas limit

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• gasPrice string

  The gas price willing to be paid by the sender in wei

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• input string

  input data

  Match pattern: ^0x[0-9a-f]*$

  ---

• maxFeePerBlobGas string

  The maximum total fee per gas the sender is willing to pay for blob gas in wei

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• maxFeePerGas string

  The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• maxPriorityFeePerGas string

  Maximum fee per gas the sender is willing to pay to miners in wei

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• nonce string

  nonce

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• proofs array<string>

  List of blob proofs. Pre-PeerDAS this contains one KZG proof per blob (length == len(blobs)). Post-PeerDAS this contains cell proofs with length == 128 * len(blobs).

  Match pattern: ^0x[0-9a-f]*$

  ---

• to null or string

  ---

  Show Option 1 Contract Creation (null) null

  Contract Creation (null) fields

  to null

  Contract Creation (null)

  ---

  Show Option 2 Address string

  Address fields

  to string

  Address

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• type string

  type

  Match pattern: ^0x[0-9a-f]{1,2}$

  ---

• value string

  value

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• additionalProperties false

  ---

Result

Transaction result object

Filled unsigned transaction object.

---

Show Transaction result object

Transaction result fields

• tx object or object or object or object or object or object required

  ---

  Show Option 1 EIP-7702 transaction object

  EIP-7702 transaction fields

  tx object required

  EIP-7702 transaction

  ---

  Show tx object

  tx fields

  • accessList array<object> required

    EIP-2930 access lists

    ---

    Show accessList object

    accessList fields

    EIP-2930 access lists

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • authorizationList array<object> required

    List of authorizations for the transaction

    ---

    Show authorizationList object

    authorizationList fields

    List of authorizations for the transaction

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • chainId string required

      Chain ID on which this transaction is valid

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

      ---

    • nonce string required

      nonce

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

      ---

    • r string required

      r

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

      ---

    • s string required

      s

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

      ---

    • yParity string required

      The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature

      Match pattern: ^0x[0-9a-f]{1,2}$

      ---

    • additionalProperties true

      ---

  • chainId string required

    Chain ID that this transaction is valid on

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to string required

    to address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x4$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 2 Unsigned 4844 transaction with sidecar object

  Unsigned 4844 transaction with sidecar fields

  tx object required

  Unsigned 4844 transaction with sidecar

  ---

  Show tx object

  tx fields

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • blobVersionedHashes array<string> required

    List of versioned blob hashes associated with the transaction's EIP-4844 data blobs

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • blobs array<string> required

    Raw blob data.

    Match pattern: ^0x[0-9a-f]*$

    ---

  • chainId string required

    Chain ID that this transaction is valid on

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • commitments array<string> required

    hex encoded bytes

    Match pattern: ^0x[0-9a-f]*$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxFeePerBlobGas string required

    The maximum total fee per gas the sender is willing to pay for blob gas in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • proofs array<string> required

    Pre-PeerDAS this contains one KZG proof per blob (length == len(blobs)). Post-PeerDAS this contains cell proofs with length == 128 * len(blobs).

    Match pattern: ^0x[0-9a-f]*$

    ---

  • to string required

    to address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x3$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 3 EIP-4844 transaction. object

  EIP-4844 transaction. fields

  tx object required

  EIP-4844 transaction.

  ---

  Show tx object

  tx fields

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • blobVersionedHashes array<string> required

    List of versioned blob hashes associated with the transaction's EIP-4844 data blobs

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • chainId string required

    Chain ID that this transaction is valid on

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxFeePerBlobGas string required

    The maximum total fee per gas the sender is willing to pay for blob gas in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to string required

    to address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x3$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 4 EIP-1559 transaction. object

  EIP-1559 transaction. fields

  tx object required

  EIP-1559 transaction.

  ---

  Show tx object

  tx fields

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • chainId string required

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string required

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x2$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 5 EIP-2930 transaction. object

  EIP-2930 transaction. fields

  tx object required

  EIP-2930 transaction.

  ---

  Show tx object

  tx fields

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • chainId string required

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string required

    The gas price willing to be paid by the sender in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x1$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 6 Legacy transaction. object

  Legacy transaction. fields

  tx object required

  Legacy transaction.

  ---

  Show tx object

  tx fields

  • chainId string

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string required

    The gas price willing to be paid by the sender in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • type string required

    type

    Match pattern: ^0x0$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

• additionalProperties true

  ---

Request

Server URL:

{ "jsonrpc": "2.0", "method": "eth_fillTransaction", "params": [ { "accessList": [ { "address": "string", "storageKeys": [ "string" ] } ], "authorizationList": [ { "address": "string", "chainId": "string", "nonce": "string", "r": "string", "s": "string", "yParity": "string" } ], "blobVersionedHashes": [ "string" ], "blobs": [ "string" ], "chainId": "string", "commitments": [ "string" ], "from": "string", "gas": "string", "gasPrice": "string", "input": "string", "maxFeePerBlobGas": "string", "maxFeePerGas": "string", "maxPriorityFeePerGas": "string", "nonce": "string", "proofs": [ "string" ], "to": "example", "type": "string", "value": "string" } ], "id": 1 }