Add automatic TFT refund for transfers with no/invalid memo #4

New issue

Closed

opened 2026-02-25 22:24:50 +00:00 by mahmoud · 1 comment

mahmoud commented

2026-02-25 22:24:50 +00:00

Owner

Description

When users send TFT to the treasury with no memo or an invalid memo, the bridge
cannot mint SPORE. Currently these transfers are marked FAILED and the TFT is
stuck in the treasury, requiring manual intervention.

Implement an automatic refund system that:

Returns TFT (minus a small fee) to the sender when a transfer cannot be processed
Supports two refund paths: catch-all RefundHandler for no-memo transfers, and
inline refund on is_refundable() handler errors
Tracks refund state with REFUNDED/REFUND_FAILED statuses and refund_tx in the DB
Is opt-in via REFUND_ENABLED config flag with treasury mnemonic validation

### Description When users send TFT to the treasury with no memo or an invalid memo, the bridge cannot mint SPORE. Currently these transfers are marked FAILED and the TFT is stuck in the treasury, requiring manual intervention. Implement an automatic refund system that: - Returns TFT (minus a small fee) to the sender when a transfer cannot be processed - Supports two refund paths: catch-all RefundHandler for no-memo transfers, and inline refund on is_refundable() handler errors - Tracks refund state with REFUNDED/REFUND_FAILED statuses and refund_tx in the DB - Is opt-in via REFUND_ENABLED config flag with treasury mnemonic validation