Remove deprecated token event format from soroban-token-sdk

soroban-token-sdk/src/_migrating.rs

@@ -1,3 +1,10 @@
+//! # Migrating from v23 to v26
+//!
+//! 1. Remove the deprecated event format. For details, see the [migration guide for v23 contract events].
+//!    And for an example using the `soroban_token_sdk` directly, see the [migration guide for v23 token transfer][v23_token_transfer].
+//!
+//! [migration guide for v23 contract events]: soroban_sdk::_migrating::v23_contractevent
+//!
 //! # Migrating from v22 to v23
 //!
 //! 1. [`MuxedAddress` replaces `Address` as the `to` of the `TokenInterface::transfer`][v23_token_transfer]

soroban-token-sdk/src/_migrating/v23_token_transfer.rs

@@ -16,9 +16,11 @@
 //! the exchange deposits for the token contracts, but is necessary for that.
 //!
 //! The necessary token modification is very minimal. Consider the following
-//! `transfer` implementation that still uses `Address` destination:
+//! `transfer` implementation that still uses `Address` destination. Note that
+//! this example will only compile pre-v26. If you are using v26 or later, you
+//! will need to use the updated implementation shown in the next code snippet.
 //!
-//! ```
+//! ```compile_fail
 //! use soroban_sdk::{Env, Address};
 //! use soroban_token_sdk::TokenUtils;
 //! // ... inside some token contract ...

soroban-token-sdk/src/lib.rs

@@ -2,11 +2,9 @@
 #![cfg_attr(feature = "docs", feature(doc_cfg))]
 pub mod _migrating;
 
-use crate::event::Events;
 use crate::metadata::Metadata;
 use soroban_sdk::Env;
 
-pub mod event;
 pub mod events;
 pub mod metadata;
 mod tests;
@@ -23,8 +21,4 @@ impl TokenUtils {
     pub fn metadata(&self) -> Metadata {
         Metadata::new(&self.0)
     }
-
-    pub fn events(&self) -> Events {
-        Events::new(&self.0)
-    }
 }