Changelog

CHANGES.md

@@ -40,6 +40,8 @@ be compatible with this version,  specifically, those that ran with
  -  (Libplanet.Store) Removed `BaseNode`.  [[#3574]]
  -  (Libplanet.Store) Added `ITrie.Remove()` interface method.  [[#3576]]
  -  (Libplanet.Store) Added `FullNode.RemoveChild()` method.  [[#3576]]
+ -  (Libplanet.Action) Added `IAccount.RemoveState()` interface method.
+    [[#3577]]
 
 [#3559]: https://github.com/planetarium/libplanet/pull/3559
 [#3560]: https://github.com/planetarium/libplanet/pull/3560
@@ -51,6 +53,7 @@ be compatible with this version,  specifically, those that ran with
 [#3573]: https://github.com/planetarium/libplanet/pull/3573
 [#3574]: https://github.com/planetarium/libplanet/pull/3574
 [#3576]: https://github.com/planetarium/libplanet/pull/3576
+[#3577]: https://github.com/planetarium/libplanet/pull/3577
 
 
 Version 3.9.2

Libplanet.Action/State/Account.cs

@@ -52,6 +52,8 @@ public Account(
         [Pure]
         public IAccount SetState(Address address, IValue state) => UpdateState(address, state);
 
+        /// <inheritdoc/>
+        [Pure]
         public IAccount RemoveState(Address address) => UpdateState(address, null);
 
         /// <inheritdoc/>

Libplanet.Action/State/IAccount.cs

@@ -67,6 +67,21 @@ public interface IAccount : IAccountState
         [Pure]
         IAccount SetState(Address address, IValue state);
 
+        /// <summary>
+        /// Gets a new instance that the account state of the given
+        /// <paramref name="address"/> is removed.
+        /// </summary>
+        /// <param name="address">The <see cref="Address"/> referring
+        /// the account to remove its state.</param>
+        /// <returns>A new <see cref="IAccount"/> instance that
+        /// the account state of the given <paramref name="address"/>
+        /// is removed.</returns>
+        /// <remarks>
+        /// This method method does not manipulate the instance,
+        /// but returns a new <see cref="IAccount"/> instance
+        /// with updated states instead.
+        /// </remarks>
+        [Pure]
         IAccount RemoveState(Address address);
 
         /// <summary>