Skip to content

Commit d960898

Browse files
authored
docs: Add 1.3.0 release note
1 parent 4012b09 commit d960898

File tree

1 file changed

+69
-0
lines changed

1 file changed

+69
-0
lines changed
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
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

Comments
 (0)