github agglayer/aggkit v0.11.0-rc13
v0.11.0-rc3

latest releases: v0.12.0-rc4, v0.12.0-rc3, v0.12.0-rc2...
pre-releaseone month ago

๐Ÿš€ 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-status now reports all six syncers, adds is_halted to every entry, and gives each entry its own redacted error (#1877).
  • Bridge tracker: GET /tracker/v1/activity/from/{from_address} is paginated and returns a total count (#1888).
  • Proxy: it exposes bridge tracker cache size and alive counts as Prometheus metrics (#1871).
  • Autoclaim: operational fixes for EthTxManager defaults and for the bridge detectors' start block (#1875).

โš ๏ธ Breaking Changes

  • ๐Ÿ› ๏ธ Config:
    • A deployment that omitted AutoClaim.L1ToL2BridgeDetector.StartBlock or L2ToLxBridgeDetector.StartL1Block no longer scans from genesis. It now resolves a recent block from StartLookback (default 24h). Explicit values, including 0, are unaffected (#1875).
    • The proxy now opens a Prometheus listener on localhost:9091 by default. Set [Prometheus] Enabled = false to disable it (#1871).
    • The AggOracle EthTxManager defaults used the wrong TOML keys, so they never applied. GetReceiptMaxTime and GetReceiptWaitInterval are now WaitReceiptMaxTime and WaitReceiptCheckInterval (#1875).
  • ๐Ÿ”Œ API/CLI:
    • Autoclaim: the {id} path parameter is replaced by {global_index}, and the id response 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_revision goes from 5 to 6 (#1888).
    • Bridge service: GET /bridge/v1/sync-status always answers 200. Component failures are reported in each entry's error field instead of a 500 (#1877).

๐Ÿ“‹ 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 any EthTxManager field 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_info and claim_l2_info.
    • Added is_halted and error to 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.
  • GET /health:
    • Added details.l1_info_tree, details.claim_l1 and details.claim_l2.
    • Added is_halted to every details.* entry.
    • Error text in details.*.error is now redacted.
    • Not a breaking change.

๐Ÿ”Œ Proxy API

  • GET /tracker/v1/activity/from/{from_address}:
    • Added the optional page_number and page_size query params (default 1/20, max 200).
    • Added a count field to the response.
    • Results are sorted most recent first.
    • Breaking because of the default page size (see above). api_revision is now 6.
  • GET /tracker/v1/health is unchanged.
  • New Prometheus endpoint http://<Host>:<Port>/metrics with bridgetracker_cache_size_bytes, bridgetracker_alive_trackers and bridgetracker_alive_activities.

๐Ÿ”Œ Others API

  • Autoclaim API:
    • GET /autoclaim/v1/bridges/{global_index} and POST /autoclaim/v1/bridges/{global_index}/approve|reject replace the {id} routes. They take a decimal or 0x hex global index, and non-numeric values return 400.
    • GET /autoclaim/v1/bridges gains a global_index filter.
    • The id field 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 TestBridgeServiceSyncStatusAllSyncers and an extended TestBridgeServiceHealthSyncStatus (test/e2e/sync_status_all_syncers_test.go). New unit tests cover autoclaim global-index lookup, the EthTxManager defaults, activity pagination, and the proxy metrics sampler.

๐Ÿ“ฆ Full Changelog

Full Changelog: v0.11.0-rc12...v0.11.0-rc13

Don't miss a new aggkit release

NewReleases is sending notifications on new releases.