worldcoin/world-chain v2.8.3

on GitHub

World Chain v2.8.3 adds opt-in, resumable preconfirmed-log APIs for locally validated Flashblocks.

Changes

• Add worldchain_getPreconfirmedLogs and WebSocket worldchain_subscribe / worldchain_unsubscribe, with atomic snapshots, pagination, bounded replay and lifecycle updates. #1226
• Add bounded native trace-projection foundations. Runtime activation and deadline-owned native workers are not included in this release. #1227
• Correct proxyd cursor-affinity guidance and release asset links. #1228

Configuration and rollout

The new APIs are disabled by default. To enable them on an existing configured Flashblocks node, add --rpc.preconfirmed-logs and enable the eth namespace on the required HTTP/WebSocket transports. See the API and rollout guide.

Preconfirmed results remain provisional; this release does not change confirmation or finality requirements. Cursors are backend-local. A WebSocket connection through proxyd does not by itself guarantee affinity for HTTP-mapped queries; follow the guide's recovery and routing requirements. Release publication does not deploy nodes or enable the feature.

Docker

Image: ghcr.io/worldcoin/world-chain:v2.8.3. Supports Linux AMD64 and ARM64; Docker selects the matching architecture automatically.

Pull the release:

docker pull ghcr.io/worldcoin/world-chain:v2.8.3

For reproducible deployments, pin the multi-architecture digest:

docker pull ghcr.io/worldcoin/world-chain:v2.8.3@sha256:d2c22323180a52c213f0a4ae5d99d19066bfab2f5cd5e578aedfcba7a3366ad2

Use the same pinned reference as the image in Docker Compose or Kubernetes.

Source revision: 97f658ae0b854412592d37824375f3285d987b1d.

Linux binaries

Both architectures were smoke-tested on Ubuntu 24.04. The native tarballs require newer runtime libraries than Debian 12/bookworm; use the Docker image on older distributions.

Detached signatures use the PGP fingerprint C75F BC64 E9D4 8E89 FB60 418B 8949 B352 D042 2E74.

Full changelog: v2.8.2...v2.8.3