From 00783007a3025315dbb5c264f08970fc94a0bee7 Mon Sep 17 00:00:00 2001 From: Greg Nazario Date: Wed, 9 Oct 2024 11:26:59 -0700 Subject: [PATCH] [exchange guide] Add more explicit native token docs (#655) --- apps/nextra/pages/en/build/guides/exchanges.mdx | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/apps/nextra/pages/en/build/guides/exchanges.mdx b/apps/nextra/pages/en/build/guides/exchanges.mdx index c3b9d9444..de65ee845 100644 --- a/apps/nextra/pages/en/build/guides/exchanges.mdx +++ b/apps/nextra/pages/en/build/guides/exchanges.mdx @@ -73,6 +73,11 @@ We will call this from now on **migrated coins**. Migrated coins can be used int with Fungible Asset and Coin standards. This is important to note when querying balances, to use coin functions and not fungible asset functions. + +APT, the native token of Aptos, is a migrated coin. This means it can be used +with both the Coin and Fungible Asset standards. + + ### Coin Standard (tl;dr) A **coin** has an associated contract that holds the on-chain struct that represents the coin. The coin is @@ -111,7 +116,8 @@ returns a balance of `100000000`, this is `1 APT`. If it returns `100` this is Note: This includes APT and any other coin that was migrated to a fungible - asset. + asset. If the asset is a migrated coin, use this over fungible asset balance. The + fungible asset balance will not include the coin portion of the balance. To retrieve the balance of a coin, or a coin that was migrated to a fungible asset, you can use @@ -1112,6 +1118,11 @@ Here is an example of a migrated coin with APT: https://api.mainnet.aptoslabs.co ### Coin (or migrated coin) Transfers + + APT, the native token of Aptos, is a migrated coin. Please use the `aptos_account::transfer` functions + to transfer APT tokens. + + We suggest you use `0x1::aptos_account::transfer_coins(receiver address, amount)` for transferring coins. It will register the coin if it hasn't been registered yet, and create the associated account if it hasn't been created yet. This will continue to work with any coins that were migrated to a fungible asset, including APT.