feat: `eth_getTransactionReceipt` and `eth_getBlockReceipts` RPCs by JonathanOppenheimer · Pull Request #150 · ava-labs/strevm

JonathanOppenheimer · 2026-02-05T20:38:40Z

Closes #91

This PR adds receipt retrieval for eth_getTransactionReceipt and eth_getBlockReceipts. To do so, it adds the following backend methods:

GetReceipts(ctx, hash) - Cache-first receipt lookup (checks vm.blocks, falls back to DB)
BlockByNumberOrHash(ctx, blockNrOrHash) - Unified block lookup
- Taken directly from the devnet
HeaderByNumberOrHash(ctx, blockNrOrHash) - Unified header lookup
- Taken directly from the devnet
readByNumberOrHash[T]() - Generic helper for number-or-hash lookups
- Taken directly from the devnet

necessary to support these RPCs. I also added a (fairly comprehensive test), TestReceiptAPIs which covers:

Cache path (executed, not yet settled) and DB path (settled, evicted from cache)
Cache-vs-DB equivalence via cmp.Diff with cmputils.Receipts()
- I also tried to write a test to ensure the base fee changes would be correct, but was unable to write a test simulating a full execcution cycle where the base fee changed and was not the worst case.
Multi-transaction blocks (correct TransactionIndex ordering)
Pending/unexecuted blocks return nil
Nonexistent hashes return nil
eth_getBlockReceipts by hash and by number produce equivalent results
Genesis block returns empty receipts

While working on this PR, I surfaced some inconsistencies about the fields of receipts, which I fixed in execution.go. See comments below.

JonathanOppenheimer · 2026-02-05T22:14:03Z

saexec/execution.go

+	// The [types.Header] that we pass to [core.ApplyTransaction] is adjusted to
+	// reduce worst‑case gas, which changes the block hash. DeriveFields recomputes
+	// receipt/log metadata (e.g., block hash, effective gas price, etc.) against the final
+	// block header so cached receipts match the DB path.
+	var blobGasPrice *big.Int
+	if header.ExcessBlobGas != nil {
+		blobGasPrice = eip4844.CalcBlobFee(*header.ExcessBlobGas)
+	}
+	if err := receipts.DeriveFields(e.chainConfig, b.Hash(), b.NumberU64(), header.Time, header.BaseFee, blobGasPrice, b.Transactions()); err != nil {
+		return err
+	}
+


This was surfaced after writing tests that compare the receipts of cached blocks vs settled blocks, and we found that the effective gas price was missing from the receipts of blocks in the cache, but not from those of the database. There was an inconsistency here with how receipts are provided from the database and manually resetting the block hash pointed to that.

In geth, receipts are only retrieved from settled blocks, which have all their fields properly derived via DeriveFields(). We match that behavior here.

Thanks to @alarso16 for helping me figure this out.

cmputils/types.go

JonathanOppenheimer · 2026-02-06T00:36:06Z

sae/rpc_test.go


