Skip to content

v0.9.0 — Retry-After, Multi-Secret Rotation, Endpoint Verification

Choose a tag to compare

@nyx-builds nyx-builds released this 04 Aug 09:13
· 1 commit to main since this release

What's New in v0.9.0

Three production-grade features for enterprise webhook delivery.

1. Retry-After Header Support (RFC 7231)

When a downstream server returns 429/503 with a Retry-After header, the engine now:

  • Parses both integer-seconds (Retry-After: 120) and HTTP-date formats
  • Uses the server-requested delay instead of computed backoff
  • Clamps the delay to max_delay_seconds for safety
  • Stores retry_after_seconds in the attempt metadata

2. Multi-Secret Rotation (Zero-Downtime Key Rotation)

Full lifecycle HMAC signing key rotation via SecretRotationManager:

  • initiate — demotes current primary to 'previous', promotes new secret to 'rotating'
  • verify — confirms new secret working, retires old with 24h grace period
  • complete — cleans up expired retired secrets
  • Old secrets remain valid for incoming verification during grace period
  • Cancel mid-rotation reverts to previous primary

3. Endpoint Verification Challenge

Prove endpoint ownership before activation via ChallengeManager:

  • Generates 256-bit cryptographic random token
  • Endpoint must echo token in header (X-Webhook-Verify-Challenge) or body field
  • Configurable: location (header/body/either), TTL (default 10min), max attempts (default 3)
  • Constant-time token comparison prevents timing attacks

Stats

  • MCP tools: 73 → 82 (+9 new)
  • Tests: 661 → 743 (+82 new)
  • New modules: secret_rotation.py, verification.py
  • New model field: DeliveryAttempt.metadata