Skip to main content
from pytonapi.utils import raw_to_userfriendly, userfriendly_to_raw, to_nano, to_amount

​
Address Conversion

raw_to_userfriendly — convert a raw address (workchain:hex) to user-friendly base64 format. 
raw = "0:83ae019a23a8162beaa5cb0ebdc56668b2eac6c6ba51808812915b206a152dc5"

raw_to_userfriendly(raw)
# UQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxZR0

raw_to_userfriendly(raw, is_bounceable=True)
# EQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxcmx

raw_to_userfriendly(raw, is_test_only=True)
# 0QCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxS_-

raw_to_userfriendly(raw, is_test_only=True, is_bounceable=True)
# kQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxXI7
ParameterDefaultDescription
addressRequiredRaw address in workchain:hex form.
is_bounceableFalseBounceable flag.
is_url_safeTrueURL-safe base64 encoding.
is_test_onlyFalseTest-only address flag.
userfriendly_to_raw — convert a user-friendly base64 address back to raw format. 
userfriendly_to_raw("EQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxcmx")
# 0:83ae019a23a8162beaa5cb0ebdc56668b2eac6c6ba51808812915b206a152dc5
Accepts both standard and URL-safe base64. Raises ValueError on invalid input.

​
Amount Conversion

to_nano — convert a human-readable amount to the smallest unit (nanotons for TON). 
to_nano(1.5)                # 1_500_000_000
to_nano("0.001")            # 1_000_000
to_nano(100, decimals=6)    # 100_000_000 (USDT)
ParameterDefaultDescription
valueRequiredAmount (number or string).
decimals9Decimal places (9 for TON).
to_amount — convert the smallest unit back to a human-readable Decimal. 
to_amount(1_500_000_000)               # Decimal("1.5")
to_amount(1_500_000_000, precision=2)  # Decimal("1.50")
to_amount(100_000_000, decimals=6)     # Decimal("100")
ParameterDefaultDescription
valueRequiredAmount in smallest units.
decimals9Decimal places (9 for TON).
precisionOptionalRound result to N decimal places.