feat: split bridgesyncer into bridgesyncer + claimsyncer

[joanestebanr]

🔄 Changes Summary

This PR extracts claim event synchronization out of bridgesync into a new, dedicated claimsync package. The change enables claim indexing to run as an independent component with its own database, lifecycle, and RPC interface. Both the AggSender and the AggSender Validator are updated to use the new claim syncer.

The key feature is that decoupling claimsync allow to use a full-node RPC instead of archive RPC for aggsender-proposer and aggsender-validator.

• Don't sync L1 claims
• For new deployments starts to synchronize just the block required: This synchornization use a debug end-point for the legacy claim events, but new deployments emit detailedClaimEvent that avoid this requiremente

⚙️ Internal changes

• The syncer using sync package no longer require to create the first block manually. Now can use the call EVMDriver.Sync(ctx context.Context, firstBlockNumber *uint64):
  • You can set the first to synchronize
  • You can set to nil that means wait until the call processor.GetLastProcessedBlock returns a block.
• The syncer allow to late start of syncer calling EVMDriver.Sync(ctx, nil):
  • The syncer must implement a method: SetNextRequiredBlock to user pass the required first block (only works for 1 consumer)
  • It could call to driver.SyncNextBlock(ctx, blockNumber) to process only the first block. It would produces calls as a regular block process but it always include the block even if there are no events there

⚠️ Breaking Changes

🚨 This PR force to resync all claims! It's going to be deletagate to another PR to prevent it and move the data to new database (pending to implements #1546 to avoid it)

📋 Config Updates

This PR introduces the new configuration for claimsyncer for L1 and L2

[ClaimL1Sync]
DBPath = "{{PathRWData}}/claiml1sync.sqlite"
DBQueryTimeout = "{{BridgeL1Sync.DBQueryTimeout}}"
BlockFinality = "{{BridgeL1Sync.BlockFinality}}"
InitialBlockNum = {{BridgeL1Sync.InitialBlockNum}}
AutoStart = "auto"
BridgeAddr = "{{BridgeL1Sync.BridgeAddr}}"
SyncBlockChunkSize = {{BridgeL1Sync.SyncBlockChunkSize}}
RetryAfterErrorPeriod = "{{BridgeL1Sync.RetryAfterErrorPeriod}}"
MaxRetryAttemptsAfterError = {{BridgeL1Sync.MaxRetryAttemptsAfterError}}
WaitForNewBlocksPeriod = "{{BridgeL1Sync.WaitForNewBlocksPeriod}}"
RequireStorageContentCompatibility = {{BridgeL1Sync.RequireStorageContentCompatibility}}

[ClaimL2Sync]
DBPath = "{{PathRWData}}/claiml2sync.sqlite"
DBQueryTimeout = "{{BridgeL2Sync.DBQueryTimeout}}"
BlockFinality = "{{BridgeL2Sync.BlockFinality}}"
InitialBlockNum = {{BridgeL2Sync.InitialBlockNum}}
AutoStart = "auto"
BridgeAddr = "{{BridgeL2Sync.BridgeAddr}}"
SyncBlockChunkSize = {{BridgeL2Sync.SyncBlockChunkSize}}
RetryAfterErrorPeriod = "{{BridgeL2Sync.RetryAfterErrorPeriod}}"
MaxRetryAttemptsAfterError = {{BridgeL2Sync.MaxRetryAttemptsAfterError}}
WaitForNewBlocksPeriod = "{{BridgeL2Sync.WaitForNewBlocksPeriod}}"
RequireStorageContentCompatibility = {{BridgeL2Sync.RequireStorageContentCompatibility}}

✅ Testing

• 🤖 Automatic: e2e-kurtosis, and e2e-go

🐞 Issues

• Closes #[issue-number]

🔗 Related PRs

• [Optional: Enumerate related pull requests]

📝 Notes

• [Optional: design decisions, tradeoffs, or TODOs]

[Copilot]

Pull request overview

This PR extracts claim event synchronization into a dedicated claimsync package and updates existing syncers and aggsender components to use the new claim syncer, enabling independent claim indexing and improved RPC requirements (full-node vs archive).

Changes:

• Added standalone + embedded claim syncer APIs, storage/migrations, and RPC services.
• Extended sync driver/downloader interfaces to support bootstrap syncing and “no blocks processed yet” semantics.
• Updated aggsender/bridge service flows and interfaces to source claims from claimsync instead of bridgesync.

Reviewed changes

