Telegram готовит торговлю подарками, которые уже лежат в блокчейне, прямо в приложении. 7–11 ноября в бете Telegram для macOS 13.2.0 появились методы API для покупки, выставления на продажу и снятия с продажи таких подарков, для предложений цены за них и для вывода заработанных Gram во встроенный кошелёк. Строки интерфейса к этим экранам уже лежат на платформе переводов Telegram для iOS: подарки с Fragment получают свой фильтр на торговой площадке Telegram, а платят за них и продают их из раздела «Деньги». В стабильных версиях ничего из этого нет, всё на стадии теста. Касается это владельцев коллекционных подарков, перенесённых в блокчейн, и тех, кто получает доход в Gram от каналов, ботов и подарков.
Подарки с Fragment на торговой площадке Telegram
Коллекционный подарок можно держать в профиле или перенести в блокчейн как NFT. С 21 октября для этого есть встроенный кошелёк, а продают такие NFT на Fragment и других площадках сети TON. Торговая площадка внутри Telegram до сих пор показывала только подарки, выставленные из профилей, за звёзды или Gram.
На платформе переводов для iOS у фильтров площадки появились два новых пункта: From Fragment и On-Chain Sales. Рядом стоят строки, которые описывают, как такой лот покупается:
- лоты с Fragment оплачиваются и продаются из кошелька Telegram, без кошелька купить их нельзя;
- купить такой лот можно только себе, не в подарок другому;
- после покупки подарок «появится в вашем кошельке, когда сеть подтвердит» перевод, а при нехватке Gram приложение называет сумму вместе с комиссией сети.
Фильтр From Fragment в выпадающем списке площадки уже видели в клиенте 7 ноября.
Покупка и продажа из кошелька
В схеме API беты для macOS 7 ноября (слой 234) появились три метода:
| Метод | Что передаёт клиент | Что делает, судя по названию |
|---|---|---|
payments.buyStarGiftOnchain | короткое имя подарка и ожидаемую цену | покупка подарка из блокчейна |
payments.updateStarGiftOnchainPrice | короткое имя подарка и новую цену | выставление или смена цены |
payments.cancelStarGiftOnchainSale | короткое имя подарка | снятие с продажи |
Все три отвечают одинаково: адрес NFT, сумма и готовое тело сообщения для блокчейна. Сам сервер подарок не перекладывает: транзакцию подписывает кошелёк пользователя, а Telegram только собирает её содержимое. Поэтому в строках у каждого действия есть состояние ожидания: подарок «будет выставлен на продажу, когда сеть подтвердит», «будет снят с продажи, когда сеть подтвердит». Смена цены, судя по строкам, идёт в два шага: лот снимается с продажи и выставляется заново. Для сбоя между шагами есть своя строка: подарок с продажи снят, а выставить его по новой цене не вышло. Цена ограничена диапазоном, вне его сервер отвечает ошибкой.
В истории кошелька у таких операций свои записи: «Выставлен на продажу», «Снят с продажи», «Куплен» (Put on sale, Removed from sale, Purchased).
Предложения цены за подарки в блокчейне
Для подарков в профиле предложения цены уже есть: покупатель указывает адресата, подарок и сумму в звёздах или Gram, а в чате появляется сервисное сообщение. 8 ноября в схеме беты появился такой же механизм для подарков в блокчейне, но устроенный иначе.
Запрос payments.sendStarGiftOnchainOffer несёт только короткое имя подарка, сумму в Gram, срок и случайный номер — адресата в нём нет, владельца сервер определяет по подарку. В ответ клиент получает не готовую сделку, а транзакцию, которую должен подписать сам: адрес отдельного контракта предложения, срок, сумму и, если контракта ещё нет, его код и данные. Судя по полям ответа, на каждое предложение в сети разворачивается свой контракт, и Gram покупателя лежат на нём до конца срока: строка интерфейса так и говорит, что сумма «удерживается до» такой-то даты. В ответе есть и бюджет на хранение контракта в сети, и запас на исполнение, и штраф.
Дальше сделка идёт так, как её описывают строки iOS:
- Покупатель вводит сумму в Gram и выбирает срок, за который владелец должен ответить. Меньше минимальной цены предложить нельзя: её задаёт отдельное поле подарка, появившееся в сборке 11 ноября. В окне подтверждения — «Вы платите», комиссия площадки и срок.
- Владелец получает сервисное сообщение «Вам предложили … за …» с кнопкой «Посмотреть». Дальше — окно «Подтвердить продажу» с ценой и кнопками «Продать» и «Отклонить». Если подарок сейчас выставлен на продажу, принять предложение нельзя, пока лот не снят.
- Отклонил владелец или вышел срок — Gram возвращаются покупателю сами.
- Покупатель отозвал предложение раньше срока — за это берётся плата, остаток возвращается. Отзывать, по строкам, нужно «в чате с Telegram», и второе предложение на тот же подарок не отправить, пока не отозвано первое.
Сервисное сообщение предложения хранит сумму, комиссию площадки в базисных пунктах, срок, адрес контракта, возврат покупателю и штраф. Отдельный статус «Продажа завершается» показывает, что подтверждённая сделка ещё идёт в сети. Размер комиссии и штрафа в строках не назван: их подставляет сервер.
В сборке 11 ноября к ответу на предложение добавилось второе, необязательное сообщение для отправки без газа. За переводы во встроенном кошельке Telegram уже оплачивает комиссию сети сам, и, вероятно, речь о том же для предложений.
Вывод Gram Earnings в «Деньги»
Gram Earnings — баланс Gram, который аккаунт получает с подарков, рекламы и Fragment. Сейчас вывести его можно только через сайт Fragment, и для этого нужна проверка личности.
7 ноября в схеме беты появился метод payments.withdrawStarsRevenueToWallet, замеченный в тот же день. Он принимает владельца дохода (канал, бот или сам аккаунт), сумму и временный пароль двухэтапной проверки, а отвечает просто «да» или «нет» — без ссылки на Fragment, которую возвращает нынешний метод вывода. Строки iOS к нему — набор Ton.WithdrawToWallet: «Gram уйдут на ваш некастодиальный кошелёк» с адресом в скобках, ошибки «превышен лимит вывода» и «кошелёк ещё создаётся», а также совет проверить историю транзакций, если результат вывода не подтвердился.
Есть и связка с торговлей. Если Gram в кошельке на подарок не хватает, приложение предлагает взять их из Gram Earnings: сумма переходит на баланс кошелька и уходит на покупку. Пока перевод в пути, купить подарок нельзя: покупку нужно повторить, когда Gram дойдут.
Звёзды или Gram
Метод назван по доходу в звёздах, но строки к нему говорят только о Gram. У Telegram доход в звёздах и в Gram хранится в одной структуре, и нынешний метод вывода через Fragment различает их флагом ton. В схеме, извлечённой из беты для macOS, такие флаги-переключатели не видны: у метода статистики дохода пропадают флаги dark и ton, у переноса подарка в кошелёк — keep_on_profile, хотя в схеме Telegram Desktop они есть. У нового метода необязательная сумма стоит на флаге 1, а флаг 0 в схеме не виден — вероятно, это тот же флаг ton. Выведут ли напрямую звёзды, из схемы не следует: звёзды — не монета блокчейна, и строк о выводе звёзд на кошелёк нет.
Что подтверждено, а что нет
- Методы покупки, продажи и предложений и вывод на кошелёк есть только в бете Telegram для macOS, в схеме Telegram Desktop (слой 233) их нет. В документации API их тоже нет.
- Строки интерфейса пока только английские и только для iOS; в разделе macOS и в строках Telegram Desktop их нет.
- Какую часть цены берёт площадка, каков штраф за ранний отзыв и лимит вывода, из клиента не видно.
- Нужна ли проверка личности для вывода Gram Earnings на кошелёк Telegram, пока неизвестно.




