К основному содержанию
T TON Adoption
← Словарь
NODE/03 · Term

Raw Address

Полный адрес контракта в TON в виде workchain:hash, например 0:abc... — машинное представление, без человеко-читаемых проверок.

Синонимы: raw address, сырой адрес, workchain:hash

Raw Address — это машинное представление адреса в TON: пара workchain:hash, где workchain — целое число (обычно 0 для basechain или -1 для masterchain), а hash — 256-битный hash начального состояния контракта в hex-виде.

Пример: 0:8a1c5c9a92b9c5c0e1...c0. Полная длина — 64 hex-символа после двоеточия.

Зачем нужен

Raw — это базовое представление. На нём построена внутренняя индексация в TVM, эксплорерах и SDK. Все get-методы и tonutils-go / ton-core принимают адрес именно в raw-формате (или конвертируют в него на лету).

Чем отличается от friendly

СвойствоRaw (0:abc…)Friendly (EQ…/UQ…)
Длина64 hex + workchain48 base64-символов
Контрольная сумманетCRC16
Bounce-флагне указанзакодирован в букве (E vs U)
Тестнет / mainnetне указанзакодирован
Где использоватьAPI, SDK, скриптыUI, кошельки, общение с пользователем

В кошельке пользователь видит friendly-адрес. Под капотом он конвертируется в raw перед формированием транзакции.

Конвертация

Все основные SDK предоставляют функции Address.parse() и address.toString({ bounceable: …, testOnly: … }). Эксплореры (TonViewer, TonScan) показывают оба формата на странице контракта.

Безопасность

Raw-адрес не имеет встроенной проверки опечаток: одна неверная цифра — и вы шлёте на другой, потенциально несуществующий контракт. Поэтому в UI почти всегда используют friendly с CRC. Raw-формат — это «системный» адрес, и в коде контракта он встречается чаще, чем в интерфейсах.

См. также