Что есть что

Короткий словарь и ответы на первые вопросы.

Здесь по-русски объяснены слова, которые встречаются на других страницах. Английское имя в скобках стоит только там, где оно есть в коде или API.

01 · Понятия

Основные термины.

SubroseПлатформа удалённого управления своими устройствами. Через неё отдаются команды, читаются события и меняются настройки. Устройство слушается только подписи владельца, а в TON записано, кто владелец, какая нода обслуживает устройство, его параметры и события.
УстройствоЖелезо, на котором работает агент subrose: роутер на OpenWrt или Keenetic, Raspberry Pi, Linux-машина, macOS.
ВладелецТот, кому принадлежит устройство. Устройство проверяет каждую команду по его подписи, а право командовать держится на ключе у самого владельца. Аккаунт на чужом сервере не нужен.
ПодписьКриптографическое «да» владельца, которое нельзя подделать. Без подписи устройство не выполнит ни одной команды.
Агент subroseНебольшая программа на самом устройстве. Она проверяет подпись на каждой команде, выполняет команду и отправляет события.
НодаНезависимый сервер, который держит связь с устройством: передаёт команды и знает, какие устройства сейчас на связи. Таких серверов в сети много, они заменяют друг друга и не принадлежат кому-то одному. Ключа владельца у ноды нет, поэтому командовать вместо него она не может. Тем, кто держит серверы, пригодится страница «Операторам нод».
TONБлокчейн, в котором записано, кто владелец устройства, какая нода его обслуживает, его параметры и события. Такие записи нельзя подделать или потерять вместе с чьим-то сервером.
Контракт устройства (Device contract)Запись устройства в TON, где закреплены владелец, права и обслуживающая нода. В коде и API она называется Device contract.
Группа устройств (DeviceGroup)Несколько устройств одного владельца с общим балансом TON: пополняется один кошелёк, и с него платят все. Состав группы меняется только подписью владельца.
Веб-консоль SubroseОткрывается в браузере, ставить ничего не нужно. Там идут привязка устройства по 5-значному коду, управление, события и платежи, руками или через встроенный ИИ-чат. Адрес: console.subrose.co.
СобытиеЗапись о факте из жизни устройства: включилось, сменило ноду, подало собственный сигнал. Значимые факты попадают в TON, а свои события читаются в консоли или через API. Отправляются они одной командой, рецепт есть на странице «События устройства».
КонфигурацияНастройки устройства, закреплённые в TON. Меняются из консоли и только с подписью владельца.
ПлатёжПеревод TON за период обслуживания с баланса владельца. Автоматический перевод с самого устройства на подходе.
Эскроу-кошелёкКошелёк в TON, куда доля ноды и производителя приходит автоматически в момент списания.

02 · Где что лежит

Что у ноды, а что в TON.

В TON записано только то, что должно жить долго. Всё быстрое идёт мимо: нода передаёт команду, агент выполняет её, консоль за секунды показывает результат. Свои события тоже идут этим быстрым путём.

В TON попадает то, что не должно зависеть ни от ноды, ни от производителя: владелец, допущенные ключи, назначенная нода, значимые события. Сами ключи остаются на устройстве и у владельца.

03 · FAQ

Вопросы, которые задают первыми.

Это ещё одно облако для устройств?Нет. Облако — это чужой сервер, чужой аккаунт и чужие правила. Здесь право командовать держится на подписи владельца, важные записи лежат в TON, а связь дают независимые ноды. Поэтому выключить всё разом некому.
Зачем здесь блокчейн?Чтобы важные факты нельзя было переписать: кто владелец и какая нода обслуживает устройство. Записи можно проверить напрямую. Консоль показывает адрес контракта устройства, и по этому адресу запись видна в TON.
Кто может управлять моим устройством?Только тот, у кого есть ключ владельца, то есть сам владелец.
Что будет, если часть инфраструктуры исчезнет?Устройство продолжит работать. Если упала нода, оно само меряет скорость до остальных и после короткой паузы переходит на быструю. От сервисов производителя оно не зависит: права и настройки лежат в TON и на самом устройстве.
Все события устройства публичны?В TON попадают только значимые факты вроде регистрации и смены ноды. Свои события туда не идут и доступны в консоли и через API. Подпись защищает событие от подделки, но не от чтения. Шифрование на подходе, поэтому паролям и личным данным в событии пока не место.
Где здесь деньги?Обслуживание оплачивается в TON за период, с баланса владельца. Автоматический перевод с самого устройства на подходе. Подробности есть на странице «Начать».
Чем нода отличается от облака производителя?Нода — один сервер из сети таких же независимых нод. Она не решает, что можно делать с устройством: она передаёт команду и заменяется другой, если пропадёт. Облако производителя — единственный сервер, которым управляет он один.
Что произойдёт, если производитель перестанет поддерживать модель?Устройство продолжит слушаться владельца. Право командовать держится на его подписи и записи в TON, а от сервера производителя не зависит.
Что видно посторонним в TON, а что нет?В TON лежат владелец устройства, обслуживающая нода, параметры и факты вроде регистрации. Это открытая запись, и свериться с ней можно по адресу контракта. Свои события устройства и содержимое команд туда не попадают: они доступны только через ноду или консоль.
Можно ли пользоваться без понимания блокчейна?Да. Веб-консоль открывается в браузере, устройство привязывается по 5-значному коду, а команды, события и платежи видны в обычном интерфейсе. Нужен только TON-кошелёк с балансом, о нём написано на странице «Начать».

Дальше

Следующий шаг: агент на устройстве.

Агент ставится на одно устройство, привязка идёт по коду, а в консоли сразу видно первое событие. Можно и вернуться на свою страницу: владельцам, производителям, разработчикам, операторам.

Открыть инструкцию