Authenticate binary downloads
Prerequisites
- The transaction hash of your Polygon USDC payment, if you placed a paid order
- A browser, or
curlconfigured to follow redirects - Nothing else — no local verification tool, key file, or signature utility is needed
Purpose
Obtain a release from software.pointsav.com through the signed download path, and understand which part of that path actually authenticates the file — about two minutes once your payment has confirmed on-chain.
Note: every product currently listed is priced at $0 for the BETA period and requires no license or payment today. The order-and-token path below is working code and is what a paid order will use, but at present you can download any current release without going through a paid order at all. Steps 1 and 2 apply only if you have placed one.
Procedure
-
Open your order page at
https://software.pointsav.com/order/<tx_hash>, where<tx_hash>is your payment transaction hash. The order reads as pending untiltool-walletconfirms the payment on-chain. -
Reload the page once confirmation lands. A receipt code appears — a deterministic identifier derived from the transaction. Keep it for your records; no download step asks for it, and it is not a download credential.
-
Follow the download link at
https://software.pointsav.com/order/<tx_hash>/download. That request mints a fresh Ed25519-signed token and redirects straight to the release download with the token already attached as a URL parameter. There is no separate token to copy. -
Let the download run to completion. The release service verifies the token's Ed25519 signature server-side before it streams a single byte, so there is no client-side verification command to run afterward.
-
Optional: address a release directly rather than through an order page, using the release URL pattern:
https://software.pointsav.com/releases/<product>/<version>/<platform> https://software.pointsav.com/releases/<product>/latest/<platform>The
latestform redirects to the resolved current version.
Expected outcome
You hold the release file, and the fact that you hold it is the proof that its download token verified: a request carrying a missing, malformed, or badly-signed token does not produce a release file. The token's wire format is base64url(signature || payload_json), unpadded, and it is checked with Ed25519 on the server before the response body begins.
Verification
Confirm you received a release file rather than an error page — check the file's size and type against what the release page advertised. The signature check itself has already happened at that point; it is not a step you repeat locally.
To inspect the platform's public signing key independently, the release service publishes it at /verify-key.pub as a plain hex string: 32 raw bytes, 64 hex characters.
Warning: that path is not currently reachable through the public
software.pointsav.comdomain. The underlying service serves it correctly, but a routing gap in front of the public domain means a request to it there does not reach the handler. Treat independent key retrieval as unavailable over the public domain until that routing is fixed.
Rollback
Downloading changes nothing on the server and nothing on your host outside the file you fetched, so there is nothing to reverse. Delete the file and start again from step 3 if a download is incomplete or corrupted.
Do not reuse a saved download URL from an earlier session. The token is minted fresh on each visit to the order page's download link, so a stale link is repaired by returning to the order page rather than by editing the URL.
Next steps
- Self-host a deployment — boot an appliance image once you have it
- Private binary download endpoint for paying customers — the ordering and distribution architecture behind these URLs
- PointSav software distribution substrate — how signed binary releases are delivered