Сколько nanoton в одном GRAM?

Миллиард: 1 GRAM = 1 000 000 000 nanoton (10^9). GRAM — переименованная нативная монета TON, ранее называвшаяся Toncoin; сама сеть по-прежнему называется TON. Любое значение, которое возвращает нода или API, — целое число в nanoton.

Почему бы просто не разделить на 1e9 в JavaScript?

Число в JavaScript — это 64-битный float с 53 битами целочисленной точности. Балансы выше примерно 9 007 199 254 740 992 nanoton (около 9 миллионов GRAM) теряют последние цифры, а десятичные дроби вроде 0.1 вообще непредставимы. Этот инструмент держит всё в BigInt и десятичных строках, поэтому результат точен при любом размере.

Что означает ошибка точности?

Вы ввели больше знаков после запятой, чем есть у единицы. 0.0000000001 GRAM — это десятая часть nanoton, которой в сети не существует; инструмент отказывает вместо тихого округления, потому что округлённая сумма в транзакции — это неверная сумма.

Бесплатные инструменты

Конвертер nanoton ↔ GRAM (TON) и единиц жетонов

Точный перевод между человеческими суммами и целыми базовыми единицами, которыми реально оперирует сеть: nanoton для GRAM (бывший Toncoin, 9 знаков) и raw-единицы для жетонов с любым числом decimals. Арифметика на BigInt, без чисел с плавающей точкой, без округления.

GRAM (TON) ↔ nanoton

GRAM (бывший Toncoin)

nanoton

Сумма жетона ↔ raw-единицы

Пресет

Decimals

Сумма

Raw-единицы

Работает в браузере. То, что вы вставляете, не покидает эту страницу.

Nanoton, GRAM и девять знаков

Любая сумма в TON — целое число. Liteserver, API или get-метод никогда не возвращают «1.5 GRAM»; они возвращают 1500000000 — количество nanoton, а как это показать, решает клиент. Один GRAM — переименованная нативная монета TON, ранее Toncoin; сама сеть по-прежнему называется TON — равен 10⁹ nanoton, так что отображаемая сумма — это целое число со сдвигом десятичной точки на девять разрядов влево:

Text

1 GRAM           = 1 000 000 000 nanoton
0.000000001 GRAM = 1 nanoton
1e9 GRAM         = 1 000 000 000 000 000 000 nanoton

Конвертер делает ровно это и ничего больше: сдвигает десятичную точку. Здесь нет ни курса, ни запросов к сети.

Почему инструмент отказывается от float

number в JavaScript — это 64-битный float. Целые числа он представляет точно только до 2⁵³, около 9,007 × 10¹⁵ — это примерно 9 миллионов GRAM в nanoton, — а большинство десятичных дробей не может представить вовсе: 0.1 + 0.2 даёт 0.30000000000000004. Поэтому разделить баланс на 1e9 и умножить обратно — операция с потерями, а сумма, отличающаяся на один nanoton, в транзакции всё равно неверная.

Всё на этой странице — арифметика BigInt на десятичных строках. Значение, которое нельзя представить в decimals единицы — 0.0000000001 GRAM, десятая часть nanoton, — это ошибка, а не округление. Экспоненциальная запись обрабатывается так же: 1e9 — миллиард, 2.5e-3 — 0.0025, оба значения точны.

Жетоны и decimals

Сумма жетона — тоже целое число в собственной базовой единице жетона. Сколько базовых единиц составляют одну отображаемую, определяют decimals жетона, опубликованные в его метаданных — ячейке content, которую возвращает get-метод get_jetton_data мастер-контракта, — под ключом decimals. Если ключа нет, стандарт (TEP-64) предписывает 9.

USDT в TON использует 6, как и USDT в других сетях: 1 USDT — это 1000000 raw-единиц. Отправить 1000000000, предположив девять знаков, значит отправить 1 000 USDT — это самая частая ошибка с единицами в сети. Пресеты покрывают USDT и обычные девять; в поле decimals можно ввести любое значение от 0 до 30 для жетона, который вы рассматриваете.

Эта версия не читает decimals из сети. Если вы их не знаете, прочитайте метаданные жетона через liteserver или обозреватель, прежде чем доверять числу здесь.

Какой ввод принимает конвертер

Цифры с одной десятичной точкой или одной десятичной запятой (1,5), разделители разрядов — пробелы, подчёркивания или запятые при наличии точки (1 000.25, 1,000,000.5), ведущий + и экспоненту (1e9, 2.5E-3). Отрицательные суммы отклоняются. Результат — целое или десятичное число без оформления плюс вариант с разделителями разрядов для чтения.

Частые вопросы

Сколько nanoton в одном GRAM?: Миллиард: 1 GRAM = 1 000 000 000 nanoton (10^9). GRAM — переименованная нативная монета TON, ранее называвшаяся Toncoin; сама сеть по-прежнему называется TON. Любое значение, которое возвращает нода или API, — целое число в nanoton.
Почему бы просто не разделить на 1e9 в JavaScript?: Число в JavaScript — это 64-битный float с 53 битами целочисленной точности. Балансы выше примерно 9 007 199 254 740 992 nanoton (около 9 миллионов GRAM) теряют последние цифры, а десятичные дроби вроде 0.1 вообще непредставимы. Этот инструмент держит всё в BigInt и десятичных строках, поэтому результат точен при любом размере.
Где взять decimals жетона?: В метаданных жетона — ячейке content, которую возвращает get-метод get_jetton_data мастер-контракта, под ключом decimals. Если ключа нет, стандарт говорит 9. USDT в TON использует 6, поэтому 1 USDT — это 1 000 000 raw-единиц, а не 1 000 000 000.
Что означает ошибка точности?: Вы ввели больше знаков после запятой, чем есть у единицы. 0.0000000001 GRAM — это десятая часть nanoton, которой в сети не существует; инструмент отказывает вместо тихого округления, потому что округлённая сумма в транзакции — это неверная сумма.

Приватный доступ к liteserverТарифы Litenode и Archive: запрашивайте сеть напрямую со своим ключом.Документация LiteServersВсе методы, лимиты, маршрутизация в архив и полная глава об ошибках.

Другие инструменты

Коды ошибок TON liteserver403, 429, 502, -400, 651, 652, -503: причина и решение для каждой ошибки liteserver, с поиском.Конвертер и валидатор TON-адресовRaw ↔ EQ ↔ UQ, mainnet и testnet, проверка контрольной суммы, пакетный режим.Хеш TON-сообщения из BoCcell_hash, norm_hash по TEP-467 и sha256 любого BoC сообщения, hex и base64.