eth_getTransactionByHash

Blink intercepts eth_getTransactionByHash and resolves it in two steps:

1. The request is forwarded to an Ethereum node. If the node knows the transaction — mined, or sitting in its mempool — that response is returned unchanged.

2. If — and only if — the node returns null, Blink checks its own records. If the transaction was submitted through Blink within the last 3 hours — or the last 96 seconds if it used revert protection — Blink returns a synthetic pending response built from the raw transaction you submitted.

The node always wins. A transaction body or an error from the node is passed through untouched; only a definitive null reaches Blink's own store.

eth_getGaslessTransactionByHash is an alias for this method and behaves identically.

A transaction still pending more than a minute after submission is almost always either nonce-blocked — an earlier nonce from the same sender has not landed yet — or underpriced for current network conditions.

Neither is terminal. If the base fee falls or the sender tops up their balance, Blink can still get the transaction on chain inside its retention window — though a revert-protected submission has only 96 seconds of that window, so gas pricing matters more there. We recommend strong nonce management and being generous with the gas price.

Reading the response

Response	Meaning
result with a non-null blockNumber	Mined. Comes straight from the node.
result with blockNumber: null	Not mined yet. Either the node's own mempool entry, or a transaction Blink is holding that the node has not seen. It remains includable — see the note above.
result: null	Neither the node nor Blink knows of the transaction within its retention window. See below.

result: null does not mean the transaction failed. It covers several distinct situations this method cannot tell apart:

• never submitted, or submitted somewhere other than Blink

• submitted more than 3 hours ago, or more than 96 seconds ago with revert protection

• submitted to Blink and rejected at ingress (in which case your original eth_sendRawTransaction call returned an error)

• included and then reorged out

• replaced by another transaction with the same sender and nonce

See Determining a final outcome for how to resolve these.

Submission lifecycle

A transaction submitted through Blink is first offered exclusively to Blink's integrated builders, then submitted more widely for a further set of blocks. It stays eligible for inclusion throughout the 3-hour window.

Revert protection is the exception. A revert-protected submission is sent to builders as a bundle targeting a fixed range of upcoming blocks, and is not retried past it — so it is dropped after 96 seconds rather than staying eligible for 3 hours. From then on this method returns null for it.

The synthetic pending response

When Blink answers from its own records rather than the node, the response is built from the raw transaction bytes you submitted. It is a well-formed transaction object:

• blockHash, blockNumber and transactionIndex are null, as for any pending transaction.

• to is null for contract creation, as for any node response.

• v, r and s are returned as 0x0. Blink deliberately withholds signature values for transactions that have not yet been included — see below.

The remaining fields are decoded from the transaction you submitted. Field-level parity with a node's own response is not guaranteed for a synthetic body; treat the node's response as authoritative once it has one.

Why signature values are withheld

A transaction's signature, combined with the other fields, is enough to re-encode the complete signed transaction. If Blink returned real signature values for a transaction still in flight, anyone who learned the hash could reconstruct it and submit it to builders themselves — bypassing the protection you submitted it for, or using it to front-run or sandwich you.

Blink therefore zeroes v, r and s until the transaction is on chain. The fields are still present, so the response keeps the shape a node returns. Once the transaction is mined, the response comes straight from the node and carries the real values.

Every other field is reported faithfully, and the hash is the real transaction hash, so you can still match the response to your submission.

Determining a final outcome

A non-null blockNumber is the only positive terminal signal. Wait for your required confirmation depth before treating it as final.

Otherwise:

1. Compare eth_getTransactionCount(from, "latest") with your transaction's nonce. A count greater than the nonce means the nonce was consumed by a different transaction, so yours will never land.

2. If the nonce is still free and the transaction is still pending, it is waiting on gas price or on an earlier nonce — see the note at the top. Raising the fee or clearing the blocking nonce resolves it faster than waiting does.

3. Past the retention window — 3 hours, or 96 seconds with revert protection — Blink no longer holds the transaction and returns null.

If Blink's own lookup fails, the method returns a JSON-RPC error rather than null. Treat an error as "retry the poll", never as "the transaction is gone".

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getTransactionByHash",
  "params": [
    "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
  ]
}

Example response — pending

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "blockHash": null,
    "blockNumber": null,
    "transactionIndex": null,
    "chainId": "0x1",
    "from": "0x398137383b3d25c92898c656696e41950e47316b",
    "gas": "0x1d45e",
    "gasPrice": "0x4a817c800",
    "maxFeePerGas": "0x4a817c800",
    "maxPriorityFeePerGas": "0x3b9aca00",
    "hash": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "input": "0xf7d8c88300000000000000000000000000000000000000000000000000000000000cee6100000000000000000000000000000000000000000000000000000000000ac3e1",
    "nonce": "0x18",
    "to": "0x1234567890123456789012345678901234567890",
    "type": "0x2",
    "accessList": [],
    "value": "0x1c6bf526340000",
    "v": "0x0",
    "r": "0x0",
    "s": "0x0"
  }
}

Example response — mined

Returned unchanged from the node once the transaction is included.

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "blockHash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35",
    "blockNumber": "0x5bad55",
    "transactionIndex": "0x11",
    "chainId": "0x1",
    "from": "0x398137383b3d25c92898c656696e41950e47316b",
    "gas": "0x1d45e",
    "gasPrice": "0x4a817c800",
    "hash": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "input": "0xf7d8c88300000000000000000000000000000000000000000000000000000000000cee6100000000000000000000000000000000000000000000000000000000000ac3e1",
    "nonce": "0x18",
    "to": "0x1234567890123456789012345678901234567890",
    "type": "0x2",
    "value": "0x1c6bf526340000",
    "v": "0x1",
    "r": "0x8b7c0d9f0e1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f7081920304",
    "s": "0x5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829304a"
  }
}