기술 세부 정보, 법률 문서 및 일부 계정 절차는 아직 영어로 제공됩니다.
애플리케이션이 이미 사용하는 언어 및 그래프 프로토콜로 시작하세요.
Passkey 또는 EIP-4361 SIWE 지갑으로 세션을 생성하세요. 그런 다음 Kotobase가 하나의 테넌트, 그래프, 홀더, 만료 및 권한 집합에 제한된 단기 Biscuit을 발급합니다.
주요 API 자격 증명은 Passkey 또는 SIWE 인증 후에만 발급되는 단기 Biscuit입니다. 필요한 정확한 그래프와 권한에 대해 요청하세요:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
엔드포인트가 반환하는 전체 권한 부여 값을 사용하세요:
Authorization: Biscuit <token>
CACAO 및 불투명한 Bearer 자격 증명은 마이그레이션 전용 호환 경로로 남아 있습니다.
반환된 권한 부여 값을 TypeScript, Python 또는 PHP SDK에 직접 전달하세요:
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(RDF4J HTTP 경로 호환 포함), Cypher, Gremlin, GraphQL은 명시적 기능 발견 및 적합성 테스트를 통해 추적됩니다.
다음에서 MCP 엔드포인트를 사용하세요
https://kotobase.net/mcp
동일한 테넌트 그래프에 대해, 또는
kotobase mcp
를 실행하여 클라이언트 구성을 출력하세요.
Markdown, frontmatter, [[wikilinks]]를 보존하면서 Obsidian 볼트를 가져오거나 양방향 동기화하세요.
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을 평가합니다; 저장소나 네트워크 I/O를 소유하지 않습니다. | 호출자가 제공하는 datom 소스와 인덱스를 소비합니다. | 프로덕션 구성 요소 의존성 |
| kotobase-query | 평면 Kotobase 저장소에서 Datalog 물질화로의 호환성 브리지입니다. | 두 네임스페이스는 ayatori에 의해 전달되므로, 여전히 이름을 지정하는 호출자는 계속해서 해석됩니다. | 대체됨; 동일한 네임스페이스가 이제 ayatori에서 제공됩니다 |
상태 라벨은 30년 2026월에 검사된 공유 프로덕션 쿼리 구성 요소를 설명합니다. 소스 핀이나 통과 벤치마크만으로는 라이브러리가 프로덕션 요청을 처리한다는 증명이 되지 않습니다.