Технические сведения, юридические документы и некоторые операции с учётной записью пока доступны на английском.
Начните с языка и протокола графа, которые уже использует ваше приложение.
Создайте сессию с Passkey или кошельком EIP-4361 SIWE. Затем Kotobase выдает краткоживущий Biscuit, ограниченный одним арендатором, графом, держателем, сроком действия и набором разрешений.
Основным API-учетным данным является краткоживущий Biscuit, выдаваемый только после аутентификации Passkey или SIWE. Запросите его для точного графа и необходимых разрешений:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Используйте полное значение авторизации, возвращаемое конечной точкой:
Authorization: Biscuit <token>
Учетные данные CACAO и непрозрачные Bearer остаются путями совместимости только для миграции.
Передайте возвращенное значение авторизации напрямую в SDK для TypeScript, Python или PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Отклоненный Biscuit никогда не повторяется как CACAO или Bearer.
Установите CLI одной командой:
curl -fsSL https://kotobase.net/install.sh | sh
Требуется babashka и записывает только в ваш собственный ~/.local.
Клиенты TypeScript, Python и PHP используют один транспорт и контракт аутентификации.
Datomic Client API, SPARQL (включая совместимость с HTTP-путем RDF4J), Cypher, Gremlin и GraphQL отслеживаются через явное обнаружение возможностей и тесты соответствия.
Используйте конечную точку MCP по адресу
https://kotobase.net/mcp
против того же графа арендатора или запустите
kotobase mcp
для вывода конфигурации клиента.
Импортируйте или синхронизируйте двунаправленно хранилище Obsidian, сохраняя Markdown, frontmatter и [[wikilinks]].
Ayatori — это композиция плоскости запросов, которая превращает обнаружение провайдера и неизменяемые IPLD-блоки в постоянную, доступную для запросов проекцию.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
Обнаружение — это только подсказка провайдера. Ayatori не рассматривает это как доказательство получения, действительности CID или выполнения запроса.
По состоянию на 30 августа 2026 года общий путь запроса в продуктивной среде kotobase.net построен на ayatori.query, а имя компонента блокировки в продуктиве — ayatori.
Это изменение репозитория, обслуживающего продуктив, а не того, что он вычисляет: ayatori.query — это псевдоним пространства имен над тем же мостом. Обнаружение провайдера IPNI и проверенные удаленные чтения блоков по-прежнему не выполняются на пути запроса.
| Библиотека | Ответственность | Прямое отношение | Статус |
|---|---|---|---|
| ayatori | Координирует обнаружение, проверенные удаленные чтения, постоянные курсоры и материализацию запросов. | Использует io-ipni-specs, io-ipld, arrangement и kotobase. | На продуктивном пути запроса; его плоскости обнаружения и удаленного чтения — нет |
| io-ipni-specs | Парсит объявления IPNI и результаты провайдеров делегированного маршрутизации. | Возвращает кандидатов провайдеров; не загружает и не проверяет блоки. | Зависимость Ayatori |
| io-ipld | Кодирует и декодирует IPLD-ссылки и проверяет блоки по запрошенным CID. | Используется Ayatori и стеком постоянного индекса. | Зависимость компонента продуктивной среды |
| arrangement | Сохраняет четыре покрывающих индекса как снимки с адресацией по CID и предоставляет чтение курсоров. | Использует prolly-tree, datom-source и datalog. | Зависимость компонента продуктивной среды |
| prolly-tree | Хранит упорядоченные узлы индекса как блоки DAG-CBOR с адресацией по содержимому. | Обеспечивает поиск, префиксное сканирование и сканирование диапазона для arrangement. | Зависимость компонента продуктивной среды |
| datom-source | Определяет контракт курсора паттерна, нейтрального к хранилищу, используемый путями запросов. | Отделяет оценку запроса от конкретной реализации хранилища. | Зависимость компонента продуктивной среды |
| datalog | Выполняет Datalog по четырём покрывающим индексам; не владеет хранилищем или сетевым вводом-выводом. | Потребляет источники датомов и индексы, предоставленные вызывающей стороной. | Зависимость компонента продуктивной среды |
| kotobase-query | Мост совместимости от плоского хранилища Kotobase к материализации Datalog. | Его два пространства имён поддерживаются ayatori, поэтому вызывающие, которые всё ещё их называют, продолжают разрешаться. | Устарело; те же пространства имён теперь поставляются из ayatori |
Статусные метки описывают общие компоненты производственного запроса, проверенные 30 августа 2026 года. Закрепление источника или прохождение бенчмарка само по себе не доказывает, что библиотека обслуживает производственные запросы.