Skip to content

v1.2 - Lightning Improvements

Stability and performance improvements to the Lightning Network integration, focused on reliability in low-connectivity environments like Kwanokuthula township.

What changed

  • Automatic invoice expiry handling — expired invoices are now cleanly detected and the user is prompted to regenerate rather than seeing a cryptic error
  • Retry logic for failed payment forwards — transient routing failures are retried up to 3 times before surfacing an error to the merchant
  • Connection health indicator — the merchant dashboard now shows real-time Lightning node connection status
  • Reduced gRPC timeout — default timeout lowered from 60s to 15s to match real-world usage on mobile connections

Bug fixes

  • Fixed a race condition where two simultaneous payment notifications could create duplicate transaction records
  • Fixed QR codes not rendering on older Android WebView versions

Upgrade notes

No database migrations required. Update LIGHTNING_GRPC_TIMEOUT_MS in your .env if you had previously customised the timeout.