Rincian teknis, dokumén hukum, jeung sababaraha prosés akun masih dina basa Inggris.
Mimitian ku basa jeung protokol grafik anu geus dipaké ku aplikasi anjeun.
Jieun sési nganggo Passkey atanapi dompét SIWE EIP-4361. Kotobase teras ngaluarkeun Biscuit anu umurna pondok, diwatesan ka hiji tenant, graph, holder, expiry, sareng permission set.
Kredensial API utama nyaéta Biscuit anu umurna pondok, ngan dikaluarkeun saatos auténtikasi Passkey atanapi SIWE. Ménta éta pikeun graph sareng idin anu pasti diperyogikeun ku anjeun:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Anggo nilai otorisasi lengkep anu dipulangkeun ku endpoint:
Authorization: Biscuit <token>
Kredensial CACAO sareng Bearer anu opak tetep janten jalur kompatibilitas migrasi wungkul.
Pasrahkeun nilai otorisasi anu dipulangkeun langsung ka SDK TypeScript, Python, atanapi PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Biscuit anu ditolak moal pernah dicoba deui salaku CACAO atanapi Bearer.
Pasang CLI ku hiji paréntah:
curl -fsSL https://kotobase.net/install.sh | sh
Éta diperlukeun babashka sareng ngan ukur nyerat ka anjeun sorangan ~/.local.
Klien TypeScript, Python, sareng PHP ngabagi hiji transportasi sareng kontrak auténtikasi.
Datomic Client API, SPARQL (kaasup kasaluyuan jalur HTTP RDF4J), Cypher, Gremlin, sareng GraphQL dilacak ngaliwatan discovery kamampuh anu eksplisit sareng tés konformansi.
Anggo titik akhir MCP
https://kotobase.net/mcp
kana grafik tenant anu sarua, atanapi jalankeun
kotobase mcp
pikeun ngahasilkeun konfigurasi klien.
Impor atanapi singkronkeun dua arah hiji brankas Obsidian bari ngajaga Markdown, frontmatter, sareng [[wikilinks]].
Ayatori nyaéta komposisi query-plane anu ngarobah discovery panyadia sareng blok IPLD anu teu bisa dirobah jadi proyéksi anu tetep sareng bisa di-query.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
Discovery ngan ukur petunjuk panyadia. Ayatori henteu nganggap éta minangka bukti yén retrieval, validitas CID, atanapi palaksanaan query geus hasil.
Nepi ka 30 Agustus 2026, jalur paménta query produksi kotobase.net anu dibagikeun dikomposisikeun dina ayatori.query, sareng konci komponén produksi nyebut ayatori.
Éta téh parobahan ngeunaan répositori mana anu ngalayanan produksi, lain ngeunaan naon anu diitungna: ayatori.query nyaéta alias namespace dina bridge anu sarua. Discovery panyadia IPNI jeung remote block reads anu diverifikasi tetep henteu dilakukeun dina jalur pamundut.
| Pustaka | Tanggung jawab | Patali langsung | Status |
|---|---|---|---|
| ayatori | Ngakoordinasikeun discovery, remote read anu diverifikasi, kursor persistén, jeung matérialisasi query. | Ngagunakeun io-ipni-specs, io-ipld, arrangement, jeung kotobase. | Dina jalur pamundut produksi; pesawat discovery jeung remote-read-na henteu |
| io-ipni-specs | Ngaparés IPNI advertisements jeung hasil panyadia delegated-routing. | Ngabalikeun calon panyadia; henteu nyokot atawa mariksa blok. | Gumantungna Ayatori |
| io-ipld | Ngodekeun jeung ngadékodekeun tumbu IPLD sarta mariksa blok dumasar kana CID anu dipénta. | Dipaké ku Ayatori jeung tumpukan indéks persistén. | Gumantungna komponén produksi |
| arrangement | Ngajaga opat indéks anu ngawengku salaku snapshot anu dialamatkeun ku CID sarta nyayagikeun bacaan kursor. | Ngagunakeun prolly-tree, datom-source, jeung datalog. | Gumantungna komponén produksi |
| prolly-tree | Nyimpen titik indéks anu diurutkeun salaku blok DAG-CBOR anu alamatna dumasar kana eusi. | Nyadiakeun lookup, pamindaian awalan, jeung pamindaian rentang ka arrangement. | Gumantungna komponén produksi |
| datom-source | Nangtukeun kontrak kursor pola anu nétral kana panyimpenan pikeun jalur query. | Misahkeun évaluasi query tina palaksanaan panyimpenan anu tangtu. | Gumantungna komponén produksi |
| datalog | Ngaévaluasi Datalog dina opat indéks anu ngawengku; ieu henteu miboga I/O panyimpenan atawa jaringan. | Ngonsumsi sumber datom jeung indéks anu disayagikeun ku anu nelepon. | Gumantungna komponén produksi |
| kotobase-query | Jembatan kasaluyuan tina panyimpenan Kotobase datar kana matérialisasi Datalog. | Dua namespace-na dibawa ku ayatori, ku kituna anu nelepon anu masih nyebutna bakal tetep bisa ngarésolvana. | Geus digantikeun; namespace anu sarua ayeuna dikirim ti ayatori |
Labél status ngajelaskeun komponén query produksi babarengan anu dipariksa dina 30 Agustus 2026. Pin sumber atawa benchmark anu lulus henteu ku sorangan ngabuktikeun yén hiji perpustakaan ngalayanan pamundut produksi.