Concepts & glossary
Эта страница определяет каждую основную сущность DIG Network один раз, простым языком, и связывает её с документом, где раскрыта вся глубина темы. Это человекочитаемый костяк документации — и, поскольку каждый термин также публикуется как машиночитаемые структурированные данные, это карта, которую агент может считать, чтобы изучить словарь сети. Просмотрите её для ориентации; переходите по ссылке, чтобы углубиться.
Capsule
Capsule — это одно неизменяемое поколение store: пара (storeId, rootHash), записываемая канонически
как storeId:rootHash. Это атомарная единица сети — для компиляции (один WASM-модуль фиксированного
размера), ценообразования (единая цена за capsule для mint или
commit, оплачиваемая в $DIG), получения (один URN именует одну capsule), кэширования и
происхождения. Store — это последовательность capsule, по одной на коммит. Это определение
идентично в DigStore, dig RPC и DIG Browser. → Capsule подробно
Store
Store — это идентичность плюс её контент и история: последовательность capsule, по одной на коммит. Его идентичность — это 64-символьный шестнадцатеричный store id, который является launcher id его on-chain синглтона Chia — синглтон в блокчейне является источником истины для текущего корня store. Store — это эквивалент веб-сайта в DIG. → Структура store
Generation
Generation — это одно зафиксированное состояние store, идентифицируемое корневым хешем
(корнем Меркла по листьям ресурсов этого поколения). Каждый commit запечатывает текущий контент в
новое, добавляемое-только поколение — то же самое, что именует capsule. Generation растут
монотонно, как история Git. → Generation и корневые хеши
URN
URN — это адрес и ключ DigStore в одной строке:
urn:dig:chia:<storeId>[:<rootHash>][/<resource>]. Он одновременно находит ресурс и выводит
ключ, расшифровывающий его — обладание URN необходимо и достаточно для чтения публичного ресурса.
Сокращённая форма для браузера — протокол chia://. → URN и шифрование
Retrieval key
Retrieval key — это SHA-256(canonical_urn), единственный адрес, который вообще покидает клиент. Он
находит шифротекст ресурса, не раскрывая его путь или URN. Он не зависит от корня, поэтому один
и тот же ключ находит ресурс во всех generation; отданные байты затем
верифицируются по Меркла отн осительно правильного корня. Отдельный ключ расшифровки
выводится локально (HKDF) из того же URN и никогда не отправляется. → Два значения, одна строка
Merkle proof
Каждое generation строит дерево Меркла с одним листом на ресурс, фиксируя точные байты шифротекста, которые отдаются. Единственное доказательство включения сопровождает отданный ресурс и доказывает, что эти байты принадлежат именно этому корню — так контент верифицируется без расшифровки, а узлу никогда не доверяют факт возврата подлинных байтов. → Доказательства Меркла
On-chain закрепление
Каждый store — это синглтон в основной сети Chia. digstore init минтит его (launcher id
становится store id), а каждый digstore commit закрепляет новый корень generation
в блокчейне как обновление синглтона CHIP-0035. Обе операции блокируются до подтверждения и тратят
реальные средства. Блокчейн является источником истины для последнего корня store. → On-chain закрепление
DIG payment
$DIG — это токен DIG Network (Chia CAT). Минт capsule (init) или её коммит стоит
единую цену за capsule в $DIG, включённую атомарно в ту же on-chain трату, что и закрепление —
отдельной транзакции нет, а memo несёт store id. → Стоимость
DigStore CLI
digstore — это инструмент командной строки, который создаёт, коммитит, делится и читает store —
рабочий процесс в стиле Git (init, add, commit, log, clone, push, pull) поверх
зашифрованного, on-chain формата store. → Справочник команд · CLI-туториал
dig.toml
dig.toml — это коммитимый манифест проекта в корне проекта — store-id, output-dir,
build-command и другая конфигурация проекта, общая для digstore dev, digstore deploy и шаблонов
скаффолдинга. Он не содержит секретов (они берутся из окружения), поэтому его безопасно коммитить.
→ Конфигурация проекта и значения времени сборки
create-dig-app
create-dig-app (npm create dig-app) — это входная точка на JS для запуска проекта DIG: он
создаёт готовый к запуску стартовый проект — приложение, dig.toml и (для шаблонов с
кошельком) подключённый DIG SDK — на основе одного из пяти шаблонов (static, vite-react,
next-static, nft-drop, dapp-window-chia). Скаффолдинг бесплатен — без минта, без блокчейна, без
трат; вы платите единую цену capsule только при публикации capsule. Это npm-аналог CLI на
Rust — команды digstore new. → Скаффолдинг приложения
GitHub deploy Action
dig-network/deploy-action — это GitHub Action для git-push-to-deploy: он устанавливает
CLI digstore на раннере, запускает digstore deploy для продвижения вашего store
(никогда не минтит) и сообщает об опубликованной capsule + URL + стоимости обратно как
выходные данные шага, комментарий к PR, GitHub Deployment и статус коммита. С if-changed
(по умолчанию) байт-идентичная сборка становится no-op — без трат. → Деплой из GitHub Actions
DIG SDK
DIG SDK (@dignetwork/dig-sdk) — это типизированный npm-пакет для интегрирующих разработчиков:
ChiaProvider (предпочитает внедрённый window.chia, при отсутствии — WalletConnect →
Sage), DigClient (читает верифицированный зашифрованный контент через dig RPC), Paywall
(высокоуровне вый помощник pay-to-unlock / гейтинга по владению NFT, объединяющий провайдер со
строителем трат) и канонический строитель трат CHIP-0035, ре-экспортированный по подпути /spend.
→ Создание dapp на Chia
dig RPC
dig RPC — это общесетевой интерфейс чтения: сервис JSON-RPC 2.0 поверх HTTPS POST, на котором
одинаково говорит каждый хостинг-узел. Он отдаёт шифротекст + доказательства включения
по retrieval key, целые capsule по (storeId, root) и метаданные для
обнаружения — слепо по конструкции, с верификацией и расшифровкой на стороне клиента. Это
универсальный путь чтения: каждая опубликованная capsule доступна для чтения здесь по её
URN / адресу chia:// в момент подтверждения в блокчейне — без регистрации и
без платы сверх публикации capsule. Опциональный, удобный для человека
хендл *.on.dig.net — это входная точка поверх этого; сам dig RPC всегда доступен.
→ Что такое dig RPC?
Протокол chia://
chia:// — это нативная схема адресации контента DIG Browser — вводимая вручную форма
URN urn:dig:. Вставьте ссылку chia://<storeId>/, и браузер получит контент прямо из сети,
адресованный по содержимому и криптографически верифицированный. → Протокол chia://
window.chia
window.chia — это провайдер кошелька Chia, который DIG Browser внедряет на каждую страницу. Он
говорит на CHIP-0002, поэтому
веб-приложение может запросить адрес пользователя, подписи и траты без настройки WalletConnect —
готовая альтернатива для приложений, уже говорящих на CHIP-0002. → Использование window.chia
· Спецификация провайдера window.chia (нормативная, версионированная)
DIGHUb
DIGHUb (hub.dig.net) — это веб-приложение для публикации и управления capsule без CLI — создавайте capsule, деплойте фронтенд и просматривайте свои store прямо в браузере. Это также контролируемая плоскость управления, которая бюджетирует дорогостоящие задания ZK-доказательств выполнения.
dig-node
dig-node — это сервер контента сети — сторона предложения. Он размещает capsule,
хранит локальный кэш .dig и говорит на dig RPC идентично rpc.dig.net. Для чтения
контента DIG узел не обязателен (потребители по умолчанию используют rpc.dig.net); запуск узла
делает чтение локально-приоритетным и увеличивает мощность обслуживания сети. Хост слеп — он лишь
ретранслирует шифротекст + доказательства.
→ Запуск узла
Хендл on.dig.net
Хендл on.dig.net — это опциональный, платный удобный для человека веб-адрес для store:
<ваше-имя>.on.dig.net. Store не получает его автоматически — вы регистрируете хендл (платная
регистрация CHIP-54 / on.dig.net в DIGHUb), и эта регистрация закрепляет store за именем.
Без регистрации адреса *.on.dig.net не будет. Это исключительно удобная входная точка: store уже
доступен для чтения через dig RPC по своему URN / адресу chia://
независимо от наличия хендла. (Хендлы аккаунтов и слаги store — отдельные пространства имён и не
раскрывают поддомен автоматически.) → Могу ли я получить адрес *.on.dig.net?
Смотрите также
- Обзор DIG Network — примитивы одним взглядом
- Quickstart — соберите и просмотрите бесплатно, опубликуйте capsule в конце
- Создание dapp на Chia — все примитивы сшиты в одном выпущенном dapp
- Что такое DigStore? — формат store в один файл
- Что такое dig RPC? — путь чтения сети
- Протокол chia:// — адресация контента в браузере
- Получить помощь — каналы сообщества и как сообщить об ошибке
Для агентов и LLM
Эта документация машиночитаема. Каждая страница несёт schema.org JSON-LD (эта страница — как набор
DefinedTerm), и на корне сайта размещены две подготовленные карты:
/llms.txt— насыщенная ссылками markdown-карта документации (соглашение llms.txt)./knowledge-graph.json— сущности (концепции + документы) и типизированные связи (defines,part-of,requires,see-also).