Aptos token base unit, Octa

[Alexzander-Stone]

Asked by markkusweird on Discord (#dev-discussions):

When we transfer from one account to another (be it a normal account or a resource account)
We are transfering it in OCTAS, right?
So if I want to transfer 1 whole Aptos Coin (which is worth about $14 today but that doesn't matter, just for the sake of being on the same page) I need to transfer 100000000 OCTAS here:
aptos_account::transfer(from, to, amount);
the amount will be in OCTAS?
is that correct?

Keywords
Aptos token, Octa, base unit, conversion, transfer

[Alexzander-Stone]

Revised Questions

There are three questions here:

1. What is the smallest unit of the Aptos token (APT)?
2. How many of this smallest unit make up a single APT?
3. When using aptos_account::transfer(from, to, amount) on-chain, what unit of APT is used for the amount argument?

Answers

1. Smallest Unit of the Aptos token

The smallest unit available for APT, is an Octa.

2. One Aptos token = ? Octa

1 Aptos token is 100,000,000 Octas.
or
1 Octa = 10^-8 Aptos token.

3. What unit does the amount argument use, when calling aptos_account::transfer(from, to, amount)?

In the aptos.dev documentation on aptos_account, amount is expressed as a u64 integer. Since we can't have a fractional value on this u64 amount, we use the smallest unit available for the Aptos token.
Which is the Octa.

[flaviokicis]

That is perfect. Thank your for the extremely clear information.