From 1ed952dba005c23b09076dc846b47e9a9998e4ed Mon Sep 17 00:00:00 2001
From: Khanh Hoa <khanhoait.bka@gmail.com>
Date: Wed, 24 Apr 2024 20:27:07 +0700
Subject: [PATCH] docs: add MsgRevokeAll

---
 x/authz/README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/x/authz/README.md b/x/authz/README.md
index 755bfa59c174..5c40338f4714 100644
--- a/x/authz/README.md
+++ b/x/authz/README.md
@@ -21,6 +21,7 @@ granting arbitrary privileges from one account (the granter) to another account
 * [Messages](#messages)
     * [MsgGrant](#msggrant)
     * [MsgRevoke](#msgrevoke)
+    * [MsgRevokeAll](#msgrevokeall)
     * [MsgExec](#msgexec)
     * [MsgPruneExpiredGrants](#msgpruneexpiredgrants)
 * [Events](#events)
@@ -168,6 +169,19 @@ The message handling should fail if:
 
 NOTE: The `MsgExec` message removes a grant if the grant has expired.
 
+### MsgRevokeAll
+
+The `MsgRevokeAll` message revokes all grants issued by the specified granter. This is useful for quickly removing all authorizations granted by a single granter without specifying individual message types or grantees.
+
+```protobuf reference
+https://github.com/cosmos/cosmos-sdk/tree/main/proto/cosmos/authz/v1beta1/tx.proto#L91-L97
+```
+
+The message handling should fail if:
+
+* the `granter` address is not provided or invalid.
+* the `granter` does not have any active grants.
+
 ### MsgExec
 
 When a grantee wants to execute a transaction on behalf of a granter, they must send `MsgExec`.