Add ArbFilteredTransactionsManager precompile #4174

MishkaRogachev · 2025-12-24T14:21:45Z

Fixes NIT-4152
pulls in OffchainLabs/nitro-precompile-interfaces#25
pulls in OffchainLabs/go-ethereum#604
pulls in OffchainLabs/nitro-testnode#169

Changes:

Add new precompile ArbFilteredTransactionsManager to manage filtered transactions
Add transaction censors to ArbOs and ArbOwner to limit access to ArbFilteredTransactionsManager
Add an account, separated from ArbOs state, to store filtered transactions

codecov · 2025-12-24T15:10:03Z

Codecov Report

❌ Patch coverage is 23.40426% with 72 lines in your changes missing coverage. Please review.
✅ Project coverage is 34.90%. Comparing base (9e434ee) to head (ea8efef).
⚠️ Report is 7 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #4174      +/-   ##
==========================================
+ Coverage   33.05%   34.90%   +1.85%     
==========================================
  Files         459      463       +4     
  Lines       55830    55992     +162     
==========================================
+ Hits        18453    19543    +1090     
+ Misses      34159    32984    -1175     
- Partials     3218     3465     +247

github-actions · 2025-12-24T15:50:16Z

❌ 7 Tests Failed:

Tests completed	Failed	Passed	Skipped
4454	7	4447	0

View the top 3 failed tests by shortest run time

TestSetLatestSnapshotUrl

Stack Traces | 0.140s run time

... [CONTENT TRUNCATED: Keeping last 20 lines]
    init_test.go:300: running test case latest file with http url
INFO [12-31|10:22:42.169] Set latest snapshot url                  url=http://some.domain.com/arb1/2024/21/archive.tar.gz
    init_test.go:300: running test case latest file with https url
INFO [12-31|10:22:42.172] Set latest snapshot url                  url=https://some.domain.com/arb1/2024/21/archive.tar.gz
    init_test.go:300: running test case chain and contents with upper case
