|
| 1 | +# vspd 1.3.0 |
| 2 | + |
| 3 | +vspd v1.3.0 contains all development work completed since v1.2.0 (June 2023). |
| 4 | +All commits included in this release can be viewed |
| 5 | +[on GitHub](https://github.com/decred/vspd/compare/release-v1.2.0...release-v1.3.0). |
| 6 | + |
| 7 | +## Dependencies |
| 8 | + |
| 9 | +vspd 1.3.0 must be built with go 1.20 or later, and requires: |
| 10 | + |
| 11 | +- dcrd 1.8.0 |
| 12 | +- dcrwallet 1.8.0 |
| 13 | + |
| 14 | +When deploying vspd to production, always use release versions of all binaries. |
| 15 | +Neither vspd nor its dependencies should be built from master when handling |
| 16 | +mainnet tickets. |
| 17 | + |
| 18 | +## Recommended Upgrade Path |
| 19 | + |
| 20 | +The upgrade path below includes vspd downtime, during which clients will not be |
| 21 | +able to register new tickets, check their ticket status, or update their voting |
| 22 | +preferences. Voting on tickets already registered with the VSP will not be |
| 23 | +interrupted. You may wish to put up a temporary maintenance webpage or announce |
| 24 | +downtime in public channels. |
| 25 | + |
| 26 | +The upgrade path assumes dcrd and dcrwallet are already version 1.8.0. |
| 27 | + |
| 28 | +1. Build vspd from the 1.3.0 release tag. |
| 29 | +1. Stop vspd. |
| 30 | +1. **Make a backup of the vspd database file in case rollback is required.** |
| 31 | +1. Install new vspd binary and start it. |
| 32 | +1. Check vspd log file for warnings or errors. |
| 33 | +1. Log in to the admin webpage and check the VSP Status tab for any issues. |
| 34 | + |
| 35 | +## Notable Changes |
| 36 | + |
| 37 | +- Fee calculation now takes the new block reward subsidy split from the activation |
| 38 | + of [DCP-0012](https://github.com/decred/dcps/blob/master/dcp-0012/dcp-0012.mediawiki) |
| 39 | + into consideration. In practice, this means that VSPs will begin charging |
| 40 | + marginally higher fees. |
| 41 | +- vspd will now distinguish between tickets which are "missed" and tickets which |
| 42 | + are "expired". Previously these tickets would be considered as a single set |
| 43 | + labelled "expired". This is acheived using dcrd and |
| 44 | + [Golomb-Coded Set filters](https://github.com/decred/dcrd/tree/master/gcs#gcs). |
| 45 | +- vspd 1.3.0 will perform a **one-time update of every revoked ticket in the |
| 46 | + database** the first time it is started. This may take a while for VSPs which |
| 47 | + have been active for a long time or have a large number of revoked tickets. |
| 48 | +- Expired and missed tickets added to `/vspinfo`. Revoked is now deprecated. |
| 49 | +- Minor improvements to web UI: |
| 50 | + - Homepage now displays expired and missed tickets instead of revoked tickets. |
| 51 | + - Homepage only displays the current network if it is not running on mainnet. |
| 52 | + - Admin page now displays decoded transactions in a human readable format |
| 53 | + in addition to the raw bytes. |
| 54 | +- Logging has been reviewed to reduce unnecessary verbosity and to make better |
| 55 | + use of log levels. Scripts or monitoring solutions which parse logs may need |
| 56 | + to be updated. |
| 57 | + |
| 58 | +### Bug Fixes |
| 59 | + |
| 60 | +- Disable spell checking on admin page input for ticket hash |
| 61 | + ([#397](https://github.com/decred/vspd/pull/397)). |
| 62 | +- Duplicate transactions will no longer cause an error when calling |
| 63 | + sendrawtransaction |
| 64 | + ([#398](https://github.com/decred/vspd/pull/398)). |
| 65 | +- Calculate missed/expired/revoked ticket ratios as percentage of all tickets, |
| 66 | + not just voted tickets |
| 67 | + ([#417](https://github.com/decred/vspd/pull/417)). |
| 68 | +- Web server returns explicit errors intead of zero values when cache is not ready |
| 69 | + ([#440](https://github.com/decred/vspd/pull/440)). |
0 commit comments