eth_sendTransaction

Create and send a new transaction or message call

Defined in the Ethereum JSON-RPC Specification

Creates new message call transaction or a contract creation, if the data field contains code. This method submits the transaction to the network and returns the transaction hash once it’s been accepted by the network.

Parameters

transaction · object · required

The transaction object to send.

Show Transaction object properties

to · string

The recipient address (20 bytes). For contract creation transactions, this field should be omitted.

from · string · required

The sender address (20 bytes).

gas · string

Integer of the gas provided for the transaction execution (hex format).

gasPrice · string

Integer of the gasPrice used for each paid gas (hex format).

value · string

Integer of the value sent with this transaction (hex format).

data · string

The compiled code of a contract OR the hash of the invoked method signature and encoded parameters.

nonce · string

Integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce.

Returns

result · string

The transaction hash (32 bytes) as a hexadecimal string.

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [{
    "from": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    "to": "0xd46e8dd67c5d32be8d24c6b0afe7c5c3f4e9c3b2",
    "gas": "0x76c0",
    "gasPrice": "0x9184e72a000",
    "value": "0x9184e72a",
    "data": "0xd46e8dd67c5d32be8d24c6b0afe7c5c3f4e9c3b2"
  }]
}

Success Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"
}

Error Handling

Code	Message	Description
4001	User rejected the request	User denied the transaction request
4100	Requested method not supported	The method is not supported by the wallet
4200	Wallet not connected	No wallet connection available
-32602	Invalid params	Invalid transaction parameters
-32000	Insufficient funds	Account doesn’t have enough balance

Make sure to validate transaction parameters before sending, especially the to address and value to prevent loss of funds.