Merge ce96930ecc into 12d9297c02

pyrogram/methods/chats/transfer_chat_ownership.py

@@ -0,0 +1,65 @@
+from typing import Union
+import pyrogram
+from pyrogram import raw, utils
+
+
+class TransferChatOwnership:
+    async def transfer_chat_ownership(
+        self: "pyrogram.Client",
+        chat_id: Union[int, str],
+        user_id: Union[int, str],
+        password: str,
+    ) -> bool:
+        """Change the owner of a chat or channel.
+
+        .. note::
+
+            Requires owner privileges.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+                Unique identifier for the target chat in form of a *t.me/joinchat/* link, identifier (int) or username
+                of the target channel/supergroup (in the format @username).
+
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the new owner.
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+
+            password (``str``):
+                The 2-step verification password of the current user.
+
+        Returns:
+            ``bool``: True on success.
+
+        Raises:
+            ValueError: In case of invalid parameters.
+            RPCError: In case of a Telegram RPC error.
+
+        Example:
+            .. code-block:: python
+
+                await app.transfer_chat_ownership(chat_id, user_id, "password")
+        """
+        peer_channel = await self.resolve_peer(chat_id)
+        peer_user = await self.resolve_peer(user_id)
+
+        if not isinstance(peer_channel, raw.types.InputPeerChannel):
+            raise ValueError("The chat_id must belong to a channel/supergroup.")
+
+        if not isinstance(peer_user, raw.types.InputPeerUser):
+            raise ValueError("The user_id must belong to a user.")
+
+        r = await self.invoke(
+            raw.functions.channels.EditCreator(
+                channel=peer_channel,
+                user_id=peer_user,
+                password=utils.compute_password_check(
+                    await self.invoke(raw.functions.account.GetPassword()), password
+                ),
+            )
+        )
+
+        return bool(r)