feat: add map based sep-41 event definitions

Author: mootz12

ecosystem/sep-0041.md

@@ -6,8 +6,8 @@ Title: Soroban Token Interface
 Authors: Jonathan Jove <@jonjove>, Siddharth Suresh <@sisuresh>, Simon Chow <@chowbao>, Leigh McCulloch <@leighmcculloch>
 Status: Draft
 Created: 2023-09-22
-Updated: 2025-08-28
-Version 0.4.1
+Updated: 2026-06-08
+Version 0.5.0
 Discussion: https://discord.com/channels/897514728459468821/1159937045322547250, https://github.com/stellar/stellar-protocol/discussions/1584
 ```
 
@@ -173,6 +173,12 @@ pub trait TokenInterface {
 
 ### Events
 
+Token events support two data formats. The original data format is the format
+defined by earlier versions of this SEP. The map data format encodes the event
+data as a `Map` with `Symbol` keys, and may contain additional keys beyond
+those defined in this SEP. Event consumers must be able to handle keys they do
+not recognize, and are expected to support both formats.
+
 #### Approve Event
 
 The `approve` event is emitted when the allowance is set.
@@ -183,10 +189,17 @@ The event has topics:
 - `Address` the address holding the balance of tokens to be drawn from.
 - `Address` the address spending the tokens held by `from`.
 
-The event has data:
+The event's original data format is:
+
+- `Vec` containing
+  - `i128` the amount allowed to be spent.
+  - `u32` the expiration ledger.
+
+The event's map data format is:
 
-- `i128` the amount allowed to be spent.
-- `u32` the expiration ledger.
+- `Map` containing entries with `Symbol` keys, and values defined as
+  - `amount: i128` the amount allowed to be spent.
+  - `live_until_ledger: u32` the expiration ledger.
 
 #### Transfer Event
 
@@ -199,15 +212,17 @@ The event has topics:
 - `Address` the address holding the balance of tokens that was drawn from.
 - `Address` the address that received the tokens.
 
-The event has data:
+The event's original data format is:
 
 - `i128` the amount transferred.
-- or `map` containing entries with `Symbol` keys, and values defined as
-  - `amount: i128` the amount minted.
+
+The event's map data format is:
+
+- `Map` containing entries with `Symbol` keys, and values defined as
+  - `amount: i128` the amount transferred.
   - `to_muxed_id: Option<u64 | String | BytesN<32>>` void, or entry absent, if
     no muxed ID, or the u64 muxed ID, or for historical legacy reasons, the
     string or bytes memo for Stellar assets.
-  - Other entries allowed as defined by the implementation.
 
 #### Burn Event
 
@@ -218,10 +233,15 @@ The event has topics:
 - `Symbol` with value `"burn"`
 - `Address` the address holding the balance of tokens that was burned.
 
-The event has data:
+The event's original data format is:
 
 - `i128` the amount burned.
 
+The event's map data format is:
+
+- `Map` containing entries with `Symbol` keys, and values defined as
+  - `amount: i128` the amount burned.
+
 #### Mint Event
 
 The `mint` event is emitted when an amount of the token is minted.
@@ -234,15 +254,17 @@ The event has topics:
 - `Symbol` with value `"mint"`
 - `Address` the address to hold the newly minted tokens.
 
-The event has data:
+The event's original data format is:
 
 - `i128` the amount minted.
-- or `map` containing entries with `Symbol` keys, and values defined as
+
+The event's map data format is:
+
+- `Map` containing entries with `Symbol` keys, and values defined as
   - `amount: i128` the amount minted.
   - `to_muxed_id: Option<u64 | String | BytesN<32>>` void, or entry absent, if
     no muxed ID, or the u64 muxed ID, or for historical legacy reasons, the
     string or bytes memo for Stellar assets.
-  - Other entries allowed as defined by the implementation.
 
 #### Clawback Event
 
@@ -259,10 +281,15 @@ The event has topics:
 - `Address` The address holding the balance from which the clawback will take
   tokens.
 
-The event has data:
+The event's original data format is:
 
 - `i128` the amount clawed back.
 
+The event's map data format is:
+
+- `Map` containing entries with `Symbol` keys, and values defined as
+  - `amount: i128` the amount clawed back.
+
 ### Mint and Clawback Event Flexibility
 
 This SEP has purposely not added `mint()`, `init_asset()`, nor `clawback()`
@@ -283,6 +310,8 @@ and a clawback action that emits a clawback event must reduce total supply.
 - `v0.4.0` - Add muxed support to transfer, and mint.
 - `v0.4.1` - Clarify that clawback burns tokens reducing total supply and that
   no separate burn or transfer event is emitted alongside the clawback event.
+- `v0.5.0` - Document the original and map data formats for all events,
+  generalizing the form already used by `transfer` and `mint`.
 
 ## Implementations