Technische Details, Rechtsdokumente und einige Kontovorgänge bleiben auf Englisch.
Beginnen Sie mit dem Sprach- und Graphprotokoll, das Ihre Anwendung bereits verwendet.
Erstellen Sie eine Sitzung mit einem Passkey oder EIP-4361 SIWE Wallet. Kotobase stellt dann einen kurzlebigen Biscuit aus, der auf einen Mandanten, Graph, Inhaber, Ablaufdatum und Berechtigungssatz beschränkt ist.
Die primäre API-Anmeldeinformation ist ein kurzlebiger Biscuit, der nur nach Passkey- oder SIWE-Authentifizierung ausgestellt wird. Fordern Sie ihn für den genauen Graph und die benötigten Berechtigungen an:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Verwenden Sie den vollständigen Autorisierungswert, der vom Endpunkt zurückgegeben wird:
Authorization: Biscuit <token>
CACAO- und undurchsichtige Bearer-Anmeldeinformationen bleiben nur Migrations-Kompatibilitätspfade.
Übergeben Sie den zurückgegebenen Autorisierungswert direkt an das TypeScript-, Python- oder PHP-SDK:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Ein abgelehnter Biscuit wird niemals erneut als CACAO oder Bearer versucht.
Installieren Sie die CLI mit einem Befehl:
curl -fsSL https://kotobase.net/install.sh | sh
Es benötigt babashka und schreibt nur in Ihr eigenes ~/.local.
TypeScript-, Python- und PHP-Clients teilen sich einen Transport- und Authentifizierungsvertrag.
Datomic Client API, SPARQL (einschließlich RDF4J HTTP-Pfadkompatibilität), Cypher, Gremlin und GraphQL werden durch explizite Fähigkeitsentdeckung und Konformitätstests verfolgt.
Verwenden Sie den MCP-Endpunkt unter
https://kotobase.net/mcp
gegen denselben Mandanten-Graphen oder führen Sie
kotobase mcp
aus, um die Client-Konfiguration zu erzeugen.
Importieren oder synchronisieren Sie bidirektional ein Obsidian-Vault und bewahren Sie Markdown, Frontmatter und [[wikilinks]] auf.
Ayatori ist die Abfrageebenen-Komposition, die Anbieterdetektion und unveränderliche IPLD-Blöcke in eine persistente, abfragbare Projektion verwandelt.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
Discovery ist nur ein Anbieterhinweis. Ayatori behandelt es nicht als Nachweis für Abruf, CID-Gültigkeit oder Abfrageausführung.
Ab dem 30. August 2026 ist der gemeinsame kotobase.net Produktions-Abfrageanforderungspfad auf ayatori.query aufgebaut, und der Produktionskomponenten-Lock heißt ayatori.
Dies ist eine Änderung, welches Repository die Produktion bedient, nicht was es berechnet: ayatori.query ist ein Alias-Namespace über derselben Brücke. IPNI-Anbieterdetektion und verifizierte Remote-Block-Lesevorgänge werden auf dem Anforderungspfad weiterhin nicht durchgeführt.
| Bibliothek | Verantwortung | Direkte Beziehung | Status |
|---|---|---|---|
| ayatori | Koordiniert Discovery, verifizierte Remote-Lesevorgänge, persistente Cursor und Abfragematerialisierung. | Verwendet io-ipni-specs, io-ipld, arrangement und kotobase. | Auf dem Produktionsanforderungspfad; seine Discovery- und Remote-Leseebenen sind es nicht |
| io-ipni-specs | Parst IPNI-Anzeigen und delegierte Routing-Anbietergebnisse. | Gibt Anbieter-Kandidaten zurück; es lädt oder verifiziert keine Blöcke. | Ayatori-Abhängigkeit |
| io-ipld | Kodiert und dekodiert IPLD-Links und verifiziert Blöcke gegen angeforderte CIDs. | Wird von Ayatori und dem persistenten Index-Stack verwendet. | Produktionskomponenten-Abhängigkeit |
| arrangement | Persistiert vier abdeckende Indizes als CID-adressierte Snapshots und stellt Cursor-Lesevorgänge bereit. | Verwendet prolly-tree, datom-source und datalog. | Produktionskomponenten-Abhängigkeit |
| prolly-tree | Speichert geordnete Indexknoten als inhaltsadressierte DAG-CBOR-Blöcke. | Bietet Lookup, Präfix-Scan und Bereichs-Scan für arrangement. | Produktionskomponenten-Abhängigkeit |
| datom-source | Definiert den speicherneutralen Pattern-Cursor-Vertrag, der von Abfragepfaden verwendet wird. | Trennt die Abfrageauswertung von einer bestimmten Speicherimplementierung. | Produktionskomponenten-Abhängigkeit |
| datalog | Wertet Datalog über vier abdeckende Indizes aus; besitzt keinen Speicher oder Netzwerk-I/O. | Verbraucht Datom-Quellen und Indizes, die vom Aufrufer bereitgestellt werden. | Produktionskomponenten-Abhängigkeit |
| kotobase-query | Kompatibilitätsbrücke vom flachen Kotobase-Speicher zur Datalog-Materialisierung. | Seine zwei Namensräume werden von ayatori getragen, sodass Aufrufer, die sie noch benennen, weiterhin aufgelöst werden. | Abgelöst; dieselben Namensräume werden jetzt von ayatori bereitgestellt |
Statuslabels beschreiben die gemeinsam genutzten Produktionsabfragekomponenten, die am 30. August 2026 inspiziert wurden. Ein Source-Pin oder ein bestandener Benchmark beweist nicht allein, dass eine Bibliothek Produktionsanfragen bedient.