This is the final mandatory upgrade required to transition to the SESH token and TGE (updated with some minor fixes).
11.3.1 minor update
The 11.3.1 release includes some minor bug fixes, log improvement for L2 provider failures, and some new L2 provider tuning parameters. It is recommended, but not a required updated if already running 11.3.0.
The following release notes are for the 11.3.x updates in general, and are copied from the 11.3.0 release:
Oxen 11.3 Landing
This mandatory update, compared to the earlier 11.2.x releases, includes some improvements, a few bug fixes, but most importantly adds the upgrade to the final "Landing" hardfork, internally called hardfork 21, along with the conversion info (pubkeys, registered OXEN addresses, and earned SN bonus amounts) needed to complete the transition.
Hardfork 21 begins at block 1852079, which is expected to arrive at Wed, 21 May 2025 00:00, UTC.
Important notes for upgrading
-
The 11.x upgrade (beginning with the previous release) added a new key file,
key_bls
, in your oxen data directory. Restoring or moving a node requires this key, and so you should ensure that you back it up along with your existingkey_ed25519
if you haven't already done so. -
Nodes that currently have different primary and auxiliary pubkeys (i.e. that have separate
key
andkey_ed25519
key files -- this will apply to nodes that were set up prior to Oxen 8) will change their SN pubkey at the HF21 to unify these to only use thekey_ed25519
going forward. This means that any tools you have tracking a node by pubkey may need to be updated at the hardfork to recognize the new pubkey. (If your node does not show a separate Auxiliary Pubkey when you look it up on https://oxen.observer then this does not apply to you). -
For operators running nodes on Ubuntu 20.04, please note that this Ubuntu version is nearing the end of its support lifetime at the end of May, and while we still support 20.04 packages for this release, this will be the last major releases where we continue to support Ubuntu 20.04. Upgrading to 22.04, or better yet, 24.04, is recommended.
L2 oxen proxy upgrading
If you are running multiple service nodes and using an L2 proxy, note that you will need to ensure that you update the proxy and any proxy-using nodes at the same time: 11.2.x nodes will produce errors when talking to 11.3.x proxies, and vice versa, because of the contract address added in the release. One solution, if you have set up multiple redundant oxend proxies, is to update one proxy at the beginning of your upgrade plan, and the other at the end, so that all your nodes have at least one same-version oxend proxy through the upgrade process. (This is not expected to be needed for future service node upgrades, but rather is a unique situation for the 11.2->11.3 upgrade).
Updating service nodes
For service node operators using Debian 11+ and Ubuntu 20.04+, the upgraded packages are available from our APT repository. Static binaries for other users are available below. Note that Ubuntu 20.04 support will be dropped in the near future, and operators on 20.04 should start planning to upgrade to 22.04 or 24.04.
Signatures for static release binaries
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Signed SHA256 hashes of release files. These are signed using Jason's GPG
key available at:
- the oxen-io/oxen-core repository, at /utils/gpg_keys/Jason.asc
- OpenPGP key servers (Jason Rhinelander <jason@session.foundation>, A88D4262)
- https://imaginary.ca/public.gpg
- https://github.com/jagerman.gpg
ddfc0b9b645ea7386234ed4adab23198514863d7f54b4eedda274d09d67bcd52 oxen-linux-x86_64-11.3.1.tar.xz
6909684eb48037fe71d8807922a26573fbdadf08d01de7faceed2844343075ab oxen-macos-arm64-11.3.1.tar.xz
60cce81b499827529e6509ded778a822f04915f230d4324f91dac4d63904e4ee oxen-macos-x86_64-11.3.1.tar.xz
68aadc20cabaaf78e700735d136887091bc038caf3952cd7bfab31a7d5cd8d3c oxen-win-x64-11.3.1.zip
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCgAdFiEEZjYdjjyW5Bxty3BRxJks56iNQmIFAmgmG4UACgkQxJks56iN
QmLI7Q//TYUV2MjaiG/VEi2IY5A3w2LY2wiTywcj1RWhs+E5dy3VOI3a0JRTtxT5
HQMpDjiAmKosUZHHg1iDlQbG+1IQ2YTPKvkg4/r4Gx9T8vP8X4DQevKjZt9kC3CZ
KDZsAfJC+0Bh5UqCZmUBK51Jk1vH9jB1O+Dz7TEUzcP5Ym3H55vU7iz6JFOf2H8U
X15ZvUnnfWCeeTKLhuqHijk1QwT3oenhBYNvJQpyjY32/rQAcgwsiBxhDJkVqto7
XT28v1lyNIWwUgArOAvBFz3x3lzC1kYHXQnszBv3PWfQsiIpfPcgOngTGn75DCUS
uOqN/+dzRRJp7L8VGpVESosMG4EJBl/VABnWWyLrarH5rbq+dVtzTwsgdSpPf+gb
Ix9s3cLB76xt2B2Qry3Q+YNx1BoD42bRvfadQR5wj4QzjVkbBGCcDJdCfuEoN41M
tUyd3zTbACwkoo0JLhbyJMRiHXhAnYBRW3BUl/oQBtV1EgGcWdmsxVVb9RhYNzvQ
2hSJVyNMU0jq+/KHTerwWe8omEuZe31D2diNniaxrBs6AHUGVNcCUnzUJQFR8aLB
XsRZTtsNikv8CiB1h46p1UcK8CtmsY77zkI3wg97T/mzdbpe1rPLQxmFqE8mXsGc
F5P55ICJzZVUky/FPj04lM4z2H1OFTPT9dbIRsBsproUdDdHSs0=
=Cvtj
-----END PGP SIGNATURE-----