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 ​

  • Beacon blocks propagated on every slot (new in v1.3.2). Partner gateways now propagate beacon blocks over mump2p on every slot. On v1.3.0 and v1.3.1 some slots were skipped. 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