SSV Oracle & Cluster Updater by olegshmuelov · Pull Request #3 · ssvlabs/ssv-oracle

olegshmuelov · 2025-12-03T12:53:57Z

Off-chain oracle that publishes Merkle roots of SSV cluster effective balances on-chain.

Highlights

Event-sourced state sync to PostgreSQL
Beacon chain integration for validator balances
OpenZeppelin-compatible Merkle proofs
Automatic tx management (gas bumping, retries, cancellation)
Cluster balance updater with --updater flag

Usage

make run        # Oracle only
make run-all    # Oracle + updater
make docker     # Build image

updater/updater.go

txmanager/manager.go

iurii-ssv

The 2nd pass from me, code reads well! Left some questions/suggestions, but haven't reviewed all the new changes yet (will drop another review soon)

updater/updater.go

txmanager/manager.go

oracle/oracle.go

updater/updater.go

oleg-ssvlabs

gj.
Left couple of small comments. Still need to review few packages.

go.mod

api/api.go

api/api_test.go

api/handlers.go

eth/execution/batch_size_test.go

eth/execution/client.go

eth/retry.go

api/handlers.go

eth/execution/client.go

eth/syncer/syncer.go

…ping

iurii-ssv

Looking good!

oleg-ssvlabs

lgtm!

contract/client.go

contract/events.go

cmd/oracle/commands/config.go

merkle/encoding.go

updater/updater.go

y0sher

Looks good! some minor comments

olegshmuelov added 2 commits December 3, 2025 14:53

initial commit

a5bd8df

improve error handling and address code review issues

11b7a47

olegshmuelov changed the title ~~SSV oracle & updater~~ SSV Oracle & Cluster updater Dec 4, 2025

olegshmuelov added 17 commits December 4, 2025 11:40

decouple updater from timing calculation

1936909

migrate to zap structured logging

2cbf35f

deduplicate syncOnce by delegating to SyncToBlock

afe61fc

simplify schema for forward-only processing

ad3185a

refactor: integrate updater into oracle with --updater flag

533ab69

remove mock mode and consolidate to single SSV Network contract

1329a0f

migrate beacon client to go-eth2-client

641583a

refactor storage interfaces and improve graceful shutdown

d2c1a95

use typed map keys instead of hex strings

ad9dc92

rename TimingPhase to CommitPhase

b8e1f42

simplify logging by removing passed logger parameters

de63a37

simplify merkle package: remove unused code and fix tests

c5d81f5

improve error handling and logging

6294517

simplify Makefile

db006b5

update docs with new Makefile commands

1355206

add wallet abstraction and commit status tracking

0908780

add txmanager package for transaction lifecycle management

fcfcffc

olegshmuelov changed the title ~~SSV Oracle & Cluster updater~~ SSV Oracle & Cluster Updater Dec 8, 2025

olegshmuelov added 2 commits December 8, 2025 15:37

add ClusterBalanceUpdated event and refactor parsers to use Cluster type

b6049dd

docker: production-ready image with OCI labels and build improvements

343116d

olegshmuelov marked this pull request as ready for review December 8, 2025 14:01

olegshmuelov added 6 commits December 8, 2025 16:57

use composite interface and consolidate constants

bc2e9a9

remove redundant comments and add missing doc comments

d5e2a50

improve code quality and observability

c46ad0b

extract cluster event helpers to reduce duplication

a9baf8a

review adjustments

db34c50

rename timing to phase

e15c0d3