Skip to main content

eth_sendTransaction

Signs and submits a transaction.

Parameters (by position)

Transaction object required

Transaction object generic to all types


Show Transaction object

Transaction fields

  • type string

    type

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$


  • nonce string

    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}$


  • 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]*)$


  • value string

    value

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


  • input string

    input data

    Match pattern: ^0x[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]*)$


  • 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]*)$


  • 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]*)$


  • 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]*)$


  • 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


  • 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]*)$


  • authorizationList array<object>

    EIP-7702 authorization list


    Show authorizationList object

    authorizationList fields

    EIP-7702 authorization list

    • 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]*)$


    • address string required

      hex encoded address

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


    • yParity string required

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

      Match pattern: ^0x([0-9a-fA-F]?){1,2}$


    • 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})$


    • additionalProperties true


  • additionalProperties false


Result

Transaction hash string

32 byte hex value

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


Errors

Error code: -32000

  • code

    -32000

  • message

    Invalid input

Error code: -32001

  • code

    -32001

  • message

    Resource not found

Error code: -32002

  • code

    -32002

  • message

    Resource unavailable

Error code: -32003

  • code

    -32003

  • message

    Transaction rejected

Error code: -32004

  • code

    -32004

  • message

    Method not supported

Error code: -32005

  • code

    -32005

  • message

    Limit exceeded

Error code: -32006

  • code

    -32006

  • message

    JSON-RPC version not supported

Error code: -32700

  • code

    -32700

  • message

    Parse error

Error code: -32600

  • code

    -32600

  • message

    Invalid request

Error code: -32601

  • code

    -32601

  • message

    Method not found

Error code: -32602

  • code

    -32602

  • message

    Invalid params

Error code: -32603

  • code

    -32603

  • message

    Internal error

Error code: 800

  • code

    800

  • message

    Intrinsic gas too low / Intrinsic gas exceeds gas limit

  • x-error-category

    GAS_ERRORS

Error code: 801

  • code

    801

  • message

    Insufficient gas for floor data gas cost

  • x-error-category

    GAS_ERRORS

Error code: 802

  • code

    802

  • message

    Tx gas limit exceeds max block gas limit / intrinsic gas exceeds gas limit

  • x-error-category

    GAS_ERRORS

Error code: 803

  • code

    803

  • message

    Transaction gas limit too high

Error code: 804

  • code

    804

  • message

    Gas price below configured minimum gas price / transaction gas price below minimum

  • x-error-category

    GAS_ERRORS

Error code: 805

  • code

    805

  • message

    Insufficient funds for gas * price + value / Upfront cost exceeds account balance

  • x-error-category

    GAS_ERRORS

Error code: 806

  • code

    806

  • message

    Max priority fee per gas higher than max fee per gas

  • x-error-category

    GAS_ERRORS

Error code: 807

  • code

    807

  • message

    Tx fee exceeds the configured cap / Transaction fee cap exceeded

  • x-error-category

    GAS_ERRORS

Error code: 1

  • code

    1

  • message

    Nonce too low

  • x-error-category

    EXECUTION_ERRORS

Error code: 2

  • code

    2

  • message

    Nonce too high

  • x-error-category

    EXECUTION_ERRORS

Error code: 3

  • code

    3

  • message

    Execution reverted by REVERT Opcode

  • x-error-category

    EXECUTION_ERRORS

Error code: 4

  • code

    4

  • message

    Invalid opcode

  • x-error-category

    EXECUTION_ERRORS

Error code: 1000

  • code

    1000

  • message

    Transaction is already known to the transaction pool

  • x-error-category

    TXPOOL_ERRORS

Error code: 1001

  • code

    1001

  • message

    Replacement transaction is sent without the required price bump

  • x-error-category

    TXPOOL_ERRORS

Error code: 1002

  • code

    1002

  • message

    Oversized data: Transaction input data exceeds the allowed limit

  • x-error-category

    TXPOOL_ERRORS

Error code: 1003

  • code

    1003

  • message

    Only replay-protected (EIP-155) transactions allowed over RPC

  • x-error-category

    TXPOOL_ERRORS

Error code: 1004

  • code

    1004

  • message

    Transaction pool is full

  • x-error-category

    TXPOOL_ERRORS

Error code: 1005

  • code

    1005

  • message

    Transaction Data contains invalid RLP encoding

  • x-error-category

    TXPOOL_ERRORS

Error code: 1006

  • code

    1006

  • message

    Transaction sender is invalid

  • x-error-category

    TXPOOL_ERRORS

Error code: 1007

  • code

    1007

  • message

    Transaction with negative value

  • x-error-category

    TXPOOL_ERRORS

Error code: 1008

  • code

    1008

  • message

    Transaction sender is denylisted

  • x-error-category

    TXPOOL_ERRORS

Error code: 1009

  • code

    1009

  • message

    Transaction receiver is denylisted

  • x-error-category

    TXPOOL_ERRORS

Error code: 1010

  • code

    1010

  • message

    Transaction chain ID does not match the expected chain ID

  • x-error-category

    TXPOOL_ERRORS

Error code: 2000

  • code

    2000

  • message

    Not enough step counters to continue the execution

  • x-error-category

    ZK_EXECUTION_ERRORS

Examples

eth_sendTransaction example

Request

{
"params": [
{
"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
"to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
"gas": "0x76c0",
"gasPrice": "0x9184e72a000",
"value": "0x9184e72a",
"input": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
}
]
}

Response

"0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"