2faaa8b32b
Go 1.14 added runtime support for handling the windows CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, and CTRL_SHUTDOWN_EVENT events by adding a definition for syscall.SIGTERM to windows and converting the events to that signal. It also added definitions for other common signals, including SIGHUP, and treats them as NOOPs on windows. Consequently, this modifies the logic that deals with conditionally handling SIGTERM and SIGHUP to handle them for windows as well as all unix-like operating systems, including newer ones that are supported by Go since the code was originally written. Although the additional signals could probably just be added unconditionally without too much issue now due to the runtime adding stubs to all operating systems the project officially supports, it is safer to be explicit when dealing with syscall definitions since there is no guarantee that they will exist for newly-added operating systems.
vspd
Overview
First announced in 2020, vspd is a from scratch implementation of a Voting Service Provider (VSP) for the Decred network.
A VSP running vspd can be used to vote on any ticket - tickets do not need to be purchased with any special conditions such as dedicated outputs for paying VSP fees. Fees are paid directly to the VSP with an independent on-chain transaction.
To use vspd, ticket holders must prove ownership of their ticket with a cryptographic signature, pay the fee requested by the VSP, and submit a private key which enables the VSP to vote the ticket. Once this process is complete the VSP will add the ticket to a pool of always-online voting wallets.
Features
-
API - Tickets are registered with the VSP using a JSON HTTP API. For more detail on the API and its usage, read api.md
-
Web front-end - A minimal website (no JavaScript) providing public pool stats. A password protected admin page provides an overview of system status, enables searching for tickets and downloading database backups.
-
Two-way accountability - All vspd requests and responses are signed by their sender, which enables both the client and the server to hold each other accountable in the case of misbehaviour. For more detail and examples, read two-way-accountability.md.
-
Dynamic fees - Clients must request a new fee address and amount for every ticket. When these are given to a client, there is an associated expiry period. If the fee is not paid in this period, the client must request a new fee. This enables the VSP admin to change their fee as often as they like.
Implementation
vspd is built and tested on go 1.20 and 1.21, making use of the following libraries:
-
gin-gonic/gin webserver.
-
etcd-io/bbolt key-value database.
-
jrick/wsrpc for RPC communication with dcrd and dcrwallet.
Deployment
A vspd deployment consists of a single front-end server which handles web requests, and a number of remote servers which host voting wallets. For more information about deploying vspd, check out deployment.md.
Development
Test Harness
A test harness is provided in harness.sh. The test harness uses tmux to start
a testnet instance of dcrd, multiple dcrwallets, and finally vspd. Further
documentation can be found in harness.sh.
Web server debug mode
The config option --webserverdebug will:
- Force HTML templates to be reloaded on every web request.
- Reload the cached homepage data every second rather than every 5 minutes.
- Enable detailed webserver logging to the terminal (does not get written to log file).
Issue Tracker
The integrated GitHub issue tracker is used for this project.
License
vspd is licensed under the copyfree ISC License.