diff --git a/src/danog/MadelineProto/DataCenterConnection.php b/src/danog/MadelineProto/DataCenterConnection.php
index fa3aed64e..1018aa084 100644
--- a/src/danog/MadelineProto/DataCenterConnection.php
+++ b/src/danog/MadelineProto/DataCenterConnection.php
@@ -163,7 +163,7 @@ class DataCenterConnection implements JsonSerializable
     /**
      * Check if auth key is present.
      *
-     * @param boolean|null $temp Whether to fetch the temporary auth key
+     * @param bool $temp
      *
      * @return bool
      */
@@ -175,7 +175,7 @@ class DataCenterConnection implements JsonSerializable
      * Set auth key.
      *
      * @param AuthKey|null $key  The auth key
-     * @param boolean|null $temp Whether to set the temporary auth key
+     * @param bool $temp
      *
      * @return void
      */
@@ -186,7 +186,7 @@ class DataCenterConnection implements JsonSerializable
     /**
      * Get temporary authorization key.
      *
-     * @return AuthKey
+     * @return TempAuthKey
      */
     public function getTempAuthKey(): TempAuthKey
     {
@@ -195,7 +195,7 @@ class DataCenterConnection implements JsonSerializable
     /**
      * Get permanent authorization key.
      *
-     * @return AuthKey
+     * @return PermAuthKey
      */
     public function getPermAuthKey(): PermAuthKey
     {
diff --git a/src/danog/MadelineProto/Db/SqlArray.php b/src/danog/MadelineProto/Db/SqlArray.php
index b3dc4259a..e2f790361 100644
--- a/src/danog/MadelineProto/Db/SqlArray.php
+++ b/src/danog/MadelineProto/Db/SqlArray.php
@@ -12,7 +12,8 @@ abstract class SqlArray extends DriverArray
     /**
      * Create table for property.
      *
-     * @return array|null
+     * @return \Generator
+     *
      * @throws \Throwable
      */
     abstract protected function prepareTable(): \Generator;
diff --git a/src/danog/MadelineProto/MTProtoSession/CallHandler.php b/src/danog/MadelineProto/MTProtoSession/CallHandler.php
index cad16180b..9bf46ecc0 100644
--- a/src/danog/MadelineProto/MTProtoSession/CallHandler.php
+++ b/src/danog/MadelineProto/MTProtoSession/CallHandler.php
@@ -188,7 +188,7 @@ trait CallHandler
      * @param array  $args   Arguments
      * @param array  $aargs  Additional arguments
      *
-     * @return Promise
+     * @return \Generator
      */
     public function objectCall(string $object, $args = [], array $aargs = ['msg_id' => null]): \Generator
     {
diff --git a/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php b/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php
index 97bed8a85..3496b943b 100644
--- a/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php
+++ b/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php
@@ -141,7 +141,7 @@ class HttpProxy implements RawProxyStreamInterface, BufferedProxyStreamInterface
      *
      * @param int $length Length of data that is going to be written to the write buffer
      *
-     * @return \Generator
+     * @return Promise
      */
     public function getWriteBuffer(int $length, string $append = ''): Promise
     {
@@ -152,7 +152,7 @@ class HttpProxy implements RawProxyStreamInterface, BufferedProxyStreamInterface
      *
      * @param int $length Length of payload, as detected by this layer
      *
-     * @return \Generator
+     * @return Promise
      */
     public function getReadBuffer(&$length): Promise
     {
diff --git a/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php b/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php
index 397211551..ebcdd9f5a 100644
--- a/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php
+++ b/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php
@@ -148,7 +148,7 @@ class SocksProxy implements RawProxyStreamInterface, BufferedProxyStreamInterfac
      *
      * @param int $length Length of data that is going to be written to the write buffer
      *
-     * @return \Generator
+     * @return Promise
      */
     public function getWriteBuffer(int $length, string $append = ''): Promise
     {
@@ -159,7 +159,7 @@ class SocksProxy implements RawProxyStreamInterface, BufferedProxyStreamInterfac
      *
      * @param int $length Length of payload, as detected by this layer
      *
-     * @return \Generator
+     * @return Promise
      */
     public function getReadBuffer(&$length): Promise
     {
diff --git a/src/danog/MadelineProto/Stream/Transport/WsStream.php b/src/danog/MadelineProto/Stream/Transport/WsStream.php
index f852e3c7e..6fbb3931c 100644
--- a/src/danog/MadelineProto/Stream/Transport/WsStream.php
+++ b/src/danog/MadelineProto/Stream/Transport/WsStream.php
@@ -121,7 +121,7 @@ class WsStream implements RawStreamInterface, ProxyStreamInterface
     /**
      * {@inheritdoc}
      *
-     * @return \Amp\Socket\Socket
+     * @return EncryptableSocket
      */
     public function getSocket(): EncryptableSocket
     {
diff --git a/src/danog/MadelineProto/TL/TL.php b/src/danog/MadelineProto/TL/TL.php
index 6d27d284c..9a236a158 100644
--- a/src/danog/MadelineProto/TL/TL.php
+++ b/src/danog/MadelineProto/TL/TL.php
@@ -98,7 +98,7 @@ class TL
     /**
      * Get constructors.
      *
-     * @param int $td Whether to get TD or normal methods
+     * @param bool $td
      *
      * @return TLConstructors
      */
@@ -109,7 +109,7 @@ class TL
     /**
      * Get methods.
      *
-     * @param int $td Whether to get TD or normal methods
+     * @param bool $td
      *
      * @return TLMethods
      */
diff --git a/src/danog/MadelineProto/TON/APIFactory.php b/src/danog/MadelineProto/TON/APIFactory.php
index 008f98f12..c22475579 100644
--- a/src/danog/MadelineProto/TON/APIFactory.php
+++ b/src/danog/MadelineProto/TON/APIFactory.php
@@ -89,7 +89,7 @@ class APIFactory extends AbstractAPIFactory
      * @param string $name     Method name
      * @param array $arguments Arguments
      *
-     * @return mixed
+     * @return \Generator
      */
     public function __call_async(string $name, array $arguments): \Generator
     {