Adding transfer_token function to aptos_token_client.py and adding do…

…cumentation tags for the new your_first_nft tutorial.
aptos-labs · Aug 10, 2023 · f805839 · f805839
1 parent 262d264
commit f805839
Showing 1 changed file with 27 additions and 3 deletions.
diff --git a/ecosystem/python/sdk/aptos_sdk/aptos_token_client.py b/ecosystem/python/sdk/aptos_sdk/aptos_token_client.py
@@ -9,7 +9,8 @@
 from .account_address import AccountAddress
 from .async_client import RestClient
 from .bcs import Deserializer, Serializer
-from .transactions import EntryFunction, TransactionArgument, TransactionPayload
+from .transactions import (EntryFunction, TransactionArgument,
+                           TransactionPayload)
 from .type_tag import StructTag, TypeTag
 
 
@@ -383,6 +384,7 @@ def create_collection_payload(
 
         return TransactionPayload(payload)
 
+    # :!:>create_collection
     async def create_collection(
         self,
         creator: Account,
@@ -401,7 +403,7 @@ async def create_collection(
         tokens_freezable_by_creator: bool,
         royalty_numerator: int,
         royalty_denominator: int,
-    ) -> str:
+    ) -> str:  # <:!:create_collection
         payload = AptosTokenClient.create_collection_payload(
             description,
             max_supply,
@@ -458,6 +460,7 @@ def mint_token_payload(
 
         return TransactionPayload(payload)
 
+    # :!:>mint_token
     async def mint_token(
         self,
         creator: Account,
@@ -466,7 +469,7 @@ async def mint_token(
         name: str,
         uri: str,
         properties: PropertyMap,
-    ) -> str:
+    ) -> str:  # <:!:mint_token
         payload = AptosTokenClient.mint_token_payload(
             collection, description, name, uri, properties
         )
@@ -515,6 +518,27 @@ async def mint_soul_bound_token(
         )
         return await self.client.submit_bcs_transaction(signed_transaction)
 
+    # :!:>transfer_token
+    async def transfer_token(
+        self, sender: Account, token: AccountAddress, to: AccountAddress
+    ) -> str:
+        payload = EntryFunction.natural(
+            "0x1::object",
+            "transfer",
+            [TypeTag(StructTag.from_str("0x4::token::Token"))],
+            [
+                TransactionArgument(token, Serializer.struct),
+                TransactionArgument(to, Serializer.struct),
+            ],
+        )
+
+        signed_transaction = await self.client.create_bcs_signed_transaction(
+            sender, TransactionPayload(payload)
+        )
+        return await self.client.submit_bcs_transaction(
+            signed_transaction
+        )  # <:!:transfer_token
+
     async def burn_token(self, creator: Account, token: AccountAddress) -> str:
         payload = EntryFunction.natural(
             "0x4::aptos_token",