I’m submitting a transaction, but it’s not being mined

After creating and sending a transaction, you receive a transaction hash, however calling eth_getTransactionReceipt always returns a blank value, indicating the transaction has not been mined:

String transactionHash = sendTransaction(...);

// you loop through the following expecting to eventually get a receipt once the transaction
// is mined
EthGetTransactionReceipt.TransactionReceipt transactionReceipt =

if (!transactionReceipt.isPresent()) {
    // try again, ad infinitum

However, you never receive a transaction receipt. Unfortunately there may not be a an error in your Ethereum client indicating any issues with the transaction:

I1025 18:13:32.817691 eth/api.go:1185] Tx(0xeaac9aab7f9aeab189acd8714c5a60c7424f86820884b815c4448cfcd4d9fc79) to: 0x9c98e381edc5fe1ac514935f3cc3edaa764cf004

The easiest way to see if the submission is waiting to mined is to refer to Etherscan and search for the address the transaction was sent using If the submission has been successful it should be visible in Etherscan within seconds of you performing the transaction submission. The wait is for the mining to take place.


If there is no sign of it then the transaction has vanished into the ether (sorry). The likely cause of this is likely to be to do with the transaction’s nonce either not being set, or being too low. Please refer to the section The transaction nonce for more information.

I want to see details of the JSON-RPC requests and responses

Set the following system properties in your main class or project configuration:

// For HTTP connections
System.setProperty("org.apache.commons.logging.simplelog.showdatetime", "true");
System.setProperty("", "DEBUG");

// For IPC connections
System.setProperty("", "DEBUG");

I want to obtain some Ether on Testnet, but don’t want to have to mine it myself

Head to the Ethereum Ropsten Faucet to request one free Ether.

How do I obtain the return value from a smart contract method invoked by a transaction?

You can’t. It is not possible to return values from methods on smart contracts that are called as part of a transaction. If you wish to read a value during a transaction, you must use Events. To query values from smart contracts you must use a call, which is separate to a transaction. These methods should be marked as constant functions. Solidity smart contract wrappers created by web3j handle these differences for you.

The following StackExchange post is useful for background.

Is it possible to send arbitrary text with transactions?

Yes it is. Text should be ASCII encoded and provided as a hexadecimal String in the data field of the transaction. This is demonstrated below:

        <nonce>, GAS_PRICE, GAS_LIMIT, "0x<address>", <amount>, "0x<hex encoded text>");

byte[] signedMessage = TransactionEncoder.signMessage(rawTransaction, ALICE);
String hexValue = Numeric.toHexString(signedMessage);

EthSendTransaction ethSendTransaction =
String transactionHash = ethSendTransaction.getTransactionHash();

Note: Please ensure you increase the gas limit on the transaction to allow for the storage of text.

The following StackExchange post is useful for background.

Do you have a project donation address?

Absolutely, you can contribute Bitcoin or Ether to help fund the development of web3j.

Ethereum 0x2dfBf35bb7c3c0A466A6C48BEBf3eF7576d3C420
Bitcoin 1DfUeRWUy4VjekPmmZUNqCjcJBMwsyp61G

Where can I get commercial support for web3j?

Commercial support and training is available from