Skip to content

agoric-upgrade-13-rc0

Pre-release
Pre-release
Compare
Choose a tag to compare
@mhofman mhofman released this 07 Dec 18:42
· 349 commits to release-mainnet1B since this release
agoric-upgrade-13-rc0
5a6cdeb

The Agoric OpCo engineering team is pleased to publish the agoric-upgrade-13-rc0 release candidate. This release is primarily intended to offer a new smart wallet provisioning flow, update the interchain stack dependencies, and fix various issues. It does not change the behavior of any JavaScript contracts.

The following new features are included in this release:

  • #8558: automatically provision a smart wallet, charging a beans based provisioning fee
  • #8570: allow to return grants of clawback vesting accounts
  • #8223: incremental upgrade of the interchain stack

The release contains at least the following fixes:

Assuming agoric-upgrade-13-rc0 satisfies all pre-release/testnet validation checks, it will be promoted to agoric-upgrade-13, and recommended for chains to upgrade from the previous agoric-upgrade-12 release. As a state-machine-breaking upgrade, once approved, all chain validators will need to upgrade from agoric-upgrade-12 to this new version (after the chain halts due to reaching the height required in a governance proposal).

No data is migrated during this upgrade.

Since the agoric-upgrade-11 release, state-sync snapshots include more data than before. Nodes which have inadvertently pruned this data (e.g. those created from a state-sync before the agoric-upgrade-11 release) will not be able to produce such snapshots, and will need to be restored from state-sync using this release. We are aware of continued performance issues related to state-sync. In particular, we've observed that on some deployments, the current implementation can require 100 GB of free disk space and 16GB of memory. By default state-sync uses /tmp, which can be overridden by setting the TMPDIR environment variable for agd.

Below is the cosmos upgrade handler name for this release. This is the name that can be used in governance proposals to deploy this upgrade.

Cosmos Upgrade Handler Name: agorictest-upgrade-13

Below is the git information related to this software release. Note the git tag and cosmos upgrade handler name differ.

Git Tag: agoric-upgrade-13-rc0
Git Commit: 5a6cdeb0c18ae9700d706445acf402f8d1e873c3
@agoric/cosmos package version: 0.35.0-u13.0
Docker: ghcr.io/agoric/agoric-sdk:39

As shown in go.mod this release is based on:

ibc-go v4.5.1
cosmos-sdk v0.45.16
cometbft v0.34.27

How to upgrade

Presuming that your node is running agorictest-upgrade-12, once the upgrade height for a subsequent proposal to upgrade to agorictest-upgrade-13 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 or 18, clang 10 or gcc 10
# stop the agd service
cd agoric-sdk
git fetch --all
git checkout agoric-upgrade-13-rc0
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 16.13 or higher (previous LTS) or Node.js 18.12 or higher (maintenance LTS).
Please note the current active LTS of Node 20 is not officially supported.

Golang Version

The agoric-upgrade-13-rc0 release requires Go 1.20.2 or higher.

C Compiler Version

Clang version 10 or GCC version 10 required.

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

Specifying --upgrade-info for the software upgrade proposal

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.

Assets 2