+func TestReceiptAPIs(t *testing.T) {
+	opt, vmTime := withVMTime(t, time.Unix(saeparams.TauSeconds, 0))
+	ctx, sut := newSUT(t, 5, opt)


Creating the sut here is acceptable from my understanding. We create and use 5 accounts to avoid logging logging nonce stuff.

ARR4N · 2026-02-06T11:45:04Z

The arr4n/recovery branch is a WIP that doesn't have a non-draft PR associated (i.e. I reserve the right to force-push to it) so your workflow is going to be regularly broken.

JonathanOppenheimer · 2026-02-06T15:17:55Z

The arr4n/recovery branch is a WIP that doesn't have a non-draft PR associated (i.e. I reserve the right to force-push to it) so your workflow is going to be regularly broken.

Yup all good, I'm going to leave this as a draft until your base PR is merged

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

cmputils/types.go

sae/rpc.go

sae/rpc_test.go

alarso16 · 2026-02-10T19:29:58Z

sae/rpc_test.go

+	blockMultiTxs := sut.createAndAcceptBlock(t, txMulti1, txMulti2, txMulti3)
+	require.NoErrorf(t, blockMultiTxs.WaitUntilExecuted(ctx), "%T.WaitUntilExecuted()", blockMultiTxs)
+
+	// Block 4: Triggers settlement of block 2


I think block 3 settled block 4

We don't call WaitUntilSettled until here.

sae/rpc_test.go

alarso16 · 2026-02-10T19:32:18Z

sae/rpc_test.go

+
+	var receipt *types.Receipt
+	err := sut.CallContext(ctx, &receipt, "eth_getTransactionReceipt", txSettled.Hash())
+	require.ErrorContains(t, err, "reading execution-result base fee")


Why not use require.ErrorIs?

We need Tsvetan's PR to clean this up.

saexec/execution.go

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer · 2026-02-11T16:44:50Z

saexec/execution.go

-		// modified to reduce gas price from the worst-case value agreed by
-		// consensus. This changes the hash, which is what is copied to receipts
-		// and logs.
-		receipt.BlockHash = b.Hash()


The below block does this -- confirmed with Cey that we can remove this.

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

Co-authored-by: Austin Larson <78000745+alarso16@users.noreply.github.com> Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer · 2026-02-11T21:02:32Z

sae/rpc.go

@@ -316,6 +328,23 @@ func readByHash[T any](b *ethAPIBackend, hash common.Hash, read canonicalReader[

 var errFutureBlockNotResolved = errors.New("not accepted yet")


Why is this variable declared here. I'd move it but it would create an irrelevant diff. Seems very strange to declare an error after it is used.

ARR4N and others added 5 commits February 5, 2026 15:53

WIP

8a4a36c

feat: reciepts RPCs

b2e94e6

refactor: use devnet DRY methods

8eafdad

style: sentinel errors at top

a443eb4

chore: lint

75b0f64

JonathanOppenheimer changed the title ~~feat: reciepts RPCs~~ feat: eth_getTransactionReceipt and eth_getBlockReceipts RPCs Feb 5, 2026

JonathanOppenheimer self-assigned this Feb 5, 2026

JonathanOppenheimer added 3 commits February 5, 2026 16:19

fix: cache derived reciepts

fd68bc7

fix: populate reciepts properly

23679e1

fix: properly derive fields

260f88c

JonathanOppenheimer commented Feb 5, 2026

View reviewed changes

test: minor test improvements

81247c9

JonathanOppenheimer commented Feb 6, 2026

View reviewed changes

cmputils/types.go Show resolved Hide resolved

Merge branch 'main' into JonathanOppenheimer/support-reciepts

05560e8

JonathanOppenheimer commented Feb 6, 2026

View reviewed changes

JonathanOppenheimer changed the base branch from main to arr4n/recovery February 6, 2026 00:39

JonathanOppenheimer and others added 3 commits February 5, 2026 19:40

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

01b48fd

chore: change to tip of Arran's recovery branch

66d7dce

fix: readd correct reciept deriviation

13c89e4

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from b28849b to 13c89e4 Compare February 6, 2026 00:52

WIP

6aa252e

ARR4N force-pushed the arr4n/recovery branch from 8a4a36c to 6aa252e Compare February 6, 2026 08:41

JonathanOppenheimer and others added 2 commits February 6, 2026 12:11

fix: GetReceipts

0c3e2dc

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

c5a95a9

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch 2 times, most recently from 26be9e3 to c82e54e Compare February 6, 2026 17:24

chore: reduce diff

ac595dc

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from c82e54e to ac595dc Compare February 6, 2026 17:25

WIP

9cf6641

ARR4N force-pushed the arr4n/recovery branch from c6c280b to 9cf6641 Compare February 10, 2026 15:23

JonathanOppenheimer and others added 2 commits February 10, 2026 11:26

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

2b0cab4

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

WIP

6a6a6a8

ARR4N force-pushed the arr4n/recovery branch from 9cf6641 to 6a6a6a8 Compare February 10, 2026 16:50

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

bc709d1

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

alarso16 reviewed Feb 10, 2026

View reviewed changes

ARR4N force-pushed the arr4n/recovery branch 4 times, most recently from ca81fd1 to 433de16 Compare February 11, 2026 14:51

WIP

36b0e29

ARR4N force-pushed the arr4n/recovery branch from 433de16 to 36b0e29 Compare February 11, 2026 15:59

JonathanOppenheimer commented Feb 11, 2026

View reviewed changes

saexec/execution.go Outdated Show resolved Hide resolved

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch 2 times, most recently from 9129673 to bc709d1 Compare February 11, 2026 16:40

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

6774ac3

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from 512ee0f to 6774ac3 Compare February 11, 2026 16:43

fix: revert revert to base fee change

5820f35

JonathanOppenheimer commented Feb 11, 2026

View reviewed changes

ARR4N force-pushed the arr4n/recovery branch from 36b0e29 to c9a3080 Compare February 11, 2026 19:13

Merge branch 'arr4n/recovery' into JonathanOppenheimer/support-reciepts

9e046d4

Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from 36787bf to 9e046d4 Compare February 11, 2026 19:56

JonathanOppenheimer and others added 2 commits February 11, 2026 15:48

test: clean up reciepts testing

9a799e6

Update sae/rpc_test.go

4487a09

Co-authored-by: Austin Larson <78000745+alarso16@users.noreply.github.com> Signed-off-by: Jonathan Oppenheimer <147infiniti@gmail.com>

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from eef7035 to 1baee20 Compare February 11, 2026 21:00

style: move variables

333e8ae

JonathanOppenheimer force-pushed the JonathanOppenheimer/support-reciepts branch from 1baee20 to 333e8ae Compare February 11, 2026 21:01

JonathanOppenheimer commented Feb 11, 2026

View reviewed changes

refactor: use existing function

398e6ac

		@@ -316,6 +328,23 @@ func readByHash[T any](b *ethAPIBackend, hash common.Hash, read canonicalReader[

		var errFutureBlockNotResolved = errors.New("not accepted yet")

Conversation

JonathanOppenheimer commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JonathanOppenheimer Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

JonathanOppenheimer Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

ARR4N commented Feb 6, 2026

Uh oh!

JonathanOppenheimer commented Feb 6, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

alarso16 Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

JonathanOppenheimer Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

alarso16 Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

JonathanOppenheimer Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

JonathanOppenheimer Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

JonathanOppenheimer Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

JonathanOppenheimer commented Feb 5, 2026 •

edited

Loading

JonathanOppenheimer Feb 5, 2026 •

edited

Loading