Ed25519 JWS Signing Key Rotation
The facilitator serves allactive and verify_only public keys at GET /.well-known/jwks.json (Cache-Control: public, max-age=300).
- Insert a new
activeEd25519 key encrypted withAES-256-GCMunderMASTER_KEY. - Move the previous key to
verify_onlyfor at least 10 minutes so all 60-second in-flight payment tokens verify cleanly. - Transition old keys to
retired.
Zero-Downtime Seller Key Rotation
Each seller can hold up to 2 active seller keys (hgs_<env>_...) at the same time:
- Create a second key in Sell → Seller keys.
- Roll your middleware deployment with the new
HAGGLES_SELLER_KEY. - Revoke the old key.