INFO [12-31|10:22:42.173] Set latest snapshot url                  url=http://127.0.0.1:39263/arb1/2024/21/archive.tar.gz
    init_test.go:353: goroutine 87 [running]:
        runtime/debug.Stack()
        	/opt/hostedtoolcache/go/1.25.5/x64/src/runtime/debug/stack.go:26 +0x5e
        github.com/offchainlabs/nitro/util/testhelpers.RequireImpl({0x2e5fdf0, 0xc0004a7500}, {0x2e32ac0, 0x41b6460}, {0xc000906000, 0x1, 0x1})
        	/home/runner/work/nitro/nitro/util/testhelpers/testhelpers.go:29 +0x55
        github.com/offchainlabs/nitro/cmd/nitro.Require(0xc0004a7500, {0x2e32ac0, 0x41b6460}, {0xc000906000, 0x1, 0x1})
        	/home/runner/work/nitro/nitro/cmd/nitro/config_test.go:304 +0x5d
        github.com/offchainlabs/nitro/cmd/nitro.startFileServer.func2()
        	/home/runner/work/nitro/nitro/cmd/nitro/init_test.go:353 +0xa5
        created by github.com/offchainlabs/nitro/cmd/nitro.startFileServer in goroutine 13
        	/home/runner/work/nitro/nitro/cmd/nitro/init_test.go:350 +0x285
        
    init_test.go:353: �[31;1m [failed to shutdown server] context canceled �[0;0m
--- FAIL: TestSetLatestSnapshotUrl (0.14s)

TestDataStreaming_PositiveScenario/Many_senders,_long_messages

Stack Traces | 0.210s run time

=== RUN   TestDataStreaming_PositiveScenario/Many_senders,_long_messages
WARN [12-31|10:21:28.380] Served datastreaming_start               conn=127.0.0.1:38402 reqid=8 duration=12.216437ms err="we have already seen this request; aborting replayed protocol"
INFO [12-31|10:21:28.419] rpc response                             method=datastreaming_start logId=8 err="we have already seen this request; aborting replayed protocol" result={} attempt=0 args="[\"0x6954f928\", \"0x32\", \"0xd9\", \"0x2a10\", \"0xa\", \"0xd199966a5b9702afdd1aa022571641f80c7eceec61b47be2336e83f25a4fc44f07489b11d3497e0ff31e88e3b17924bc50ee2d5b78277218dd173ffac6b589f300\"]" errorData=null
    protocol_test.go:230: goroutine 252 [running]:
        runtime/debug.Stack()
        	/opt/hostedtoolcache/go/1.25.5/x64/src/runtime/debug/stack.go:26 +0x5e
        github.com/offchainlabs/nitro/util/testhelpers.RequireImpl({0x1568e90, 0xc000225340}, {0x154f940, 0xc000a03d40}, {0x0, 0x0, 0x0})
        	/home/runner/work/nitro/nitro/util/testhelpers/testhelpers.go:29 +0x55
        github.com/offchainlabs/nitro/daprovider/data_streaming.testBasic.func1()
        	/home/runner/work/nitro/nitro/daprovider/data_streaming/protocol_test.go:230 +0x14f
        created by github.com/offchainlabs/nitro/daprovider/data_streaming.testBasic in goroutine 245
        	/home/runner/work/nitro/nitro/daprovider/data_streaming/protocol_test.go:223 +0x85
        
    protocol_test.go:230: �[31;1m [] we have already seen this request; aborting replayed protocol �[0;0m
--- FAIL: TestDataStreaming_PositiveScenario/Many_senders,_long_messages (0.21s)

TestDataStreaming_PositiveScenario

Stack Traces | 0.240s run time

=== RUN   TestDataStreaming_PositiveScenario
--- FAIL: TestDataStreaming_PositiveScenario (0.24s)

📣 Thoughts on this report? Let Codecov know! | Powered by Codecov

Tristan-Wilson

Looks good, just a minor comment about consistency of the interface with other precompiles.

Tristan-Wilson · 2025-12-29T15:32:32Z

precompiles/ArbFilteredTransactionsManager.go

+	return filteredState.IsFiltered(txHash)
+}
+
+func (con ArbFilteredTransactionsManager) hasAccess(c *Context) (bool, error) {


This signature is slightly different to ArbNativeTokenManager which has

func (con ArbNativeTokenManager) hasAccess(c ctx) bool { manager, err := c.State.NativeTokenOwners().IsMember(c.caller) return manager && err == nil }

and therefore the behavior when there is an error is slightly different in this implementation in that if there is an error, then the gas is not burned out.

Unsure if this difference is intentional or not.

Tristan-Wilson · 2025-12-29T16:40:43Z

We should consider making ArbFilteredTransactionsManager calls free for transaction censors, similar to how ArbOwner calls are free for chain owners. Currently, censors pay gas for AddFilteredTransaction/DeleteFilteredTransaction, but since they're trusted actors authorized by chain owners, it would make sense to follow the same pattern. This could be done by creating a CensorPrecompile wrapper (similar to OwnerPrecompile in wrapper.go) that checks TransactionCensors().IsMember(caller) and returns gasSupplied with multigas.ZeroGas() on success.

…anager

MishkaRogachev · 2025-12-29T17:52:20Z

This could be done by creating a CensorPrecompile wrapper (similar to OwnerPrecompile in wrapper.go) that checks TransactionCensors().IsMember(caller) and returns gasSupplied with multigas.ZeroGas() on success.

@Tristan-Wilson, wdyt about going further: remove ArbNativeToken-style check and return an error right in CensorPrecompile, like in ArbOwner?

Tristan-Wilson · 2025-12-30T12:37:22Z

system_tests/filtered_transactions_test.go

+	"github.com/offchainlabs/nitro/solgen/go/precompilesgen"
+)
+
+func TestManageTransactionCensors(t *testing.T) {


Can you please also test that the transactions that should be free are free? You can look at TestArbNativeTokenManager and getGasUsed inside it for inspiration.

I don't really get how to use getGasUsed in this case, since the transaction will still cost something, only the add/delete call is free. I can suggest to use multigas like this:

tx, err = arbFilteredTxs.AddFilteredTransaction(&censorTxOpts, txHash) require.NoError(t, err) receipt, err := builder.L2.EnsureTxSucceeded(tx) require.NoError(t, err) require.Equal(t, uint64(0), receipt.MultiGasUsed.Get(multigas.ResourceKindStorageAccess))

This somehow proves that tx did not perform any storage operations like set and clear

Could you check the censor account's balance is unchanged after adding/deleting filtered txs?

This was referenced Dec 24, 2025

Add ArbFilteredTransactionsManager precompile OffchainLabs/nitro-precompile-interfaces#25

Open

core: Add ArbFilteredTransactionsManager address OffchainLabs/go-ethereum#604

Open

MishkaRogachev changed the title ~~Add ArbCensoredTransactionsManager precompile (idle)~~ Add ArbCensoredTransactionsManager precompile Dec 24, 2025

MishkaRogachev force-pushed the create-arbcensoredtransactionsmanager-precompile branch from 1adc79f to 81f4e5e Compare December 24, 2025 14:55

MishkaRogachev force-pushed the create-arbcensoredtransactionsmanager-precompile branch 2 times, most recently from 45fb413 to 67c13f2 Compare December 26, 2025 15:01

MishkaRogachev changed the title ~~Add ArbCensoredTransactionsManager precompile~~ Add ArbFilteredTransactionsManager precompile Dec 26, 2025

MishkaRogachev force-pushed the create-arbcensoredtransactionsmanager-precompile branch 2 times, most recently from acf9398 to 7b7a735 Compare December 26, 2025 19:18

MishkaRogachev added 6 commits December 29, 2025 11:25

Add ArbCensoredTransactionsManager precompile (idle)

fd3ee72

Limit access to ArbCensoredTransactionsManager with transaction censors

1f8b4ed

Separated kv-storage for censored transactions

e865353

Rename: censored -> filtered transactions

7fc8bed

chore: minor fixes

a3ebdd4

Add a system test for filtered transaction manager

f56f36c

MishkaRogachev force-pushed the create-arbcensoredtransactionsmanager-precompile branch from 7b7a735 to f56f36c Compare December 29, 2025 12:06

MishkaRogachev mentioned this pull request Dec 29, 2025

Add ArbFilteredTransactionsManager.abi OffchainLabs/blockscout#207

Open

Update nitro-testnode pin

8d200f4

MishkaRogachev mentioned this pull request Dec 29, 2025

Update blockscout pin OffchainLabs/nitro-testnode#169

Open

MishkaRogachev marked this pull request as ready for review December 29, 2025 13:48

MishkaRogachev requested review from Tristan-Wilson, diegoximenes and tsahee December 29, 2025 13:48

Tristan-Wilson self-assigned this Dec 29, 2025

Tristan-Wilson requested changes Dec 29, 2025

View reviewed changes

Tristan-Wilson assigned MishkaRogachev and Copilot and unassigned Tristan-Wilson Dec 29, 2025

Tristan-Wilson unassigned Copilot Dec 29, 2025

Make ArbFilteredTransactionsManager access similar to ArbNativeTokenM…

12b3f91

…anager

MishkaRogachev added 2 commits December 29, 2025 18:57

Add CensorPrecompile wrapper to make transaction filtring free

688f9a7

Add events for filtered transaction

11a4eb2

MishkaRogachev assigned Tristan-Wilson and unassigned MishkaRogachev Dec 30, 2025

MishkaRogachev requested a review from Tristan-Wilson December 30, 2025 11:00

Tristan-Wilson reviewed Dec 30, 2025

View reviewed changes

Tristan-Wilson assigned MishkaRogachev and unassigned Tristan-Wilson Dec 30, 2025

Add test for free calls for FilteredTransactionsManager

ea8efef

MishkaRogachev assigned Tristan-Wilson and unassigned MishkaRogachev Dec 31, 2025

Tristan-Wilson assigned MishkaRogachev and unassigned Tristan-Wilson Dec 31, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add ArbFilteredTransactionsManager precompile #4174

Add ArbFilteredTransactionsManager precompile #4174

MishkaRogachev commented Dec 24, 2025 •

edited

Loading

Uh oh!

codecov bot commented Dec 24, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 24, 2025 •

edited

Loading

Uh oh!

Tristan-Wilson left a comment

Uh oh!

Tristan-Wilson Dec 29, 2025

Uh oh!

Tristan-Wilson commented Dec 29, 2025 •

edited

Loading

Uh oh!

MishkaRogachev commented Dec 29, 2025

Uh oh!

Tristan-Wilson Dec 30, 2025

Uh oh!

MishkaRogachev Dec 30, 2025

Uh oh!

Tristan-Wilson Dec 31, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Add ArbFilteredTransactionsManager precompile #4174

Are you sure you want to change the base?

Add ArbFilteredTransactionsManager precompile #4174

Conversation

MishkaRogachev commented Dec 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Dec 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

github-actions bot commented Dec 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❌ 7 Tests Failed:

Uh oh!

Tristan-Wilson left a comment

Choose a reason for hiding this comment

Uh oh!

Tristan-Wilson Dec 29, 2025

Choose a reason for hiding this comment

Uh oh!

Tristan-Wilson commented Dec 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MishkaRogachev commented Dec 29, 2025

Uh oh!

Tristan-Wilson Dec 30, 2025

Choose a reason for hiding this comment

Uh oh!

MishkaRogachev Dec 30, 2025

Choose a reason for hiding this comment

Uh oh!

Tristan-Wilson Dec 31, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

MishkaRogachev commented Dec 24, 2025 •

edited

Loading

codecov bot commented Dec 24, 2025 •

edited

Loading

github-actions bot commented Dec 24, 2025 •

edited

Loading

Tristan-Wilson commented Dec 29, 2025 •

edited

Loading