Skip to content

Подписка на блоки

Last updated: November 20, 2026

В этой подписке передаются новые блоки из воркчейнов -1 и 0 по возрастанию seqno. Вы можете настроить получение данных только из определенного воркчейна и выбрать, какие именно данные блока получать.

Структура уведомления

Когда новый блок будет сформирован, вы получите уведомление, которое содержит все транзакции и измененные состояния аккаунтов в блоке.

{
    "jsonrpc": "2.0",
    "method": "block",
    "params": {
        "id": {
            "@type": "tonNode.blockIdExt",
            "workchain": 0,
            "shard": -9223372036854775808,
            "seqno": 1234567890,
            "root_hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
            "file_hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
        },
        "header": {
            /* TL-B-схема 'BlockInfo' в 'block.tlb' */
        },
        "transactions": {
            "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=": { // хэш транзакции
                /* TL-B-схема 'Transaction' в 'block.tlb' */
            }
        },
        "account_states": {
            "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=": { // хэш аккаунта
                /* TL-B-схема 'ShardAccount' в 'block.tlb' */
            }
        }
    }
}
ПолеТипОбязательноеОписание
idobjectДаРасширенный идентификатор блока. TL-схема tonNode.blockIdExt в ton_api.tl.
headerobjectНетЗаголовок блока. TL-B-схема BlockInfo в block.tlb. Поле присутствует, если include_block_header установлен true.
transactionsobjectНетСписок обработанных транзакций в блоке, отсортированных по возрастанию параметра lt транзакции. Ключ - хэш транзакции, значение - TL-B-схема Transaction в block.tlb. Поле присутствует, если include_transactions установлен true.
account_statesobjectНетСписок измененных состояний аккаунтов. Ключ - хэш аккаунта (часть адреса аккаунта), значение - TL-B-схема ShardAccount в block.tlb. Поле присутствует, если include_account_states установлен true.

Создание подписки

Подписка на все воркчейны

Чтобы подписаться на все воркчейны, укажите только название подписки без других параметров.

{
    "jsonrpc": "2.0",
    "method": "subscribe",
    "params": {
        "subscription": "block"
    },
    "id": 1
}

Подписка на конкретный воркчейн

Чтобы подписаться на определенный воркчейн, укажите его номер в параметре workchains.

{
    "jsonrpc": "2.0",
    "method": "subscribe",
    "params": {
        "subscription": "block",
        "workchains": [0]
    },
    "id": 1
}

Настройка получаемых данных

Чтобы получать только определенные данные блока, установите true для нужного параметра include_*.

{
    "jsonrpc": "2.0",
    "method": "subscribe",
    "params": {
        "subscription": "block",
        "workchains": [0],
        "include_block_header": false,
        "include_transactions": true
    },
    "id": 1
}

Ответ сервера

После каждого запроса в ответ вы будете получать сообщение с текущими параметрами подписки, чтобы видеть актуальную подписку на сервере.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "workchains": [0, -1],
        "include_block_header": false,
        "include_transactions": true,
        "include_account_states": false
    },
    "id": 1
}
ПолеТипОбязательноеОписание
subscriptionstringДаИмя подписки. По умолчанию всегда block.
workchainsint[]НетСписок воркчейнов.
include_block_headerboolНетВключать ли заголовок блока в уведомления.
include_transactionsboolНетВключать ли транзакции блока в уведомления.
include_account_statesboolНетВключать ли состояния аккаунтов блока в уведомления.

Управление подпиской

Допустим, у вас есть подписка с такими параметрами.

{
    "subscription": "block",
    "workchains": [-1],
    "include_block_header": true,
    "include_transactions": true,
    "include_account_states": false
}

Добавление воркчейна

Чтобы добавить к этой подписке еще один воркчейн, укажите его в параметре workchains.

{
    "jsonrpc": "2.0",
    "method": "subscribe",
    "params": {
        "subscription": "block",
        "workchains": [0]
    },
    "id": 2
}

В ответ вы получите сообщение с обновленными параметрами подписки.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "workchains": [0, -1],
        "include_block_header": true,
        "include_transactions": true,
        "include_account_states": false
    },
    "id": 2
}

Добавление параметров

Чтобы добавить параметры include_*, укажите true для нужного параметра, а в workchains укажите [].

{
    "jsonrpc": "2.0",
    "method": "subscribe",
    "params": {
        "subscription": "block",
        "workchains": [],
        "include_account_states": true
    },
    "id": 3
}

В ответ вы получите сообщение с обновленными параметрами подписки.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "workchains": [0, -1],
        "include_block_header": true,
        "include_transactions": true,
        "include_account_states": true
    },
    "id": 3
}

Удаление воркчейна

Допустим, у вас есть подписка на воркчейны и параметры. Чтобы убрать из подписки один воркчейн, укажите его в параметре workchains.

{
    "jsonrpc": "2.0",
    "method": "unsubscribe",
    "params": {
        "subscription": "block",
        "workchains": [0]
    },
    "id": 4
}

В ответ вы получите сообщение с обновленными параметрами подписки.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "workchains": [-1],
        "include_block_header": true,
        "include_transactions": true,
        "include_account_states": true
    },
    "id": 4
}

Удаление параметров

Чтобы удалить параметры include_*, укажите true для нужного параметра, а в workchains укажите [].

{
    "jsonrpc": "2.0",
    "method": "unsubscribe",
    "params": {
        "subscription": "block",
        "workchains": [],
        "include_account_states": true
    },
    "id": 5
}

В ответ вы получите сообщение с обновленными параметрами подписки.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "workchains": [-1],
        "include_block_header": true,
        "include_transactions": true,
        "include_account_states": false
    },
    "id": 5
}

Удаление подписки

Чтобы полностью удалить подписку, укажите только её название без других параметров.

{
    "jsonrpc": "2.0",
    "method": "unsubscribe",
    "params": {
        "subscription": "block"
    },
    "id": 6
}

В ответ вы получите сообщение об удалении подписки.

{
    "jsonrpc": "2.0",
    "result": {
        "subscription": "block",
        "include_block_header": false,
        "include_transactions": false,
        "include_account_states": false
    },
    "id": 6
}