Skip to content

v1.3.2

Required upgrade. v1.3.2 is the current release. Partners on earlier releases must upgrade. Networking and CL peering are unchanged — same ports and firewall rules.

Highlights

  • Improved beacon-block acceleration (new in v1.3.2). Partner gateways now accelerate beacon blocks on every slot. On v1.3.0 and v1.3.1 they skipped acceleration for some slots. No partner configuration change.
  • Gateway self-enrollment (added in v1.3.1, new to you if you are upgrading from v1.2.0 or earlier). Fleet operators can mint one org-wide join key (ojk_) and configure gateways with OPT_JOIN_KEY instead of distributing one ogw_ API key per host. Each gateway enrolls once on first boot and mints JWTs with a local keypair thereafter. See Gateway Self-Enrollment.
  • Legacy API keys unchanged. The ogw_ path in Quick Start is still the default for single-gateway deployments.

The consumer block stream, long-running stream support, and stream metrics all carry forward into v1.3.2 unchanged.

Upgrade from an earlier release

docker restart alone keeps the old image. Recreate the container:

bash
export OPT_API_KEY=ogw_live_xxx   # unchanged if you use API keys
docker pull getoptimum/gateway:v1.3.2
docker rm -f optimum-gateway
docker run --name optimum-gateway --rm \
  -p 33212:33212/tcp \
  -p 33213:33213/tcp \
  -p 127.0.0.1:48123:48123/tcp \
  -e OPT_API_KEY=$OPT_API_KEY \
  -v $(pwd)/config:/app/config \
  -v $(pwd)/data/libp2p:/tmp/libp2p \
  -v $(pwd)/data/mump2p:/tmp/mump2p \
  getoptimum/gateway:v1.3.2 \
  -config=/app/config/app_conf.yml

Confirm health and mesh:

bash
curl -s http://localhost:48123/health | jq '.status, .checks'
curl -s http://localhost:48123/api/v1/self_info | jq '.mump2p.total_peers, .chain'

No firewall or CL peering changes are required. Join-key enrollment is opt-in — you only change credentials if you adopt the new fleet path.

If you run consumer streams, treat Holding a stream open for weeks as the complete checklist for production always-on feeds. It covers client keepalives and in-band token refresh, and also reconnecting after GOAWAY, retrying Internal as well as Unavailable, and accounting for permanent gaps.

Version Status

VersionStatus
v1.3.2CURRENT - required
v1.3.1DEPRECATED / unsupported
v1.3.0DEPRECATED / unsupported
v1.2.0DEPRECATED / unsupported
v1.1.1DEPRECATED / unsupported
v1.0.2DEPRECATED / unsupported
v0.0.1-rc12REMOVED / unsupported
v0.0.1-rc11REMOVED / unsupported