Refactor code and improve documentation for NFTTransferTransaction an…

…d JettonTransferTransaction.

aiogram_tonconnect/tonconnect/transactions.py

@@ -50,17 +50,23 @@ def __init__(
 class JettonTransferTransaction(Transaction):
     """
     Create a Jetton transfer transaction.
+    Jetton specification link https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md
 
     :param jetton_wallet_address: The address of the Jetton wallet.
     :param recipient_address: The recipient's address.
     :param jetton_amount: The amount of Jetton to transfer.
     :param jetton_decimal: The number of decimal places in the Jetton amount (default is 9).
     :param query_id: The query ID (default is 0).
-    :param transfer_fee: The transfer fee amount in TON (default is 0.07 TON).
-    :param response_address: The address for the response (default is the recipient's address).
+    :param transfer_fee: The transfer fee amount in TON (default is 0.05 TON).
+    :param response_address: The address for the response (the sender's address is specified).
+        If the address is specified, the excess of TON is returned to the specified address;
+        otherwise, it remains on the token contract.
     :param custom_payload: Custom payload for the transaction.
     :param forward_payload: Forward payload for the transaction.
-    :param forward_amount: Forward amount in TON.
+        If forward_amount is greater than 0, this payload will be included with the notification to the new owner.
+    :param forward_amount: Forward amount in TON (default is 0.01 TON).
+        A notification will be sent to the new owner if the amount is greater than 0;
+        otherwise, the new owner will not receive a notification.
     """
 
     def __init__(
@@ -70,19 +76,19 @@ def __init__(
             jetton_amount: int,
             jetton_decimal: int = 9,
             query_id: Optional[int] = 0,
-            transfer_fee: Union[float, int] = 0.07,
+            transfer_fee: Union[float, int] = 0.05,
             response_address: Optional[str] = None,
             custom_payload: Optional[Cell] = Cell.empty(),
             forward_payload: Optional[Cell] = Cell.empty(),
-            forward_amount: Union[float, int] = 0,
+            forward_amount: Union[float, int] = 0.01,
     ) -> None:
         payload = urlsafe_b64encode(
             begin_cell()
             .store_uint(0xf8a7ea5, 32)
             .store_uint(query_id, 64)
             .store_coins(int(jetton_amount * 10 ** jetton_decimal))
             .store_address(recipient_address)
-            .store_address(response_address or recipient_address)
+            .store_address(response_address)
             .store_maybe_ref(custom_payload)
             .store_coins(int(forward_amount * 1e9))
             .store_maybe_ref(forward_payload)
@@ -104,15 +110,21 @@ def __init__(
 class NFTTransferTransaction(Transaction):
     """
     Create an NFT (Non-Fungible Token) transfer transaction.
+    Link to NFT specification https://github.com/ton-blockchain/TEPs/blob/master/text/0062-nft-standard.md
 
     :param nft_address: The address of the NFT.
     :param new_owner_address: The new owner address.
-    :param response_address: The address for the response (default is the recipient's address).
+    :param response_address: The address for the response (the sender's address is specified).
+        If the address is specified, the excess of TON is returned to the specified address;
+        otherwise, it remains on the token contract.
     :param query_id: The query ID (default is 0).
     :param transfer_fee: The transfer fee amount (default is 0.05 TON).
     :param custom_payload: Custom payload for the transaction.
     :param forward_payload: Forward payload for the transaction.
-    :param forward_amount: Forward amount in TON.
+        If forward_amount is greater than 0, this payload will be included with the notification to the new owner.
+    :param forward_amount: Forward amount in TON (default is 0.01 TON).
+        A notification will be sent to the new owner if the amount is greater than 0;
+        otherwise, the new owner will not receive a notification.
     """
 
     def __init__(
@@ -124,14 +136,14 @@ def __init__(
             transfer_fee: Union[int, float] = 0.05,
             custom_payload: Optional[Cell] = Cell.empty(),
             forward_payload: Optional[Cell] = Cell.empty(),
-            forward_amount: Union[float, int] = 0,
+            forward_amount: Union[float, int] = 0.01,
     ) -> None:
         payload = urlsafe_b64encode(
             begin_cell()
             .store_uint(0x5fcc3d14, 32)
             .store_uint(query_id, 64)
             .store_address(new_owner_address)
-            .store_address(response_address or new_owner_address)
+            .store_address(response_address)
             .store_maybe_ref(custom_payload)
             .store_coins(int(forward_amount * 1e9))
             .store_maybe_ref(forward_payload)