The Agoric OpCo engineering team is pleased to publish the mainnet1B-rc2 release. This release contains a number of significant upgrades and new features including:
- Vaults contracts
- Validator State Sync
- Smart Contract Upgradeability
- Governance Capability Upgrade
- Decentralized Oracle Network
- Critical Message Prioritization
- Scalability and Performance Improvements
This is a state-machine-breaking upgrade so all chain validators will need to upgrade from PismoC to this new version.
Discussion for this release will take place in the Agoric community forum.
Tag: mainnet1B-rc2
Commit: b66bf7c
Docker: ghcr.io/agoric/agoric-sdk:34
As shown in go.mod this release is based on:
ibc-go v3.4.0
cosmos-sdk v0.45.11
tendermint v0.34.23
How to upgrade
Presuming that your node is running pismoC, once the upgrade height for a subsequent proposal to upgrade to agoric-upgrade-10 has been reached, your node will halt automatically allowing you to upgrade the agoric stack.
# prepare by installing Go 1.20.2 or higher, Node 16, clang 10 or gcc 10
# stop the agd service
cd agoric-sdk
git fetch --all
git checkout mainnet1B-rc2
yarn install
yarn build
(cd packages/cosmic-swingset && make)
#start the agd service
Do not copy the agd
script or Go binary to another location. If you would like to have an executable agd
in another location, then create a symlink in that location pointing to agoric-sdk/bin/agd
.
Node Version
Node.js LTS (version 16.13.0 or higher).
Golang Version
The agoric-upgrade-10 release requires Go 1.20.2 or higher.
C Compiler Version
Clang version 10 or GCC version 10 required (for __has_builtin
).
Troubleshooting xsnap requires __has_builtin
An error like this:
/root/agoric-sdk/packages/xsnap/xsnap-native/xsnap/makefiles/lin/../../sources/xsnap-worker.c:15:2: error: #error "xsnap requires __has_builtin (gcc>=10, e.g. Ubuntu-22.04), see https://github.com/Agoric/agoric-sdk/issues/7829"
15 | #error "xsnap requires __has_builtin (gcc>=10, e.g. Ubuntu-22.04), see https://github.com/Agoric/agoric-sdk/issues/7829"
| ^~~~~
make: *** [xsnap-worker.mk:147: /root/agoric-sdk/packages/xsnap/xsnap-native/xsnap/makefiles/lin/../../build/tmp/lin/release/xsnap-worker/xsnap-worker.o] Error 1
means you need to use Clang version 10 or GCC version 10. Note that Ubuntu-20.04-LTS provides GCC version 9 as the default, which is too old. See #7829 for more details.
Troubleshooting repoconfig.sh: No such file or directory
Unlike typical cosmos-sdk chains where the daemon is a single executable file, Agoric's use of cosmos-sdk depends on many components of agoric-sdk
at runtime. Copying agd
to /usr/local/bin
or the like is unlikely to produce a working installation. For more detail, see: #7825
Troubleshooting Cannot find dependency ...
in systemd
If you have LimitNOFILE=4096
in your systemd unit file, change it to LimitNOFILE=65536
. For more detail, see #7817
Generating a software upgrade proposal with checksums
The ./scripts/gen-upgrade-proposal.sh
is designed to aid in composing a agd tx submit-proposal software-upgrade ...
command. In particular, it captures package checksums to verify integrity of downloaded software.