SEP-41: Clarify mint and clawback effects on total supply

[leighmcculloch]

What

• Clarify that a clawback is a type of burn that reduces the holder's balance and total supply, and that no separate burn or transfer event is emitted alongside the clawback event.
• Clarify that a mint increases total supply and the balance of the recipient.
• State that implementations must increase total supply on mint and reduce it on clawback.

Why

The semantics of clawback were ambiguous — it was unclear whether clawback burns tokens or could transfer them, and whether a separate burn event should accompany the clawback event. This was raised in #1858 (reply in thread). This change makes the behavior explicit and consistent with the Stellar Asset Contract.

Thanks to @orbitlens for identifying the gap.

Close #1858

[Copilot]

Pull request overview

This PR clarifies the semantics of mint and clawback events in the SEP-41 Soroban Token Interface, making explicit that clawback burns tokens (reducing total supply and holder balance) and that no separate burn or transfer event accompanies a clawback event.

Changes:

• Added clarification that mint increases total supply and recipient balance
• Added clarification that clawback is a type of burn that reduces both holder balance and total supply
• Added requirement that implementations must increase total supply on mint and reduce it on clawback
• Updated version from 0.4.0 to 0.4.1 and added corresponding changelog entry

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.