Copilot reviewed 128 out of 140 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
sync/evmdriver.go	Adds bootstrap sync and supports “no processed block” flow.
sync/evmdownloader.go	Extends downloader API to support bounded downloads and empty-first-block reporting.
sync/evmdownloader_test.go	Updates tests and adds coverage for new downloader behaviors.
scripts/local_config_fep	Makes config artifact name overridable with a default.
scripts/l2claimsync_get_claims.sh	Adds helper script for ClaimSync RPC getClaims.
scripts/l1claimsync_set_starting_block.sh	Adds helper script for ClaimSync RPC setNextRequiredBlock.
scripts/aggsender_request_status.sh	Adds helper script for Aggsender status RPC.
scripts/aggsender_request_last_cert.sh	Adds helper script for Aggsender last cert RPC.
multidownloader/sync/evmdriver.go	Updates multidownloader driver sync signature and logging/error labels.
multidownloader/sync/evmdriver_test.go	Adds test coverage for firstBlockNumber parameter validation.
multidownloader/sync/evmdownloader.go	Renames log/error prefixes and reduces log verbosity.
multidownloader/evm_multidownloader.go	Changes info logs to debug and fixes finalized flag handling for missing DB header.
multidownloader/evm_multidownloader_test.go	Updates exploratory test to pass explicit fromBlock pointer.
multidownloader/e2e_test.go	Updates e2e to pass explicit fromBlock pointer.
l2gersync/processor.go	Changes GetLastProcessedBlock to return (num, found, err).
l2gersync/processor_test.go	Updates tests for new GetLastProcessedBlock signature.
l2gersync/l2_ger_syncer.go	Passes initial block into driver sync and stores config in syncer.
l2gersync/evm_downloader_sovereign.go	Updates downloader interface signature and improves error logging context.
l2gersync/evm_downloader_sovereign_test.go	Updates download call signature.
l2gersync/evm_downloader_legacy.go	Updates downloader interface signature.
l1infotreesync/processor.go	Changes GetLastProcessedBlock to return (num, found, err).
l1infotreesync/l1infotreesync.go	Threads initial block into driver sync and adapts to new processor API.
l1infotreesync/mock_driver_interface.go	Updates driver mock Sync signature.
grpc/server.go	Adds TODO note about setting claimsyncer starting block.
config/types/true_false_auto.go	Introduces tri-state config type (true/false/auto) with resolution support.
config/types/true_false_auto_test.go	Adds unit tests for tri-state config parsing/validation/resolve.
config/default.go	Adds default ClaimL1Sync/ClaimL2Sync sections and EmbeddedClaimSync toggle.
config/config.go	Adds ClaimL1Sync/ClaimL2Sync config fields.
common/components.go	Adds L2CLAIMSYNC component; removes PROVER constant from validation list.
claimsync/config.go	Adds embedded/standalone claimsync configuration definitions and validation.
claimsync/config_test.go	Adds validation tests for claimsync configs.
claimsync/processor.go	Adds standalone claimsync processor (DB + embedded processor).
claimsync/embedded.go	Adds embedded claimsync integration for bridgesync transaction reuse.
claimsync/claimdata.go	Adds local aliases for claimsync types/constants.
claimsync/helpers_test.go	Fixes package name to claimsync.
claimsync/claimcalldata_test.go	Updates package and callsites; adds alias/constant tests.
claimsync/claimsync_test.go	Adds integration test for deferred-start behavior via SetNextRequiredBlock.
claimsync/claimsync_rpc.go	Adds ClaimSync RPC service endpoints (status/getClaims/getClaimsByGlobalIndex/setNextRequiredBlock).
claimsync/claimsync_rpc_test.go	Adds unit tests for ClaimSync RPC endpoints.
claimsync/agglayer_bridge_l2_reader.go	Moves AgglayerBridgeL2Reader into claimsync package/types.
claimsync/agglayer_bridge_l2_reader_test.go	Updates tests to use claimsync types.
claimsync/types/claim_syncer.go	Defines ClaimSyncer interface for claimsync component.
claimsync/types/claim_storager.go	Defines storage interface for claims DB operations.
claimsync/types/claim_reader.go	Defines read-only claims interface.
claimsync/types/claim_querier.go	Defines boundary block query interface.
claimsync/types/processor.go	Defines embedded processor interface for transactional embedding.
claimsync/types/syncer_id.go	Adds claim syncer IDs and DB schema version constant.
claimsync/storage/migrations/migrations.go	Adds claimsync migration registry and embedded SQL.
claimsync/storage/migrations/claimsync0001.sql	Adds initial claimsync schema.
claimsync/types/mocks/mock_embedded_processor.go	Adds autogenerated mocks for embedded processor interface.
claimsync/types/mocks/mock_claim_querier.go	Adds autogenerated mocks for claim querier interface.
bridgesync/config.go	Replaces custom tri-state with shared TrueFalseAutoMode and adds resolved logging.
bridgesync/types/types.go	Removes Unclaim type (moved to claimsync types).
bridgesync/bridgesync.go	Removes claim APIs from bridgesync and threads initial block into sync driver.
bridgesync/bridgesync_test.go	Updates tests for new APIs and removed claim methods.
bridgesync/e2e_test.go	Adapts helpers to new GetLastProcessedBlock signature and constructor params.
bridgesync/mock_bridge_querier.go	Updates BridgeQuerier mock to use claimsync claim types.
bridgeservice/bridge_interfaces.go	Splits claim operations into a dedicated Claimer interface.
bridgeservice/utils.go	Updates claim response conversion to accept claimsync claim type.
bridgeservice/bridge.go	Wires claimL1/claimL2 into handlers and updates GetLastProcessedBlock signature usage.
aggsender/types/status.go	Adds explicit status transitions with logging.
aggsender/types/interfaces.go	Updates interfaces to use claimsync types and adds InitialBlockClaimSyncerSetter.
aggsender/types/optimistic_interface.go	Switches optimistic signer to consume claimsync claims.
aggsender/types/certificate_build_params.go	Switches certificate build params claims/unclaims to claimsync types.
aggsender/types/certificate_build_params_test.go	Updates tests for claimsync types.
aggsender/trigger/trigger_by_bridge.go	Handles “no processed block” in ForceTriggerEvent.
aggsender/trigger/trigger_by_bridge_test.go	Updates GetLastProcessedBlock mock signature.
aggsender/query/bridge_query.go	Sources claims from claim syncer and reports min(bridge, claim) synced height.
aggsender/query/certificate_query.go	Uses claim syncer for globalIndex→block resolution.
aggsender/query/initial_block_to_claimsync_setter.go	Adds helper to set claim syncer next required block from latest settled cert.
aggsender/query/initial_block_to_claimsync_setter_test.go	Adds tests covering success and error paths of initial-block setter.
aggsender/query/aggchain_proof_query.go	Switches to claimsync unclaim types and claims input.
aggsender/query/aggchain_proof_query_test.go	Updates tests for claimsync types.
aggsender/prover/proof_generation_tool.go	Pulls claims via claim syncer and updates L2 reader to claimsync.
aggsender/prover/proof_generation_tool_test.go	Updates tests to include claim syncer mock and new signatures.
aggsender/flows/builder_flow_factory.go	Threads claim syncer through common flow components and uses claimsync reader.
aggsender/flows/builder_flow_factory_test.go	Updates factory tests for new parameter.
aggsender/flows/verifier_flow_factory.go	Threads claim syncer into verifier flows.
aggsender/flows/verifier_flow_factory_test.go	Updates verifier flow factory test parameters.
aggsender/flows/flow_base.go	Switches claims/unclaims types and uses new GetLastProcessedBlock signature.
aggsender/flows/max_l2blocknumber_limiter_test.go	Updates claims test data types.
aggsender/converters/imported_bridge_exit_converter.go	Converts from claimsync claim type instead of bridgesync claim.
aggsender/converters/imported_bridge_exit_converter_test.go	Updates tests for claimsync claim type.
aggsender/optimistic/optimistichash/calculate_hash_commit_imported_bridges.go	Switches optimistic hashing inputs to claimsync claim type.
aggsender/optimistic/optimistichash/calculate_hash_commit_imported_bridges_test.go	Updates tests for claimsync claim type.
aggsender/optimistic/optimistic_sign.go	Switches optimistic signing inputs to claimsync claim type.
aggsender/optimistic/optimistic_sign_test.go	Updates tests for claimsync claim types.
aggsender/optimistic/mocks/mock_optimistic_signature_calculator.go	Updates mock signature to use claimsync claim types.
aggsender/mocks/mock_optimistic_signer.go	Updates mock signature to use claimsync claim types.
aggsender/mocks/mock_l2_bridge_syncer.go	Updates GetLastProcessedBlock signature and removes claim mocks from L2 bridge syncer.
aggsender/mocks/mock_bridge_querier.go	Updates bridge querier mock to use claimsync claim/unclaim types + new last processed signature.
aggsender/mocks/mock_aggsender_flow_baser.go	Updates claim conversion mock signature to claimsync claim.
aggsender/mocks/mock_agglayer_bridge_l2_reader.go	Updates reader mock to use claimsync Unclaim type.
aggsender/mocks/mock_initial_block_claim_syncer_setter.go	Adds mock for initial block claim syncer setter.
aggsender/aggsender.go	Wires claim syncer and sets claim sync starting block before flow init.
aggsender/aggsender_test.go	Updates tests for claim syncer wiring and new signatures/types.
aggsender/aggsender_validator.go	Wires claim syncer + initial-block setter into validator startup.
aggsender/aggsender_validator_test.go	Adds tests for validator startup and delegation behavior.
.mockery.yaml	Adds mockery generation config for claimsync interfaces.

[joanestebanr]

@claude

[sonarqubecloud]

Quality Gate passed

Issues
13 New issues
0 Accepted issues

Measures
0 Security Hotspots
81.6% Coverage on New Code
0.7% Duplication on New Code

See analysis details on SonarQube Cloud