Repository navigation
v0.11.0-rc3
Pre-release
Pre-release
·
41 commits
to develop
since this release
π What's New
- Autoclaim: the API now identifies requests by their claim global index, the same encoding as the bridge API (#1891).
- Bridge service:
/bridge/v1/sync-statusnow reports all six syncers, addsis_haltedto every entry, and gives each entry its own redactederror(#1877). - Bridge tracker:
GET /tracker/v1/activity/from/{from_address}is paginated and returns a totalcount(#1888). - Proxy: it exposes bridge tracker cache size and alive counts as Prometheus metrics (#1871).
- Autoclaim: operational fixes for
EthTxManagerdefaults and for the bridge detectors' start block (#1875).
β οΈ Breaking Changes
- π οΈ Config:
- A deployment that omitted
AutoClaim.L1ToL2BridgeDetector.StartBlockorL2ToLxBridgeDetector.StartL1Blockno longer scans from genesis. It now resolves a recent block fromStartLookback(default 24h). Explicit values, including0, are unaffected (#1875). - The proxy now opens a Prometheus listener on
localhost:9091by default. Set[Prometheus] Enabled = falseto disable it (#1871). - The AggOracle
EthTxManagerdefaults used the wrong TOML keys, so they never applied.GetReceiptMaxTimeandGetReceiptWaitIntervalare nowWaitReceiptMaxTimeandWaitReceiptCheckInterval(#1875).
- A deployment that omitted
- π API/CLI:
- Autoclaim: the
{id}path parameter is replaced by{global_index}, and theidresponse field is removed (#1891). - Bridge tracker activity: a client that sends no pagination params now gets only the first 20 bridges, most recent first. It must page using
count.api_revisiongoes from 5 to 6 (#1888). - Bridge service:
GET /bridge/v1/sync-statusalways answers 200. Component failures are reported in each entry'serrorfield instead of a 500 (#1877).
- Autoclaim: the
π Configuration Updates
π§© Proxy
- π§Ύ Config Diff:
+[Prometheus]
+Enabled = true
+Host = "localhost"
+Port = 9091
+
[Tracker]
+MetricsSampleInterval = "15s"π§© Aggkit
- π§Ύ Config Diff:
[AggOracle.EVMSender.EthTxManager]
-GetReceiptMaxTime = "250ms"
-GetReceiptWaitInterval = "1s"
+WaitReceiptMaxTime = "250ms"
+WaitReceiptCheckInterval = "1s"
[AutoClaim.L1ToL2BridgeDetector]
-StartBlock = 0
[AutoClaim.L2ToLxBridgeDetector]
-StartL1Block = 0- Each
[[AutoClaim.Claimers]]entry now gets defaults for anyEthTxManagerfield left unset. This prevents a zero-delay monitor busy-loop and underpriced transactions (#1875).
π API Updates
π Bridge service API
GET /bridge/v1/sync-status:- Added
l1_info_tree_info,claim_l1_infoandclaim_l2_info. - Added
is_haltedanderrorto every entry. - Always responds 200 instead of 500 on a component failure.
- The JSON shape is additive only, so the only breaking part is the status-code behaviour.
- Added
GET /health:- Added
details.l1_info_tree,details.claim_l1anddetails.claim_l2. - Added
is_haltedto everydetails.*entry. - Error text in
details.*.erroris now redacted. - Not a breaking change.
- Added
π Proxy API
GET /tracker/v1/activity/from/{from_address}:- Added the optional
page_numberandpage_sizequery params (default 1/20, max 200). - Added a
countfield to the response. - Results are sorted most recent first.
- Breaking because of the default page size (see above).
api_revisionis now 6.
- Added the optional
GET /tracker/v1/healthis unchanged.- New Prometheus endpoint
http://<Host>:<Port>/metricswithbridgetracker_cache_size_bytes,bridgetracker_alive_trackersandbridgetracker_alive_activities.
π Others API
- Autoclaim API:
GET /autoclaim/v1/bridges/{global_index}andPOST /autoclaim/v1/bridges/{global_index}/approve|rejectreplace the{id}routes. They take a decimal or0xhex global index, and non-numeric values return 400.GET /autoclaim/v1/bridgesgains aglobal_indexfilter.- The
idfield is removed from responses. - Breaking interface change.
- Known limitation: in the rare case where a legacy pre-Etrog index collides with a rollup-origin one, the by-index routes return 409.
β Testing & Validation
- Test cases: new e2e
TestBridgeServiceSyncStatusAllSyncersand an extendedTestBridgeServiceHealthSyncStatus(test/e2e/sync_status_all_syncers_test.go). New unit tests cover autoclaim global-index lookup, theEthTxManagerdefaults, activity pagination, and the proxy metrics sampler.
π¦ Full Changelog
- ci: use Sonnet 5.5 for @claude mentions on PRs by @arnaubennassar in #1880
- fix(autoclaim): EthTxManager defaults and start-block defaulting by @arnaubennassar in #1875
- feat(bridgeservice): sync status for all syncers with is_halted (#1861) by @arnaubennassar in #1877
- feat: proxy: expose cache size and alive counts as Prometheus metrics 1870 by @joanestebanr in #1871
- fix: paginate bridge tracker activity endpoint 442 by @joanestebanr in #1888
- feat(autoclaim): identify API requests by global index by @arnaubennassar in #1891
Full Changelog: v0.11.0-rc12...v0.11.0-rc13