Rincian teknis, dokumen hukum, lan sawetara proses akun isih nganggo basa Inggris.
Miwiti nganggo basa lan protokol graf sing wis digunakake aplikasi sampeyan.
Gawe sesi nganggo Passkey utawa dompet SIWE EIP-4361. Kotobase banjur ngetokake Biscuit sing umuré cendhak, diwatesi mung kanggo siji tenant, graph, holder, wektu kadaluwarsa, lan set idin.
Kredensial API utama yaiku Biscuit sing umuré cendhak lan mung diterbitake sawisé autentikasi Passkey utawa SIWE. Nyuwuna kanggo graph lan idin sing pas karo kabutuhanmu:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Gunakake nilai wewenang lengkap sing dibalekake dening endpoint:
Authorization: Biscuit <token>
Kredensial CACAO lan Bearer sing ora transparan mung tetep dadi jalur kompatibilitas migrasi.
Terusake nilai wewenang sing dibalekake langsung menyang SDK TypeScript, Python, utawa PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Biscuit sing ditolak ora bakal dicoba maneh minangka CACAO utawa Bearer.
Instal CLI nganggo siji prentah:
curl -fsSL https://kotobase.net/install.sh | sh
Iki butuh babashka lan mung nulis menyang duwèkmu dhewe ~/.local.
Klien TypeScript, Python, lan PHP nuduhake siji transportasi lan kontrak autentikasi.
Datomic Client API, SPARQL (kalebu kompatibilitas path HTTP RDF4J), Cypher, Gremlin, lan GraphQL dilacak liwat discovery kapabilitas eksplisit lan tes konformansi.
Gunakake endpoint MCP ing
https://kotobase.net/mcp
marang tenant graph sing padha, utawa jalanake
kotobase mcp
kanggo ngasilake konfigurasi klien.
Impor utawa sinkronisasi bidirectional vault Obsidian kanthi njaga Markdown, frontmatter, lan [[wikilinks]].
Ayatori minangka komposisi query-plane sing ngowahi discovery provider lan blok IPLD immutable dadi proyeksi sing persisten lan bisa dikueri.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
Discovery mung minangka petunjuk provider. Ayatori ora nganggep iku minangka bukti retrieval, validitas CID, utawa eksekusi query.
Ing tanggal 30 Agustus 2026, shared kotobase.net production query request path disusun ing ayatori.query, lan production component lock nyebut ayatori.
Iku minangka owah-owahan babagan repositori endi sing nyedhiyakake produksi, dudu babagan apa sing diitung: ayatori.query minangka namespace alias ing ndhuwur bridge sing padha. Panemuan panyedhiya IPNI lan maca blok remot sing wis diverifikasi isih ora ditindakake ing jalur panjalukan.
| Pustaka | Tanggung jawab | Hubungan langsung | Status |
|---|---|---|---|
| ayatori | Ngatur panemuan, maca remot sing wis diverifikasi, kursor permanen, lan materialisasi pitakon. | Nggunakake io-ipni-specs, io-ipld, arrangement, lan kotobase. | Ing jalur panjalukan produksi; bidang panemuan lan maca remoté ora |
| io-ipni-specs | Ngurai iklan IPNI lan asil panyedhiya delegated-routing. | Ngasilaké kandidat panyedhiya; ora njupuk utawa verifikasi blok. | Dependensi Ayatori |
| io-ipld | Ngode lan mbongkar pranala IPLD, lan verifikasi blok marang CID sing dijaluk. | Digunakake déning Ayatori lan tumpukan indeks permanen. | Dependensi komponen produksi |
| arrangement | Nyimpen patang indeks sing nutupi minangka snapshot sing dialamataké CID lan mbukak maca kursor. | Nggunakaké prolly-tree, datom-source, lan datalog. | Dependensi komponen produksi |
| prolly-tree | Indeks simpul disimpen minangka blok DAG-CBOR sing alamaté adhedhasar konten. | Nyedhiyakake lookup, pemindaian prefiks, lan pemindaian rentang menyang arrangement. | Dependensi komponen produksi |
| datom-source | Ndefinisèkaké kontrak kursor pola sing netral panyimpenan lan digunakaké déning jalur pitakon. | Misahaké evaluasi pitakon saka implementasi panyimpenan tartamtu. | Dependensi komponen produksi |
| datalog | Ngevaluasi Datalog ing patang indeks sing nutupi; ora nduwèni panyimpenan utawa I/O jaringan. | Nganggo sumber datom lan indeks sing diwenehake déning pemanggil. | Dependensi komponen produksi |
| kotobase-query | Jembatan kompatibilitas saka panyimpenan Kotobase datar menyang materialisasi Datalog. | Rong namespace kasebut digawa déning ayatori, mula pemanggil sing isih nyebut jeneng kasebut tetep bisa ngrampungaké. | Wis digantèkaké; namespace sing padha saiki dikirim saka ayatori |
Label status njlèntrèhaké komponen pitakon produksi bebarengan sing dipriksa ing 30 Agustus 2026. Pin sumber utawa benchmark sing lulus ora kanthi otomatis mbuktekaké yèn pustaka nyedhiyakake panjaluk produksi.