Release v1.17.1
v1.17.1 - 2024-01-11
Users should upgrade to v1.17.1 at their earliest convenience.
Release v1.17.1 addresses CWA-2023-004 and also adds some command-line functionality and configuration recommendations.
[High Low] Security Advisory CWA-2023-004
Provenance 1.17.1 contains a dependency update for the CosmWasm VM to resolve a security issue which could result in non-determinism and a halt of the network. This advisory has been reclassified from HIGH to LOW risk due to the configuration of the Provenance Blockchain Network.
The Provenance Blockchain network does not permit the permission-less upload of smart contract code, resulting in a Low risk exposure for this advisory. The Provenance Blockchain Foundation advises against accepting any further smart contract code proposals until after the deployment of the 1.17.1 patch. This is to provide the network with an opportunity to mitigate potential risks effectively. Updating to the 1.17.1 release is recommended at your earliest convenience.
New Configuration Recommendations
Provenance has a few new recommendations regarding node configuration.
Goleveldb
Provenance now recommends that nodes use goleveldb
as their db backend. Support for cleveldb
and badgerdb
will be removed in a future upgrade. It is better to do this migration outside of an upgrade. Nodes currently using those database backends should migrate to goleveldb
at your leisure prior to that upgrade. If your node is using cleveldb
, a warning will be issued when your node starts.
To migrate to goleveldb
from cleveldb
:
- Stop your node.
- Back up your
data
andconfig
directories. - Update your
config.toml
to havedb_backend = "goleveldb"
. - Update your
app.toml
to have eitherapp-db-backend = ""
orapp-db-backend = "goleveldb"
. - Restart your node.
In some cases, that process might not work and your node will fail to restart. If that happens, restore your data
and config
directories and follow the same steps below.
To migrate to goleveldb
from badgerdb
(or if the above steps failed):
- Stop your node.
- Back up your
data
andconfig
directories. - Use the dbmigrate utility to migrate your node's database to
goleveldb
. This can take 3 hours or more to complete and should not be interrupted. - Restart your node.
IAVL-Fastnode
Provenance also recommends that nodes enable iavl-fastnode. In a future upgrade, nodes will be required to use iavl-fastnode, and it is better to do this migration outside of an upgrade. If your node's app.toml
has iavl-disable-fastnode = true
, you should migrate your store at your leisure prior to the next upgrade. If your node has iavl-fastnode disabled, a warning will be issued when your node starts.
It might take 3 hours or more for the migration to finish. Do not stop or restart your node during this process. Your node will be unavailable during this process.
To migrate to iavl-fastnode, follow these steps:
- Stop your node.
- Back up your data directory.
- Update your node's
app.toml
to haveiavl-disable-fastnode = false
. - Restart your node.
Pruning Interval
Provenance recommends, too, that validators use a pruning interval of at most 10
. This can help prevent missed blocks. This is configured in app.toml
. If you have a pruning
value of "default"
, "nothing"
, or "everything"
, you are okay. If you have a pruning
value of "custom"
and a pruning-interval
of 1000
or more, a warning will be issued when your node starts.
Indexer
Lastly, Provenance recommends that validators do not enable tx indexing. This should also help prevent missed blocks. This is configured in config.toml
in the indexer
field of the tx_index
section (aka tx_index.indexer
). If you have an indexer defined, a warning will be issued when your node starts.
Features
- Add CLI commands for the exchange module endpoints and queries #1701.
- Create CLI commands for adding a market to a genesis file #1757.
- Add CLI command to generate autocomplete shell scripts #1762.
Improvements
- Add StoreLoader wrapper to check configuration settings #1792.
- Create a default market in
make run
,localnet
,devnet
and theprovenanced testnet
command #1757. - Updated documentation for each module to work with docusaurus PR 1763
- Set the default
iavl-disable-fastnode
value tofalse
and the defaulttx_index.indexer
value to"null"
#1807.
Bug Fixes
- Deprecate marker proposal transaction #1797.
Dependencies
- Bump
github.com/spf13/cobra
from 1.7.0 to 1.8.0 (#1733) - Bump
github.com/CosmWasm/wasmvm
from 1.2.4 to 1.2.6 (#1799) - Bump
github.com/CosmWasm/wasmd
from v0.30.0-pio-5 to v0.30.0-pio-6 (#1799)